# Integração Conta Azul

![Integração Conta Azul](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN3BsQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a3bba7a5a415758d36bd8d55802eec77fe492fbc/simplesdesk-contaazul.png)

Conecte o **Conta Azul** ao SimplesDesk e responda perguntas financeiras sem trocar de tela: o Agente de IA localiza o cliente, consulta as contas a receber com valor e vencimento e traz o resumo financeiro do período — e os fluxos automatizam o lembrete de vencimento com a fonte de contas a receber.

## Quando utilizar

- Sua gestão financeira é no Conta Azul e o time atende pelo WhatsApp;
- Você quer **réguas de cobrança** (lembrete de conta a vencer, aviso de atraso) sem planilha;
- Atendimento com **Agente de IA** que informa situação e vencimento das cobranças do cliente na conversa.

## Como conectar

A conexão usa o **login oficial do Conta Azul (OAuth)** — você autoriza o acesso na tela do próprio Conta Azul:

1. Crie sua aplicação no **Portal de Desenvolvedores do Conta Azul** para obter o **Client ID** e o **Client Secret**. A **URL de redirecionamento** deve ser exatamente a configurada na aplicação.
2. Acesse **Configurações → Integrações**, clique no card **Conta Azul** e preencha Client ID e Client Secret.
3. Clique em **Abrir login do Conta Azul**, entre com sua conta e autorize. Você será redirecionado — copie o valor de `code` da URL (ou cole a URL inteira). O código vale por **3 minutos**.
4. Cole o **código de autorização** e clique em **Conectar**.

O código é trocado por tokens de acesso e a **renovação depois é automática** — se a autorização for revogada no Conta Azul, basta reconectar pelo card.

Com a conta conectada, três frentes ficam disponíveis: **Agente de IA**, **nós de fluxo** e **fonte de contatos para disparos agendados**.

---

## Agente de IA

Nas configurações do assistente (**Central IA → seu assistente → Integrações**), ative o **Conta Azul**. A IA passa a fazer:

| Grupo | O que a IA passa a fazer |
| --- | --- |
| **Cliente** | Localizar o cliente no Conta Azul pelo CPF/CNPJ ou nome — sempre o primeiro passo antes das consultas |
| **Contas a receber** | Listar as contas a receber por período de vencimento (valor, vencimento e situação), filtrando pelo cliente vinculado |
| **Resumo financeiro** | Visão geral do período: total pago, vencido, vence hoje, pendente e em aberto (do escritório, não por cliente) |

---

## Nós de fluxo

No editor de fluxos, a paleta ganha a categoria **Conta Azul (ERP)** com dois nós que se encadeiam:

- **Conta Azul: Localizar cliente** — busca por CPF/CNPJ (campo aceita `{{variables.cnpj}}`); sem documento, busca pelo **Nome**. Salva `{{variables.contaazul_cliente_id}}`, `{{variables.contaazul_cliente_nome}}`, `{{variables.contaazul_cliente_documento}}` e `{{variables.contaazul_cliente_email}}`, e vincula o id ao contato para os próximos nós. Saída verde = encontrado, amarela = não encontrado.
- **Conta Azul: Contas a receber** — lista as contas do cliente localizado (ou de um **ID do cliente Conta Azul** informado) no período configurado (dias para trás / dias para frente). Salva `{{variables.contaazul_contas_count}}`, `{{variables.contaazul_contas_resumo}}` (pronto para mensagem) e a primeira conta: `{{variables.contaazul_conta_valor}}`, `{{variables.contaazul_conta_vencimento}}`, `{{variables.contaazul_conta_situacao}}`. Verde = encontrou, amarela = nada.

Em caso de erro do Conta Azul, a mensagem fica em `{{variables.contaazul_erro}}` para você tratar num caminho alternativo.

---

## Fonte de contatos: contas a receber por vencimento

No gatilho **Disparo agendado**, a fonte **"Conta Azul — Contas a receber"** busca as contas pelo vencimento e dispara o fluxo para cada cliente. Configure:

- **Modo** — "a vencer" ou "vencidas";
- **Dias** — a vencer EM n dias / vencidas HÁ n dias (padrão 1).

Cada disparo chega com as variáveis prontas: `{{variables.contaazul_cliente_nome}}` · `{{variables.contaazul_valor}}` · `{{variables.contaazul_vencimento}}` · `{{variables.contaazul_situacao}}` · `{{variables.contaazul_descricao}}` · `{{variables.contaazul_conta_id}}`.

> ⚠️ O disparo depende de o cliente ter **telefone ou e-mail** no Conta Azul — contas sem dado de contato são puladas.

### Exemplo: lembrete de vencimento

1. Gatilho **Disparo agendado** (diário) + fonte **Conta Azul — Contas a receber**, modo **a vencer**, 3 dias;
2. **Enviar Mensagem**: "Olá {{variables.contaazul_cliente_nome}}, sua cobrança de R$ {{variables.contaazul_valor}} vence em {{variables.contaazul_vencimento}}. Podemos ajudar com o pagamento?";
3. Na resposta, transfira para o time financeiro — ou deixe o **Agente de IA** assumir e detalhar as contas em aberto.

> 📗 Para dominar o editor, veja os tutoriais da categoria **Fluxos** — do primeiro fluxo ao gatilho de disparo agendado.

> 📘 Precisa de ajuda? Fale com nosso suporte pelo chat — é só chamar.