WhatsApp

Conecte seu agente ao WhatsApp para atender clientes diretamente pelo aplicativo de mensagens mais usado do mundo.

Como conectar

1. Acesse o Mission Control do seu agente
2. Vá em Channels → WhatsApp
3. Um QR Code será exibido
4. Abra o WhatsApp no seu celular → Dispositivos vinculados → Vincular dispositivo
5. Escaneie o QR Code
6. Pronto! O agente agora responde pelo WhatsApp

Configurações

Allowlist

Restrinja quais números podem conversar com o agente:

json
{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+5511999999999"]
    }
  }
}

Grupos

Configure menção obrigatória para ativação em grupos:

json
{
  "channels": {
    "whatsapp": {
      "groups": { "*": { "requireMention": true } }
    }
  }
}

Considerações

• O WhatsApp Web permite apenas uma sessão ativa por número
• Mensagens de mídia (imagens, áudio, documentos) são suportadas
• Recomenda-se usar um número dedicado para o agente

Templates WABA no Chatcenter

Ao atender pelo WhatsApp Business (WABA), você envia templates aprovados pelo comando de barra no Chatcenter:

1. No campo de mensagem, digite / para abrir a lista de comandos.
2. Apenas templates aprovados aparecem (templates pendentes ou rejeitados ficam ocultos).
3. Se o template tiver variáveis ({{1}}, {{2}}…), um formulário abre para você preencher cada variável. Cada campo mostra o rótulo configurado no template (ex.: "Nome do cliente"), deixando claro o que preencher. Templates sem variáveis são enviados direto.

Rótulos das variáveis

Ao criar/editar um template em Templates WABA, você pode dar um rótulo a cada variável. O rótulo é usado apenas dentro da plataforma (para ajudar quem envia) e não é enviado ao WhatsApp/Gupshup.

Status de envio de mensagens e templates

Ao enviar uma mensagem ou template no Chatcenter, a bolha aparece imediatamente com o indicador "Enviando" (ícone girando) enquanto a plataforma confirma o envio com o WhatsApp:

• Enviando → Enviado → Entregue → Lida: o indicador de status na própria bolha é atualizado automaticamente, sem precisar recarregar a página — inclusive se outro atendente estiver olhando a mesma conversa em outra aba.
• Se o envio falhar (ex.: janela de 24h expirada, template rejeitado), a bolha exibe "Detalhes do Erro" com o motivo e um botão Reenviar — tanto para mensagens de texto quanto para templates.

Criar contato e já iniciar a conversa

No cadastro de contato (Contatos → Adicionar Novo Contato), preenchendo um telefone válido você pode, opcionalmente, selecionar um template aprovado para iniciar a conversa assim que o contato for criado. A plataforma cria o contato, abre a conversa e envia o template — com mensagens de confirmação para cada etapa.

Abrir a conversa de um contato

Na lista de Contatos, o botão de chat de cada contato leva ao Chatcenter:

• Se o contato tem uma conversa, ela abre direto.
• Se tem várias, você escolhe qual abrir em uma lista.
• Se não tem nenhuma, a plataforma pergunta se deseja criar uma nova conversa e já abre o chat.

Recuperação automática de conversas sem resposta

Quando uma conversa fica sem resposta do agente, a plataforma pode acionar uma retentativa automática em segundo plano:

• As conversas mais antigas são priorizadas primeiro.
• Se a fila de processamento estiver habilitada, a retentativa é enfileirada de forma assíncrona.
• Conversas já presentes na fila não são enfileiradas novamente, evitando duplicações.

Custos das mensagens

O envio pela API oficial (WABA) é cobrado pela Meta por mensagem entregue, com preço definido pela categoria do template e pelo país do destinatário.

Atenção: a partir de 1º de outubro de 2026, as respostas em texto livre dentro da janela de 24 horas (mensagens de serviço) e os templates de utilidade enviados dentro dessa janela — hoje gratuitos — passam a ser cobrados. Isso afeta diretamente quem atende com agentes de IA.

Veja Cobrança do WhatsApp (WABA) para o detalhamento, e a calculadora de custo para estimar o impacto na sua operação.