Integração Whatsapp API

Owned by Luciano César Ascari
Last updated: May 24, 2024 by Lucca Fabro
7 min read

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.

      image-20240502-125157.png

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

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

      image-20240502-135334.png

    • 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:

Sua empresa está proibida de fazer publicidade, incluindo o compartilhamento de aplicativos.

Your business is prohibited from advertising, including app sharing.

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”:

  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/webhook e o Token (XMTiZSz7hW7UHvJqBXjeEzxWBU1RMvN0URhwByPDf44Ytpv122f7ddd665c3) 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

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.