Mensajes personales, enviados a escala.
Elige una plantilla aprobada y envíala a hasta 10 000 destinatarios. Cada persona recibe sus propias variables y cada resultado regresa por número.
API de Grupos de WhatsApp
Crea un grupo de WhatsApp para una cohorte de curso, un club VIP o un caso de soporte, y envíale actualizaciones desde tu propio sistema.
Parte de la API de desarrollador de WhatsApp.
Última actualización el
| Funcionalidad | Cómo se usa | Estado |
|---|---|---|
| Crear un grupo y enviarle actualizaciones desde tu sistema | API REST | Próximamente |
Aún no hay endpoints de grupos en la API de Wati. Cuéntanos sobre tu caso de uso.
Cohortes, clubes y casos de soporte en un solo grupo de WhatsApp, mantenido al día por tu sistema.
Elige una plantilla aprobada y envíala a hasta 10 000 destinatarios. Cada persona recibe sus propias variables y cada resultado regresa por número.
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.
Tu tienda, sistema de reservas o facturación envía una plantilla aprobada cuando algo cambia. Los clientes presionan un botón o responden.
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.
Los webhooks envían nuevos mensajes, confirmaciones de lectura, clics y errores a tu URL. Sin sondeos.
Las respuestas llegan a la bandeja de entrada del equipo en Wati. Asigna un operador, establece estados y añade etiquetas mediante la API para que la persona correcta lo atienda.
Crea y actualiza contactos con atributos personalizados, y luego obtén una vista previa de un segmento antes de enviarle un mensaje.
Enumera comentarios en tus publicaciones, responde públicamente o envía una respuesta privada.
Vincula tu número de WhatsApp mediante el Registro integrado de Meta dentro de Wati.
Crea un token de API en Wati y asígnale únicamente los permisos que necesites. Guárdalo en tu servidor.
Envía una plantilla aprobada con una sola solicitud. Luego, añade un webhook para supervisar la entrega.
Esto es lo que incluye una solicitud y dónde aparece cada parte en el mensaje.
El número de WhatsApp del cliente, con código de país.
phone_number14155552671El nombre de una plantilla que Meta haya aprobado en tu cuenta.
template_nameorder_updateLos valores para los espacios en blanco de la plantilla, uno por persona.
custom_paramsname = Mayaorder_id = 10482Tu token de API, enviado con cada solicitud. Guárdalo en tu servidor.
Authorization: Bearer <token>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_idEl texto del mensaje y order_update son ejemplos. Tu plantilla aprobada define la redacción exacta.
El comentario que estás respondiendo. Obtienes su ID al listar los comentarios de una publicación.
comment_iden la ruta de la URLTu cuenta de Instagram conectada a Wati.
channelLa persona que escribió el comentario, obtenida del mismo comentario.
userIduserNameTexto plano de hasta 1000 caracteres o una plantilla con botones.
type = texttexttype = templateUn 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: successPOST /api/ext/v3/comments/{comment_id}/privateReply. El comentario y el texto de la respuesta son ejemplos. Consulta la solicitud en la documentación
Conéctate a través del registro integrado de Meta. La cuenta de WhatsApp Business se registra para tu empresa.
Los cambios de aprobación, calidad y categoría llegan como webhooks, para que lo sepas antes de que un envío falle.
Hasta 144 reintentos, cada 10 minutos. Si tu endpoint sigue fallando, Wati te envía un correo electrónico.
Si vas demasiado rápido, obtienes un error 429 con una cabecera Retry-After. Los mensajes aceptados esperan en una cola.
Una bandeja de entrada de equipo compartida para las conversaciones que tu código no deba responder a solas.
La versión v3 admite tokens con ámbito, por lo que cada integración obtiene únicamente el acceso que necesita.
Programa el envío de una plantilla para más tarde con una sola llamada. Wati la envía a tiempo.
Calcula cuánto costará una difusión antes de enviar nada.
Inicia conversaciones con plantillas aprobadas, ahora o de forma programada.
Documentación →GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/scheduleLee 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-costResponde 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/typingIndicatorEnumera tus chatbots de Wati e inicia uno para un contacto.
Documentación →GET/chatbotsPOST/chatbots/startGestiona las suscripciones y enumera los tipos de eventos que puedes recibir.
Documentación →GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}Sincroniza contactos y atributos desde tu CRM y, a continuación, segmenta tu público.
Documentación →POST/contactsPUT/contactsPOST/segments/evaluateAsigna un operador, cambia el estado y añade o elimina etiquetas.
Documentación →PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tagsEnumera 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}/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.
También hay disponibles versiones BSUID de varios eventos. Documentación de webhooks
Llamadas para enviar plantillas, según tu plan (Growth, Pro o Business).
Una plantilla, hasta 10 000 personas, cada una con sus propias variables.
El texto, los contenidos multimedia y los botones requieren una ventana de atención al cliente abierta. Fuera de ella, envía una plantilla.
Wati te indica cuánto tiempo debes esperar. Los mensajes aceptados se procesan en una cola.
| 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, enumerados por nombre de endpoint. La llamada masiva 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. Actualizar los atributos de muchos contactos a la vez requiere Business. Disponibilidad de endpoints por plan. Para límites superiores, consulta con Wati sobre tu caso de uso.
La referencia completa de la API es pública. Leer la documentación
Habla con nosotros sobre el acceso. Comparte tu caso de uso, como cohortes de cursos, clubes VIP o casos de soporte, y el equipo de Wati te guiará a través de las opciones para tu cuenta.
Los grupos son ideales para conversaciones con muchas personas sobre un tema en común: una cohorte de un curso que necesita cambios de horario, un club VIP que recibe acceso anticipado o un caso de soporte que reúne a tu equipo y al personal de un cliente. Tu sistema crea el grupo y publica actualizaciones en él.
La API de Broadcast. Envía una plantilla aprobada a un máximo de 10 000 personas por llamada, con resultados por destinatario. Cada persona recibe el mensaje en su propio chat, no en un grupo.
Menos que antes. Los creadores de aplicaciones con 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.
Aun así, necesitas un número de WhatsApp conectado a Wati, un token de API y una plantilla que Meta haya aprobado antes de poder iniciar una conversación. Si una herramienta de IA escribe el código, comprueba que tu token permanezca en el servidor.
Las llamadas de contacto 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, obtienes el código HTTP 429 con una cabecera Retry-After. Para límites más altos, ponte en contacto con Wati.
En WhatsApp, el texto de formato libre, los archivos multimedia y los mensajes interactivos requieren una ventana de servicio al cliente abierta de 24 horas. Fuera de esa ventana, inicia la conversación con una plantilla que Meta haya aprobado.
La aplicación Business es 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 a gran escala, automatizar respuestas, recibir webhooks y compartir un número en una bandeja de entrada de equipo.
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 documentación enumera la disponibilidad de endpoints por plan.
Obtén acceso, conecta tu número de WhatsApp en Wati y realiza tu primera llamada.