Difusiones
Mensajes personales, enviados a escala.
Elija una plantilla aprobada y envíela a un máximo de 10.000 destinatarios. Cada persona recibe sus propias variables y cada resultado regresa por número.
API de Difusión de WhatsAppEnvía una plantilla a hasta 10,000 clientes por llamada de API.
Una sola solicitud envía una plantilla aprobada a hasta 10,000 personas, cada una con sus propios detalles. Prográmala, calcula el costo primero y luego lee los resultados por destinatario.
¿Prefieres no usar código? Envía una difusión de WhatsApp desde Wati.
- 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
Una solicitud. Hasta 10,000 clientes.
Cada persona recibe su propio nombre, pedido o fecha. Cada resultado se devuelve por número.
- Comienza con una plantillaUna plantilla aprobada abre la conversación, para un cliente o hasta 10,000 por llamada.
- Continúa en el chat o en una llamadaTexto, multimedia y botones una vez que el cliente responde, o una llamada de voz en el mismo hilo.
- Termina con tu equipoLos webhooks informan a tu código. La bandeja de entrada del equipo informa a tu personal.
El producto
Enviar. Responder. Escuchar de vuelta. Transferir.
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 listas, 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 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 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 inicia. Las personas lo terminan.
Las respuestas llegan a la bandeja de entrada del equipo de Wati. Asigna un operador, establece estados 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 previsualiza un segmento antes de enviarle un mensaje.
InstagramComentarios de Instagram
Crea automatización para Instagram también.
Lista los comentarios en tus publicaciones, responde públicamente o envía una respuesta privada. Los mensajes directos de Instagram también funcionan: responde a conversaciones activas mediante REST o a través del servidor MCP de Wati.
Fragment 1 of 2. Translate only the text inside this item.
Empezar
Activo en tres pasos.
- Conectar
Conecta tu número
Vincula tu número de WhatsApp a través del Registro Integrado de Meta dentro de Wati.
- Autenticar
Obtén un token
Crea un token de API en Wati y asígnale únicamente los permisos que necesites. Mantenlo en tu servidor.
- 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.
- Quién
El número de WhatsApp del cliente, con código de país.
phone_number14155552671 - Qué mensaje
El nombre de una plantilla que Meta haya aprobado en tu cuenta.
template_nameorder_update - Qué rellenar
Los valores para los espacios en blanco de la plantilla, uno por persona.
custom_paramsname = Mayaorder_id = 10482 - Tu clave
Tu token de API, enviado con cada solicitud. Mantenlo en tu servidor.
Authorization: Bearer <token> - Qué recibes de vuelta
Un 200 significa que Wati aceptó el mensaje, junto con un broadcast_id. Los estados de entregado y leído llegan más tarde por webhook.
200broadcast_id
El texto del mensaje y order_update son ejemplos. Tu plantilla aprobada establece la redacción.
- Qué comentario
El comentario al que estás respondiendo. Obtienes su ID al listar los comentarios de una publicación.
comment_iden la ruta de la URL - Desde qué cuenta
Tu cuenta de Instagram conectada a Wati.
channel - A quién
La persona que escribió el comentario, obtenida del mismo comentario.
userIduserName - Qué enviar
Texto plano de hasta 1,000 caracteres, o una plantilla con botones.
type = texttexttype = template - Qué recibes de vuelta
Un 200 con ok establecido en true significa que la respuesta privada se envió correctamente. Utiliza la misma cabecera Authorization que en cualquier otra llamada.
ok: trueresult: success
POST /api/ext/v3/comments/{comment_id}/privateReply. El comentario y el texto de respuesta son ejemplos. Consulta la solicitud en la documentación
Fragmento 2 de 2. Traduce solo el texto dentro de este elemento.Ejemplos en cURL, Node, Python y PHP. La solicitud seleccionada coincide con esta página.
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" }
]
}
]
}'200Respuesta 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": []
}
]
}URL del servidor para la región de tu espacio de trabajo
Global
https://mcp.wati.io/mcpUE
https://eu-mcp.wati.io/mcpClientes con una configuración de mcpServers
{
"mcpServers": {
"wati": {
"url": "https://mcp.wati.io/mcp"
}
}
}Claude Code
claude mcp add --transport http wati https://mcp.wati.io/mcpInicia sesión con OAuth cuando tu cliente lo solicite. No se incluye ninguna clave de API en la configuración. Para espacios de trabajo en la UE, usa la URL de la UE. Documentación de MCP
Incluido
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 un encabezado Retry-After. Los mensajes aceptados esperan en una cola.
Intervención humana
Una bandeja de entrada de equipo compartida para las conversaciones que tu código no debería responder por sí solo.
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 el costo de una difusión antes de enviar nada.
Bajo el capó
Los endpoints, por capacidad.
Qué se incluye en una llamada de difusión
| Campo | Obligatorio | Notas |
|---|---|---|
template_name | Sí | Una plantilla aprobada en tu cuenta. Enuméralas con GET /messageTemplates. |
broadcast_name | Sí | Tu propia etiqueta para este envío |
recipients | Sí | De 1 a 10.000 personas, cada una con un phone_number |
custom_params | Por destinatario | Pares de nombre y valor para las variables de la plantilla |
local_message_id | No | Tu propio ID, devuelto en los resultados por destinatario |
channel | No | El número de envío, por nombre o número. Canal predeterminado si se omite. |
Del esquema del endpoint de envío v3. La respuesta incluye success, un broadcast_id y errors por destinatario.
Plantillas
Inicia conversaciones con plantillas aprobadas, ahora o programadas.
Documentación →GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/scheduleDifusiones
Lee los resultados de las campañas y el estado por destinatario, y calcula el costo primero.
Documentación →GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-costMensajería
Responde con texto, archivos multimedia o botones dentro de la ventana de 24 horas.
Documentación →POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicatorChatbots Pro+
Enumera tus chatbots de Wati e inicia uno para un contacto.
Documentación →GET/chatbotsPOST/chatbots/startWebhooks
Gestiona 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, luego segmenta el público objetivo.
Documentación →POST/contactsPUT/contactsPOST/segments/evaluateBandeja 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}/tagsLlamadas
Lee registros de llamadas, grabaciones, transcripciones y resúmenes. Solo lectura.
Documentación →GET/callsGET/calls/{call_id}/transcriptGET/calls/{call_id}/summaryEnumera publicaciones y comentarios, responde en público o en privado, comprueba permisos.
Documentación →GET/posts/{post_id}/commentsPOST/comments/{comment_id}/repliesPOST/comments/{comment_id}/privateReplyGET/channels/{channel}/permissionsLas 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 los 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 webhook 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
Solo eventos de WhatsApp: todavía no hay eventos de webhook de Instagram. 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 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 v3
Una plantilla, hasta 10.000 personas, cada una con sus propias variables.
24 h de ventana
Respuestas de formato libre
El texto, los archivos multimedia y los botones requieren una ventana de servicio 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
| Endpoint | Growth | Pro | Business |
|---|---|---|---|
/addContact, /getContacts | 10 / 10 s | 10 / 10 s | 10 / 10 s |
/getMessages | 10 / 10 s | 10 / 10 s | 10 / 10 s |
/sendTemplateMessage | 30 / 10 s | 60 / 10 s | 100 / 10 s |
/sendTemplateMessages | 30 / 10 s | 60 / 10 s | 100 / 10 s |
Límites publicados en Errores y límites de velocidad, ordenados por nombre de endpoint. La llamada masiva 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. Para límites más altos, consulta con Wati sobre tu caso de uso.
Preguntas frecuentes
Preguntas frecuentes
La referencia completa de la API es pública. Leer la documentación
¿A cuántas personas puedo contactar con una llamada de la API de difusión?
Hasta 10,000 destinatarios por llamada de envío v3. Envías una plantilla aprobada y cada destinatario puede tener sus propias variables, como un nombre o número de pedido. Los envíos de plantillas están limitados a 30, 60 o 100 llamadas cada 10 segundos, según tu plan. El límite de mensajería de Meta de tu número y la calidad de la plantilla siguen aplicándose, así que calienta un número nuevo antes de realizar envíos masivos.
¿Puedo programar una difusión y verificar el costo primero?
Sí. POST /messageTemplates/schedule se envía a la hora que elijas y POST /broadcasts/estimate-cost calcula el costo antes de enviar cualquier elemento.
¿Cómo puedo ver quién recibió y leyó una difusión?
Llama a GET /broadcasts para tus campañas y a GET /broadcasts/{broadcast_id}/recipients para conocer el estado por destinatario. Para obtener actualizaciones en tiempo real, suscríbete a webhooks como sentMessageDELIVERED_v2, sentMessageREAD_v2 y templateMessageFailed.
¿Cómo hago coincidir los resultados con mis propios registros?
Asigna a cada destinatario un local_message_id, como tu ID de pedido. Wati lo devuelve en los resultados por destinatario de la llamada de envío, junto con cualquier error para ese número.
¿Puedo elegir qué número de WhatsApp envía la difusión?
Sí. Pasa channel con el nombre o número del canal de envío. Déjalo en blanco para enviar desde tu canal predeterminado.
¿Necesito saber programar?
Menos que antes. Los creadores de aplicaciones de IA pueden redactar las llamadas a la API a partir de instrucciones en inglés sencillo, y los ejemplos de 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, asegúrate de que tu token permanezca en el servidor.
¿Cuáles son los límites de velocidad de la API?
Las llamadas de contactos y de historial de mensajes están limitadas a 10 solicitudes cada 10 segundos en todos los planes. Los envíos de plantillas están limitados a 30, 60 o 100 solicitudes cada 10 segundos en los planes Growth, Pro y Business. Cuando alcances un límite, recibirás un error HTTP 429 con un encabezado Retry-After. Para límites más altos, comunícate con Wati.
¿Puedo enviar un mensaje a un cliente en cualquier momento?
En WhatsApp, los mensajes de texto de formato libre, multimedia e interactivos requieren una ventana abierta de servicio al cliente de 24 horas. Fuera de esa ventana, inicia la conversación con una plantilla aprobada por Meta.
¿Cuál es la diferencia entre la aplicación WhatsApp Business y la API?
La aplicación Business está diseñada 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 tus propios sistemas. Puedes enviar plantillas aprobadas a escala, automatizar respuestas, recibir webhooks y compartir un número en una bandeja de entrada de equipo.
Tu primer mensaje está a una solicitud de distancia.
Obtén acceso, conecta tu número de WhatsApp en Wati y realiza tu primera llamada.