Novo O Safe Mode aquece números novos para reduzir o risco de banimento no WhatsApp. Saiba mais →

Maytapi/Documentação//interactive

/interactiveSem aprovação de templates

API 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
Botões e listas interativos do WhatsApp
Tipos de mensagem

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

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
Uma mensagem do WhatsApp com foto, título, rodapé e quatro botões de resposta enviada pela API da Maytapi
Listas

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
Uma mensagem de lista do WhatsApp com o menu de opções aberto, enviada pela API da Maytapi
Carrosséis

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
Um carrossel do WhatsApp com cards de produtos deslizáveis e botões, enviado pela API da Maytapi
Requisiçã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"
      }
    ]
  }'
Casos de uso

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.

FAQ

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.

Comece a usar a API do WhatsApp

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.