curl -X POST https://chatbot.menuia.com/api/create-message \
-H "Content-Type: application/json" \
-d '{
"appkey": "SUA_APPKEY_AQUI",
"authkey": "SUA_AUTHKEY_AQUI",
"to": "5511999999999",
"message": "Confira nossas ofertas exclusivas:",
"footer_text": "Promoções válidas por tempo limitado",
"cards": [
{
"image_url": "https://exemplo.com/produto1.jpg",
"title": "Smartphone Premium",
"subtitle": "Modelo 2026",
"description": "Tela OLED, câmera de 200MP e bateria de longa duração.",
"buttons": [
{"type": "quickReplyButton", "displaytext": "Tenho interesse", "id": "opt-1"},
{"type": "urlButton", "displaytext": "Abrir", "action": "https://exemplo.com/produto1"},
{"type": "callButton", "displaytext": "Ligar", "action": "+5511999999999"}
]
},
{
"image_url": "https://exemplo.com/produto2.jpg",
"title": "Notebook Pro",
"subtitle": "Edição Especial",
"description": "Processador de última geração, ideal para trabalho e jogos.",
"buttons": [
{"type": "quickReplyButton", "displaytext": "Quero saber mais", "id": "opt-2"},
{"type": "urlButton", "displaytext": "Ver detalhes", "action": "https://exemplo.com/produto2"}
]
}
]
}'
const response = await fetch('https://chatbot.menuia.com/api/create-message', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
appkey: 'SUA_APPKEY_AQUI',
authkey: 'SUA_AUTHKEY_AQUI',
to: '5511999999999',
message: 'Confira nossas ofertas exclusivas:',
footer_text: 'Promoções válidas por tempo limitado',
cards: [
{
image_url: 'https://exemplo.com/produto1.jpg',
title: 'Smartphone Premium',
subtitle: 'Modelo 2026',
description: 'Tela OLED, câmera de 200MP e bateria de longa duração.',
buttons: [
{ type: 'quickReplyButton', displaytext: 'Tenho interesse', id: 'opt-1' },
{ type: 'urlButton', displaytext: 'Abrir', action: 'https://exemplo.com/produto1' },
{ type: 'callButton', displaytext: 'Ligar', action: '+5511999999999' }
]
},
{
image_url: 'https://exemplo.com/produto2.jpg',
title: 'Notebook Pro',
subtitle: 'Edição Especial',
description: 'Processador de última geração, ideal para trabalho e jogos.',
buttons: [
{ type: 'quickReplyButton', displaytext: 'Quero saber mais', id: 'opt-2' },
{ type: 'urlButton', displaytext: 'Ver detalhes', action: 'https://exemplo.com/produto2' }
]
}
]
})
});
import requests
response = requests.post(
'https://chatbot.menuia.com/api/create-message',
json={
'appkey': 'SUA_APPKEY_AQUI',
'authkey': 'SUA_AUTHKEY_AQUI',
'to': '5511999999999',
'message': 'Confira nossas ofertas exclusivas:',
'footer_text': 'Promoções válidas por tempo limitado',
'cards': [
{
'image_url': 'https://exemplo.com/produto1.jpg',
'title': 'Smartphone Premium',
'subtitle': 'Modelo 2026',
'description': 'Tela OLED, câmera de 200MP e bateria de longa duração.',
'buttons': [
{'type': 'quickReplyButton', 'displaytext': 'Tenho interesse', 'id': 'opt-1'},
{'type': 'urlButton', 'displaytext': 'Abrir', 'action': 'https://exemplo.com/produto1'},
{'type': 'callButton', 'displaytext': 'Ligar', 'action': '+5511999999999'}
]
},
{
'image_url': 'https://exemplo.com/produto2.jpg',
'title': 'Notebook Pro',
'subtitle': 'Edição Especial',
'description': 'Processador de última geração, ideal para trabalho e jogos.',
'buttons': [
{'type': 'quickReplyButton', 'displaytext': 'Quero saber mais', 'id': 'opt-2'},
{'type': 'urlButton', 'displaytext': 'Ver detalhes', 'action': 'https://exemplo.com/produto2'}
]
}
]
}
)
$response = Http::post('https://chatbot.menuia.com/api/create-message', [
'appkey' => 'SUA_APPKEY_AQUI',
'authkey' => 'SUA_AUTHKEY_AQUI',
'to' => '5511999999999',
'message' => 'Confira nossas ofertas exclusivas:',
'footer_text' => 'Promoções válidas por tempo limitado',
'cards' => [
[
'image_url' => 'https://exemplo.com/produto1.jpg',
'title' => 'Smartphone Premium',
'subtitle' => 'Modelo 2026',
'description' => 'Tela OLED, câmera de 200MP e bateria de longa duração.',
'buttons' => [
['type' => 'quickReplyButton', 'displaytext' => 'Tenho interesse', 'id' => 'opt-1'],
['type' => 'urlButton', 'displaytext' => 'Abrir', 'action' => 'https://exemplo.com/produto1'],
['type' => 'callButton', 'displaytext' => 'Ligar', 'action' => '+5511999999999']
]
],
[
'image_url' => 'https://exemplo.com/produto2.jpg',
'title' => 'Notebook Pro',
'subtitle' => 'Edição Especial',
'description' => 'Processador de última geração, ideal para trabalho e jogos.',
'buttons' => [
['type' => 'quickReplyButton', 'displaytext' => 'Quero saber mais', 'id' => 'opt-2'],
['type' => 'urlButton', 'displaytext' => 'Ver detalhes', 'action' => 'https://exemplo.com/produto2']
]
]
]
]);
{
"status": 200,
"message": "Carrossel enviado com sucesso."
}
{
"status": 401,
"message": "validation.required"
}
{
"status": 404,
"message": "Nenhum dispositivo encontrado."
}
Mensagens Interativas
Enviar Carrossel
POST
/
api
/
create-message
curl -X POST https://chatbot.menuia.com/api/create-message \
-H "Content-Type: application/json" \
-d '{
"appkey": "SUA_APPKEY_AQUI",
"authkey": "SUA_AUTHKEY_AQUI",
"to": "5511999999999",
"message": "Confira nossas ofertas exclusivas:",
"footer_text": "Promoções válidas por tempo limitado",
"cards": [
{
"image_url": "https://exemplo.com/produto1.jpg",
"title": "Smartphone Premium",
"subtitle": "Modelo 2026",
"description": "Tela OLED, câmera de 200MP e bateria de longa duração.",
"buttons": [
{"type": "quickReplyButton", "displaytext": "Tenho interesse", "id": "opt-1"},
{"type": "urlButton", "displaytext": "Abrir", "action": "https://exemplo.com/produto1"},
{"type": "callButton", "displaytext": "Ligar", "action": "+5511999999999"}
]
},
{
"image_url": "https://exemplo.com/produto2.jpg",
"title": "Notebook Pro",
"subtitle": "Edição Especial",
"description": "Processador de última geração, ideal para trabalho e jogos.",
"buttons": [
{"type": "quickReplyButton", "displaytext": "Quero saber mais", "id": "opt-2"},
{"type": "urlButton", "displaytext": "Ver detalhes", "action": "https://exemplo.com/produto2"}
]
}
]
}'
const response = await fetch('https://chatbot.menuia.com/api/create-message', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
appkey: 'SUA_APPKEY_AQUI',
authkey: 'SUA_AUTHKEY_AQUI',
to: '5511999999999',
message: 'Confira nossas ofertas exclusivas:',
footer_text: 'Promoções válidas por tempo limitado',
cards: [
{
image_url: 'https://exemplo.com/produto1.jpg',
title: 'Smartphone Premium',
subtitle: 'Modelo 2026',
description: 'Tela OLED, câmera de 200MP e bateria de longa duração.',
buttons: [
{ type: 'quickReplyButton', displaytext: 'Tenho interesse', id: 'opt-1' },
{ type: 'urlButton', displaytext: 'Abrir', action: 'https://exemplo.com/produto1' },
{ type: 'callButton', displaytext: 'Ligar', action: '+5511999999999' }
]
},
{
image_url: 'https://exemplo.com/produto2.jpg',
title: 'Notebook Pro',
subtitle: 'Edição Especial',
description: 'Processador de última geração, ideal para trabalho e jogos.',
buttons: [
{ type: 'quickReplyButton', displaytext: 'Quero saber mais', id: 'opt-2' },
{ type: 'urlButton', displaytext: 'Ver detalhes', action: 'https://exemplo.com/produto2' }
]
}
]
})
});
import requests
response = requests.post(
'https://chatbot.menuia.com/api/create-message',
json={
'appkey': 'SUA_APPKEY_AQUI',
'authkey': 'SUA_AUTHKEY_AQUI',
'to': '5511999999999',
'message': 'Confira nossas ofertas exclusivas:',
'footer_text': 'Promoções válidas por tempo limitado',
'cards': [
{
'image_url': 'https://exemplo.com/produto1.jpg',
'title': 'Smartphone Premium',
'subtitle': 'Modelo 2026',
'description': 'Tela OLED, câmera de 200MP e bateria de longa duração.',
'buttons': [
{'type': 'quickReplyButton', 'displaytext': 'Tenho interesse', 'id': 'opt-1'},
{'type': 'urlButton', 'displaytext': 'Abrir', 'action': 'https://exemplo.com/produto1'},
{'type': 'callButton', 'displaytext': 'Ligar', 'action': '+5511999999999'}
]
},
{
'image_url': 'https://exemplo.com/produto2.jpg',
'title': 'Notebook Pro',
'subtitle': 'Edição Especial',
'description': 'Processador de última geração, ideal para trabalho e jogos.',
'buttons': [
{'type': 'quickReplyButton', 'displaytext': 'Quero saber mais', 'id': 'opt-2'},
{'type': 'urlButton', 'displaytext': 'Ver detalhes', 'action': 'https://exemplo.com/produto2'}
]
}
]
}
)
$response = Http::post('https://chatbot.menuia.com/api/create-message', [
'appkey' => 'SUA_APPKEY_AQUI',
'authkey' => 'SUA_AUTHKEY_AQUI',
'to' => '5511999999999',
'message' => 'Confira nossas ofertas exclusivas:',
'footer_text' => 'Promoções válidas por tempo limitado',
'cards' => [
[
'image_url' => 'https://exemplo.com/produto1.jpg',
'title' => 'Smartphone Premium',
'subtitle' => 'Modelo 2026',
'description' => 'Tela OLED, câmera de 200MP e bateria de longa duração.',
'buttons' => [
['type' => 'quickReplyButton', 'displaytext' => 'Tenho interesse', 'id' => 'opt-1'],
['type' => 'urlButton', 'displaytext' => 'Abrir', 'action' => 'https://exemplo.com/produto1'],
['type' => 'callButton', 'displaytext' => 'Ligar', 'action' => '+5511999999999']
]
],
[
'image_url' => 'https://exemplo.com/produto2.jpg',
'title' => 'Notebook Pro',
'subtitle' => 'Edição Especial',
'description' => 'Processador de última geração, ideal para trabalho e jogos.',
'buttons' => [
['type' => 'quickReplyButton', 'displaytext' => 'Quero saber mais', 'id' => 'opt-2'],
['type' => 'urlButton', 'displaytext' => 'Ver detalhes', 'action' => 'https://exemplo.com/produto2']
]
]
]
]);
{
"status": 200,
"message": "Carrossel enviado com sucesso."
}
{
"status": 401,
"message": "validation.required"
}
{
"status": 404,
"message": "Nenhum dispositivo encontrado."
}
Webhook relacionado: Botão / Lista
O clique nos botões do card dispara o evento Botão / Lista no seu webhook.
Descrição
Este endpoint permite enviar uma mensagem em formato de carrossel com múltiplos cards. Cada card pode conter imagem, título, subtítulo, descrição e botões interativos (resposta rápida, link URL ou chamada telefônica).Parâmetros
string
required
Chave de aplicação.
string
required
Chave de autenticação do usuário.
string
required
Número de telefone no formato internacional ou ID do grupo.
string
required
Texto do topo do carrossel, exibido antes dos cards.
string
Texto do rodapé exibido abaixo do carrossel.
array
required
Array de cards que compõem o carrossel. Cada card possui:
image_url: URL da imagem do cardtitle: Título do cardsubtitle: Subtítulo do carddescription: Descrição ou legenda do cardbuttons: Array de botões do card (ver tipos abaixo)
Tipos de Botões
quickReplyButton: Botão de resposta rápida. Quando clicado, envia o texto do botão como resposta. Requer
displaytext e id.urlButton: Botão que abre um link externo. Requer displaytext e action com a URL.callButton: Botão que inicia uma chamada telefônica. Requer displaytext e action com o número de telefone.curl -X POST https://chatbot.menuia.com/api/create-message \
-H "Content-Type: application/json" \
-d '{
"appkey": "SUA_APPKEY_AQUI",
"authkey": "SUA_AUTHKEY_AQUI",
"to": "5511999999999",
"message": "Confira nossas ofertas exclusivas:",
"footer_text": "Promoções válidas por tempo limitado",
"cards": [
{
"image_url": "https://exemplo.com/produto1.jpg",
"title": "Smartphone Premium",
"subtitle": "Modelo 2026",
"description": "Tela OLED, câmera de 200MP e bateria de longa duração.",
"buttons": [
{"type": "quickReplyButton", "displaytext": "Tenho interesse", "id": "opt-1"},
{"type": "urlButton", "displaytext": "Abrir", "action": "https://exemplo.com/produto1"},
{"type": "callButton", "displaytext": "Ligar", "action": "+5511999999999"}
]
},
{
"image_url": "https://exemplo.com/produto2.jpg",
"title": "Notebook Pro",
"subtitle": "Edição Especial",
"description": "Processador de última geração, ideal para trabalho e jogos.",
"buttons": [
{"type": "quickReplyButton", "displaytext": "Quero saber mais", "id": "opt-2"},
{"type": "urlButton", "displaytext": "Ver detalhes", "action": "https://exemplo.com/produto2"}
]
}
]
}'
const response = await fetch('https://chatbot.menuia.com/api/create-message', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
appkey: 'SUA_APPKEY_AQUI',
authkey: 'SUA_AUTHKEY_AQUI',
to: '5511999999999',
message: 'Confira nossas ofertas exclusivas:',
footer_text: 'Promoções válidas por tempo limitado',
cards: [
{
image_url: 'https://exemplo.com/produto1.jpg',
title: 'Smartphone Premium',
subtitle: 'Modelo 2026',
description: 'Tela OLED, câmera de 200MP e bateria de longa duração.',
buttons: [
{ type: 'quickReplyButton', displaytext: 'Tenho interesse', id: 'opt-1' },
{ type: 'urlButton', displaytext: 'Abrir', action: 'https://exemplo.com/produto1' },
{ type: 'callButton', displaytext: 'Ligar', action: '+5511999999999' }
]
},
{
image_url: 'https://exemplo.com/produto2.jpg',
title: 'Notebook Pro',
subtitle: 'Edição Especial',
description: 'Processador de última geração, ideal para trabalho e jogos.',
buttons: [
{ type: 'quickReplyButton', displaytext: 'Quero saber mais', id: 'opt-2' },
{ type: 'urlButton', displaytext: 'Ver detalhes', action: 'https://exemplo.com/produto2' }
]
}
]
})
});
import requests
response = requests.post(
'https://chatbot.menuia.com/api/create-message',
json={
'appkey': 'SUA_APPKEY_AQUI',
'authkey': 'SUA_AUTHKEY_AQUI',
'to': '5511999999999',
'message': 'Confira nossas ofertas exclusivas:',
'footer_text': 'Promoções válidas por tempo limitado',
'cards': [
{
'image_url': 'https://exemplo.com/produto1.jpg',
'title': 'Smartphone Premium',
'subtitle': 'Modelo 2026',
'description': 'Tela OLED, câmera de 200MP e bateria de longa duração.',
'buttons': [
{'type': 'quickReplyButton', 'displaytext': 'Tenho interesse', 'id': 'opt-1'},
{'type': 'urlButton', 'displaytext': 'Abrir', 'action': 'https://exemplo.com/produto1'},
{'type': 'callButton', 'displaytext': 'Ligar', 'action': '+5511999999999'}
]
},
{
'image_url': 'https://exemplo.com/produto2.jpg',
'title': 'Notebook Pro',
'subtitle': 'Edição Especial',
'description': 'Processador de última geração, ideal para trabalho e jogos.',
'buttons': [
{'type': 'quickReplyButton', 'displaytext': 'Quero saber mais', 'id': 'opt-2'},
{'type': 'urlButton', 'displaytext': 'Ver detalhes', 'action': 'https://exemplo.com/produto2'}
]
}
]
}
)
$response = Http::post('https://chatbot.menuia.com/api/create-message', [
'appkey' => 'SUA_APPKEY_AQUI',
'authkey' => 'SUA_AUTHKEY_AQUI',
'to' => '5511999999999',
'message' => 'Confira nossas ofertas exclusivas:',
'footer_text' => 'Promoções válidas por tempo limitado',
'cards' => [
[
'image_url' => 'https://exemplo.com/produto1.jpg',
'title' => 'Smartphone Premium',
'subtitle' => 'Modelo 2026',
'description' => 'Tela OLED, câmera de 200MP e bateria de longa duração.',
'buttons' => [
['type' => 'quickReplyButton', 'displaytext' => 'Tenho interesse', 'id' => 'opt-1'],
['type' => 'urlButton', 'displaytext' => 'Abrir', 'action' => 'https://exemplo.com/produto1'],
['type' => 'callButton', 'displaytext' => 'Ligar', 'action' => '+5511999999999']
]
],
[
'image_url' => 'https://exemplo.com/produto2.jpg',
'title' => 'Notebook Pro',
'subtitle' => 'Edição Especial',
'description' => 'Processador de última geração, ideal para trabalho e jogos.',
'buttons' => [
['type' => 'quickReplyButton', 'displaytext' => 'Quero saber mais', 'id' => 'opt-2'],
['type' => 'urlButton', 'displaytext' => 'Ver detalhes', 'action' => 'https://exemplo.com/produto2']
]
]
]
]);
{
"status": 200,
"message": "Carrossel enviado com sucesso."
}
{
"status": 401,
"message": "validation.required"
}
{
"status": 404,
"message": "Nenhum dispositivo encontrado."
}
⌘I

