Todo chamado que nasce no WhatsApp pessoal do técnico é um chamado que não existe: não tem número, não tem fila, não tem SLA, e o histórico some quando o técnico sai da empresa. É a cena que a i9aTech mais encontra quando avalia operações de suporte que atendem usuário por mensagem — o canal preferido do usuário virou o ponto cego da gestão.
A saída não é proibir o WhatsApp. É oficializá-lo. Desde a versão 6.3 (lançada em 17 de abril de 2024), o Zammad traz o WhatsApp Business como canal nativo, usando a WhatsApp Cloud API da Meta — sem gateway pago de terceiro. A mensagem do usuário vira ticket como outro qualquer: com dono, prioridade, SLA e relatório. Abaixo, o passo a passo real da configuração, com o erro comum de cada etapa.
Antes de começar: o que você precisa
- Zammad 6.3 ou superior, acessível pela internet — a Meta entrega as mensagens via webhook, então instância fechada na rede interna não recebe nada.
- FQDN correto em Configurações > Sistema, porque é ele que compõe a URL de callback.
- Conta Meta Business (business.facebook.com) e uma conta de desenvolvedor Meta.
- Um número dedicado ao canal — que nunca tenha sido usado em app WhatsApp ou WhatsApp Business.
O passo a passo
Passo 1: crie o app na plataforma Meta
Em developers.facebook.com/apps, clique em Create App, escolha o caso de uso Connect with customers through WhatsApp e vincule o app ao seu portfólio de negócios. Depois, em API Setup, adicione e verifique o número de telefone do canal.
Erro comum: tentar reaproveitar o número que já atende no aplicativo WhatsApp Business do celular. A Cloud API exige número livre — planeje a migração ou use um número novo.
Passo 2: gere as credenciais
Você vai precisar de três valores. O WhatsApp Business Account ID fica em API Setup no painel do app. O App Secret fica em App settings > Basic. O Access Token deve ser de um usuário de sistema: crie-o no Meta Business em Usuários > Usuários do sistema, atribua o app com acesso de administrador (toggle Manage app) e gere o token com as permissões whatsapp_business_management e whatsapp_business_messaging, de preferência sem expiração.
Erro comum: gerar o token temporário do painel de testes (expira em 24 horas) ou fechar a tela sem copiar — o token é exibido uma única vez. Canal que “funcionou uma semana e parou” quase sempre é token vencido.
Passo 3: adicione o canal no Zammad
No Zammad, vá em Canais > WhatsApp e clique em Adicionar conta. Informe Business Account ID, Access Token e App Secret. Ao avançar, o Zammad valida as credenciais e busca o número vinculado ao app.
Erro comum: a validação falhar por FQDN errado ou instância sem HTTPS válido. Confira o certificado e a URL pública antes de culpar as credenciais.
Passo 4: configure número, boas-vindas e grupo
Na segunda etapa do assistente, selecione o número, defina a mensagem de boas-vindas (enviada na primeira mensagem do cliente), os lembretes automáticos da janela de atendimento e o grupo onde os tickets serão criados.
Erro comum: ignorar a janela de 24 horas da Meta. Fora dela, o agente não consegue responder mensagem livre — deixe os lembretes ativos e oriente o time a não deixar conversa esfriar.
Passo 5: registre o webhook na Meta
De volta ao painel do app, em Use cases > Configuration, cole a Callback URL e o Verify Token que o Zammad exibe na terceira etapa e confirme em Verify and save. Depois, em Webhook fields, ative o campo messages. Só então clique em Finalizar no Zammad.
Erro comum: pular este passo. O canal aparece no Zammad, mas nenhuma mensagem chega — a Meta não sabe pra onde enviar. É a causa número 1 de “configurei e não funciona”.
Passo 6: teste de ponta a ponta
Envie uma mensagem real de outro celular: confirme que virou ticket no grupo certo, que a boas-vindas chegou e que a resposta do agente retorna ao WhatsApp. Teste também anexo e áudio.
Erro comum: testar só com o número de teste da Meta, que exige inscrição manual no webhook do WABA — e concluir errado que o canal quebrou.
Canal no ar não é operação madura
WhatsApp oficial resolve a fricção da entrada, mas o ticket ainda precisa de triagem, categoria e prazo — sem isso, você só trocou o caos de lugar. Vale medir onde sua operação está com o Quiz de Maturidade ITIL e, se a ferramenta ainda está em avaliação, o comparador de ferramentas coloca o Zammad lado a lado com GLPI e OTRS em 2 minutos. A frente de implantação de Zammad da i9aTech entrega o canal configurado junto com o que sustenta ele: catálogo, SLA e automação de triagem.
Próximo passo
Quer atender no WhatsApp com número oficial, fila e SLA — sem depender do celular do técnico? Comece pelo diagnóstico gratuito de 30 minutos: a i9aTech mapeia seus canais de entrada e aponta as 3 ações de maior impacto pra tirar o suporte do improviso. Faz parte do nosso projeto de Service Desk.