> For the complete documentation index, see [llms.txt](https://ajuda.norux.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.norux.chat/admin/configuracao-e-administracao/webmail-gmail.md).

# Webmail (Gmail)

## Webmail (Gmail)

A integração de Webmail com o Gmail permite que você centralize sua comunicação por e-mail diretamente no Norux. 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: "Norux 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 Norux**

1. Acesse o painel Admin do Norux, 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 Norux 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 "Norux SMTP") e o Google gerará uma senha de 16 letras.
5. Retorne ao Norux, 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 Norux e salvar novamente.
{% endhint %}

***

**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 Norux, 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://ajuda.norux.chat/admin/configuracao-e-administracao/webmail-gmail.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.