Maytapi/Documentação//interactive
/interactiveSem aprovação de templatesAPI de mensagens interativas do WhatsApp
Envie botões de resposta, botões de link e de ligação, menus de lista e carrosséis de produtos do seu próprio número de WhatsApp. Um único endpoint sendMessage, sem aprovação de templates — a escolha do cliente volta para o seu webhook.
- botões de resposta
- botões de link e ligação
- mensagens de lista
- carrosséis

Todos os formatos interativos em um endpoint
Escolha o campo type e o tipo de botão; o resto da requisição continua igual.
-
buttons · id
Botões de resposta
Respostas rápidas como Confirmar ou Cancelar. O id do botão volta para o seu código saber o que foi escolhido.
-
buttons · url
Botões de link
Abra uma página de rastreio, um link de pagamento ou seu site com um toque.
-
buttons · phoneNumber
Botões de ligação
O cliente liga para o seu suporte direto da mensagem.
-
buttons · code
Botões de copiar código
Compartilhe um cupom ou código de verificação que o cliente copia com um toque.
-
type: list
Mensagens de lista
Um botão de menu que abre seções e linhas — ideal para menus de suporte e horários de agendamento.
-
type: carousel
Carrosséis
Até 10 cartões deslizáveis, cada um com mídia e até 5 botões, para produtos e ofertas.
Botões com mídia, título e rodapé
Adicione uma imagem ou vídeo, um título, o corpo e um rodapé, e combine botões de resposta, link, ligação e copiar código na mesma mensagem.
- ✓Botões de resposta devolvem o id ao seu webhook
- ✓Botões de link e ligação não exigem configuração extra
- ✓Botões de copiar código para cupons e códigos únicos
Menus de lista para muitas opções
Quando três botões não bastam, envie uma lista. O cliente abre com o texto do seu botão e escolhe uma linha das suas seções.
- ✓Agrupe linhas em seções com título
- ✓Cada linha tem título, descrição e rowId
- ✓Ideal para menus de suporte, filiais e horários
Cartões de produto deslizáveis
Mostre vários produtos ou ofertas lado a lado. Cada cartão tem sua própria mídia, texto e botões.
- ✓Até 10 cartões por carrossel
- ✓Até 5 botões por cartão
- ✓Mídia obrigatória em cada cartão
Mesmo endpoint, type diferente
Botões, listas e carrosséis são enviados com POST /sendMessage. Só mudam o campo type e suas opções.
- ✓Funciona com cURL, Node.js, Python, PHP e qualquer cliente HTTP
- ✓Sem revisão de templates, envie na hora
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "55119xxxxxx67@c.us",
"type": "buttons",
"title": "Your order #10482",
"message": "Your order is ready to ship. Please confirm the delivery address.",
"footer": "Maytapi Store",
"media": "https://example.com/order.jpg",
"buttons": [
{
"id": "confirm",
"text": "Confirm"
},
{
"url": "https://example.com/track/10482",
"text": "Track order"
},
{
"phoneNumber": "55119xxxxxx67",
"text": "Call us"
}
]
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "55119xxxxxx67@c.us",
"type": "buttons",
"message": "Here is 10% off your next order.",
"buttons": [
{
"code": "WELCOME10",
"text": "Copy code"
}
]
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "55119xxxxxx67@c.us",
"type": "list",
"title": "How can we help?",
"message": "Choose a topic and we will connect you to the right team.",
"footer": "Support",
"button_text": "See options",
"sections": [
{
"title": "Support topics",
"rows": [
{
"rowId": "status",
"title": "Order status",
"description": "Track a recent order"
},
{
"rowId": "returns",
"title": "Returns",
"description": "Start a return or exchange"
}
]
}
]
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "55119xxxxxx67@c.us",
"type": "carousel",
"message": "New arrivals this week",
"cards": [
{
"title": "Classic sneaker",
"body": "Sizes 38–45",
"media": "https://example.com/sneaker.jpg",
"buttons": [
{
"id": "add_sneaker",
"text": "Add to cart"
},
{
"url": "https://example.com/sneaker",
"text": "Details"
}
]
},
{
"title": "Canvas backpack",
"body": "Free shipping",
"media": "https://example.com/backpack.jpg",
"buttons": [
{
"id": "add_backpack",
"text": "Add to cart"
},
{
"url": "https://example.com/backpack",
"text": "Details"
}
]
}
]
}'Onde as mensagens interativas funcionam melhor
-
Confirmação de pedidos
Confirme, altere ou cancele um pedido com um toque em vez de uma resposta digitada.
-
Lembretes de agendamento
Envie um lembrete com botões Confirmar e Remarcar e atualize sua agenda pelo webhook.
-
Menus de suporte
Encaminhe o cliente à equipe certa com uma mensagem de lista antes de um atendente entrar.
-
Vitrine de produtos
Apresente novidades em um carrossel com botões de adicionar ao carrinho e detalhes.
-
Cupons e códigos
Entregue códigos de desconto ou verificação com um botão de copiar código.
-
Fluxos de chatbot
Conduza as conversas do bot com botões para manter as respostas estruturadas.
Perguntas frequentes sobre mensagens interativas
Pergunte o que quiser ao nosso suporte pelo WhatsApp. O tempo médio de resposta é inferior a 24 horas.
Central de ajuda →Preciso de aprovação de templates para enviar botões?
Não. A Maytapi envia mensagens interativas do seu próprio número pelo WhatsApp Web, então não há revisão de templates da Meta. Você pode enviar na hora.
Quais tipos de botão são suportados?
Botões de resposta com id, de link com url, de ligação com phoneNumber e de copiar código com code. Título, rodapé e mídia são opcionais.
Quantos cartões um carrossel pode ter?
Até 10 cartões por carrossel. Cada cartão precisa de mídia e aceita até 5 botões.
Como sei qual botão o cliente tocou?
A escolha do cliente chega ao seu webhook como qualquer mensagem recebida, para que seu código reaja na hora.
Posso adicionar uma imagem a uma mensagem com botões?
Sim. Adicione uma URL em media e a imagem ou o vídeo aparece acima do corpo da mensagem.

Pegue sua chave e envie a primeira mensagem em dez minutos
Sem aprovação, sem templates, sem cartão. Todos os endpoints liberados por três dias.