Como conectar um número oficial do WhatsApp

O que o Fiber Desk vai pedir

Estes são os campos do formulário do canal. O guia abaixo busca cada um deles.

Antes de começar

Três coisas precisam existir do lado da Meta. Sem elas o resto não anda.

1. Um Gerenciador de Negócios (Meta Business) É a conta da empresa na Meta, em business.facebook.com. Se o provedor já anuncia no Facebook ou Instagram, ela já existe. Você precisa ser administrador dela.
2. Um número de telefone que NÃO esteja no WhatsApp O número precisa estar livre: se ele já tem WhatsApp comum ou WhatsApp Business no celular, é preciso apagar a conta no aplicativo antes (não basta desinstalar). Depois de virar oficial, o número não volta para o aplicativo do celular. Ele passa a existir só pela API. Não use o número pessoal de ninguém, e não use o número que a equipe usa hoje no celular sem combinar isso antes.
3. Um jeito de receber o código de verificação A Meta liga ou manda SMS para o número na hora de cadastrar. Tenha alguém com acesso a ele no momento do cadastro.

1. Criar o app e conectar o número

Aqui nascem os dois primeiros valores que a plataforma pede: o Phone Number ID e o WABA ID.

1. Entre em developers.facebook.com e clique em "Criar app" Em "Casos de uso", escolha "Conectar-se a clientes por meio do WhatsApp". Dê um nome ao app (o nome do provedor serve) e vincule ao Gerenciador de Negócios da empresa.
2. No painel do app, abra WhatsApp → Configuração da API Conecte a conta do WhatsApp Business (WABA) da empresa, ou crie uma nova pelo botão da própria tela. Não achou esse menu? Em apps criados pelo caminho novo ele fica em Casos de uso → Personalizar → Conectar no WhatsApp → Configuração. É a mesma tela, com outro caminho.
3. Adicione o número de telefone Em "De" (o remetente), clique em Adicionar número de telefone. Informe o número, o nome de exibição da empresa e conclua a verificação por SMS ou ligação. O nome de exibição passa por análise da Meta e é o que o cliente vê. Ele precisa ter relação com o negócio: "Unix Internet" é aprovado, "Atendimento 01" costuma ser recusado.
4. Copie o Phone Number ID e o WABA ID Nessa mesma tela: o Identificação do número de telefone é o Phone Number ID, e a Identificação da conta do WhatsApp Business é o WABA ID. Os dois são números longos. O Phone Number ID não é o telefone com DDD. Colar o telefone ali é o erro mais comum, e o canal simplesmente não envia.

2. Gerar o token permanente (Usuário do Sistema)

O passo que decide se o canal vai continuar funcionando amanhã. O token que aparece na tela de testes expira em 24 horas.

1. Abra o Gerenciador de Negócios → Configurações do negócio Em business.facebook.com/latest/settings, com a empresa certa selecionada no topo.
2. Vá em Usuários → Usuários do sistema e clique em Adicionar Dê um nome que diga o que é (Fiber Desk) e escolha a função Administrador. Um usuário do sistema não é uma pessoa: é uma identidade técnica, criada para sistemas se autenticarem. Use um usuário do sistema só para o Fiber Desk. Compartilhar o mesmo com outro sistema faz com que revogar o acesso de um derrube o outro junto.
3. Clique em Adicionar ativos e libere DUAS coisas O app que você criou (com controle total) e a conta do WhatsApp Business (a WABA). Sem o segundo, o token é gerado mas não enxerga o número, e o envio falha com erro de permissão. Este é o passo que mais fica pela metade. Se você só liberar o app, tudo parece certo até a primeira mensagem.
4. Clique em Gerar novo token Escolha o app e marque as permissões whatsapp_business_messaging e whatsapp_business_management. Em "Expiração", escolha Nunca. O token aparece UMA vez. Copie e guarde antes de fechar a janela: não há como vê-lo de novo, só gerar outro.
5. Cole o token no Fiber Desk É o campo Access Token do formulário do canal. Se você usar o token da tela "Configuração da API" da Meta, o canal funciona hoje e para sozinho em 24 horas, sem nenhum aviso. É a causa nº 1 de "funcionou ontem e hoje não".

3. Pegar a chave secreta do app

É o que permite à plataforma conferir que a mensagem veio mesmo da Meta.

1. No app, abra Configurações → Básico No campo Chave secreta do app, clique em Mostrar, confirme a senha e copie.
2. Cole no campo App Secret É opcional no formulário, mas não deixe em branco: sem ela a plataforma não consegue verificar a assinatura do webhook, e qualquer um que descubra a sua URL poderia injetar mensagens falsas na sua caixa de entrada.

4. Ligar o webhook

É o que faz as mensagens CHEGAREM. Sem este passo o canal envia, mas nada do cliente aparece no painel.

1. Crie o canal no Fiber Desk primeiro Salve o canal com os dados dos passos anteriores. A plataforma então mostra a URL de callback e o Verify Token prontos, com botão de copiar.
2. Na Meta, abra WhatsApp → Configuração → Webhook e clique em Editar Cole a URL de retorno de chamada e o Token de verificação, exatamente como a plataforma mostrou, e clique em Verificar e salvar. No caminho novo do painel, a mesma tela fica em Casos de uso → Personalizar → Conectar no WhatsApp → Configuração. Se der erro de verificação, quase sempre é espaço sobrando no começo ou no fim de um dos dois valores. Cole pelo botão de copiar do painel, não digitando.
3. Clique em Gerenciar e assine o campo "messages" É o único obrigatório: ele traz as mensagens recebidas e os status de entrega e leitura. Se você usa modelos (campanhas de cobrança), assine também message_template_status_update, que avisa quando a Meta aprova ou reprova um modelo. Assinar campos demais não quebra nada, mas enche o log de eventos que a plataforma ignora.
4. Mande uma mensagem de teste para o número Do seu celular, mande um "oi" para o número oficial. Ela precisa aparecer no inbox do Fiber Desk em segundos. Se aparecer, está pronto.

5. Depois de conectar

Duas coisas que não são obrigatórias no primeiro dia, mas decidem quanto você consegue enviar.

1. Verifique a empresa no Gerenciador de Negócios Sem verificação, o número fica limitado a poucos destinatários por dia. A verificação pede documento da empresa (CNPJ) e leva alguns dias.
2. Entenda o limite de envio e a nota de qualidade O número começa com um limite baixo e sobe conforme você envia sem ser bloqueado. Mensagem marcada como spam derruba a nota, e a nota define o limite. Por isso a plataforma recusa antes de enviar o que não pode dar certo (telefone fixo, número incompleto, DDD inexistente): cada envio recusado pela Meta é cobrado e machuca a nota.

Não funcionou?

Os seis casos que respondem por quase todos os chamados desta integração.