Tudo parece confuso, e é mesmo, mas aqui você tem a solução!
Pra quem já pesquisou sobre o assunto já viu que tudo é mal explicado e confuso, sim você não está sozinho nisso. Aqui penamos um pouco para conseguir na primeira vez, mas aqui estamos ajudando você!
Mas já adianto que agora nesse tutorial você vai conseguir subir seu número para Api Oficial do WhatsApp de uma forma mais fácil!
Passo 1 – Criando a aplicação na Meta
A Meta tem a lógica que o seu número do WhatsApp é um recurso dentro de uma “aplicação” que pode vir usar outros recursos como api do Instagram, Mensseger e outras coisas. Mas vamos focar no simples!
Vamos lá, acesse https://developers.facebook.com/apps/ e logue com sua conta do Facebook, aqui já temos o perfil de desenvolvedor habilitado, caso não tenha será solicitado que o faça.
Conforme imagem 1, clique em criar aplicativo.
Agora, conforme imagem 2 escolha a categoria Outro.
Selecione o tipo Empresa, conforme imagem 3.
Informe os dados básicos do seu aplicativo, imagem 4, como o nome e email. O terceiro campo, conta empresarial, se você tiver uma você já pode selecionar (recomendado), caso contrário, deverá criar uma para posteriormente linkar à essa aplicação criada.
Passo 2 – Configurando o WhatsApp como produto
Após criada a aplicação, você precisa indicar que deseja usar o WhatsApp como produto dentro desse novo app.
Para adicionar o WhatsApp no app, basta clicar em Configurar conforme destacado na imagem 5.
Uma vez adicionado, vamos às configurações de webhook e token de acesso.
Passo 3 – Configurando o Webhook
Toda vez que uma mensagem chegar no seu WhatsApp ela será encaminhada ao seu webhook configurado.
Clique em configuração e depois em Editar conforme imagem 6.
O Facebook vai querer validar o endpoint informado, para isso, informe a URL do seu sistema e coloque em token uma palavra chave da sua escolha, aqui para facilitar o entendimento da explicação a seguir, usaremos como token palavra.chave e a URL https://seu.site.
O Facebook vai enviar uma chamada GET semelhante a essa ao endpoint/URL informada:
https://seu.site/?
hub.mode=subscribe&
hub.challenge=123456&
hub.verify_token=palavra.chave
Para validar seu webhook, você precisa dar um simples echo no conteúdo de hub.challenge, se quiser, por segurança valide o hub.verify_token, nesse caso palavra.chave. Abaixo um trecho de código em PHP (CakePHP) para executar a lógica apresentada acima.
//Se está querendo validar o webhook
if($this->request->query('hub_mode') == 'subscribe'){
$token = $this->request->query('hub_verify_token');//token
$challenge = $this->request->query('hub_challenge');
if($token == 'palavra.chave'){
echo $challenge;
die();
}
}
Agora você precisa informar quais eventos deseja receber no webhook validado. Clique em Gerenciar conforme imagem 8 e selecione somente o evento messages, ele será suficiente!
Passo 4 – Gerando o token da API
Já criamos o aplicativo, habilitamos o WhatsApp como produto, setamos o webhook, agora vamos gerar o token da API e dar as permissões.
Assim que você cria a aplicação é gerado um token temporário, mas ele tem validade de 24h, então para gerar um token permanente é necessário seguir as etapas a seguir.
Na imagem 9 temos o acesso ao token temporário, nessa página é possível fazer um envio de teste pelo número temporário que é disponibilizado pela Meta, mas ele tem restrição de envios, mas é possível a partir deste ponto usar as credenciais temporárias e o número de teste.
A seguir vamos gerar o token permanente, a lógica é atribuir a um usuário da conta Business privilégios sobre o aplicativo criado e seus recursos, nesse caso, o WhatsApp.
Acesse https://business.facebook.com/settings/system-users e selecione um dos usuários do sistema, depois clique em atribuir ativos conforme imagem 10.
Agora, selecione a aplicação recém criada e dê ao usuário o controle total conforme imagem 11.
Finalmente, sim, eu sei que é cansativo, após atribuir o ativo ao usuário clique em Gerar Token.
Ao ser gerado o token você precisa setar a validade, aqui no caso nunca, e as permissões para uso da aplicação Whatsapp que são as marcadas na imagem 13. Clique em Gerar token e o guarde, ele não fica salvo em lugar algum.
Passo 5 – Subindo seu número para a API
Esse é o último passo, acredite em mim!
Volte para https://developers.facebook.com/apps/ e selecione sua aplicação, vá em Configuração da API e selecione Adicionar telefone. Preencha os dados solicitados até a verificação do número via SMS.
Assim que essa etapa estiver finalizada, seu número já estará na nuvem. Ele agora constará na lista de números conforme destacado na imagem 9, em identificação do número de telefone.
Para alterar dados do seu WhatsApp como foto de perfil, criar templates e acessar outras informações do seu número conectado acesse: https://business.facebook.com/wa/manage/home/
IMPORTANTE: para essa última etapa, o número que deseja subir não pode estar instalado no aplicativo no celular, então remova o número do WhatsApp e somente após isso, faça o procedimento descrito aqui.
Usando a API
Para usar o número do WhatsApp que foi movido para a nuvem agora somente via API, para acesso às informações e documentações acesse: https://developers.facebook.com/docs/whatsapp/cloud-api
Ainda ficou complicado?
Não tem problema, aqui na Meu James somos especialistas nisso e temos a melhor plataforma de atendimento inteligente do mercado e podemos fazer tudo isso para você sem custo!
Então está esperando o quê? Vem para Meu James, clique no botão do WhatsApp aqui no canto ou acesse nosso site https://meujames.com e solicite seu teste 7 dias GRÁTIS!
