Skip to main content

Conceptos

Los endpoints de mensajes de esta sección permiten enviar mensajes solo cuando la ventana de conversación de WhatsApp está abierta (dentro del periodo de 24 horas). Es una regla de la API oficial de WhatsApp Business.
La ventana de conversación de 24 horas se abre cuando el cliente te envía un mensaje. Fuera de esa ventana solo es posible enviar mensajes mediante plantillas aprobadas por Meta. Los mensajes de esta sección no funcionan fuera de la ventana de conversación.

Dentro de la ventana (24 h)

¿El cliente te ha enviado un mensaje? Perfecto: la ventana está abierta. Puedes usar cualquier endpoint de esta sección para responder con texto, imagen, audio, vídeo, documento, etc.

Fuera de la ventana (después de 24 h)

Si el cliente no te ha escrito en las últimas 24 horas, la única forma de iniciar una conversación es enviar una plantilla de mensaje aprobada previamente por Meta. Las plantillas son mensajes predefinidos que creas y envías a aprobación en el panel de Meta.
En Z-API (conexión no oficial) esta limitación no existía: podías enviar mensajes en cualquier momento. En la API oficial esta regla es obligatoria y no se puede eludir.

Para enviar un mensaje necesitas el número de teléfono del contacto destinatario, incluido el código de país.

Respuesta de la API

Al enviar un mensaje, la API devuelve la misma estructura de respuesta que ya conoces de Z-API. Es decir, no hace falta ninguna adaptación en el código que procesa las respuestas: los campos, los tipos y los formatos son idénticos. Ejemplo de respuesta al enviar un mensaje:
Mantenemos la compatibilidad total con la estructura de respuesta de Z-API. Si tu aplicación ya trata esos campos, seguirá funcionando sin cambios.

Guarda el messageId

Es muy importante que guardes el messageId que se devuelve, porque lo necesitas para operaciones posteriores como responder, marcar como leído o eliminar mensajes.
Sin el messageId no podrás referenciar el mensaje más adelante para responder, reaccionar o eliminarlo.

Formato del texto

Puedes dar formato al texto de los mensajes usando los caracteres especiales de WhatsApp: