
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:
- 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.
- Acesse Configurações → Integrações, clique no card Conta Azul e preencha Client ID e Client Secret.
- Clique em Abrir login do Conta Azul, entre com sua conta e autorize. Você será redirecionado — copie o valor de
codeda URL (ou cole a URL inteira). O código vale por 3 minutos. - 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
- Gatilho Disparo agendado (diário) + fonte Conta Azul — Contas a receber, modo a vencer, 3 dias;
- 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?";
- 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.