Integração Whatsapp API

Etapa 1 - configurar conta empresarial e aplicativo Meta (Facebook)

1. Crie uma conta empresarial Meta (Facebook):

   • Visite aqui .

   • Insira o nome da sua empresa, seu nome e endereço de e-mail comercial. Clique em "Avançar".

   • Forneça os dados da sua empresa e clique em “Enviar”.

   • Insira os dados da sua empresa e clique em Enviar.

     

2. Crie um novo aplicativo Meta (Facebook) em https://developers.facebook.com/

   • "Faça login" em sua conta de desenvolvedor Meta (Facebook).

     

   • Selecione "Meus apps" .

     

   • Clique em "Criar aplicativo".

     

   • Escolha Caso de usuário: " Outro " e clique em "Avançar".

     

   • Escolha o tipo de aplicativo: " Comercial " e clique em "Avançar".

     

   • Forneça os detalhes do aplicativo: nome do aplicativo, e-mail de contato do aplicativo, conta comercial (opcional) e clique em "Criar aplicativo".

     

Obs: Caso você receba uma mensagem de alerta referente à sua conta, siga o tutorial abaixo para solicitar uma análise detalhada da sua conta pela Meta. Isso é essencial para que as restrições, incluindo a proibição de publicidade e compartilhamento de aplicativos, possam ser revistas e possivelmente levantadas.

https://www.facebook.com/business/help/4322671737743632

Exemplo de mensagens de alerta:

Etapa 2: Configurando o aplicativo Meta (Facebook) para integração com o WhatsApp

1. Adicione o WhatsApp ao seu aplicativo Meta (Facebook).

   • No "Painel de Desenvolvedores" , escolha seu aplicativo.

   • Localize " Adicionar produtos ao seu aplicativo " na guia do painel do seu aplicativo.

     

   • Escolha " WhatsApp " para configuração.

     

     • Obs: Se ocorrer alguma mensagem de alerta da Meta, como o exemplo a seguir, deve solicitar a analise da conta seguindo o tutorial a seguir >>Tutorial <<

       

   • Selecione sua conta empresarial Meta (Facebook) (se não for selecionada na etapa 2).

   • Navegue até Configurações do aplicativo > Básico na barra lateral

     

   • Defina o URL da Política de Privacidade para https://viasoft.com.br/politica-de-privacidade/

     

   • Salve as alterações.

   • Defina o modo de aplicativo como ativo.

     

Etapa 3: Gerar token do WhatsApp

Para obter um token de acesso permanente do WhatsApp, siga 1 a 3 etapas:

1. Crie um “Usuário do Sistema”:

   • Visite o Meta Business Suite .

   • Selecione a empresa que deseja configurar.

   • Vá para Usuários  >  Usuários do sistema.

     

   • Adicione um usuário do sistema Admin .

     

2. Adicione ativos.

   • Após criar o usuário do sistema, clique em Adicionar Ativos .

     

   • Navegue até Aplicativos > " Nome do seu aplicativo ".

   • Selecione seu aplicativo e conceda controle total para gerenciá-lo.

     

3. Gere tokens de acesso de usuário do sistema.

   • Clique no botão Gerar Novo Token no usuário do sistema.

     

   • Escolha o aplicativo que usará o token e defina a expiração do token como Nunca.

     

   • Selecione as permissões " whatsapp_business_messaging " e " whatsapp_business_management ".

     

   • Gere o token.

   • Copie o token de acesso e armazene-o com segurança.

     

4. Adicione um novo número comercial para WhatsApp

   • Volte para a pagina de desenvolvedor da Meta https://developers.facebook.com/

   • Você pode usar seu próprio número comercial ou o número de teste fornecido para seu chatbot do WhatsApp.

   • No Painel do desenvolvedor do WhatsApp , navegue até WhatsApp > Configuração da API na barra lateral.

     

   • Prossiga para a " Etapa 5: Adicionar um número de telefone " e clique em Adicionar número de telefone .

     

   • Forneça os detalhes necessários no formulário a seguir.

     

   • Informe o Nome que será exibido no WhatsApp, escolha um nome apropriado que siga as diretrizes da Meta. A categoria informe como Serviços Profissionais ou que melhor caracterize o ramo de atuação da sua empresa. A Descrição é opcional, portanto não é obrigatório o preenchimento desse campo.

     

   • Se o número atualmente estiver sendo usado no WhatsApp, deverá proceder com a exclusão da conta para depois poder incluir aqui, procedimento para exclusão da conta https://faq.whatsapp.com/2138577903196467/?locale=pt_BR&cms_platform=iphone .

     

   • Se tudo estiver certo com o número será enviado um código de verificação, informe ele no campo.

   • Depois de adicionado com sucesso, selecione seu número de telefone na Etapa 1 da configuração da API .

     

5. Adicione uma forma de pagamento

   • Para enviar mensagens via WhatsApp, você precisa de uma forma de pagamento válida. Visite aqui para obter detalhes.

   • Depois de adicionar seu número de telefone comercial, clique em " Adicionar forma de pagamento " para resolver o alerta " Método de pagamento válido ausente ".

     

   • Você será direcionado para a pagina de configuração do negócio. Clique em “Cobrança e pagamentos”.

     

   • Você será direcionado para as configurações da sua conta do WhatsApp. Clique em " Métodos de pagamento " > " Adicionar método de pagamento comercial " e siga as instruções para adicionar as informações do seu cartão.

     

6. Teste seu novo número comercial para WhatsApp

   • Retorne ao Painel do desenvolvedor do WhatsApp, navegue até Configuração da API > Etapa 1 .

   • Insira um número de teste " Para ".

   • Clique em " Enviar mensagem " para verificar a entrega bem-sucedida da mensagem.

     

Etapa 4: Definir as configurações do Webhook da API do WhatsApp

1. Verifique o retorno de chamada do WhatsApp Webhook.

   • No Painel do desenvolvedor do WhatsApp, navegue até Configuração .

   • Em Webhook , clique em editar

     

   • Acesse o seu Orion, clique no menu “Viasoft Assistente”, depois clique em “Configurações”.

     

   • Habilite as seguintes opções: Agendamentos - API Oficial e API Oficial.

     

   • Copie a URL do campo “Webhook Url (Meta)” e o “Webhook Verify Token (Meta)”.

     

   • Informe a URL https://api-vswhatsapp.viasoft.com.br e o Token nos respectivos campos:

     

   • Clique em Verificar e salvar

2. Configurar campo de assinatura do Webhook

   • Em " Campos de Webhook ", clique em Gerenciar .

     

   • Encontre o campo " mensagens " e inscreva-se marcando a caixa.

     

Etapa 5: Adicione uma conta do WhatsApp ao seu Chatbase Chatbot

1. Recupere informações da conta do WhatsApp

   • No Painel do desenvolvedor do WhatsApp, navegue até Configurações do aplicativo > Básico

   • Copie o segredo do aplicativo e cole-o no modal de integração do chatbase no Facebook App Secret

     

   • Cole o token de acesso permanente gerado na Etapa 3.3 https://nimitz.atlassian.net/wiki/spaces/TD/pages/3510239239/Integra+o+Whatsapp+API#Etapa-3%3A-Gerar-token-do-WhatsApp no campo “Token (Meta)” nas configurações do Viasoft Assistente.

     

   • Copie seu ID do número de telefone para o modal de integração das configurações do Viasoft Assistente.

     

   • Cole o seu ID do número de telefone no campo “Phone Number Id (Meta)” nas configurações do seu Viasoft Assistente.

     

Conclusão

Parabéns por completar a configuração do seu Viasoft Assistente com a integração da API oficial do WhatsApp! Agora, seu aplicativo está pronto para enviar e receber mensagens, o que pode ampliar significativamente a capacidade de comunicação e interação da sua empresa com seus clientes.