curl --request POST \
--url https://api.omni.z-api.io/channels/{channel_id}/token/{channel_token}/send-button-actions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511999999999",
"message": "¡Hola! ¿Cómo podemos ayudarte?",
"title": "Omni Z-API",
"footer": "Elige una opción",
"buttonActions": [
{
"id": "1",
"type": "CALL",
"phone": "5511999999999",
"label": "Fale conosco"
},
{
"id": "2",
"type": "URL",
"url": "https://www.omni.z-api.io",
"label": "Visita nuestro sitio web"
}
]
}
'{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Mensajes
Enviar botones de acción
Envía mensajes con botones de acción (llamar, URL, respuesta rápida)
POST
/
send-button-actions
curl --request POST \
--url https://api.omni.z-api.io/channels/{channel_id}/token/{channel_token}/send-button-actions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511999999999",
"message": "¡Hola! ¿Cómo podemos ayudarte?",
"title": "Omni Z-API",
"footer": "Elige una opción",
"buttonActions": [
{
"id": "1",
"type": "CALL",
"phone": "5511999999999",
"label": "Fale conosco"
},
{
"id": "2",
"type": "URL",
"url": "https://www.omni.z-api.io",
"label": "Visita nuestro sitio web"
}
]
}
'{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Conceptos
Método para enviar mensajes con botones de acción. Hay tres tipos de botón:- CALL — Botón para llamar a un número
- URL — Botón para abrir un enlace
- REPLY — Botón de respuesta rápida
No combines los tres tipos de botón en el mismo mensaje. Envía los botones de CALL + URL juntos y los de REPLY por separado. Combinarlos todos provoca un error en WhatsApp Web.
Para los botones de copiar código, usa el formato de URL:
https://www.whatsapp.com/otp/code/?otp_type=COPY_CODE&code=SU_CODIGOAutorizaciones
Secret Key generada en el panel de Seguridad de Omni Z-API
Cuerpo
application/json
Teléfono del destinatario (código de país + prefijo + número)
Ejemplo:
"5511999999999"
Texto del mensaje
Lista de botones de acción
Show child attributes
Show child attributes
Título del mensaje
Pie del mensaje
Retardo en segundos antes del envío (1-15)
Rango requerido:
1 <= x <= 15