API do Asaas: cobranças, Pix e webhooks com agentes de IA
A API do Asaas é REST e cobre praticamente tudo o que se faz no painel: cadastro de clientes, emissão de cobranças, assinaturas, transferências e notas fiscais. É usada por empresas e desenvolvedores que integram cobrança ao ERP, CRM ou sistema próprio. O acesso é por chave de API da própria conta, com ambiente de sandbox para testes.
Os grandes recursos da API, em português claro.
Cadastrar, atualizar e buscar pagadores com CPF/CNPJ, e-mail e telefone.
Emitir boleto, Pix ou cartão, consultar status, estornar e gerar segunda via.
Criar cobranças recorrentes e ajustar valor, ciclo e vencimento.
Agendar e emitir notas de serviço vinculadas às cobranças.
Consultar saldo e extrato e fazer transferências e pagamentos de contas.
Receber eventos como cobrança paga, vencida ou estornada.
Como se acessa a API do Asaas.
- Com credencial da sua empresaAutenticação por chave de API (access token) gerada no painel do Asaas, enviada no cabeçalho de cada requisição; há chaves separadas para sandbox e produção.
- Documentação oficialdocs.asaas.com
- A chave de API dá acesso amplo à conta, inclusive transferências: guarde só no cofre e bloqueie no agente as ações de saída de dinheiro.
- Use a sandbox para validar a régua antes de ligar em produção.
- CPF, telefone e dados de pagamento são pessoais; trate conforme a LGPD.
- api asaas
- asaas api documentação
- api do asaas cobrança
- webhook asaas
- integração api asaas
- asaas sandbox
- api asaas pix
O que um agente do iTeam faz com a API do Asaas.
Ao receber o evento de cobrança vencida, o agente manda lembrete no WhatsApp com a linha digitável ou o Pix e registra a resposta do cliente.
O cliente pede a segunda via por e-mail ou WhatsApp e o agente devolve o link atualizado da cobrança na hora.
O agente lê as cobranças pagas do dia e dá baixa nos títulos do ERP, separando divergências de valor para revisão.
Pedidos de desconto ou parcelamento viram proposta do agente, aprovada pelo financeiro antes de alterar a cobrança.
Da credencial ao agente trabalhando, com aprovação.
Gerar a chave de API no Asaas
No painel do Asaas, gere a chave de API da conta (comece pela sandbox) e configure a URL de webhook indicada pelo iTeam.
Definir permissões por agente
No iTeam, a credencial do Asaas vai para o cofre e cada agente ganha uma lista fechada de ações (consultar cobranças, emitir segunda via, criar cobrança). Ações que alteram dados exigem aprovação de uma pessoa.
Validar em pequeno e depois ampliar
Comece por um caso: emita uma cobrança na sandbox e simule o pagamento. Com o resultado conferido, o processo ganha mais volume, sempre com auditoria e aprovação onde houver risco.
Dúvidas sobre a API do Asaas.
A API do Asaas é gratuita?
Não há cobrança pelo uso da API em si; você paga as tarifas normais do Asaas por boleto, Pix, cartão ou nota emitida. Confira a tabela vigente no site do Asaas.
Preciso programar para usar a API do Asaas com o iTeam?
Não precisa. O iTeam lê a documentação da API do Asaas, monta as chamadas e o time de implantação ajusta o fluxo com você. O que fica com a empresa é aprovar e acompanhar.
Dá para testar a API do Asaas sem mexer em dinheiro real?
Sim. O Asaas oferece ambiente de sandbox com chave própria, onde o iTeam valida a régua de cobrança e os webhooks antes de ir para produção.
Como um agente de IA faz cobrança e régua de lembretes usando a API do Asaas?
A API do Asaas cria clientes e cobranças, consulta status e avisa mudanças por webhook, e o agente conduz a régua em cima disso. Ele lembra a fatura que vence, confirma o pagamento e propõe nova data ao inadimplente. Descontos e renegociações ficam dentro de uma regra. No iTeam, o aviso sai pelo WhatsApp com o histórico registrado.
O Asaas tem sandbox para testar cobranças sem dinheiro real?
Sim, o Asaas mantém um ambiente de sandbox à parte, com chave de API própria, onde você cria cobranças e simula pagamentos. Use-o para validar a régua, os webhooks e as regras do agente antes de ligar em produção. A chave de sandbox não funciona na conta real, e o contrário também vale, então guarde as duas separadas e identificadas.
Como autenticar o agente na API do Asaas e que cuidado a chave exige?
A chave de API da conta, gerada no painel, vai no cabeçalho access_token de cada requisição. Ela dá acesso amplo, inclusive a transferências, então fica em cofre e o agente não deve ter permissão para ações de saída de dinheiro. Se a chave vazar, revogue e gere outra. Limitar por IP, quando a conta permitir, reduz o estrago de um vazamento.
A API do Asaas é gratuita e o que influencia o custo?
A documentação do Asaas não lista cobrança pelo acesso à API; o que a conta paga são as taxas de cada cobrança, boleto, Pix ou cartão, conforme o plano. Confira a tabela vigente no site. Para o agente, soma-se o custo do modelo de IA, que depende do volume de mensagens da régua. O número de cobranças por mês é o fator que mais pesa.
O que o agente pode e não pode fazer na conta Asaas?
Pode criar cobrança, consultar pagamentos, reenviar lembrete, emitir segunda via e acompanhar assinaturas. Não deve transferir saldo nem alterar dados bancários. Bloqueie transferências no nível do agente e dê só as ações necessárias à cobrança. Cancelamento e estorno de cobrança com valor alto pedem aprovação de uma pessoa do financeiro.
Como conciliar recebimentos do Asaas com o ERP usando um agente?
O agente lê as cobranças pagas pelo webhook e cruza o identificador com o título aberto no ERP, dando baixa quando valor e cliente batem. Diferenças, como pagamento parcial ou duplicado, viram uma lista para o financeiro decidir. Isso funciona bem com os ERPs que têm API, e o iTeam liga o Asaas a esses sistemas pelo catálogo de integrações.
Posso usar a API do Asaas sem saber programar?
Para a rotina de cobrança, uma plataforma de agentes cobre a chamada à API, de modo que você configura a régua e o canal sem escrever código. Alguém precisa gerar a chave e cadastrar o webhook no painel do Asaas, tarefa de poucos passos. A programação só entra em integrações sob medida com um sistema próprio.
Dados de pagador no Asaas exigem cuidado de LGPD?
Sim: CPF ou CNPJ, telefone e histórico de pagamentos identificam o cliente. O agente deve usar esses dados só para cobrar e atender e não repetir para terceiros. Defina quanto tempo guardar as conversas de cobrança e quem pode lê-las. Ao falar de dívida em canal aberto, preserve o cliente evitando expor valores em grupos.
Outras APIs da categoria.
Times de IA prontos que usam Asaas.
Vendas no WhatsApp
Responde a pergunta de preço na hora, monta o orçamento com o seu catálogo e lembra o cliente no dia combinado, sem depender do vendedor estar online.
Cobrança e contas a receber
Uma régua de cobrança que conversa: lembra, envia a segunda via, ouve o motivo do atraso e propõe acordo só dentro do que o financeiro liberou.
