> For the complete documentation index, see [llms.txt](https://usefin.gitbook.io/guia-fin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://usefin.gitbook.io/guia-fin/automacoes/bling/adicionando-gmail-ao-agente-de-contas-a-pagar.md).

# Adicionando Gmail ao Agente de Contas a Pagar

{% hint style="info" %}
**Tempo estimado:** 5 minutos para completar todo o setup.
{% endhint %}

{% hint style="warning" %}
**Pré-requisito:** Você já deve ter uma empresa cadastrada com integração ativa ao Bling. Se ainda não configurou, siga primeiro o guia [\[Automatizando Contas a Pagar com Bling\]](/guia-fin/automacoes/bling/automatizando-contas-a-pagar-com-bling.md)
{% endhint %}

***

### O que você vai configurar

Ao final deste guia, você terá:

* Um agente que monitora sua caixa de entrada do Gmail automaticamente
* Extração inteligente de dados de boletos e notas fiscais recebidos por email
* Lançamento automático das contas a pagar direto no Bling ERP

***

### Parte 1 — Encontrando o Template na Fin Store

#### 1. Acesse a Fin Store

No menu lateral, clique em **Fin Store** para abrir o Marketplace de Agentes Pré-Prontos.

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

***

#### 2. Filtre por destino Bling

Use o filtro de destinos para encontrar rapidamente os agentes compatíveis com o Bling. Clique no dropdown **"Todos os destinos"** e selecione **Bling**.

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

***

#### 3. Selecione o Template Gmail + Bling

Após filtrar, você verá os agentes disponíveis para o Bling. Encontre o card **"Lançador de Contas a Pagar - Bling (Gmail)"** e clique em **Ver detalhes**.

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

***

#### 4. Revise os detalhes do agente

O modal de detalhes mostra tudo que o agente oferece:

* **Fluxo:** Gmail → Processamento Fin v1 → Bling
* **Funcionalidades:** Monitoramento do Gmail, extração automática, lançamento direto no Bling, matching com provisionados, criação automática de fornecedores

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

Clique em **Usar este agente** para avançar.

***

### Parte 2 — Configurando o Agente

#### 5. Selecione a empresa

No step de criação, selecione a empresa que já possui integração com o Bling.

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

Abaixo da seleção, você verá o resumo da configuração do agente:

* **Configurações do Gmail:** filtro por assunto, requer anexo, etiqueta após processamento
* **Configurações de Processamento:** aprovação automática, cadastro de fornecedores
* **Configurações do Bling:** envio automático, tentativas em caso de erro

***

#### 6. Configure a integração com Gmail

Após selecionar a empresa, um aviso indicará que a integração com o Gmail precisa ser configurada. Clique em **Configurar**.

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

***

#### 7. Conecte sua conta Gmail

Na tela de configuração de integrações, você verá:

* **Gmail** — Entrada: não conectado
* **Bling** — Destino: já conectado

Clique no botão **Conectar Gmail** para iniciar a autorização com o Google.

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

{% hint style="info" %}
Uma nova janela será aberta para você fazer login na sua conta Google e autorizar o acesso do Fin ao Gmail.
{% endhint %}

***

#### 8. Autorize o acesso no Google

Uma nova aba será aberta com a tela de autorização do Google. Como o Fin ainda está em processo de verificação pelo Google, você verá um aviso de segurança.

{% hint style="warning" %}
**Sobre a verificação do Google:** O Fin está atualmente passando pelo processo de validação do Google. Essa tela aparece para todos os aplicativos em fase de aprovação. **Seus dados estão seguros** — o Fin solicita apenas acesso de leitura aos emails para processar documentos financeiros.
{% endhint %}

**Passo 1:** Na tela de aviso, clique em **Advanced** (Avançado).

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

**Passo 2:** Clique em **Go to Fin Automação Financeira (unsafe)** para prosseguir.

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

**Passo 3:** Revise as permissões solicitadas e clique em **Continue** para autorizar.

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

{% hint style="info" %}
O Fin solicita permissão para **ler, compor e enviar emails** da sua conta Gmail. Essa permissão é usada para monitorar emails com documentos financeiros e aplicar etiquetas após o processamento.
{% endhint %}

***

#### 9. Integração confirmada

Após autorizar, uma tela de confirmação será exibida. Você pode fechar essa janela.

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

{% hint style="success" %}
Quando aparecer **"Integração Concluída"** com o ícone verde, sua conexão com o Gmail está ativa.
{% endhint %}

Volte à aba do Fin. Ambas as integrações agora estão conectadas:

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

Clique em **Continuar** para prosseguir.

***

### Parte 3 — Finalizando

#### 10. Adicionando módulos ao agente existente

Se sua empresa já possui um agente de Contas a Pagar configurado (por exemplo, com entrada via WhatsApp), o Fin detecta automaticamente e oferece **adicionar o Gmail como novo módulo de entrada** ao agente existente, sem precisar criar um novo.

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

Você verá:

* **Já configurados:** os módulos existentes (ex: WhatsApp como entrada, Bling como destino)
* **Novos módulos:** Gmail como nova entrada, já selecionado

Clique em **Adicionar módulos** para finalizar.

{% hint style="info" %}
Se sua empresa **não** possui um agente de Contas a Pagar, o Fin criará um novo agente automaticamente ao clicar em **Criar Agente**.
{% endhint %}

***

#### 11. Agente atualizado

Pronto! O módulo do Gmail foi adicionado ao seu agente. Você verá a confirmação na lista de agentes.

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

***

#### 12. Verifique os módulos configurados

Clique no agente para ver os detalhes. Na aba **Módulos**, confirme que o Gmail aparece como módulo de entrada ao lado do WhatsApp.

<figure><img src="/files/4wJtUdRgmSmnAevaNVge" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
A partir de agora, o Fin monitora automaticamente sua caixa de entrada do Gmail. Boletos e documentos financeiros recebidos por email serão processados e lançados como contas a pagar no Bling.
{% endhint %}

***

### Próximos Passos

Agora que seu agente está configurado com Gmail + Bling, você pode:

* **Enviar um email de teste** com um boleto em anexo para validar o fluxo
* **Acompanhar o processamento** na página de Lançamentos, no menu de Contas a Pagar
* **Aprovar ou ajustar** lançamentos antes de enviá-los ao Bling
* **Personalizar as configurações** do Gmail (filtro por assunto, remetentes permitidos, etiquetas) editando o agente


---

# 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:

```
GET https://usefin.gitbook.io/guia-fin/automacoes/bling/adicionando-gmail-ao-agente-de-contas-a-pagar.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.