🚀 Wati AI ya está aquí – La Capa de Inteligencia Conversacional para Empresas Modernas Explorar🚀 Wati AI ya está aquí →

API de mensajería de WhatsApp

API de WhatsApp: envía un mensaje y responde a la réplica.

Envía actualizaciones de pedidos, recordatorios y alertas con una plantilla aprobada. Cuando el cliente responda, contesta con texto, fotos, botones o una lista, y muestra un indicador de escritura mientras trabajas.

Última actualización el

  • Más de 16 000empresas en más de 190 países
  • 4,6/5calificación promedio en G2
  • OficialSocio comercial de Meta y BSP de WhatsApp
Líder en G2, ChatbotsLíder en medianas empresas en G2, ChatbotsLíder de impulso en G2, ChatbotsMás implementable en G2, WhatsApp MarketingISO 27001GDPR

Un chat. Actualizaciones, respuestas, fotos y botones.

Una plantilla abre la conversación. Todo lo posterior es una respuesta que tu código puede enviar.

  • Comienza con una plantillaUna plantilla aprobada abre la conversación, ya sea para un cliente o para 10 000.
  • Continúa en el chatTexto, multimedia y botones una vez que el cliente responde.
  • Termina con tu equipoLos webhooks informan a tu código. La bandeja de entrada del equipo informa a tu personal.
El producto

Enviar. Responder. Recibir respuestas. Derivar.

Mensajería

Responde con más que texto.

Dentro de la ventana de 24 horas, envía texto, imágenes, archivos, botones de respuesta y selectores de listas, con un indicador de escritura mientras trabajas.

Difusiones

Mensajes personales, enviados a escala.

Elige una plantilla aprobada y comunícate con hasta 10,000 destinatarios. Cada persona recibe sus propias variables y cada resultado regresa por número.

Actualizaciones de pedidos y alertas

La actualización correcta, en el momento preciso.

Tu sistema de tienda, reservas o facturación envía una plantilla aprobada cuando algo cambia. Los clientes tocan un botón o responden.

Respuesta automática y chatbots

Tu código responde.

El webhook de mensajes envía cada nuevo mensaje a tu servidor. Responde con los endpoints de envío o inicia un chatbot de Wati en Pro y Business.

Webhooks

Cada respuesta, en el instante en que llega.

Los webhooks envían nuevos mensajes, confirmaciones de lectura, clics y errores a tu URL. Sin sondeos.

Bandeja de entrada del equipo

El código lo inicia. Las personas lo terminan.

Las respuestas llegan a la bandeja de entrada del equipo de Wati. Asigna un operador, establece el estado y añade etiquetas mediante la API para que la persona adecuada se encargue.

Contactos y segmentos

Tu CRM, reflejado en Wati.

Crea y actualiza contactos con atributos personalizados, y luego obtén una vista previa de un segmento antes de enviarle mensajes.

InstagramComentarios y DMs de Instagram

Crea automatización para Instagram también.

Muestra los comentarios en tus publicaciones, responde de forma pública o envía una respuesta privada.

Empezar

En marcha en tres pasos.

  1. Conectar

    Conecta tu número

    Vincula tu número de WhatsApp a través del registro integrado (Embedded Signup) de Meta dentro de Wati.

  2. Autenticar

    Obtén un token

    Crea un token de API en Wati y Asígnale únicamente los permisos (scopes) que necesites. Consérvalo en tu servidor.

  3. Enviar

    Realiza tu primera llamada

    Envía una plantilla aprobada con una sola solicitud. Después, añade un webhook para hacer un seguimiento de la entrega.

Tu primera solicitud, explicada

Esto es lo que incluye una solicitud y dónde aparece cada parte en el mensaje.

  1. A quién

    El número de WhatsApp del cliente, con el código de país.

    phone_number14155552671
  2. Qué mensaje

    El nombre de una plantilla que Meta haya aprobado en tu cuenta.

    template_nameorder_update
  3. Qué rellenar

    Los valores para los espacios en blanco de la plantilla, uno por persona.

    custom_paramsname = Mayaorder_id = 10482
  4. Tu clave

    Tu token de API, enviado con cada solicitud. Consérvalo en tu servidor.

    Authorization: Bearer <token>
  5. Qué recibes de vuelta

    Un 200 significa que Wati aceptó el mensaje, junto con un broadcast_id. Las confirmaciones de entrega y lectura llegan más tarde por webhook.

    200broadcast_id

El texto del mensaje y order_update son ejemplos. La redacción la define tu plantilla aprobada.

Fragment 1 de 5. Traduce únicamente el texto dentro de este elemento.
Código listo para copiarOcultar el código
POST/api/ext/v3/conversations/messages/text
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/conversations/messages/text" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "14155552671",
    "text": "Tu pedido 10482 está en camino para entrega. Responde aquí para cambiar la dirección."
  }'
200 Respuesta de ejemploEjemplo de la documentación, recortado
{
  "message": {
    "id": "507f1f77bcf86cd799439011",
    "type": "text",
    "text": "Tu pedido 10482 está en camino para entrega. Responde aquí para cambiar la dirección.",
    "owner": true,
    "local_message_id": "88aed3c93a050b3c53978463",
    "conversation_id": "685bd235e6119686e693a093",
    "created": "2026-07-14T16:15:38.3992421Z",
    "event_type": "message"
  }
}
Integrado

Lo que Wati gestiona para que tú no tengas que hacerlo.

Incorporación de números

Conéctate a través del registro incorporado de Meta. La cuenta de WhatsApp Business se registra para tu empresa.

Estado de las plantillas

Los cambios de aprobación, calidad y categoría llegan como webhooks, para que lo sepas antes de que un envío falle.

Reintentos de webhooks

Hasta 144 reintentos, cada 10 minutos. Si tu endpoint sigue fallando, Wati te envía un correo electrónico.

Límites de frecuencia y colas

Si vas demasiado rápido, obtienes un 429 con una cabecera Retry-After. Los mensajes aceptados esperan en una cola.

Derivación humana

Una bandeja de entrada compartida para el equipo para aquellas conversaciones que tu código no deba responder a solas.

Tokens de API con ámbito

v3 es compatible con tokens con ámbito, por lo que cada integración obtiene únicamente el acceso que necesita.

Envios programados

Programa el envío de una plantilla para más tarde con una sola llamada. Wati la envía a tiempo.

Estimación de costos primero

Estima cuánto costará una difusión antes de enviar nada.

Bajo el capó

Los endpoints, por capacidad.

Plantillas

Inicia conversaciones con plantillas aprobadas, ahora o de forma programada.

Docs →
GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule

Difusiones

Lee los resultados de las campañas y el estado por destinatario, y calcula el costo primero.

Docs →
GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-cost

Mensajería

Responde con texto, contenido multimedia o botones dentro de la ventana de 24 horas.

Docs →
POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicator

Chatbots Pro+

Enumera tus chatbots de Wati e inicia uno para un contacto.

Docs →
GET/chatbotsPOST/chatbots/start

Webhooks

Gestiona las suscripciones y enumera los tipos de eventos que puedes recibir.

Docs →
GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}

Contactos y segmentos

Sincroniza contactos y atributos desde tu CRM y, a continuación, segmenta los públicos objetivo.

Docs →
POST/contactsPUT/contactsPOST/segments/evaluate

Bandeja de entrada del equipo

Asigna un operador, cambia el estado, añade o elimina etiquetas.

Docs →
PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags

Instagram

Enumera publicaciones y comentarios, responde de forma pública o privada, y comprueba los permisos.

Docs →
GET/posts/{post_id}/commentsPOST/comments/{comment_id}/repliesPOST/comments/{comment_id}/privateReplyGET/channels/{channel}/permissions

Las rutas son relativas a https://live-mt-server.wati.io/api/ext/v3. La creación de un webhook utiliza la ruta heredada POST /{tenantId}/api/v2/webhookEndpoints.

Para agentes de IA, el servidor Wati MCP cubre las mismas acciones de WhatsApp y puede responder a mensajes directos de Instagram y chats de Messenger con texto.

Ver los 19 tipos de eventos de webhooks de WhatsApp

Mensajes

  • message
  • newContactMessageReceived
  • sessionMessageSent_v2
  • templateMessageSent_v2

Estado de entrega

  • sentMessageDELIVERED_v2
  • sentMessageREAD_v2
  • sentMessageREPLIED_v2
  • templateMessageFailed

Plantillas y cuenta

  • templateReviewed
  • templateQualityUpdated
  • templateCategoryUpdated
  • wabaStatusReviewUpdate
  • PhoneNumberQualityUpdatedEvent
  • accountUpdated
  • accountDeleted
  • phoneNumberDeleted

Interacción y llamadas

  • chatbotTriggered
  • ctaUrlClicked
  • call.status

También hay disponibles versiones BSUID de varios eventos. Documentación de webhooks

Límites y planes

Límites claros. Publicados.

30 a 100 por 10 s

Envíos de plantillas

Llamadas para enviar plantillas, según tu plan (Growth, Pro o Business).

10 000 destinatarios

Por llamada de envío de v3

Una plantilla, hasta 10 000 personas, cada una con sus propias variables.

24 h de ventana

Respuestas de formato libre

El texto, el contenido multimedia y los botones requieren una ventana de servicio de atención al cliente abierta. Fuera de ella, envía una plantilla.

429 Retry-After

Cuando vas demasiado rápido

Wati te indica cuánto tiempo debes esperar. Los mensajes aceptados se procesan en una cola.

Límites de frecuencia y disponibilidad de planes en detalle
Límites de frecuencia documentados por plan
EndpointGrowthProBusiness
/addContact, /getContacts10 / 10 s10 / 10 s10 / 10 s
/getMessages10 / 10 s10 / 10 s10 / 10 s
/sendTemplateMessage30 / 10 s60 / 10 s100 / 10 s
/sendTemplateMessages30 / 10 s60 / 10 s100 / 10 s

Límites publicados en Errors & Rate Limits, ordenados por nombre de endpoint. La llamada masiva de v1 admite hasta 1000 contactos. Los endpoints principales de mensajería, plantillas y contactos están incluidos en todos los planes. La asignación de equipos, el estado del chat, los chatbots y los segmentos personalizados requieren Pro o Business. La actualización de atributos para muchos contactos a la vez requiere Business. Disponibilidad de endpoints por plan. Si necesitas límites más altos, habla con Wati sobre tu caso de uso.

Preguntas frecuentes

Preguntas frecuentes

La referencia completa de la API es pública. Leer la documentación

¿Puedo enviar actualizaciones de pedidos y recordatorios con la API?

Sí. Llama a POST /messageTemplates/send con una plantilla aprobada y los datos del cliente, como su nombre o número de pedido. Las plantillas pueden iniciar una conversación en cualquier momento, por lo que son ideales para actualizaciones de pedidos, recordatorios y alertas.

¿Qué puedo enviar una vez que el cliente responda?

Durante 24 horas después del último mensaje del cliente, puedes enviar mensajes de formato libre: texto con /conversations/messages/text, archivos con /conversations/messages/fileViaUrl y botones de respuesta o selectores de lista con /conversations/messages/interactive. Fuera de ese período, envía una plantilla.

¿Cómo sé si un mensaje fue entregado?

Una respuesta 200 significa que Wati aceptó el mensaje, no que haya sido entregado. Las actualizaciones de entrega, lectura y errores llegan mediante webhooks, por ejemplo sentMessageDELIVERED_v2, sentMessageREAD_v2 y templateMessageFailed.

¿Necesito saber programar?

Menos que antes. Los creadores de aplicaciones de IA pueden escribir las llamadas a la API a partir de instrucciones en lenguaje sencillo, y los ejemplos de esta página muestran cada llamada.

Aun así, necesitas un número de WhatsApp conectado a Wati, un token de API y una plantilla aprobada por Meta antes de poder iniciar una conversación. Si una herramienta de IA escribe el código, asegúrate de que tu token permanezca en el servidor.

¿Cuáles son los límites de frecuencia de la API?

Las llamadas de contactos y de historial de mensajes están limitadas a 10 solicitudes por cada 10 segundos en todos los planes. Los envíos de plantillas están limitados a 30, 60 o 100 solicitudes por cada 10 segundos en Growth, Pro y Business. Cuando alcanzas un límite, recibes un código HTTP 429 con una cabecera Retry-After. Para límites mayores, ponte en contacto con Wati.

¿Cuál es la diferencia entre la aplicación de WhatsApp Business y la API?

La aplicación Business está pensada para chats manuales en un teléfono, con un máximo de 5 dispositivos vinculados y listas de difusión limitadas a 256 contactos. La API conecta WhatsApp con tus propios sistemas. Puedes enviar plantillas aprobadas de forma masiva, automatizar respuestas, recibir webhooks y compartir un solo número en una bandeja de entrada de equipo.

¿Qué endpoints se incluyen en mi plan?

Los endpoints principales de mensajería, plantillas y contactos están incluidos en todos los planes. La asignación de equipos, el estado de los chats, los chatbots y los segmentos personalizados requieren Pro o Business. La documentación detalla la disponibilidad de los endpoints según el plan.

Tu primer mensaje está a una solicitud de distancia.

Empieza gratis, conecta tu número de WhatsApp en Wati y realiza tu primera llamada.