WhatsApp Business API para suporte — botões interativos

Visão geral do caso de uso

Este cenário envia uma mensagem com um botão interativo usando sendButton durante a janela de atendimento ao cliente de 24 horas. Três respostas rápidas permitem que o cliente escolha o menu principal, status do pedido ou transferência para um agente sem precisar digitar.

Exemplo de modelo

Como podemos ajudar você hoje?

Quando usá-lo

Acesse este cenário quando uma mensagem de cliente abrir ou continuar uma sessão de suporte no WhatsApp e eles precisarem de um caminho rápido de autoatendimento antes que um agente leia o texto livre. Ele se encaixa em filas de suporte de nível 1, onde pedidos repetitivos de status de pedido, menu e solicitações de escalonamento atrasam a primeira resposta dentro da janela de atendimento ao cliente de 24 horas.

Fluxo de Trabalho

1. Status rastreado

   Uma mensagem de cliente chega via webhook e mantém a sessão aberta.

   status: "read"

2. Construir e enviar

   Seu backend envia o menu de botões interativos com orientações no rodapé.

   POST /send_button

3. Atos do cliente

   O cliente toca em uma das três opções.

   user action

4. Entregue

   O webhook entrega o id do botão para direcionar a menus, status ou fluxos de agentes.

   delivered

Implementação técnica

Pré-requisitos

1. 1MSG Chave da API · Como obter a chave da API
2. Conta do WhatsApp Business · Como Conectar o WABA
3. Janela de sessão aberta 24 horas · Como funciona a janela de 24 horas
4. Opt-in do cliente · Como Gerenciar o Consentimento dos Clientes
5. Endpoint de webhook · Como Configurar Webhooks

Exemplos de código

#!/usr/bin/env bash
set -euo pipefail

# === Configuration (replace "___" placeholders) ===
API_BASE_URL="https://api.1msg.io"        # production 1MSG API base URL
CHANNEL_ID="___"                           # channel ID from 1MSG dashboard
API_TOKEN="___"                            # channel JWT token (Bearer)



# === Test data ===
TEST_PHONE="___"                 # client phone in international format

PHONE_NORM="$(printf '%s' "$TEST_PHONE" | tr -cd '0-9')"
URL="${API_BASE_URL%/}/${CHANNEL_ID}/sendButton"

read -r -d '' PAYLOAD <<JSON || true
{
  "phone": "${PHONE_NORM}",
  "body": "How can we help you today?",
  "footer": "Choose an option",
  "sections": [
    { "type": "reply", "reply": { "id": "menu", "title": "Main menu" } },
    { "type": "reply", "reply": { "id": "status", "title": "Order status" } },
    { "type": "reply", "reply": { "id": "agent", "title": "Talk to agent" } }
  ]
}
JSON

RESPONSE="$(curl -s -w '\n%{http_code}' -X POST "$URL" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d "$PAYLOAD")"

HTTP_CODE="$(printf '%s' "$RESPONSE" | tail -n1)"
BODY="$(printf '%s' "$RESPONSE" | sed '$d')"

case "$BODY" in
  *'"sent":true'*) ok=1 ;;
  *) ok=0 ;;
esac

if [ "$HTTP_CODE" -ge 200 ] && [ "$HTTP_CODE" -lt 300 ] && [ "$ok" -eq 1 ]; then
  echo "Message sent to client."
else
  echo "$BODY" >&2
  exit 1
fi

Status de resposta e entrega

HTTP 2xx e JSON"sent": truemean 1MSGaceitoa mensagem para envio — não que já tenha chegado ao celular do cliente.idcampowamid.…) para correlacionar callbacks de entrega.

{
  "sent": true,
  "id": "wamid.HBgLMzgwNjM5...",
  "message": "Message accepted for delivery"
}

A entrega em si chega mais tarde, como um callback separado. Registre um webhookPOST …/webhook) e 1MSG POST atualizações de status para o seu endpoint HTTPS em um nível superiorhooks[]carga.

{
  "hooks": [
    {
      "id": "gBGGeSaGViBfAgnlzOSHEwK9O6F",
      "type": "message",
      "status": "sent",
      "timestamp": "1654864094",
      "recipient_id": "556123122026"
    }
  ]
}

Se você não quiser receber ligações, escolha não ser contatado.GET {base}/{channel}/hookInfo?messageId=<id>em vez disso. Na prática, a entrega geralmente é concluída em segundos — mas o contrato da API não garante isso, então nunca bloqueie um fluxo esperando por isso.

Erros comuns

Perguntas Frequentes