Como criar seu aplicativo na Meta e conectar o número
Este guia é para quem já tem a estrutura de Business Manager pronta e quer fazer a conexão por conta própria. São oito passos: você copia quatro informações do painel da Meta e cola no Cedro.
Você vai precisar de:
- Acesso de administrador na Business Manager da sua empresa
- Um número que não esteja em uso no aplicativo comum do WhatsApp
- Cerca de 30 minutos, se for a primeira vez
- 1
Entre na sua Business Manager
Acesse business.facebook.com com a conta que administra a sua empresa. Você precisa ter acesso de administrador, senão os menus dos próximos passos não aparecem.
Atenção: Se você tem mais de uma empresa, confira no topo da tela qual está selecionada.
- 2
Confirme que existe uma conta do WhatsApp Business (WABA)
Em Configurações do negócio, procure Contas e depois Contas do WhatsApp. É lá que fica o número que vai atender. Se ainda não existe, crie uma e cadastre o número.
Atenção: O número precisa estar fora do aplicativo comum do WhatsApp. Um número já usado no app precisa ser removido de lá antes.
- 3
Crie o aplicativo na Meta
Vá em developers.facebook.com, clique em Meus apps e depois em Criar app. Escolha o tipo Empresa (Business) e vincule à sua Business Manager. Dentro do app, adicione o produto WhatsApp.
Atenção: O nome do app é interno: seu cliente nunca vê. Use algo que você reconheça depois, como Atendimento Cedro.
- 4
Copie o Phone Number ID
No app, abra WhatsApp e depois Configuração da API. Ali aparece o número e, logo abaixo, o identificador dele. É esse identificador (só números) que o Cedro pede, não o telefone.
Atenção: Também anote o WABA ID, que fica na mesma tela. Ele é opcional, mas ajuda muito no suporte.
- 5
Gere um token permanente (System User)
Em Configurações do negócio, vá em Usuários e depois Usuários do sistema. Crie um usuário do sistema com função de administrador, dê a ele acesso ao seu app e à sua conta do WhatsApp, e então gere um token com as permissões whatsapp_business_messaging e whatsapp_business_management.
Atenção: Não use o token de teste que aparece na tela de configuração da API: ele vence em 24 horas e o atendimento para no dia seguinte.
- 6
Copie o App Secret
Ainda no app, em Configurações e depois Básico, revele o campo Chave Secreta do Aplicativo (App Secret) e copie o valor. É com ele que o Cedro confere que cada mensagem recebida veio mesmo da Meta.
Atenção: Esse valor é sigiloso como uma senha. Não mande por grupo de WhatsApp nem cole em bloco de notas compartilhado.
- 7
Cole tudo no Cedro
Abra o painel do Cedro em Conexão, preencha Phone Number ID, token e App Secret e clique em Validar e conectar. Nós conferimos na hora com a Meta e mostramos o número que ela devolver.
Atenção: Se der erro, quase sempre é token de teste vencido ou número ainda não registrado na WABA.
- 8
Configure o webhook
Depois de conectar, a tela de Conexão mostra a Callback URL e o Verify token da sua conta. No app da Meta, em WhatsApp e depois Configuração, cole os dois, salve e assine o campo messages.
Atenção: Sem assinar o campo messages, o número conecta mas nenhuma mensagem chega no Cedro.
Depois de conectar, o que muda no atendimento
Janela de 24 horas
Na conexão oficial, mensagem de texto livre só sai se o cliente falou com você nas últimas 24 horas. Passou disso, a conversa só reabre com um modelo aprovado pela Meta.
Seu número fica seguro
Como o envio passa pela infraestrutura da própria Meta, não existe o risco de bloqueio que a conexão não oficial carrega quando o volume de mensagens cresce.
Travou em algum passo, ou não tem Business Manager?
Nossa equipe monta a estrutura inteira pra você: Business Manager, conta do WhatsApp Business, aprovação do número e criação do aplicativo. Setup único de R$ 500.