Integração Conta Azul com WhatsApp e IA: cobrança, boleto e cadastro sem digitar duas vezes

A integração entre Conta Azul e WhatsApp funciona pela API (interface que permite dois sistemas trocarem dados automaticamente) oficial da Conta Azul, ativa desde março de 2025, mas sem webhook (aviso automático que um sistema manda a outro quando algo muda) nativo: toda automação de cobrança, boleto ou cadastro de cliente depende de consultar a Conta Azul de tempos em tempos, o chamado polling, em vez de receber aviso automático do outro lado. Isso muda o desenho de qualquer projeto de integração conta azul whatsapp, porque a frequência da consulta decide se o cliente é avisado quase na hora do vencimento ou só no dia seguinte. A API exige o plano Conta Azul Pro ativo, com mensalidades a partir de R$ 159,90 no plano anual Essencial, e devolve um token de acesso que expira em 1 hora, renovado por um token de atualização que dura 2 semanas e vale só uma vez.

A API da Conta Azul exige plano Pro, token de 1 hora e não tem webhook nativo

A Conta Azul é um ERP (sistema de gestão financeira e operacional) usado por mais de 100 mil empresas brasileiras, segundo a própria fabricante. A versão atual da API, chamada v2, chegou em março de 2025 com base em api-v2.contaazul.com, e a versão anterior foi desligada, com recomendação oficial de migração até 5 de novembro de 2025. A autenticação usa OAuth2 (protocolo que autoriza o acesso de um sistema a outro sem expor a senha do usuário) no fluxo authorization code: o código de autorização vale só 3 minutos, o token de acesso expira em 1 hora e o token de atualização dura 2 semanas, de uso único. Pra atender mais de uma empresa é preciso repetir o fluxo inteiro por conta.

O limite de uso é de 600 chamadas por minuto e até 10 por segundo por conta conectada, com erro quando estoura, segundo a documentação oficial da API. Essa mesma documentação confirma que webhooks não existem: "a Conta Azul não possui essa tecnologia", de acordo com o FAQ de desenvolvedores, o que obriga qualquer automação a fazer polling em vez de esperar aviso. A própria API é gratuita pra consultar, mas usar em produção exige o plano Conta Azul Pro ativo, seja Essencial, Controle, Avançado ou Performance: o Conta Azul Mais, plano de parceria usado por contadores, não dá acesso à API.

Os módulos disponíveis cobrem Financeiro, Cobranças, Vendas, Contratos, Pessoas (clientes e fornecedores), Notas fiscais e, desde 23 de julho de 2026, Captura, que lê um comprovante em PDF ou imagem de até 10 megabytes e usa IA pra sugerir o lançamento financeiro. A limitação que mais pesa pro WhatsApp é a fiscal: a API só consulta nota fiscal eletrônica já emitida, e a nota de serviço eletrônica segue marcada como "em breve" na documentação.

Sete fluxos tiram a rotina financeira da planilha e colocam no WhatsApp

Sete fluxos concentram quase todo o valor prático de ligar a Conta Azul ao WhatsApp com IA, e nenhum deles depende de recurso que a Conta Azul não tenha hoje.

1. Cadastro do cliente na Conta Azul a partir da conversa qualificada: quando o lead (cliente potencial) muda de status pra QUALIFIED ou CONVERTED no CRM (sistema de gestão de relacionamento de clientes) conversacional, um webhook de saída cria o registro em Pessoas.
2. Criação da venda ou do contrato quando o negócio fecha: a mesma automação chama o endpoint de Vendas ou de Contratos com os itens combinados na conversa, o mesmo tipo de fechamento que sustenta o case da Referência Capital, maior corretora de consórcios do Brasil, com mais de R$ 4 milhões em vendas originadas de conversas de WhatsApp conduzidas pela Flly.
3. Lembrete de vencimento D-3 com o link do boleto: a rotina consulta as parcelas a vencer e manda a cobrança pelo WhatsApp antes do prazo.
4. Confirmação automática de pagamento: a mesma consulta periódica identifica quando o status da cobrança vira QUITADO e dispara um agradecimento.
5. Cobrança amigável D+1 e D+7 com a IA negociando data: depois do vencimento, o agente de IA oferece nova data dentro de uma regra configurada, sem esperar o financeiro ligar.
6. Envio de recibo ou 2ª via pelo WhatsApp: o link retornado pela API dá pra reenviar quantas vezes o cliente pedir, sem gerar novo boleto.
7. Relatório de recebimentos pro dono: um resumo periódico cruza o que venceu, o que foi pago e o que segue em aberto, entregue por PDF no WhatsApp ou por e-mail.

Os fluxos 1, 2 e 6 usam a API de forma direta, com uma chamada respondendo na hora. Os fluxos 3, 4 e 7 dependem de consulta periódica, porque não existe aviso automático de vencimento ou pagamento. O fluxo 5 é onde a IA agrega mais valor: em vez de mandar o mesmo texto de cobrança pra todo mundo, ela lê a resposta do cliente e ajusta o tom.

A arquitetura liga Flly, automação e Conta Azul em mão dupla porque não existe aviso automático

No sentido Flly para Conta Azul, a peça de saída são os webhooks da própria Flly: eventos como contact.created e conversation.lead_status_changed disparam assim que a conversa muda, com log de cada entrega, teste de ping manual e assinatura HMAC (código que garante que o aviso veio mesmo da Flly) opcional. Uma automação em n8n ou Make recebe esse aviso, normaliza o telefone e chama a API da Conta Azul pra criar a pessoa, a venda ou a cobrança correspondente. Pra ver como isso se encaixa no funil inteiro, do primeiro contato até o financeiro, vale o guia de automação comercial com IA e WhatsApp.

No sentido contrário, como a Conta Azul não avisa nada sozinha, a mesma automação roda uma rotina programada, por exemplo a cada 15 ou 30 minutos, que consulta contas a receber e parcelas por data de vencimento. Quando encontra uma cobrança vencendo ou já paga, ela chama o webhook de entrada da Flly, um endpoint único protegido por token, que aciona uma campanha por webhook e deixa a IA continuar a conversa. Um escritório de contabilidade em Brasília com 400 clientes recorrentes, por exemplo, roda essa consulta de manhã e à tarde, e reduz pra poucas horas a defasagem entre o vencimento real e o aviso ao cliente.

A Flly integra a Conta Azul por projeto ou automação própria, nunca por conector pronto

Não existe conector nativo entre Flly e Conta Azul, do mesmo jeito que não existe com HubSpot, RD Station ou Pipedrive: o caminho é webhook de saída mais n8n, Make ou Zapier, ou a Flly assume o projeto de integração, alinha o escopo com o cliente e cobra valor de implantação sem exigir que ninguém mexa em configuração. Na prática, boa parte dos clientes acaba usando só o CRM Kanban nativo da Flly como fonte única de verdade, e manda pra Conta Azul apenas o que interessa ao financeiro: cliente fechado, valor da venda e status de pagamento. O passo a passo completo de eventos e mapeamento de campos está em como integrar a Flly ao CRM com webhooks e n8n.

Montar isso por conta própria pede alguém que entenda OAuth2, JSON e o detalhe que mais trava projeto amador: o token de atualização vale 2 semanas e só funciona uma vez, então um fluxo mal desenhado que tenta usá-lo duas vezes derruba a conexão e exige nova autorização manual. A Pluga é hoje a única integração de prateleira com ação pronta pra Conta Azul, como criar contato e criar conta a receber, com plano grátis e pagos a partir de R$ 89 por mês; o n8n só tem nós de comunidade, sem suporte oficial da Conta Azul.

A tabela mostra o que a API entrega pronto e onde ainda exige rodeio

Antes de orçar prazo, vale saber exatamente o que a API da Conta Azul cobre hoje e onde falta recurso, porque parte do que fornecedores de automação anunciam contradiz a própria documentação oficial deles. Quem também usa Omie, Bling ou Tiny encontra o mesmo tipo de comparação, endpoint a endpoint, no post sobre integração de ERP com WhatsApp.

| Fluxo | Viável via API | Como funciona ou limitação | | --- | --- | --- | | Cadastro de cliente | Sim | Endpoint de Pessoas cria e atualiza clientes e fornecedores | | Criar venda ou contrato | Sim | Endpoints de Vendas e Contratos, com validação de frequência e vencimento | | Emitir cobrança (boleto, Pix, link) | Sim | Endpoint de geração de cobrança sobre um lançamento de contas a receber | | 2ª via de boleto | Sim | A mesma cobrança devolve a URL de pagamento, reaproveitável | | Lembrete de vencimento em tempo real | Parcial | Sem webhook, só via consulta periódica nas parcelas a vencer | | Confirmação automática de pagamento | Parcial | Só descobre pelo status da cobrança na próxima consulta | | Lançar despesa a partir de comprovante | Sim | Módulo Captura, desde julho de 2026, com leitura por IA | | Emitir nota fiscal de serviço | Não | A API só consulta NF-e; a nota de serviço segue "em breve" | | Reagir a um evento assim que ele acontece | Não | Sem webhook, respeitando o limite de 600 chamadas por minuto |

A régua de cobrança combina boleto da Conta Azul, IA negociando prazo e o template certo da Meta

A régua típica dispara em quatro toques: D-3 com o lembrete e o link do boleto, D0 no dia do vencimento, D+1 cobrando de forma leve e D+7 com um tom mais direto, sempre com a IA oferecendo negociar a data dentro de uma regra que o gestor define, por exemplo adiar até 5 dias sem precisar de aprovação humana. Cada toque no canal oficial da Meta precisa de um template (modelo de mensagem pré-aprovado usado pra abrir conversa fora da janela de 24 horas) da categoria utilidade, porque cobrança é atualização de conta, não promoção. Usar a categoria errada não derruba o template na hora, mas a Meta recategoriza automaticamente pra marketing, que custa mais caro que utilidade, e quem faz isso de forma recorrente perde o aviso prévio nas revisões seguintes. O desenho completo dessa cadência está na régua de cobrança automática no WhatsApp integrada ao financeiro.

A partir de 1º de outubro de 2026, a conta muda: mensagens de serviço, aquelas que hoje a empresa manda de graça respondendo dentro da janela de 24 horas, passam a ser cobradas por mensagem entregue, no mesmo valor da categoria utilidade. Isso encarece justamente a parte da régua em que a IA está negociando data ou tirando dúvida fora de um template formal, porque deixa de ser serviço grátis pra virar mensagem paga. Vale simular esse custo antes de outubro: numa régua de 4 toques pra 500 clientes recorrentes, cada rodada de negociação fora de template soma ao boleto mensal da Meta.

Segundo a Serasa Experian, o Brasil bateu recorde de inadimplência empresarial em junho de 2026: 9,1 milhões de CNPJs inadimplentes e R$ 232,9 bilhões em dívidas, com dívida média de R$ 25.508,96 por empresa.

O checklist de proteção de dados blinda o financeiro que atravessa dois sistemas

Dado de boleto, CPF ou CNPJ e status de pagamento é dado financeiro sensível sob a LGPD (Lei Geral de Proteção de Dados), e trafegar isso entre Conta Azul, automação e WhatsApp exige alguns cuidados que a maioria dos tutoriais de integração pula.

1. Finalidade declarada: o cliente autorizou receber cobrança pelo WhatsApp, não qualquer mensagem.
2. Minimização de dado: manda só o necessário pra identificar a cobrança, nunca o extrato inteiro.
3. Controle de acesso por papel: quem monta ou testa a automação não precisa ver o financeiro completo.
4. Registro de acesso: cada chamada à API fica logada, com data, conta e o que foi consultado.
5. Retenção com prazo definido: dado de cobrança paga sai do histórico de mensagens depois de um período combinado com o time jurídico.

Uma clínica em São Paulo que cobra plano de tratamento parcelado, por exemplo, só deveria mandar pelo WhatsApp o valor da parcela e o link de pagamento, nunca o histórico de procedimento junto: dado clínico e dado financeiro pedem tratamento separado, mesmo quando o mesmo agente de IA conduz a conversa inteira.

Perguntas frequentes

A Conta Azul tem integração nativa com o WhatsApp?

Duas, e nenhuma cobre o que este texto descreve. A régua de lembrete de vencimento opera por um número que só envia, nunca recebe resposta, custando R$ 0,60 por envio avulso ou R$ 2,99 no pacote com SMS e e-mail. E o Conta AI Captura aceita foto ou PDF de um comprovante de até 5 megabytes mandado pelo WhatsApp, pra lançar a despesa sozinho. Cadastro de cliente, negociação de data e envio de recibo continuam de fora: dependem da API mais uma automação por fora.

A API da Conta Azul tem webhook?

Não. A documentação oficial confirma que a Conta Azul não tem essa tecnologia, então qualquer automação precisa consultar (fazer polling) periodicamente em vez de receber aviso automático quando algo muda.

Qual plano da Conta Azul libera a API?

Qualquer nível do Conta Azul Pro, de Essencial a Performance. O Conta Azul Mais, plano gratuito voltado a contadores e escritórios de BPO, não dá acesso à API.

Como integrar a Conta Azul com n8n ou Make?

O n8n tem só nós de comunidade, sem suporte oficial da Conta Azul; Make e Zapier não têm aplicativo nativo publicado. A Pluga é a única integração pronta com ação de criar contato e criar conta a receber, com plano pago a partir de R$ 89 por mês; fora dela, é chamada direta à API em JSON.

Quanto custa o lembrete de vencimento nativo da Conta Azul pelo WhatsApp?

R$ 0,60 por envio avulso ou R$ 2,99 no pacote com SMS e e-mail, cobrado por cobrança compensada, em horário fixo às 8h e sem negociação: é aviso, não conversa.

A Flly faz essa integração pronta?

Não como conector de configurar e usar direto: a Flly monta o fluxo como projeto, com escopo e valor de implantação definidos antes de começar, ou aponta o caminho de webhook e automação pra quem prefere montar internamente.

Você pode ligar o primeiro fluxo desta integração ainda esta semana

Escolher um fluxo só, geralmente o lembrete D-3 ou o cadastro automático de cliente, e medir duas semanas antes de somar o resto evita o erro mais comum desse tipo de projeto: tentar sincronizar tudo de uma vez e travar no token que expira ou no limite de chamadas por minuto. Comece pelo fluxo que mais atrasa hoje, meça quanto tempo ele economiza e só depois encaixe o próximo na mesma automação.

Se quiser ver como a IA da Flly qualifica o lead antes de qualquer dado seguir pra Conta Azul, converse com o Miguel, nosso SDR (pré-vendedor ou atendente inicial) de IA, no WhatsApp da Flly.