Enviar mensagens interativas no WhatsApp

Aprenda a enviar mensagens com botões e mensagens de lista para criar experiências de conversação envolventes no WhatsApp.

Melhor para: Sim/Não, Confirmar/Cancelar

Melhor para: Menus, catálogos, múltipla escolha

Cabeçalho (opcional): Texto ou imagem de cabeçalho

Rodapé (opcional): Texto pequeno abaixo do corpo

Botões/Itens da Lista: Configure seus elementos interativos

Os títulos dos botões têm 20 caracteres ou menos

  1. Conhecer os tipos de mensagens interativas
  2. Criar uma mensagem com botões de resposta
  3. Criar uma mensagem de lista
  4. Gerir as respostas através de webhooks
  5. Testar as mensagens interativas

FAQ

Por que minha mensagem interativa não é enviada?

Mensagens interativas só saem dentro da janela de sessão de 24 horas do WhatsApp, que começa quando o cliente lhe envia uma mensagem. Depois que ela fecha, a API retorna um erro 422 e você precisa de um modelo de mensagem aprovado para falar com o contato novamente.

Quantos botões cabem em uma mensagem e qual o tamanho máximo do título?

Até 3 botões de resposta por mensagem, com no máximo 20 caracteres por título de botão. Se um botão não aparece, normalmente o título está longo demais ou dois botões compartilham o mesmo ID.

Posso enviar botões e listas em canais além do WhatsApp?

Os botões também funcionam no Messenger, Instagram, Telegram e Live Chat. As mensagens de lista são suportadas apenas no WhatsApp e no Live Chat. SMS e e-mail não suportam nenhum dos dois. O endpoint Channel Capabilities mostra o que um canal específico aceita antes do envio.

As mensagens interativas precisam de aprovação da Meta?

Não. Dentro da janela de sessão de 24 horas, os botões e as listas saem como mensagens comuns, então nada é enviado para revisão. Só os modelos de mensagem, necessários depois que a janela fecha, passam pela aprovação da Meta.

As mensagens interativas funcionam em um número conectado via WhatsApp Coexistence?

Sim. Você envia botões e listas pelo SendSeven enquanto sua equipe continua respondendo pelo aplicativo WhatsApp Business no celular, porque o Coexistence mantém o aplicativo e a API em paralelo no mesmo número.

Como sei qual botão ou item de lista o cliente escolheu?

O evento webhook traz o ID que você definiu ao criar a mensagem: button_reply.id para um botão e list_reply.id para um item de lista. Use esse ID para seguir para a ação certa.

Um Flow pode enviar mensagens interativas automaticamente?

Sim. Um Flow envia sozinho botões e listas do WhatsApp, com cabeçalho opcional de texto, imagem ou vídeo e um rodapé. Assim um bot apresenta opções sem que um agente precise intervir.