Documentación de la API de WhatsApp

Empiece aquí

Su primera solicitud en cuatro pasos

Conecte y habilite WhatsApp para un móvil compatible.

Confirme el destinatario con el punto final de verificación de número.

Envíe con waonly=yes.

Para mensajes entrantes, active la recuperación, sincronice y luego llame a /getwa.

The secure SMSMobileAPI mobile app connecting a phone to the web dashboard and REST API for SMS and call operations — Encrypted mobile-to-platform connection

Official mobile application

The secure bridge between your phone, dashboard and API.

SMS and call operations pass through the official SMSMobileAPI app installed on your connected phone. The app securely pairs the device with your account, synchronizes authorized events and links the mobile network to the dashboard and REST API.

1Mobile appPairs the phone and its SIM 2Encrypted linkAuthenticates and protects data in transit 3Dashboard & APIControls workflows and activity

Signed releases distributed through the official Google Play and Apple App Store listings
Google and Apple platform review, signing and distribution controls
Secure device pairing, HTTPS transport and authenticated API access
Only the permissions required for the mobile features you enable

Get the official SMSMobileAPI app on Google Play

Download the official SMSMobileAPI app on the Apple App Store

Capabilities depend on the permissions and background access allowed by Android or iOS.

Autenticación

Mantenga las credenciales en su servidor

Utilice apikey para integraciones directas. Las credenciales del cliente OAuth2 están disponibles para aplicaciones del lado del servidor; solicite un token y envíelo como Autorización: Portador ACCESS_TOKEN.

POST · GET

Enviar un mensaje de WhatsApp

ENDPOINThttps://api.smsmobileapi.com/sendsms

Envía un texto de WhatsApp o un medio compatible a través del entorno conectado.

Cuándo usarlo

Úselo para destinatarios individuales o un grupo de contactos del panel.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Su clave API; omitir cuando se utiliza un token de portador.
`recipients`	teléfono	Requerido	Código de país más número, sin + ni 00.
`message`	cadena	Requerido	Cuerpo del texto; se admiten varias líneas.
`waonly`	Sí	Requerido	Debe ser Sí para solicitar la entrega solo por WhatsApp.
`url_media`	URL HTTPS	Opcional	PDF, documento, archivo o URL pública JPG/PNG.
`url_media_shorted`	Sí	Opcional	Utilice una URL de descarga abreviada con vista previa de PDF modo.
`pdf_with_image`	Sí	Opcional	Agregar una vista previa de imagen para un PDF.
`encrypt_message`	Sí	Opcional	Requerir descifrado del lado del destinatario.
`contactGroup`	GUID	Opcional	Enviar a todos los contactos en un grupo de panel.

Ejemplo de solicitud

rizo

curl -X POST "https://api.smsmobileapi.com/sendsms?waonly=yes" \
  -d "apikey=YOUR_API_KEY" \
  -d "recipients=191728660" \
  --data-urlencode "message=Your order is ready."

Ejemplo de respuesta

JSON

{
  "result": {
    "error": 0,
    "sent": "1",
    "id": "MESSAGE_GUID",
    "send_with_whatsapp": "1"
  }
}

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

Es bueno saberlo

Las URL de medios admitidas deben ser recursos HTTPS públicos.
WhatsApp formato: *negrita*, _italic_, ~tachado~ y monoespacio de triple retroceso.

POST · GET

Reenviar un mensaje de WhatsApp no enviado

ENDPOINThttps://api.smsmobileapi.com/resendwa/

Vuelve a intentar enviar un mensaje de WhatsApp que actualmente tiene un estado de error.

Cuándo usarlo

Úsalo después de diagnosticar una entrada de registro fallida de WhatsApp.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Su clave API.
`guid`	cadena	Requerido	GUID del mensaje fallido.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID"

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

Es bueno saberlo

Solo los mensajes fallidos son elegibles para reenviar.

CONSEGUIR

Activar la recuperación entrante

ENDPOINThttps://api.smsmobileapi.com/getwa/active/

Activa, desactiva o alterna la recuperación de mensajes de WhatsApp.

Cuándo usarlo

Llámalo una vez antes de usar la sincronización entrante de WhatsApp.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Su clave API.
`statut`	0 \| 1 \| x	Opcional	1 activa, 0 desactiva, x u omisión alterna el estado actual.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/getwa/active/?apikey=YOUR_API_KEY&statut=1"

Ejemplo de respuesta

JSON

{
  "success": true,
  "read_message_active": 1,
  "status_note": "Activated"
}

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

Es bueno saberlo

La recuperación entrante está deshabilitada de forma predeterminada por motivos de privacidad.

CONSEGUIR

Sincronizar mensajes entrantes

ENDPOINThttps://api.smsmobileapi.com/getwa/synchronisation/

Solicita una nueva sincronización de WhatsApp antes de la recuperación.

Cuándo usarlo

Llámelo inmediatamente antes de /getwa cuando su aplicación necesite datos entrantes actuales.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Su clave API.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY"

Ejemplo de respuesta

JSON

{
  "error": "0",
  "messages": "synchronized",
  "expire_at": "2026-03-11 12:27:00",
  "expire_at_unix": "1773232020"
}

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

Es bueno saberlo

La sincronización es solo para recibir mensajes. No lo llame antes de enviar.

CONSEGUIR

Recuperar mensajes de WhatsApp

ENDPOINThttps://api.smsmobileapi.com/getwa

Devuelve mensajes entrantes sincronizados de WhatsApp.

Cuándo usarlo

Úselo después de activar y sincronizar la recuperación entrante.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Su clave API.
`before`	Marca de tiempo Unix	Opcional	Devuelve registros anteriores a este marca de tiempo.
`date`	AAAA-MM-DD	Opcional	Devolver registros para una fecha.
`message_type`	texto \| audio	Opcional	Filtrar mensajes de texto o mensajes de audio convertidos a texto; omitir para ambos.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY&message_type=text"

Ejemplo de respuesta

JSON

{
  "date": "2026-03-11",
  "hour": "12:27:00",
  "timestamp": "1773232020",
  "number": "19176728660",
  "contact": "SMSMobileAPI",
  "message": "When will I receive my order?",
  "guid": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c"
}

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

CONSEGUIR

Verificar un número de WhatsApp

ENDPOINThttps://api.smsmobileapi.com/whatsapp/checknumber/

Comprueba si un número de teléfono está disponible en WhatsApp.

Cuándo usarlo

Úselo antes de enviarlo para reducir fallas evitables.

Parámetros

Nombre	Tipo	Requisito	Descripción
`apikey`	cadena	Requerido	Su clave API.
`recipients`	teléfono	Requerido	Código de país más número, sin + ni 00.

Ejemplo de solicitud

rizo

curl "https://api.smsmobileapi.com/whatsapp/checknumber/?apikey=YOUR_API_KEY&recipients=19176728660"

Ejemplo de respuesta

JSON

{
  "contact_found_on_whatsapp": "yes",
  "recipients": "19176728660"
}

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

CORREO

Crear un token de acceso OAuth2

ENDPOINThttps://api.smsmobileapi.com/oauth2/token

Intercambia las credenciales del cliente por un token de portador.

Cuándo usarlo

Úselo para integraciones de servidor a servidor donde las credenciales de corta duración son preferido.

Parámetros

Nombre	Tipo	Requisito	Descripción
`grant_type`	cadena	Requerido	Debe ser client_credentials.
`client_id`	cadena	Requerido	ID de cliente desde el panel.
`client_secret`	cadena	Requerido	Secreto de cliente desde el panel.

Ejemplo de solicitud

rizo

curl -X POST "https://api.smsmobileapi.com/oauth2/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

¿Quiere ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para desbloquear el probador interactivo.

Clave de conexión ↑

Es bueno saberlo

Mantenga el cliente en secreto en su servidor. Nunca lo incluyas en el código del móvil o del navegador.

Solución de problemas

Errores y reintentos seguros

Lea el estado HTTP y el campo de error JSON antes de volver a intentarlo. No vuelva a intentar fallas de validación o autenticación sin corregir primero la solicitud.

HTTP	Código	Qué hacer
400	`missing_parameter`	Un parámetro requerido está vacío o ausente. Consulte la tabla de parámetros del punto final.
403	`invalid_apikey`	La clave API es desconocida, ha caducado o no está autorizada para la función solicitada.
429	`too_many_requests`	Las solicitudes llegan demasiado rápido. Espere y vuelva a intentarlo con un retroceso exponencial.
500	`server_error`	El servicio no pudo completar la solicitud. Conserve la respuesta y comuníquese con el soporte si persiste.

Regla de reintentoReintente solo respuestas transitorias 429 y 5xx. Comience después de 1 segundo, luego retroceda a 2, 4 y 8 segundos.

¿Necesitar ayuda?

Traiga el contexto de la solicitud, no sus secretos.

Comparta el punto final, la marca de tiempo, el estado HTTP y la respuesta desinfectada. Nunca incluya claves API, tokens ni contenido de mensajes privados.

Comuníquese con el soporte de API →