Avançar para o conteúdo principal

Integrar com WhatsApp

O WhatsApp é uma das plataformas de mensagens mais populares do mundo. Além de ser uma ferramenta de comunicação entre indivíduos, as empresas podem utilizar o WhatsApp para se conectem com seus clientes de maneira eficiente e conveniente.

Por meio do WhatsApp, as empresas podem criar perfis comerciais, fornecendo informações detalhadas sobre seus produtos e serviços, horário de funcionamento, endereço e muito mais. Isso permite que os clientes encontrem facilmente informações sobre a sua empresa e iniciem conversas diretamente da aplicação.

É possível integrar o nosso chat com o WhatsApp, oferecendo a possibilidade de receber e responder a mensagens do WhatsApp diretamente através da plataforma EBSSS.

 

ATENÇÃO: para que o chat do WhatsApp funcione corretamente é necessário antes configurar o Pusher. Veja aqui como fazer.

1. Criar APP do WhatsApp

 

Para começar a configurar a integração com o chat do WhatsApp, deverá antes criar uma APP na página para desenvolvedores do Meta .Meta. Para isso deve ir até https://developers.facebook.com/ e registar a sua conta, caso ainda não tenha uma.

 

Em cima, clique em "Aplicativos" e depois em "Criar aplicativo".

image-1707746135666.png

 

No painel seguinte, selecione "Outro" e depois em "Avançar".

 

image-1707746168907.png

Na página seguinte, selecione "Business" e faça "Avançar".

 

image-1707746292105.png

Dê um nome à sua APP e selecione o email que quer associar à mesma. Clique em Criar aplicativo para avançar para a próxima página.

 

Na página seguinte aparecerá a lista de produtos que pode adicionar à sua APP. Procure por "Webhooks" e clique em configurar.

 

image-1707746658072.png

 

Nesta página, onde tem "User", clique e selecione "Whatsapp Business Account". Depois, clique em "Subscribe to this object".

 

image-1709025890017.png

 

Ao fazer isto, abrir-se-á um painel com dois campos para inserir o "URL de retorno de chamada" e o "Token de verificação".

No "URL de retorno de chamada" deverá colocar o link de integração da sua instância. Deverá ser algo como:

  • URL - https://gestor.dominio.ebsss.eu/api/chat/whatsapp_api

Deve também criar um "Token de verificação"* que vai ser colocado tanto nesse campo, como no painel de configuração da plataforma da sua instância.

  • *O Verify Token é um componente de segurança da sua app no Facebook. Funciona como uma chave secreta que garante que apenas o Facebook possa enviar requests para sua app, protegendo-a contra acessos não autorizados. É recomendável usar um UUID (Universally Unique Identifier) como "Verify Token. Pode gerar o seu UUID no seguinte website: https://www.uuidgenerator.net/version4

image-1709030707799.png

Clique em copy, para copiar o código e cole no campo de "Token de verificação".

Após preencher os dados, deverá ficar semelhante à imagem abaixo:

image-1709838548791.png

 

 

NÃO clique em "Verificar e salvar" ainda. 

 

 

Primeiro, terá de criar uma plataforma na sua instância com o "Token de Verificação", para que o Facebook possa fazer a verficação.

Para isso, vá até à página de criação de plataformas da sua intância. Pode chegar a essa página através do Módulo Chat (1) > Configurações (2) > Plataformas. Depois, clique em "Adicionar".

 

image-1709838711732.png

 

Ao fazer isso, irá abrir um painel. Clique em "Adicionar" (em baixo) e selecione "Whatsapp".

image-1709838734939.png

 

Dê o nome à sua plataforma e coloque o mesmo token que criou anteriormente no campo "platforms.type.whatsapp.webhook-secret". Mantenha o módulo de configuração ativado e faça "Guardar".

 

image-1709885657011.png

 

Agora volte às configurações do Facebook e clique, então, em "Verificar e Salvar".

Se tudo estiver bem configurado será levado para a próxima página, onde poderá selecionar as subscrições que pretende.

Caso dê algum erro, veja o bloco abaixo.

 

ATENÇÃO: Se aparecer um erro semelhante ao abaixo, é possível que tenha algo mal nas configurações. 

image-1707749549483.png

Verifique se:
• ao criar a plataforma na sua instância, o switch do Modo Configuração está ativado
• o token que colocou em tanto neste no painel "Editar assinatura de Page" (no Facebook) como no da criação da plataforma de chat da sua instância são idênticos
• no painel de criação de plataforma de chat na sua instância está no campo "facebook-messenger.webhook-secret"
• fez "Guardar" após terminar de configurar a plataforma de chat na sua instância

 

Caso as configurações estejam corretas, será levado para a página seguinte:

image-1709839236940.png

 

Aqui, procure por "messages" e clique em "Subscribe".

 

image-1709839252060.png

 

No menu lateral da esquerda, clique em "Configurações do app"

 

image-1709839353074.png

 

Desta página pode copiar o "ID do Aplicativo" e colar no campo "APP ID" nas configurações da Plataforma.

image-1709840665197.png

 

Agora, faltam apenas dois campos para preencher, o "Token do Utilizador" e o "ID WhatsAPP Business Account". Não feche esta janela, pois vai precisar de preencher o resto dos campos.

Clique agora em "Painel"

image-1709841005385.png

Procure pelo WhatsApp e clique em configurar

 

image-1709886177443.png

 

Isto irá abrir a janela de Início Rápido

 

image-1709886552946.png

 

Clique em continuar.

Agora, no painel da esquerda, clique em Configuração da API do WhatsApp.

 

image-1709887042768.png

 

Na página seguinte, copie a identificação da conta e cole nas configurações da plataforma.

Adicione, também, o número de telefone que vai utilizar. É fornecido um para efetuar testes, mas pode adicionar o número de telefone que vai usar no seu negócio. Para isso clique da barra onde aparece o telefone e depois em "Adicionar telefone"

 

ATENÇÃO: Quando copiar o telefone para a configuração da plataforma, não inclua o símbolo "+" do indicativo e também não inclua espaços

 

image-1709887802903.png

image-1709888986333.png

 

Agora, fica apenas a falta o "Token do Utilizador".

No painel da esquerda clique em "Início Rápido" do aplicativo "WhatsApp".

 

image-1709908976425.png

 

Caso apareça um quadro da plataforma de WhatsApp Business, faça Continuar.

Clique em Informações da conta.

 

image-1710780348584.png

 

Isto irá abrir uma nova página. No painel da esquerda, em baixo, clique no ícone da roda dentada (Business Settings).

 

image-1710780526683.png

 

Clique depois, em cima, em System users.

 

image-1710780743617.png

 

Na página seguinte adicione um novo administrador de conta:

  1. Clique em Add
  2. Prencha o campo do nome do administrador
  3. No campo System user role selecione Admin
  4. Clique em Create system user

 

image-1710782297868.png

 

De seguida clique em "Assign Assets"

 

image-1710781950456.png

 

No painel que irá abrir, clique em Apps e selecione todas as opções. No final faça guardar.

 

image-1710782659201.png

 

Clique, agora, em "Generate new token".

 

image-1710783094420.png

 

No painel seguinte selecione a sua App e depois escolha o tempo de expiração do token. Se selecionar 60 dias terá de criar um novo token quando expirar. Pode selecionar Nunca para criar um token que não expira.

Em baixo, nas permissões, procure por whatsapp_business_messaging. Selecione a caixa e clique em "Generate token".

 

image-1710783744631.png

 

Isto irá abrir um novo painel conde aparece o token para utilizar na plataforma EBSSS.

 

image-1710784253935.png

 

Copie este token e coloque-no na configuração da Plataforma que criou para WhatsApp as configurações da sua instância EBSSS.

 

Nota: Antes de gravar desative o botão "Modo Configuração". Isto deve estar ativado só durante a configuração.

 

image-1710785322793.png

 

Faça "Guardar". Agora já deve receber mensagens através do WhatsApp.

 

2. Associar plataforma ao canal de comunicação

 

Finalmente deverá associar a plataforma ao canal de comunicação.

 

NOTA: se ainda não sabe o que são ou como criar canais, veja aqui como fazê-lo.

 

Para isso deve ir até ao Módulo Chat (1) > Gestão (2) > Canais (3)

image-1706805718090.png

 

Aqui, ao criar ou editar um canal, deverá selecionar a plataforma que acabou de criar e, também, um horário.

 

image-1711107934467.png

 

Faça "Guardar". Agora, quando receber uma mensagem, esta irá aparecer na página de conversas.