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

API de llamadas de WhatsApp

API de llamadas de WhatsApp Business: voz y chat en un solo número.

Los clientes hacen clic en el icono de llamada en el chat que ya utilizan, y la llamada llega a tu bandeja de entrada del equipo de Wati junto a los mensajes. Extrae registros de llamadas, grabaciones, transcripciones y resúmenes en tus propios sistemas mediante API.

  • PróximamenteRegistros de llamadas, grabaciones, transcripciones, resúmenes y el webhook call.status

Última actualización

Estado actual de las llamadas de WhatsApp

FuncionalidadCómo se usaEstado
Registros de llamadas, grabaciones, transcripciones y resúmenesAPI RESTPróximamente

Cuéntanos sobre tu caso de uso.

  • 16.000+empresas en más de 190 países
  • 4,6/5valoración media en G2
  • OficialMeta Business Partner y WhatsApp BSP
G2 Leader, ChatbotsG2 Leader Mid-Market, ChatbotsG2 Momentum Leader, ChatbotsG2 Most Implementable, WhatsApp MarketingISO 27001GDPR

Un solo hilo. Chat, llamada y transcripción.

Cada llamada se sitúa junto a los mensajes circundantes, con su grabación, transcripción y resumen.

  • Empieza con una plantillaUna plantilla aprobada inicia 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. La bandeja de entrada del equipo informa a tu personal.
El producto

Envía. Responde. Escucha. Transfiere.

Difusiones

Mensajes personales, enviados a escala.

Elige una plantilla aprobada y envíala a un máximo de 10.000 destinatarios. Cada persona recibe sus propias variables y cada resultado se devuelve por número.

Mensajería

Responde con algo más que texto.

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

Actualizaciones de pedidos y alertas

La actualización correcta, en el momento en que ocurre.

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 lleva cada mensaje nuevo 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 momento exacto 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 a un operador, establece el estado y añade etiquetas mediante 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 un mensaje.

InstagramComentarios y mensajes directos de Instagram

Crea también automatización para Instagram.

Enumera los comentarios en tus publicaciones, responde públicamente 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. Mantenlo en tu servidor.

  3. Enviar

    Haz tu primera llamada

    Envía una plantilla aprobada con una sola solicitud. Luego, añade un webhook para supervisar 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 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 en cada solicitud. Guárdalo en tu servidor.

    Authorization: Bearer <token>
  5. Lo que recibes

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

Código listo para copiarOcultar el código
POST/api/ext/v3/messageTemplates/send
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/messageTemplates/send" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "template_name": "order_update",
    "broadcast_name": "order_update_api",
    "recipients": [
      {
        "phone_number": "14155552671",
        "custom_params": [
          { "name": "name", "value": "Maya" },
          { "name": "order_id", "value": "10482" }
        ]
      }
    ]
  }'
200 Respuesta de ejemploEstructura del ejemplo de la documentación
{
  "success": true,
  "broadcast_id": "broadcast_123456",
  "recipients": [
    {
      "local_message_id": "local-msg-123",
      "phone_number": "14155552671",
      "errors": []
    }
  ]
}
Integrado

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

Incorporación de números

Conéctate a través del Registro Integrado de Meta. La cuenta de WhatsApp Business se registra en 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 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 compartida para el equipo para aquellas conversaciones que tu código no deba responder en solitario.

Tokens de API con ámbito

La versión v3 admite tokens con ámbito para que cada integración obtenga únicamente el acceso que necesita.

Envios programados

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

Estimación de costes previa

Calcula el coste de 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

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

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

Gestiona 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, segmenta tus públicos.

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

Bandeja de entrada del equipo

Asigna un operador, cambia el estado, y 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 MCP de Wati 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. Públicos.

30 a 100 por cada 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 la versión v3

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

24 h de ventana

Respuestas libres

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 la versión 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 los planes Pro o Business. Actualizar los atributos de muchos contactos a la vez requiere el plan 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

¿Qué es la API de WhatsApp Calling?

Es la extensión de voz oficial de Meta para la plataforma de WhatsApp Business. Las empresas pueden realizar y recibir llamadas de voz dentro del mismo hilo de WhatsApp que los clientes usan para enviar mensajes. Wati es un proveedor oficial de soluciones empresariales (BSP), y las llamadas aparecen en la bandeja de entrada del equipo de Wati junto con el historial de chat.

¿Qué cubre la API de Wati Calling?

Registros de llamadas con GET /calls, y la grabación, transcripción y resumen de cada llamada, ya sea una por una o por lotes. El webhook call.status le indica a su sistema cuándo cambia el estado de una llamada.

¿Puede mi empresa llamar a los clientes en WhatsApp?

Sí, con su permiso. Los clientes pueden llamarle desde el chat. Para las llamadas iniciadas por la empresa, Meta exige que el cliente acepte primero una solicitud de permiso de llamada: una solicitud por cliente cada 24 horas, hasta dos en 7 días, y la llamada debe realizarse dentro de las 72 horas posteriores a la aprobación.

¿Necesito saber programar?

Menos que antes. Los creadores de aplicaciones con 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.

Aún necesita 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úrese de que su token permanezca en el servidor.

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

Las llamadas de contactos y del 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 los planes Growth, Pro y Business. Cuando alcanza un límite, recibe un código HTTP 429 con un encabezado Retry-After. Para límites más altos, póngase en contacto con Wati.

¿Puedo enviar un mensaje a un cliente en cualquier momento?

En WhatsApp, los mensajes de texto libres, multimedia e interactivos requieren una ventana de atención al cliente abierta de 24 horas. Fuera de esa ventana, inicie la conversación con una plantilla que Meta haya aprobado.

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

La aplicación Business es para chats manuales en un teléfono, con hasta 5 dispositivos vinculados y listas de difusión limitadas a 256 contactos. La API conecta WhatsApp con sus propios sistemas. Puede enviar plantillas aprobadas a escala, automatizar respuestas, recibir webhooks y compartir un número en una bandeja de entrada para equipos.

¿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 del chat, los chatbots y los segmentos personalizados requieren los planes Pro o Business. La documentación detalla la disponibilidad de los endpoints según el plan.

Su primer mensaje está a una solicitud de distancia.

Conecte su número de WhatsApp en Wati y realice su primera llamada. Hable con nosotros si desea integrar los datos de llamadas en sus propios sistemas.