Principal Integrações Integração Conta Azul

Integração Conta Azul

Última atualização em Aug 20, 2026

Integração Conta Azul

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.