# Webmail (Gmail)

A integração de Webmail com o Gmail permite que você centralize sua comunicação por e-mail diretamente no Z-PRO. Com essa configuração, sua equipe poderá receber as mensagens na caixa de entrada unificada e responder aos e-mails diretamente pelo painel de atendimento.

Para que a integração funcione corretamente (tanto para recebimento quanto para envio de respostas), é necessário configurar um aplicativo no Google Cloud Console e gerar uma Senha de App no Gmail. Siga o passo a passo abaixo:

#### Passo 1: Criar o Aplicativo no Google Cloud Console

1. Acesse o **Google Cloud Console** e faça login com a conta do Google que deseja vincular.
2. Crie um **Novo Projeto** e dê um nome a ele (ex: "ZPRO Email").
3. Na barra de pesquisa superior, busque por **"Gmail API"** e clique em **Ativar**.
4. Antes de criar as credenciais, você precisa configurar a tela de permissão. No menu lateral, vá em **Tela de consentimento OAuth**.
5. Selecione a opção "Externo" (se aplicável), clique em **Criar** e preencha os dados obrigatórios, como o nome do app e o e-mail de suporte.
6. Após criar a tela de consentimento, é necessário colocar o aplicativo em produção. Clique em **Publicar App**.

#### Passo 2: Gerar as Credenciais OAuth

1. No menu do Google Cloud, vá até **Credenciais** e clique em **Criar Credenciais** -> **ID do cliente OAuth**.
2. No tipo de aplicativo, escolha **Aplicativo da Web** e defina um nome.
3. Na seção "URIs de redirecionamento autorizados", você deve adicionar a URL do seu frontend acompanhada do callback do Gmail.
   * *Exemplo:* `https://app.seudominio.com.br/gmail_callback.html`.
4. Clique em **Criar**. O Google irá gerar o seu **ID do Cliente** e o seu **Client Secret**. Mantenha essa tela aberta para copiar os dados.

#### Passo 3: Configurar o Canal no Z-PRO

1. Acesse o painel Admin do Z-PRO, vá no menu **Canais** e adicione um novo canal do tipo **Webmail**.
2. Dê um nome para o canal (ex: "Suporte Gmail").
3. **Importante:** Salve o canal antes de prosseguir para a próxima etapa.
4. Após salvar, clique para **Editar** o canal que você acabou de criar e vá na opção **Configurar OAuth**.
5. Uma tela do Google será aberta. Selecione a conta de e-mail desejada, conceda as permissões necessárias e conclua a autenticação.
6. Ao voltar para a edição do canal, o status deverá constar como "Autenticado". Clique em **Conectar**.

Neste momento, o Z-PRO já estará apto a receber os e-mails.

#### Passo 4: Configurar o SMTP para Envio de Respostas

Para que você consiga enviar as respostas pelo painel de atendimento, é obrigatório configurar a saída (SMTP) utilizando uma Senha de App do Google.

1. Acesse as configurações da sua Conta do Google (myaccount.google.com).
2. Vá na aba **Segurança** e certifique-se de que a **Verificação em duas etapas (2FA)** está ativada.
3. Na barra de pesquisa das configurações do Google, busque por **"Senhas de app"**.
4. Crie uma nova senha (dê um nome como "ZPRO SMTP") e o Google gerará uma senha de 16 letras.
5. Retorne ao Z-PRO, edite o seu canal de Webmail e preencha a configuração de **SMTP**:
   * **Usuário:** Seu endereço de e-mail remetente.
   * **Senha:** Cole a Senha de App de 16 letras gerada no Google (certifique-se de remover os espaços entre as letras).
6. Salve as configurações.

{% hint style="warning" %}
Se o sistema gerar algum erro de autenticação ou falha na hora de enviar a mensagem, exclua a senha anterior no painel do Google e recrie uma nova Senha de App. Depois, basta atualizar a nova senha nas configurações do canal no Z-PRO e salvar novamente.
{% endhint %}

{% embed url="<https://www.loom.com/share/29429819aae543faacbfb44c2901c31d>" %}

***

#### Como Receber e Responder E-mails na Tela de Atendimento

Com a integração finalizada, o fluxo de comunicação via e-mail ocorrerá de forma nativa na sua caixa de entrada unificada:

* **Recebendo um e-mail:** Toda vez que um cliente enviar uma mensagem para a sua conta do Gmail vinculada, ela chegará automaticamente na tela de **Atendimentos** do Z-PRO, gerando um novo ticket de conversa.
* **Enviar um e-mail:** Para enviar um e-mail, clicar no icone na tela de atendimento e preencha os dados de envio.

<figure><img src="/files/g0vG6tfslTi86LElTWcp" alt=""><figcaption></figcaption></figure>


---

# 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://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webmail-gmail.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.