# Google Business Messages

O Google Business Messages é um canal de conversação móvel que visa facilitar a comunicação entre empresa e cliente. O acesso ao chat pode ser realizado por pesquisas diretas do Google, no Maps ou então nos sites das marcas.

## Compatibilidade

**Informações aceitas:**

* Texto

**Envios possíveis:**

* Texto

{% hint style="info" %}
Não é aceito formatações como negrito e itálico.
{% endhint %}

* Arquivo:
  * &#x20;Imagens nos formatos jpeg, jpg e png, que serão apresentadas no modo visualização. Outros tipos de arquivos serão apresentados como um link para download.
* Quick Replies
* Carrossel
* Lista de Opções Modal e Inline
  * Possuem um limite de 13 itens, acima disso o componente será apresentado como uma lista, tal qual no WhatsApp.&#x20;

{% hint style="info" %}
Lembre-se que ao utilizar uma Lista de Opção você deve adicionar o campo `pick` no objeto do input. Caso contrário, a frase “Escolha uma das seguintes opções:” será apresentada por padrão.
{% endhint %}

## Configurações

Para começar, solicite para a equipe responsável a criação do agente em: <suporte@smarkio.com.br>&#x20;

{% hint style="info" %}
Certifique-se de ter realizado as configurações que são pré-requisitos.
{% endhint %}

Ao acessar, crie um novo agente:

![](/files/-M_0eL-I_Y8i3nu2Mj0c)

Em seguida, adicione o nome da marca e o nome do agente:

![](/files/-M_0eQt3MgB4zQ7XrF4V)

{% hint style="info" %}
Você pode consultar mais informações para criar o agente [no site do Google.](https://developers.google.com/business-communications/business-messages/guides/quickstarts/echo-agent)
{% endhint %}

Para realizar as configurações do canal na página do Zenvia NLU deve-se ter em mãos:

* **id do agente personalizado:** utilizado para identificar o seu agente
  * Defina o id personalizado em **Configuração > Informação do Agente** no console do Google Business Messages.

![](/files/-M_0ejn9URvY8crKuqH_)

* **partner key:** chave para validar que as mensagens são do Google. Após registrar com o Business Messages, esta chave é enviada por e-mail pelo Google assim que o projeto for registrado.

No Zenvia NLU vá até **Connect > Canais > Whatsapp > Google BM**, na tela **"Integrações com Google Business Messages"** clique no botão ➕ para criar uma nova integração e preencha os seguintes campos:

![](/files/-MYjEsVdghy5LOTSXz4X)

* **Nome:** nome da sua integração
* **Assistente:** o assistente que será vinculado à essa integração
* **Squads:** o grupo de usuários que terá acesso a este recurso
* **Custom Agent Id:** id do agente personalizado, definido nas configurações do agente no Google
* **Usar minhas credenciais do GBM (opcional):**&#x20;
  * **Private Key Id:** private\_key\_id ( .json gerado ao criar a chave)
  * **Client E-mail:** client\_email ( .json gerado ao criar a chave)
  * **Private Key:** private\_key ( .json gerado ao criar a chave)
  * **Partner Key:** chave de parceiro, encontrada nas informações de e-mail enviado pelo Google após registrar seu projeto
* **Mensagens para mídias não suportadas:** mensagens que serão exibidas caso o usuário envie um tipo de mensagem não suportado
* **Ids de Conversas de Homologação:** id de conversas para teste do fluxo de atendimento. Você encontra este id no contexto do atendimento, em gbm.conversationId

Após a criação do canal, clique no botão "editar" para configurar mais algumas informações, como:

* **Inatividade:** ao marcar essa opção o assistente será reiniciado ao identificar a inatividade do usuário após o tempo definido
* **Webhooks:** chave de API que permite ao seu assistente Zenvia NLU receber as mensagens enviadas pelos usuários. Deve ser a mesma chave utilizada na configuração de webhook em sua conta Take

Utilize as informações na seção WhatsApp para configurar o[ webhook](/connect/apis/outbound.md) de mensagens.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.altu.d1.cx/connect/canais/google-business-messages.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
