curl --request POST \
--url https://api.omni.z-api.io/v1/channels/{channelId}/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"recipient": {
"identifier": "5511999999999"
},
"content": {
"type": "TEMPLATE",
"attachments": [
{
"template": {
"name": "boas_vindas_v2",
"language": {
"policy": "deterministic",
"code": "es_ES"
},
"components": [
{
"type": "body",
"parameters": []
}
]
}
}
]
}
}
'{
"messageId": "wamid.HBgNNTU0NDk3MDUwNzg1FQIAERgSM0"
}{
"error": 401,
"message": "Unauthorized"
}Plantillas (WhatsApp)
Enviar plantilla
Envía plantillas aprobadas por Meta
POST
/
v1
/
channels
/
{channelId}
/
messages
curl --request POST \
--url https://api.omni.z-api.io/v1/channels/{channelId}/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"recipient": {
"identifier": "5511999999999"
},
"content": {
"type": "TEMPLATE",
"attachments": [
{
"template": {
"name": "boas_vindas_v2",
"language": {
"policy": "deterministic",
"code": "es_ES"
},
"components": [
{
"type": "body",
"parameters": []
}
]
}
}
]
}
}
'{
"messageId": "wamid.HBgNNTU0NDk3MDUwNzg1FQIAERgSM0"
}{
"error": 401,
"message": "Unauthorized"
}Conceptos
Envía a un contacto una plantilla de mensaje aprobada por Meta. Es la única forma de enviar mensajes fuera de la ventana de conversación de 24 horas. El campocontent.type debe ser TEMPLATE y la plantilla se envía dentro de attachments.
Las plantillas son un recurso exclusivo de WhatsApp Oficial. No existen en los demás canales, y ahí no hacen falta porque no hay ninguna ventana que reabrir. Consulta la matriz de capacidades.
La plantilla debe tener el estado
APPROVED para poder usarse. Utiliza los endpoints de Plantillas para crear y gestionar tus plantillas.Autorizaciones
Secret Key generada en el panel de Seguridad de Omni Z-API
Parámetros de ruta
ID del canal
Ejemplo:
"SU_CHANNEL_ID"
Cuerpo
application/json
Respuesta
Mensaje enviado correctamente
ID del mensaje enviado