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. Para isso deve ir até https://developers.facebook.com/ e registar a sua conta, caso ainda não tenha uma.

 

1.1. No topo clique em "Meus Apps".

image-1711117760012.png

Figura 1.a)

 

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

image-1707746135666.png

Figura 1.b)

 

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

image-1707746168907.png

Figura 1.c)

 

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

image-1707746292105.png

Figura 1.d)

 

1.5. 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.

image-1711382851158.png

 

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

image-1707746658072.png

Figura 1.e)

 

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

image-1709025890017.png

Figura 1.f)

 

2. Fazer a verificação do webhook

Após terminar o ponto 1.7. é necessário fazer a verificação da webhook. Ou seja, garantir que a ligação entre o Whatsapp e a plataforma EBSSS é segura e confiável. Isso não só assegura que as mensagens sejam entregues com sucesso, mas também ajuda a proteger a integridade dos dados e a privacidade dos utilizadores.

 

2.1. Quando fizer "Subscribe to this object" (ponto 1.7.), isso irá abrir 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

Figura 2.a)

 

2.2. 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

Figura 2.b)

 

 

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

 

 

2.3. 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

Figura 2.c)

 

Ao fazer isso, irá abrir um painel.

2.4. Clique em "Adicionar" (em baixo) e selecione "Whatsapp".

image-1709838734939.png

Figura 2.d)

 

2.5. 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

Figura 2.e) 

 

2.6. 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
Figura 2.f) 

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

Figura 2.g)

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

image-1709839252060.png

Figura 2.h)

 

3. Configurar tokens de acesso

Os tokens de acesso desempenham um papel vital na verificação da conexão entre o Whatsapp e seu site. Esses tokens atuam como chaves de autenticação, garantindo que apenas seu site tenha permissão para aceder e interagir com sua conta do Whatsapp. Isso não só protege a integridade dos dados do utilizador, mas também ajuda a manter a privacidade e a segurança da comunicação.

 

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

image-1709839353074.png

Figura 3.a)

 

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

image-1709840665197.png

Figura 3.b)

 

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.

 

3.3. Clique agora em "Painel"

image-1709841005385.png

Figura 3.c)

 

3.4. Procure pelo WhatsApp e clique em configurar

image-1709886177443.png

Figura 3.d)

 

3.5. Isto irá abrir a janela de Início Rápido.  Clique em continuar

image-1709886552946.png

Figura 3.e)

 

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

image-1709887042768.png

Figura 3.f)

 

3.7. 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

Figura 3.g)

image-1709888986333.png

Figura 3.h)

 

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

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

image-1709908976425.png

Figura 3.j)

 

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

 

3.9. Clique em Informações da conta.

image-1710780348584.png

Figura 3.k)

 

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

image-1710780526683.png

Figura 3.l)

 

3.11. Clique depois, em cima, em System users.

image-1710780743617.png

Figura 3.m)

 

3.12. 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

Figura 3.n)

 

3.13. De seguida clique em "Assign Assets"

image-1710781950456.png

Figura 3.o)

 

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

image-1710782659201.png

Figura 3.p)

 

3.15. Clique, agora, em "Generate new token".

image-1710783094420.png

Figura 3.q)

 

3.16. 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

Figura 3.r)

 

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

image-1710784253935.png

Figura 3.s)

 

3.17. 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

Figura 3.t)

 

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

 

4. Associar plataforma ao canal de comunicação

Para que o chat fique funcional é preciso criar um canal de comunicação e associar a plataforma configurada ao mesmo.

 

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

 

4.1. Vá até ao Módulo Chat (1) > Gestão (2) > Canais (3)

image-1706805718090.png

Figura 1.a)

 

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

image-1711107934467.png

Figura 1.b)

 

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