Introdução - Pluga

A Pluga é uma plataforma de integração que facilita a conexão entre ferramentas e aplicativos utilizados por empresas, permitindo automatizar fluxos de trabalho e trocar dados entre sistemas sem necessidade de programação complexa.

Com a integração entre Asaas e Pluga, é possível conectar o Asaas a ferramentas como CRMs, plataformas de e-commerce, ERPs, planilhas, ferramentas de marketing, atendimento e produtividade.

A lógica das automaçõ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 nova venda for registrada em uma plataforma de e-commerce
↓
Criar uma cobrança automaticamente no Asaas

Ou:

Quando uma cobrança for recebida no Asaas
↓
Enviar os dados dessa cobrança para uma planilha, CRM ou ferramenta de comunicação

Essa integração ajuda a reduzir tarefas manuais, minimizar erros operacionais e manter informações financeiras sincronizadas entre o Asaas e outras ferramentas utilizadas pela empresa.

Quando utilizar a integração entre Asaas e 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;
• automatizar tarefas financeiras sem desenvolver uma integração direta com a API do Asaas;
• reduzir cópia manual de dados entre sistemas;
• conectar fluxos comerciais, financeiros e administrativos;
• testar uma automação antes de investir em uma integração própria;
• manter registros financeiros atualizados em ferramentas de apoio, como Google Sheets, Bling, Nibo, Omie, Pipedrive, Slack, RD Station e outras.

A Pluga é especialmente indicada para fluxos de baixa ou média complexidade, nos quais os modelos de automação disponíveis já atendem à necessidade da operação.

Quando considerar uma integração direta com a API

Embora a Pluga facilite a criação de automações sem código, uma integração direta com a API do Asaas pode ser mais indicada quando a operação exigir:

• regras de negócio muito específicas;
• alto volume de requisições;
• controle próprio de filas, retentativas e logs;
• tratamento customizado de erros;
• idempotência controlada pela aplicação;
• validações avançadas antes da criação de cobranças;
• recursos que não estejam disponíveis nos modelos da Pluga;
• múltiplas etapas condicionais ou fluxos assíncronos mais complexos.

Nesses cenários, consulte também a documentação da API do Asaas para avaliar a melhor abordagem.

Como funcionam as integrações do Asaas através da Pluga

As automações da Pluga normalmente possuem os seguintes componentes:

No caso do Asaas, as integrações podem funcionar em dois sentidos:

Atividades que podem ser automatizadas

As integrações da Pluga com o Asaas podem ser utilizadas para automatizar atividades como:

1. Criar cobranças no Asaas a partir de dados de outras ferramentas.

2. Enviar informações de cobranças do Asaas para outros sistemas quando houver mudança de status, como:

• cobrança criada;
• cobrança recebida;
• cobrança vencida;
• cobrança estornada.

3. Registrar dados financeiros em planilhas ou ERPs.

4. Notificar times internos sobre eventos financeiros.

5. Criar fluxos de acompanhamento comercial, cobrança ou conciliação.

A disponibilidade exata de gatilhos, ações e campos depende dos modelos de automação oferecidos pela Pluga para cada ferramenta conectada.

Pré-requisitos

Antes de criar uma integração do Asaas na Pluga, você precisará:

• ter uma conta ativa no Asaas;
• ter uma conta na Pluga;
• ter acesso à outra ferramenta que deseja integrar;
• possuir permissão para conectar a conta da outra ferramenta;
• gerar ou acessar a chave de API da conta Asaas;
• definir qual fluxo será automatizado;
• identificar quais campos serão enviados entre os sistemas.

Campos importantes no mapeamento

Os campos exigidos variam conforme a automação escolhida. Em fluxos que criam cobranças no Asaas, normalmente será necessário mapear informações como:

O preenchimento incorreto desses campos pode gerar falha na automação ou criar registros inconsistentes no Asaas.

Como criar uma integração do Asaas na Pluga

Com os pré-requisitos em mãos, siga o fluxo abaixo:

1. Na Pluga, acesse a página de integrações do Asaas.

2. Busque pela ferramenta que deseja conectar ao Asaas.

3. Escolha um card com o modelo de automação desejado.

4. Clique em Fazer essa automatização.

5. Conecte a conta do Asaas informando a chave de API.

6. Conecte a outra ferramenta que fará parte do fluxo.

7. Configure filtros, se necessário.

8. Faça o mapeamento dos campos entre as ferramentas.

9. Revise os dados configurados.

10. Teste a automação.

11. Clique em Finalizar automatização.

Após a ativação, a automação passará a executar conforme o gatilho e as condições configuradas.

Exemplo de fluxo: criar cobrança a partir de uma venda

Um cenário comum é criar uma cobrança no Asaas sempre que uma venda for registrada em outra ferramenta.

Nova venda registrada no e-commerce
↓
Pluga identifica o evento
↓
Dados da venda são enviados para o Asaas
↓
Cobrança é criada no Asaas
↓
Cliente recebe ou acessa a cobrança conforme o fluxo configurado

Nesse tipo de automação, revise principalmente:

• valor da cobrança;
• data de vencimento;
• identificação do cliente;
• forma de pagamento;
• descrição da cobrança;
• referência interna da venda.

Exemplo de fluxo: cobrança recebida enviada para planilha

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

Cobrança recebida no Asaas
↓
Pluga identifica a mudança de status
↓
Dados da cobrança são enviados ao Google Sheets
↓
Uma nova linha é criada na planilha
↓
Time financeiro acompanha a conciliação

Nesse cenário, valide se a planilha possui colunas compatíveis com os dados enviados e se a automação não cria linhas duplicadas para o mesmo evento.

Comportamentos relevantes

Ao utilizar a integração entre Asaas e Pluga, considere os seguintes comportamentos:

• a automação depende do gatilho configurado na Pluga;
• o tempo de execução pode variar conforme a ferramenta de origem, a Pluga e a ferramenta de destino;
• os dados enviados ao Asaas dependem do mapeamento realizado na configuração;
• campos obrigatórios ausentes ou inválidos podem impedir a execução da ação;
• filtros mal configurados podem impedir que eventos esperados sejam processados;
• alterações na estrutura da ferramenta de origem podem quebrar o mapeamento;
• reprocessamentos ou testes com os mesmos dados podem gerar registros duplicados;
• recursos disponíveis na API do Asaas podem não estar disponíveis em todos os modelos da Pluga;
• a disponibilidade de conectores, gatilhos e ações é definida pela Pluga.

Cuidados com duplicidade

Em automações que criam cobranças ou clientes no Asaas, é importante avaliar como evitar duplicidades.

Duplicidades podem ocorrer quando:

• a mesma venda é enviada mais de uma vez;
• uma linha de planilha é processada novamente;
• a automação é testada com dados reais;
• o mesmo evento é reenviado após uma falha;
• não existe um identificador único de controle;
• filtros ou condições não foram configurados corretamente.

Para reduzir esse risco, recomenda-se:

• utilizar um identificador único da ferramenta de origem;
• testar a automação com poucos registros;
• evitar reprocessar eventos sem validar o que já foi criado;
• acompanhar o histórico de execução da Pluga;
• conferir no Asaas se a cobrança ou cliente já existe antes de repetir a operação, quando o modelo permitir.

Erros comuns

Alguns erros comuns em integrações entre Asaas e Pluga incluem:

Caso ocorra falha, consulte o histórico ou log da automação na Pluga para identificar em qual etapa o erro ocorreu.

Impactos operacionais

A configuração da integração pode impactar diretamente processos financeiros, comerciais e administrativos.

Configurações incorretas podem causar:

• criação de cobranças com valor ou vencimento incorreto;
• cobranças associadas ao cliente errado;
• ausência de registros esperados em planilhas ou ERPs;
• duplicidade de cobranças;
• divergência entre o Asaas e a ferramenta conectada;
• falhas em processos de conciliação financeira;
• atrasos na comunicação com times internos;
• necessidade de ajustes manuais posteriores.

Por isso, antes de utilizar uma automação em produção, recomenda-se validar todo o fluxo com dados controlados.

Boas práticas

Ao configurar uma integração do Asaas na Pluga, recomenda-se:

• definir claramente o objetivo da automação;
• escolher o modelo de automação mais adequado ao fluxo;
• revisar todos os campos obrigatórios;
• utilizar uma chave de API identificável para a Pluga;
• testar o fluxo antes de ativar em produção;
• evitar dados reais sensíveis durante testes;
• acompanhar as primeiras execuções após a ativação;
• manter identificadores internos para facilitar conciliação;
• revisar filtros para evitar execuções indevidas;
• documentar internamente quais automações estão ativas;
• validar periodicamente se os campos mapeados continuam corretos.

Ferramentas compatíveis

Através da Pluga, é possível integrar o Asaas com diversas ferramentas utilizadas em operações comerciais, financeiras, marketing e produtividade.

Entre as integrações mais utilizadas estão:

• ActiveCampaign;
• Bling;
• Conta Azul;
• Discord;
• eNotas;
• Gmail;
• Google Docs;
• Google Drive;
• Google Forms;
• Google Sheets;
• HubSpot CRM;
• Intercom;
• Mailchimp;
• Nibo;
• NFE.io;
• Omie;
• Pipedrive;
• Pipefy;
• RD Station Marketing;
• RD Station CRM;
• Slack;
• Trello;
• Twilio;
• Typeform;
• Zoho CRM;
• entre diversas outras.

As integrações disponíveis podem ser alteradas ao longo do tempo conforme novos conectores são adicionados ou descontinuados pela Pluga.

Conteúdos relacionados

Consulte também:

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

Caso tenha dúvidas sobre uso, configuração ou falhas dentro da Pluga, consulte também a Central de Ajuda da Pluga.