> For the complete documentation index, see [llms.txt](https://centralhub-ajuda.wlksistemas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://centralhub-ajuda.wlksistemas.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webmail-gmail.md).

# Webmail (Gmail)

Esta conexão permite vincular diretamente uma conta do Gmail (ou Google Workspace) à Central Hub via OAuth do Google, transformando e-mails recebidos em tickets de atendimento.

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

1. Acesse o [Google Cloud Console](https://console.cloud.google.com/) com a conta Google que será usada no canal (ou uma conta administrativa do Google Workspace).
2. Crie um novo projeto (ou selecione um existente).
3. No menu lateral, acesse **APIs e serviços → Tela de consentimento OAuth**.
4. Selecione o tipo de usuário (Externo, na maioria dos casos) e preencha as informações básicas do aplicativo (nome, e-mail de suporte, domínio, se aplicável).
5. Em **Escopos**, adicione os escopos do Gmail necessários para leitura e envio de e-mails (`gmail.readonly`, `gmail.send`, `gmail.modify`, conforme a necessidade).
6. Adicione os e-mails de teste (durante a fase de testes do app) que irão utilizar a integração.

## Etapa 2: Gerar as Credenciais OAuth

1. No menu lateral, acesse **APIs e serviços → Credenciais**.
2. Clique em **Criar credenciais → ID do cliente OAuth**.
3. Selecione o tipo de aplicativo **Aplicativo da Web**.
4. Em **URIs de redirecionamento autorizados**, adicione a URL de callback fornecida pela Central Hub (disponível na tela de configuração do canal, Etapa 3).
5. Clique em **Criar** e copie o **ID do cliente** e a **Chave secreta do cliente** gerados — você vai precisar deles na Central Hub.
6. Ative a **API do Gmail** para o projeto em **APIs e serviços → Biblioteca**, caso ainda não esteja ativa.

{% hint style="warning" %}
Se o aplicativo estiver em modo de teste na tela de consentimento OAuth, apenas os e-mails cadastrados como testadores conseguirão autorizar a conexão. Caso o token expire ou a autorização pare de funcionar, pode ser necessário gerar uma nova senha de aplicativo/credencial e reconectar o canal.
{% endhint %}

## Etapa 3: Configurar o Canal na Central Hub

1. No painel Admin, acesse **Canais → Adicionar Canal** e selecione **Webmail (Gmail)**.
2. Informe o **ID do cliente** e a **Chave secreta do cliente** gerados na Etapa 2.
3. Clique em **Conectar com o Google** — uma janela do Google será aberta para você autorizar o acesso à conta de e-mail.
4. Faça login com a conta do Gmail que será usada no canal e conceda as permissões solicitadas.

SCREENSHOT NECESSÁRIO: vídeo/tela do fluxo de vinculação da conta Gmail.

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

Além da autorização OAuth (usada para leitura dos e-mails), configure os dados de **SMTP** do Gmail para o envio de respostas: servidor `smtp.gmail.com`, porta `587`, usuário (o e-mail conectado) e senha de aplicativo gerada na conta Google (**Conta do Google → Segurança → Senhas de app**), já que o Gmail exige esse tipo de senha quando a verificação em duas etapas está ativa.

## Como Receber e Responder E-mails

Com o canal conectado, os e-mails recebidos na caixa de entrada vinculada passam a chegar automaticamente como tickets na tela de atendimento da Central Hub. Você pode responder diretamente pela interface de chat, e a resposta será enviada como um e-mail normal a partir da conta conectada.

## Veja também

* [Visão geral de canais](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/visao-geral-de-canais.md)
* [E-mail](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/e-mail.md) — conexão de e-mail via IMAP/SMTP para outros provedores.

## Precisa de ajuda?

Fale com o suporte da Central Hub pelo WhatsApp: [(31) 997122-2063](https://wa.me/5531997122063).


---

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