Aparência
WhatsApp API Oficial
Onde fica: Menu do atendente › Loja de Plugins › WhatsAppDesde a v3.15.0
É o canal do número oficial do WhatsApp, fornecido pela Meta. As conversas entram na fila, são distribuídas por departamento e atendidas por pessoas ou pelo atendente virtual, com o histórico do cliente junto ao dos outros canais. Use esta tela para cadastrar o número, conferir se ele está saudável e fazer um teste.
Antes de começar
Observação
O cliente vê só o primeiro nome do atendente nas mensagens que recebe. Cobrança em massa respeita o horário legal: 8h às 18h em dia útil, 10h às 16h no sábado, nunca no domingo nem em feriado.
- Só administrador abre a Loja de Plugins.
- Tenha em mãos Phone Number ID, Business Account ID (WABA), Access Token permanente e App Secret. O tutorial mostra onde achar cada um.
- A licença precisa liberar o canal WhatsApp API (Oficial). Confira em Loja de Plugins › Licença.
Passo a passo
- Abra o seu perfil, clique em Loja de Plugins e toque no cartão WhatsApp. Na janela de detalhes, clique em Configurar (ou Ajustar, se o canal já funciona).
- A tela WhatsApp API Oficial lista as integrações com Nome, Ativo, Modo, Provider e Phone Number ID. Clique em Novo. Para editar, dê dois cliques na linha.
- Na aba Configuração, preencha Nome, Phone Number ID, Business Account ID — WABA, Access Token, App Secret e Verify Token. No Verify Token, clique em Gerar.
- Deixe Ativo em Sim e clique em Salvar.
- Reabra a integração: a URL do webhook aparece, com o botão Copiar. Ela vai no painel da Meta.
- Em Botões Interativos, Sim transforma perguntas com opções em botões clicáveis (até 3 botões, ou uma lista Ver Menu com até 10 itens). Não manda as opções como texto numerado.
- A aba Templates libera os modelos de mensagem desta conta depois que a integração é salva.
Regras que a tela aplica
Atenção
Janela de 24 horas. Para começar conversa com quem não falou com você nas últimas 24 horas, o WhatsApp oficial exige um modelo (template) aprovado. Ao reabrir um atendimento finalizado com a janela fechada, o OMNI abre Abrir atendimento já com o contato, para você escolher o modelo. Cadastrar contato novo e iniciar a conversa só existe neste canal.
- Os segredos aparecem mascarados. Na edição, campo vazio mantém o valor atual.
- Ao criar, todos os campos da aba Configuração são obrigatórios.
- Com a licença no limite, a tela recusa a nova conexão e orienta procurar o suporte.
- Com o App Secret errado, a Meta entrega a mensagem e o OMNI a recusa por assinatura inválida.
O que acontece depois
A conversa aparece na fila do atendimento. O atendente virtual entende o áudio do cliente (que vira texto, com um 🎤 na frente) e responde em voz quando faz sentido, sempre com o texto junto se houver valor, link ou código de boleto ou Pix.
Na lista de integrações:
- Saúde mostra modo, status, eventos recentes, duplicados ignorados e o último erro.
- Testar envio pede um número e uma mensagem e envia de verdade. Use o seu número.
- Copiar webhook copia a URL do webhook.
No cartão da Loja, Testar conexão valida o número na Meta sem enviar mensagem. O que a empresa envia e o que a Meta cobra está em Saída do WhatsApp.
Perguntas frequentes
Posso ter mais de um número? Sim, cada número é uma integração, dentro do limite da licença.
O webhook salvou na Meta, mas nada chega. Confira se o App Secret é o do app do WhatsApp e se o campo messages está inscrito. Veja o tutorial.