¿Qué son los mensajes libres?
Los mensajes libres son mensajes que envías sin necesidad de una plantilla aprobada. Puedes enviar texto, imagen, audio, vídeo o documento —cualquier formato compatible— con total libertad de contenido. La única condición es que la ventana de conversación de 24 horas esté abierta.¿Cuándo puedo usarlos?
La ventana se abre cuando el cliente te envía un mensaje. A partir de ese momento tienes 24 horas para enviar mensajes libres. Cada mensaje nuevo del cliente reinicia el contador.¿Y si la ventana está cerrada?
Si el cliente no ha enviado ningún mensaje en las últimas 24 horas, la ventana está cerrada. En ese caso, la única opción es enviar una plantilla aprobada por Meta mediante el endpoint Enviar plantilla. Cuando el cliente responda a la plantilla, la ventana se reabre y vuelves a poder usar mensajes libres.¿Necesitas enviar una plantilla? Descubre cómo en la página Enviar plantilla. Para crear y gestionar tus plantillas, consulta la sección Plantillas.
Tipos disponibles
Todos los endpoints de esta sección utilizan la misma ruta:POST /v1/channels/{channelId}/messages
Lo que cambia es el campo content.type:
Respuesta de la API
Cuando se acepta el envío, la API responde200 con el identificador del mensaje:
messageId es una cadena hexadecimal de 32 caracteres en mayúsculas. Guarda este valor: lo necesitas para responder, reaccionar o eliminar el mensaje más adelante.
Este es el mismo valor que llega a tu webhook como
message._id. Úsalo para reconciliar la llamada de envío con el evento recibido — consulta la estructura de los payloads.Errores al enviar
Cuando la API rechaza el envío, el mensaje no se envía. La respuesta trae el estado HTTP del motivo y el código del error:Canal desconectado
Si el canal no está conectado en el momento de la llamada, la API responde422 con code BUSINESS_RULE_VIOLATION y subCode CHANNEL_DISCONNECTED, el cuerpo del ejemplo anterior. El mensaje no se envía y no queda guardado para salir después.
Para volver a enviar, conecta el canal de nuevo (consulta Conectar un canal) y repite la llamada.
Otros errores
Los rechazos hechos antes de que el mensaje pase al envío, como una Secret Key no válida o una suscripción inactiva, llegan en otro formato, solo con el campo
error.