# Como Autenticar utilizando a API Official **Objetivo:** Mostrar como conectar a conta de Whatsapp através da API oficial.\ **Para que serve:** Orientar os clientes na utilização do projeto de WhatsApp. [▶️ Assista ao vídeo](https://youtu.be/UhUXJqQoBRY?si=p-fsoCnGmQYZPPA2) **Requisitos obrigatórios:** 1. Ter um número de telefone válido não vinculado a nenhuma conta de WhatsApp; 2. Ter uma conta no Facebook Bussiness e no Facebook Developers; 3. Ter uma página empresarial criada no Facebook. Nesse material, você vai aprender o passo a passo de como conectar seu número\ de Whatsapp via API Oficial para utilizar nas automações da leadlovers. ### Passo a Passo: #### Criando a conta no Facebook Developers 1. Acesse a página ; 2. No canto superior direito, clique em **Começar** para iniciar a criação da conta. Caso seu Facebook não esteja logado, clique em **Entrar**, informe suas credenciais e depois clique em **Começar**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-b6942def913041f5.svg"} 3. Aceite os Termos da Plataforma da Meta e as Políticas do Desenvolvedor clicando em **Continuar.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-78165bbcac53be4c.svg"} 4. Preencha todos os dados de contato solicitados para criar a sua conta de desenvolvedor. 5. Escolha a opção que melhor se enquadra no seu negócio e clique em **Concluir inscrição**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-ba2124f6817191f9.svg"} ### **Criando o Aplicativo** Após isso, seguimos para a criação do **app no Facebook.** 1. Logo na tela inicial, clique no botão **Criar Aplicativo** para prosseguir. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-fdf360e0be5a6576.svg"} 2. Selecione a qual portfólio empresarial você quer conectar a conta do Whatsapp e clique em **Avançar**. :::info Para isso é necessário possuir uma página profissional no Facebook. Confira nosso artigo [Como criar uma página no Facebook.](https://central.ajudaleadlovers.com/contas/contas/contas-de-instagram/como-criar-uma-pagina-no-facebook) ::: ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-9673e77bdb91a260.svg"} 3. Defina o caso de uso do seu app como **Outro.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-1d55ddd284a1b6a9.svg"} 4. Em tipos de aplicativo, selecione o tipo **Empresa** e clique em **Avançar.** Essa opção é obrigatória. Lembre-se que o tipo de aplicativo não poderá ser alterado posteriormente. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-5a7def43300c4126.svg"} 5. Escolha o nome de exibição que será o indicador para o seu aplicativo, este nome não ficará público. :::danger Caso você adicione algum termo não permitido o sistema emitirá um alerta. ***A palavra WhatsApp não é permitida para o nome do aplicativo.*** ::: 6. Selecione seu portfólio empresarial e clique em em **criar aplicativo.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-af573976f5f7d25a.svg"} 7. Aparecerá uma janela de confirmação, informe a sua senha do Facebook para criar o aplicativo. Confirme a senha do usuário do Facebook e clique em **Enviar.** 8. Adicione o WhatsApp no seu aplicativo. Localize o ícone correspondente e clique em **Configurar**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-f4f34ad280b4776c.svg"} Selecione seu Portfólio empresarial e clique em **Continuar.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-c56202c550a578a4.svg"} Prontinho! O seu aplicativo foi criado com sucesso! ### **Cadastrando seu número** Agora é preciso adicionar o número de telefone que será utilizado na automação. 1. Dentro desta mesma tela do final do passo anterior, clique em **Configuração da API** ou **Começar a usar a API**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-5455b5c8a202ceaf.svg"} 2. Na **Etapa 1**, clique na seta localizada ao lado do número de telefone teste e clique em **Adicionar telefone** ou desça a página, localize a **Etapa 5** e clique em **Adicionar telefone**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-805cc46eed49a920.svg"} 3. Preencha os dados da sua empresa corretamente e clique em **Avançar.** :::warning **Importante:** Fique atento quanto ao preenchimento dessas informações, pois estas informações serão adicionadas em seu perfil do **WhatsApp Business** **e todas elas estarão visíveis a seus clientes.** ::: ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-4643564bfee4c6c1.svg"} 4. Preencha as informações de perfil do WhatsApp Bussiness e clique em **Avançar.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-e37cebf062dc3412.svg"} 5. Adicione as informações do número de telefone. Escolha o país de origem e insira o número do telefone. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-142a68b021298d21.svg"} :::warning **Importante:** Esse número ***não pode ter nenhum vínculo com nenhuma conta Whatsapp ou Whatsapp Business.*** Caso você queira utilizar uma conta já utilizada no Business anteriormente, é preciso desvincular o número no business antes de criar essa autenticação. ::: 6. Para finalizar, já com as informações preenchidas, opte por receber **um SMS de verificação e clique em Avançar**. 7. Você receberá um código de SMS em seu número, digite-o aqui e clique em **Avançar** para finalizar. ### **Gerando Token de acesso permanente** Para iniciar, é necessário criar um usuário de sistema em sua conta Facebook Bussiness. Para saber mais, acesse o artigo sobre [Token Permanente do Facebook Developers](https://developers.facebook.com/docs/whatsapp/business-management-api/get-started#1--acquire-an-access-token-using-a-system-user-or-facebook-login). #### Criando um Usuário de sistema 1. Acesse [https://business.facebook.com](https://business.facebook.com/) , no menu interior a esquerda, clique na engrenagem **Configurações**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-0b733875eda4230b.svg"} 2. No menu lateral esquerdo, clique em **Usuários** e em seguida em **Usuários do sistema.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-29073d5b689f6e04.svg"} 3. Clique em **Adicionar**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-b2f7a87c353efb2a.svg"} 4. Atribua um nome ao usuário e sua função no sistema e clique em **Criar usuário do sistema.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-61c4d0bdd37e8a6a.svg"} #### **Adicionando o ativo ao usuário** O ativo é o aplicativo criado anteriormente. Nessa etapa iremos associar o usuário ao aplicativo. 1. Na lista de Usuários do sistema, clique em cima do usuário criado e clique em **Adicionar ativo.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-226b8111ceb6c71b.svg"} 2. Clique em **Aplicativos** e selecione o aplicativo criado anteriormente. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-bfa8c48cf1478d8e.svg"} 3. Atribua **Controle total** e depois é só clicar em **Atribuir ativos.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-65258d77397314cf.svg"} #### Gerando o Token permanente 1. Ainda na janela correspondente ao usuário de sistema criado, clique em **Gerar Token**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-6f0861ebd318d1ee.svg"} 2. Selecione o aplicativo criado anteriormente e clique em **Avançar.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-8e66580717fc7caf.svg"} 3. Defina a expiração do Token como **Nunca** e clique em **Avançar**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-41326647531fab7c.svg"} 4. Conseda as seguintes permissões as localizando e clicando na caixinha de seleção: **Whatsapp\_bussiness\_management** e **Whatsapp\_business\_messaging**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-c682cb9d5640b9a3.svg"} 5. Clique em **Gerar token**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-b32f1f9e13a7222e.svg"} Perfeito, token gerado com sucesso! ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-d253f3c81f7eb5ad.svg"} O próximo passo é adicionar esse token na leadlovers. Então deixa ele bem guardado, combinado? ### Autenticando sua conta de WhatsApp na leadlovers utilizando CLOUD API Ainda com a tela anterior aberta, em uma nova aba acesse a leadlovers. 1. No menu lateral esquerdo, localize a opção **Contas de envio,** clique em **Contas de Whatsapp** e clique em **Adicionar conta**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-afef2023dfcbf94e.svg"} 2. Selecione a opção **WhatsApp Business Cloud API**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-03506643fb78bfa5.svg"} 3. Leia as orientações atentamente até o final e **selecione a caixinha confirmando que está ciente sobre as orientações passada**. Depois clique em **Continuar.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-47e9cd1aca9b5717.svg"} 4. Copie o token de acesso permanente que foi gerado no passo anterior e cole no campo **Token de acesso**. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-4aa9fcc53d5a7b1d.svg"} :::warning Importante não confundir o **Token permanente** com o token oferecido na tela incial de **Configurações de API.** Ele será usado em outra etapa lá frente. ::: 5. Acesse a página de **Configurações de API** no Facebook Developers (A mesma onde o número de telefone foi cadastrado), ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-16f43d9fdab3d8a8.svg"} 6. Agora copie a **Identificação de conta do WhatsApp Business**, também localizado na **Etapa 1** e cole no campo **ID da conta WhatsApp Business** na leadlovers. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-5e8b082e9e7e8d30.svg"} 7. Na página de **Configurações de API**, clique em **Gerar token de acesso**. **Não será necessário utilizar esse token.** Essa ação é necessária para conceder permissões ao aplicativo. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-b5d7fcf7eb9c537b.svg"} 8. Confirme sua conta logada no Facebook. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-74a7bfa2a5e49819.svg"} 9. Para que a automação funcione corretamente, é necessário permitir que a conexão seja para **todas as contas do WhatsApp atuais e futuras**, ou seja, **selecione a primeira opção** e clique em **Continuar.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-698edb076c5212a8.svg"} 11. Na leadlovers, com todas as informações devidamente preenchidas, clique em **Continuar.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-13cef042edad138c.svg"} Pronto, agora estamos quase lá 🙂 ### Configurando Dados de Webhook E por último, será gerada uma URL de retorno que deverá ser inserida na sua página do Facebook Developers. Veja como a seguir. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-0498fbe317be614f.svg"} 1. Acesse a página **Configuração da API** no Facebook Developers, vá até a **Etapa 3** e clique em **Configurar Webhooks.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-ee7f0f39eeca3ac0.svg"} 2. Para os campos **URL de retoreno de chamada** e **Verificar token**, vá até a leadlovers e copie os campos correspondentes para informar os dados solicitados na página de configuração do Facebook Developers. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-44cd56843cbeb51d.svg"} 3. No Facebook Developers, com todas as informações devidamente preenchidas, clique em **Verificar e salvar.** ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-ddb0590727773561.svg"} 4. Em **Campos de webhook** localize e assinale os campos a seguir para mudar de **Cancelou a assinatura** para A**ssinado:** * account\_alerts; * flows; * message\_template\_components\_update; * message\_template\_quality\_update; * message\_template\_status\_update; * messages; * phone\_number\_name\_update; * phone\_number\_quality\_update; * template\_category\_update. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-ae0cf4d19c0d3165.svg"} ### Configurando o Modo do aplicativo Na parte superior da tela, clique para deixar o aplicativo no **modo Ao vivo.** Para realizar essa ativação, é necessário que suas URLs de Política de Privacidade e Termos de uso estejam atualizada na Meta. Caso não tenha preenchido, ao clicar no botão de ativação será aberta uma janela com o link das **Configurações Básicas**, onde será possível realizar o preenchimento. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-6db6326e1db2335b.svg"} ### Configurando a conta do Whatsapp na leadlovers Para finalizar, configure as últimas definições dentro da leadlovers. 1. **Nomear conta:** Dê um nome a sua conta, isso o ajudará a identificá-la em sua listagem de contas. 2. **Vincular projeto:** Escolha um projeto de WhatsApp para vincular a sua conta. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-36a1c165f7a65e57.svg"} 3. **Notificações e Alertas:** Caso queira, cadastre um e-mail e um número de WhatsApp, para receber alertas e notificações desta conta. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-859f11602903eaf5.svg"} Prontinho! Clique em S**alvar** e após isso sua automação estará ativa na leadlovers. ::figure{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fgb-278a2b2a14a9a377.svg"} **Suporte** Se surgir qualquer dúvida ou situação, ou se precisar de qualquer ajuda durante este procedimento, por favor, **entre em contato com o nosso suporte**!