> 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/omie/automatizando-contas-a-pagar-com-gmail.md).

# Automatizando Contas a Pagar com Gmail

{% embed url="<https://youtu.be/jUwtJ0FXlQA>" %}

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

{% hint style="info" %}
**Pré-requisito:** Você já deve ter uma empresa cadastrada com integração ativa ao Omie. Se ainda não configurou, siga [primeiro o guia de configuração inicial](/guia-fin/primeiros-passos/setup.md) do Omie.
{% 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 Omie 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/WJEKT3mQS0PcBplrINU5" alt=""><figcaption></figcaption></figure>

***

#### 2. Filtre por destino Omie

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

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

***

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

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

<figure><img src="/files/XwQfPfqkGa7pPPJwtgcK" 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 → Omie ERP
* **Funcionalidades:** Monitoramento do Gmail, extração automática de dados, lançamento direto no Omie, matching com provisionados, criação automática de fornecedores

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

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

***

### Parte 2 — Configurando o Agente

#### 5. Revise a configuração

No step de criaçã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 Omie:** envio automático, tentativas em caso de erro

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

***

#### 6. Selecione a empresa e configure a integração

Selecione sua empresa no dropdown. Um aviso indicará que a integração com o Gmail precisa ser configurada. Clique em **Configurar**.

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

***

#### 7. Conecte sua conta Gmail

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

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

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

<figure><img src="/files/ArndZOp3ufvULKLixmFn" 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/5GEAssj8V6o9KMv93LTm" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/5ZfJ0EoNIr4d1bAO4sF3" 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/Pf2it0vK9RmEVKnAXmWj" 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/me5W1lUSbSoX6k1nPbG6" alt=""><figcaption></figcaption></figure>

Clique em **Continuar** para prosseguir.

***

### Parte 3 — Criando o Agente

#### 10. Crie o agente

Após concluir as integrações, você volta ao step de criação com tudo pronto. A empresa já está selecionada e as configurações revisadas.

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

Clique em **Criar Agente** para finalizar.

{% hint style="success" %}
Seu agente será criado e ativado automaticamente.
{% endhint %}

***

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

Na página do agente, acesse a aba **Módulos** para confirmar que tudo foi configurado corretamente:

* **Módulo de Entrada:** Gmail
* **Módulo de Processamento:** Regras Fin
* **Módulo de Saída:** Omie ERP

<figure><img src="/files/9uGBgOGWSYGrfTiHgJEx" 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 Omie.
{% endhint %}

***

### Próximos Passos

Agora que seu agente está configurado com Gmail + Omie, 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 Omie
* **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/omie/automatizando-contas-a-pagar-com-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.
