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

API de respuestas automáticas y chatbot de WhatsApp

API de chatbot de WhatsApp: respuestas automáticas ejecutadas por tu código.

Cuando un cliente escribe, Wati envía un webhook de mensaje a tu servidor. Tu código envía la respuesta de vuelta o inicia uno de tus chatbots de Wati para ese contacto.

Última actualización

  • +16 000empresas en más de 190 países
  • 4,6/5valoración media en G2
  • OficialPartner de Negocios de Meta y BSP de WhatsApp
Líder en G2, ChatbotsLíder en Medianas Empresas en G2, ChatbotsLíder de Momentum en G2, ChatbotsMás implementable en G2, WhatsApp MarketingISO 27001RGPD

Un webhook. Tu código responde.

Reglas de palabras clave, un modelo que tú elijas o una consulta en tu sistema de pedidos. Wati transporta el mensaje en ambas direcciones.

  • Empieza con una plantillaUna plantilla aprobada abre la conversación, para un cliente o para 10 000.
  • Continúa en el chatTexto, contenido multimedia y botones una vez que el cliente responde.
  • Termina con tu equipoLos webhooks informan a tu código. El buzón de equipo informa a tus agentes.
El producto

Envía. Responde. Recibe respuestas. Transfiere.

Respuesta automática y chatbots

Tu código responde.

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

Difusiones

Mensajes personales, enviados a escala.

Elige una plantilla aprobada y contacta hasta a 10 000 destinatarios. Cada persona recibe sus propias variables y cada resultado regresa por número.

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.

Actualizaciones de pedidos y alertas

La actualización correcta, en el momento justo.

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

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 (polling).

Bandeja de entrada del equipo

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

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

Contactos y segmentos

Tu CRM, reflejado en Wati.

Crea y actualiza contactos con atributos personalizados, y luego visualiza una vista previa de un segmento antes de enviarle un mensaje.

InstagramComentarios y mensajes directos de Instagram

Crea también automatización para Instagram.

Enumera los comentarios en tus publicaciones, responde en público 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 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

    Haz tu primera llamada

    Envía una plantilla aprobada con una sola solicitud. Luego, 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. Lo que recibes de vuelta

    Un código 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. Tu plantilla aprobada define la redacción exacta.

Código listo para copiarOcultar el código
WEBHOOKevento de mensaje entrante, POST /api/ext/v3/conversations/messages/text saliente
# 1. Wati envía cada mensaje nuevo a tu URL de webhook mediante POST (evento: message).
# 2. Tu código procesa la respuesta y la devuelve:
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": "Sí, estamos abiertos de 9:00 a. m. a 9:00 p. m."
  }'
IN Lo que Wati envía a tu URLCampos del ejemplo de la documentación, recortados
{
  "eventType": "message",
  "id": "69282478274a880fe782b2d9",
  "conversationId": "68c8d56157578adb12ada249",
  "waId": "14155552671",
  "senderName": "Maya",
  "type": "text",
  "text": "¿Están abiertos mañana?",
  "owner": false,
  "timestamp": "1764238453"
}
Creado en

Lo que Wati se encarga de hacer para que tú no tengas que preocuparte.

Incorporación de números

Conéctate a través del Registro Integrado 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 falle un envío.

Reintentos de webhook

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

Límites de velocidad y colas

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

Transferencia a agentes humanos

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

Tokens de API con ámbito

v3 admite tokens con ámbito, de modo 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 previa

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.

Documentación →
GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule

Difusiones

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

Documentación →
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.

Documentación →
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.

Documentación →
GET/chatbotsPOST/chatbots/start

Webhooks

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

Documentación →
GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}

Contactos y segmentos

Sincroniza contactos y atributos desde tu CRM y, a continuación, dirígete a segmentos específicos.

Documentación →
POST/contactsPUT/contactsPOST/segments/evaluate

Bandeja de entrada del equipo

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

Documentación →
PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags

Instagram

Enumera publicaciones y comentarios, responde en público o en privado, y comprueba los permisos.

Documentación →
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 con texto a mensajes directos de Instagram y chats de Messenger.

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ío 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, los contenidos multimedia y los botones requieren una ventana 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 velocidad y disponibilidad de planes en detalle
Límites de velocidad 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 Errores y límites de velocidad, enumerados por nombre de endpoint. La llamada masiva de v1 admite hasta 1,000 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. Actualizar los atributos de 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

¿Tiene Wati una API de chatbot para WhatsApp?

Sí, de dos maneras. Wati publica cada mensaje entrante en tu URL con el webhook message, y tu código responde con los endpoints de mensajería. O bien, en los planes Pro y Business, POST /chatbots/start inicia un chatbot que creaste en Wati para un contacto. No hay un único endpoint de respuesta automática: tu código o tu chatbot de Wati deciden qué decir.

¿Cómo inicio un chatbot de Wati desde la API?

Enumera tus chatbots con GET /chatbots, luego llama a POST /chatbots/start con el contacto y el chatbot_id. Úsalo cuando el flujo ya esté creado en Wati y tu código solo decida cuándo se ejecuta. El webhook chatbotTriggered te indica cuándo se ejecuta un chatbot. Ambos endpoints requieren un plan Pro o Business.

¿Puedo usar un modelo de IA para redactar las respuestas?

Sí. Tu código recibe el texto del mensaje en el webhook, puede pasarlo a cualquier modelo o servicio que elijas, y envía la respuesta con los endpoints de texto o interactivos. Las respuestas de formato libre funcionan dentro de la ventana de 24 horas, la cual está abierta porque el cliente acaba de escribirte.

¿Necesito saber programar?

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

Todavía 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, verifica que tu token permanezca en el servidor.

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

Tu primer mensaje está a una solicitud de distancia.

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