Pluga

A Pluga é uma plataforma de integração que permite conectar o Asaas a outras ferramentas utilizadas na operação da empresa, sem necessidade de desenvolvimento próprio ou escrita de código.

Com a Pluga, é possível criar automações entre o Asaas e sistemas de vendas, atendimento, marketing, produtividade, planilhas, ERPs, CRMs e outras ferramentas utilizadas no dia a dia da operação.

A lógica das integrações da Pluga é baseada em gatilhos e ações:

Quando algo acontecer em uma ferramenta
↓
Executar uma ação em outra ferramenta

Por exemplo:

Quando uma cobrança for recebida no Asaas
↓
Criar uma linha no Google Sheets com os dados dessa cobrança

Ou:

Quando uma nova venda for registrada em uma ferramenta externa
↓
Criar uma cobrança automaticamente no Asaas

Essa integração é indicada para empresas que desejam automatizar processos financeiros e operacionais sem construir uma integração direta com a API do Asaas.

Quando utilizar a Pluga

Utilize a integração entre Asaas e Pluga quando sua operação precisar:

• criar cobranças no Asaas a partir de dados gerados em outros sistemas;
• enviar informações de cobranças do Asaas para planilhas, CRMs, ERPs ou ferramentas de comunicação;
• reduzir tarefas manuais de cópia e colagem entre sistemas;
• automatizar processos financeiros sem desenvolver uma integração própria;
• conectar o Asaas a ferramentas já utilizadas por times comerciais, financeiros, administrativos ou de atendimento;
• criar fluxos simples ou intermediários com menor esforço técnico;
• validar uma automação antes de investir em uma integração direta via API.

Essa integração é especialmente útil para empresas que já utilizam ferramentas externas no fluxo de vendas, cobrança, conciliação ou acompanhamento financeiro.

Quando considerar uma integração direta via API

A Pluga é indicada para automações sem código e fluxos padronizados. No entanto, uma integração direta com a API do Asaas pode ser mais adequada quando a operação exigir:

• regras de negócio avançadas;
• alto volume de requisições;
• controle próprio de filas, logs e retentativas;
• tratamento customizado de erros;
• múltiplas etapas condicionais;
• recursos que não estejam disponíveis nos modelos de automação da Pluga;
• controle detalhado sobre autenticação, idempotência e conciliação entre sistemas.

Nesses casos, consulte também a documentação da API do Asaas para avaliar a melhor abordagem técnica.

Como a integração funciona

As automações da Pluga normalmente são compostas por três elementos principais:

Nas integrações com o Asaas, a Pluga pode atuar em dois sentidos:

Fluxo geral de criação de uma automação

Em uma configuração típica, a criação de uma automação envolvendo o Asaas segue o fluxo abaixo:

Criar ou acessar uma conta na Pluga
↓
Escolher o Asaas como ferramenta de origem ou destino
↓
Selecionar a outra ferramenta que será conectada
↓
Escolher o modelo de automação desejado
↓
Conectar a conta Asaas usando a chave de API
↓
Conectar a conta da outra ferramenta
↓
Configurar filtros, se necessário
↓
Mapear os campos entre os sistemas
↓
Testar a automação
↓
Finalizar e ativar o fluxo

Cada modelo de automação pode exigir campos e configurações diferentes, conforme a ferramenta conectada, o gatilho escolhido e a ação executada.

Pré-requisitos

Antes de configurar uma automação com o Asaas na Pluga, verifique se você possui:

• uma conta ativa no Asaas;
• uma conta na Pluga;
• acesso à ferramenta que será conectada ao Asaas;
• permissão para gerar ou utilizar a chave de API da conta Asaas;
• definição clara do evento que deve iniciar a automação;
• definição dos campos que serão enviados entre os sistemas.

Caso a automação envolva criação de cobranças, também é importante validar previamente quais dados serão utilizados, como cliente, valor, vencimento, forma de pagamento e identificadores internos.

Chave de API do Asaas

Para conectar o Asaas à Pluga, normalmente será necessário informar a chave de API da conta Asaas.

A chave de API autentica a integração e permite que a Pluga execute ações na conta conectada, conforme os recursos disponíveis no modelo de automação utilizado.

Sempre que possível, utilize uma chave identificável para a integração, com um nome que facilite a rastreabilidade, como:

Chave API - Pluga

Campos importantes no mapeamento

Os campos exigidos dependem do tipo de automação configurada. Em fluxos que criam cobranças no Asaas, normalmente é necessário mapear informações como:

O mapeamento incorreto pode causar falha na criação da cobrança ou gerar cobranças com informações incompletas.

Exemplos de uso

Criar cobrança a partir de uma venda

Um fluxo comum é criar uma cobrança no Asaas sempre que uma nova venda for registrada em outra ferramenta.

Nova venda registrada no e-commerce
↓
Pluga recebe os dados da venda
↓
Pluga cria uma cobrança no Asaas
↓
Cobrança fica disponível para pagamento

Esse cenário é útil para lojas, sistemas de pedidos ou plataformas que desejam gerar cobranças automaticamente sem integrar diretamente com a API.

Enviar cobrança recebida para uma planilha

Outro uso comum é registrar cobranças recebidas em uma planilha para controle financeiro.

Cobrança recebida no Asaas
↓
Pluga identifica o evento
↓
Pluga cria uma linha no Google Sheets
↓
Time financeiro acompanha os recebimentos

Esse cenário ajuda operações que utilizam planilhas como apoio para conciliação, controle interno ou relatórios.

Notificar o time sobre eventos financeiros

A integração também pode ser usada para notificar times internos sobre eventos financeiros.

Cobrança vencida ou recebida no Asaas
↓
Pluga identifica o evento
↓
Mensagem é enviada para Slack, Discord ou outra ferramenta conectada

Esse fluxo pode apoiar times de atendimento, cobrança ou operações financeiras.

Comportamentos relevantes

Ao utilizar a Pluga com o Asaas, considere os seguintes comportamentos:

• a execução da automação depende do gatilho configurado na Pluga;
• os dados enviados ao Asaas dependem do mapeamento realizado durante a configuração;
• campos obrigatórios ausentes ou inválidos podem impedir a execução da ação;
• alterações realizadas na ferramenta de origem podem impactar o fluxo se o mapeamento deixar de corresponder aos dados esperados;
• integrações baseadas em eventos podem não ser instantâneas em todos os cenários;
• a disponibilidade de conectores, gatilhos e ações depende da Pluga;
• recursos disponíveis na API do Asaas podem não estar disponíveis em todos os modelos de automação da Pluga.

Cuidados com duplicidade

Em automações que criam cobranças ou clientes, é importante avaliar como a integração irá lidar com reprocessamentos ou execuções repetidas.

Duplicidades podem ocorrer quando:

• o mesmo gatilho é executado mais de uma vez;
• uma linha de planilha é reenviada;
• a automação é testada usando dados reais;
• não há um identificador único para relacionar a origem com o registro criado no Asaas;
• o fluxo é reativado após erro sem validação prévia.

Para reduzir esse risco, recomenda-se utilizar campos de controle, como número do pedido, ID da venda ou referência externa, sempre que o modelo de automação permitir.

Impactos operacionais

A integração entre Asaas e Pluga pode impactar diretamente processos financeiros e operacionais da empresa.

Configurações incorretas podem causar:

• criação de cobranças com valor, vencimento ou cliente incorreto;
• ausência de cobranças esperadas;
• duplicidade de cobranças;
• envio de dados incompletos para sistemas externos;
• divergência entre o Asaas e a ferramenta conectada;
• falhas em fluxos de conciliação financeira;
• atraso no acionamento de times internos ou clientes.

Por isso, recomenda-se testar a automação antes de utilizar em produção e revisar os dados mapeados sempre que houver alteração na ferramenta de origem.

Boas práticas

Ao configurar uma automação entre Asaas e Pluga, recomenda-se:

• definir claramente qual evento deve iniciar o fluxo;
• revisar os campos obrigatórios antes de ativar a automação;
• utilizar uma chave de API identificável para a integração;
• testar o fluxo com poucos registros antes de operar em volume;
• evitar o uso de dados reais sensíveis durante testes;
• validar se os dados criados no Asaas correspondem ao esperado;
• utilizar identificadores internos para facilitar conciliação;
• revisar filtros para evitar execuções indevidas;
• monitorar as primeiras execuções após ativar a automação;
• consultar os logs ou histórico de execução da Pluga em caso de falha.

Erros comuns

Alguns problemas comuns em integrações via Pluga incluem:

Quando ocorrer erro, valide primeiro a configuração da automação na Pluga, os campos mapeados, a chave de API utilizada e os dados enviados para o Asaas.

Organização desta seção

Esta página apresenta uma visão geral da integração entre Asaas e Pluga.

Para aprofundar a configuração e os cenários específicos, consulte as subpáginas desta seção:

• Introdução - Pluga: explica o funcionamento da integração, ferramentas compatíveis e primeiros passos de configuração.
• Split Asaas no Pluga: apresenta como configurar automações com split de pagamento utilizando a Pluga.
• FAQ - Pluga: reúne dúvidas frequentes, erros comuns e orientações operacionais sobre a integração.

Conteúdos relacionados

Consulte também:

• Introdução - Pluga;
• Split Asaas no Pluga;
• FAQ - Pluga;
• Criar cobrança;
• Criar cliente;
• Webhooks;
• Split de Pagamentos;
• Chaves de API;
• Sandbox.