Menu, cardápio e formulário no WhatsApp pela API não oficial

Menu de atendimento, cardápio, pesquisa de satisfação: tudo isso cabe dentro da conversa, sem mandar o cliente para um site. Este artigo mostra os formatos que a API não oficial da WAME envia e quando usar cada um. Para o resumo do produto, veja a página da API não oficial da WAME.

Todos os exemplos usam a base https://server.wame.api.br/SUA_KEY/.

Lista de opções: o menu de atendimento

A lista abre um menu com seções, ideal para "escolha o assunto":

curl -X POST "https://server.wame.api.br/SUA_KEY/message/list" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5566997145103",
    "title": "Menu principal",
    "text": "Como posso ajudar?",
    "buttonText": "Ver opções",
    "sections": [
      { "title": "Atendimento", "rows": [
        { "title": "Falar com atendente", "rowId": "suporte" },
        { "title": "Segunda via de boleto", "rowId": "financeiro" }
      ]},
      { "title": "Informações", "rows": [
        { "title": "Horário", "description": "Seg a Sex, 9h às 18h", "rowId": "horario" }
      ]}
    ]
  }'

A escolha do cliente chega pelo webhook com o rowId, e o seu bot decide o próximo passo.

Cardápio: lista com seções ou catálogo

Para um cardápio curto, a mesma lista funciona: uma seção para entradas, outra para pratos, outra para bebidas, com o preço na description de cada item.

Para cardápio com foto, use o catálogo do WhatsApp Business. Os produtos ficam cadastrados no catálogo (/business/catalog/product) e o cartão vai para o cliente por /message/catalog. O catálogo é recurso do plano Enterprise. Para fechar pedido dentro da conversa, veja catálogo com carrinho no WhatsApp e, para delivery, API do WhatsApp para delivery e restaurante.

Botões: decisão rápida

Para sim ou não, confirmar ou remarcar, os botões de resposta são mais diretos que a lista:

curl -X POST "https://server.wame.api.br/SUA_KEY/message/button_reply" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5566997145103",
    "header": { "title": "Consulta amanhã às 14h" },
    "text": "Você confirma?",
    "buttons": [
      { "type": "quick_reply", "id": "confirma", "text": "Confirmo" },
      { "type": "quick_reply", "id": "remarca", "text": "Remarcar" }
    ]
  }'

Botões de ação (abrir um site, ligar, copiar um código) usam /message/button_action.

Formulário nativo: várias perguntas, dentro da conversa

Este é exclusivo da não oficial. O formulário do WhatsApp mostra até 3 perguntas, cada uma com até 5 opções, e o cliente responde sem sair da conversa:

curl -X POST "https://server.wame.api.br/SUA_KEY/message/form" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5566997145103",
    "text": "Responda em alguns passos",
    "title": "Pesquisa rápida",
    "steps": [
      { "label": "Como avalia nosso atendimento?", "options": ["Ótimo", "Bom", "Ruim"] },
      { "label": "O que melhorar?", "options": ["Rapidez", "Preço"], "multiple": true },
      { "label": "Canal preferido?", "options": ["WhatsApp", "E-mail"], "allowCustom": true }
    ]
  }'

Passou dos limites, a API recusa com erro 400, porque o cliente veria um formulário quebrado. Na API oficial, o equivalente é o WhatsApp Flows.

Enquete: a pergunta de um clique

Para uma pergunta só, a enquete é a mais leve, e funciona bem em grupo:

curl -X POST "https://server.wame.api.br/SUA_KEY/message/poll" \
  -H "Content-Type: application/json" \
  -d '{ "to": "5566997145103", "name": "Qual horário prefere?", "values": ["Manhã", "Tarde", "Noite"], "selectableCount": 1 }'

Para pesquisa de satisfação completa, veja NPS no WhatsApp com enquete.

Qual usar

Todos esses formatos são para conversa: o cliente pediu o menu, o bot responde com ele. É uso normal, do lado seguro. Para montar o bot inteiro, veja como criar um bot de WhatsApp com a API não oficial.

Conclusão

Lista, botões, enquete, formulário nativo e catálogo cobrem menu de atendimento, cardápio e pesquisa sem tirar o cliente da conversa. O formulário nativo de várias perguntas é exclusivo da não oficial. Veja tudo o que a não oficial faz na página da API não oficial.