Avançar para o conteúdo principal

Integrar com o Google Business Messages

O Google Business Messages é uma plataforma de mensagens desenvolvida pelo Google para permitir que as empresas se comuniquem diretamente com os seu clientes por meio de aplicações de mensagens populares, como o Google Maps, Pesquisa Google e o Google Assistente. Com essa ferramenta, as empresas podem oferecer suporte ao cliente, responder a perguntas, agendar compromissos, realizar vendas e muito mais, tudo dentro da interface familiar de mensagens instantâneas.

Os clientes podem iniciar uma conversa com as empresas por meio dos perfis empresariais nos serviços do Google, proporcionando uma experiência conveniente e familiar. Essa abordagem permite uma comunicação direta e personalizada, ajudando as empresas a fornecer um atendimento ao cliente eficiente e satisfatório.

 

Para integrar o nosso chat com o Google Business Messages, terá de ter uma conta Google e ir à página Business Comunications.

Clique em "Criar Agente"

 

image-1710798711493.png

 

Isto irá abrir um painel onde tem de colocar a sua marca (ou  pode criar uma, clicando na seta). Coloque também o nome do agente que desejar. No fim clique em "Criar agente" para guardar.

 

image-1710799109213.png

 

Após uns segundos, o seu agente será criar e aparecerá na janela anterior.

 

image-1710799331705.png

 

Clique no mesmo e, depois, à esquerda, clique em Integrações.

 

image-1710799373578.png

 

Na caixa "Webhook" clique em configurar.

 

image-1710799479003.png

 

Ao fazer isto, abrir-se-á um painel com dois campos para inserir o "URL do terminal do webhook" e o "Token do cliente".

 

image-1710799589230.png

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

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

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

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

image-1707747540130.png

Clique em copy, para copiar o código e cole no campo de "Token do cliente".

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

image-1710799770028.png

 

 

NÃO clique em "Verificar" ainda. 

 

 

Primeiro, terá de criar uma plataforma na sua instância com o "Token do cliente", para que o Google 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-1707748139823.png

 

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

 

image-1710800032491.png

 

Dê o nome à sua plataforma e coloque o URL de Integração da sua instância no campo "URL do webhook". Coloque, também, o mesmo token que criou anteriormente no campo "Token do cliente". Mantenha o módulo de configuração ativado e faça "Guardar".

 

image-1710800509234.png

 

Depois de fazer "Guardar", volte ao painel da configuração do Google Business Messages e clique em "Verificar". Se estiver tudo bem, o painel irá fechar e, no canto superior direito irá aparecer a mensagem seguinte:

 

image-1710801168088.png

 

Clique, agora, nas "Configurações da conta do parceiro", que se encontra no canto superior direito, com o ícone em baixo.

 

image-1710802565311.png

 

Depois, clique em "Conta de serviço"

 

image-1710802630450.png

 

Clique, agora, em "Criar chaves"

 

image-1710802837867.png

 

No painel seguinte, confirme a criação da mesma. A chave é um ficheiro que será descarregado para a pasta de "downlaods" do seu computador. Será um ficheiro .json que pode abrir arrastando apra uma janela do seu navegador WEB.

Deverá ser algo semelhante à imagem em baixo:

 

image-1710803217463.png

 

Selecione o texto todo e faça "copiar".

Agora volte ao Gestor EBBS e às configurações da sua plataforma. Cole o texto no campo "Google Business Messages Json keys".

Faltando agora apenas o campo do "ID da marca", volte ao Google Business Messages e clique em "Comunicações Empresariais" no canto superior esquerdo ou siga para a página Business Comunications.

Clique no agente que criou anteriormente. Deverá abrir uma página semelhante à que se encontra em baixo. Copie o "ID da marca" e cole nas configurações da plataforma no Gestor EBSSS.

 

image-1710803605477.png

 

No final, a configuração da plataforma deverá estar deste modo:

 

image-1710803768248.png

 

Não se esqueça de desativar o "Modo Configuração", pois isto é só necessário durante a verificação.

Para partilhar os links de 

 

image-1710870960236.png

 

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-1711109975302.png

 

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