curl --request POST \
--url https://api.omni.z-api.io/channels/{channel_id}/token/{channel_token}/send-button-list \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511999999999",
"message": "¿Cómo valoras nuestra atención?",
"buttonList": {
"buttons": [
{
"id": "1",
"label": "Ótimo"
},
{
"id": "2",
"label": "Bom"
},
{
"id": "3",
"label": "Regular"
}
]
}
}
'{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Mensajes
Enviar lista de botones
Envía mensajes con botones de selección rápida
POST
/
send-button-list
curl --request POST \
--url https://api.omni.z-api.io/channels/{channel_id}/token/{channel_token}/send-button-list \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511999999999",
"message": "¿Cómo valoras nuestra atención?",
"buttonList": {
"buttons": [
{
"id": "1",
"label": "Ótimo"
},
{
"id": "2",
"label": "Bom"
},
{
"id": "3",
"label": "Regular"
}
]
}
}
'{
"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 selección rápida. El destinatario puede elegir entre las opciones que se le presentan, que funcionan como respuesta al mensaje. Opcionalmente puedes incluir una imagen o un vídeo junto a los botones añadiendo el campoimage o video dentro de buttonList.
Envía solo
image o video, nunca los dos a la vez.Autorizaciones
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 (obligatorio, no puede estar vacío)
Configuración de los botones
Show child attributes
Show child attributes
Retardo en segundos antes del envío (1-15)
Rango requerido:
1 <= x <= 15