Introdução - Pluga

Conecte o Asaas a outras ferramentas pela Pluga para criar cobranças, enviar informações financeiras ou executar outros fluxos disponíveis sem desenvolver uma integração própria.

A automação é composta por um gatilho, que inicia o fluxo, e uma ou mais ações executadas nas ferramentas conectadas.

Como funciona

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Evento na ferramenta de origem"] --> B["Pluga identifica o gatilho"]
    B --> C["Mapear os dados"]
    C --> D["Executar a ação"]
    D --> E["Atualizar a ferramenta de destino"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px

    class A inicio
    class B,C,D validacao
    class E sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

O Asaas pode atuar como origem ou destino:

A disponibilidade de gatilhos, ações, filtros e campos depende do modelo de automação oferecido pela Pluga.

Quando usar Pluga ou API

Use a Pluga quando o modelo disponível atender ao fluxo que você precisa automatizar sem desenvolvimento próprio.

Considere uma integração direta com a API do Asaas quando precisar de:

• regras de negócio 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;
• recursos que não estejam disponíveis na Pluga;
• fluxos assíncronos ou condicionais que exijam arquitetura própria.

Antes de começar

Tenha:

• uma conta ativa no Asaas;
• uma conta na Pluga;
• acesso à outra ferramenta da automação;
• permissão para conectar as contas envolvidas;
• uma chave de API válida da conta Asaas;
• o gatilho e a ação que deseja executar definidos.

Se precisar criar uma credencial, consulte Chaves de API.

1. Escolha a automação

Acesse a página de integrações do Asaas na Pluga.

Depois:

1. escolha a ferramenta que será conectada ao Asaas;
2. localize o modelo de automação desejado;
3. clique em Fazer essa automatização.

Antes de continuar, confirme se o modelo possui o gatilho e a ação necessários para sua operação.

2. Conecte as contas

Conecte a conta do Asaas utilizando a chave de API.

Em seguida, autentique a outra ferramenta utilizada no fluxo.

Confirme se as contas conectadas correspondem aos ambientes e operações esperados antes de realizar o mapeamento.

3. Configure gatilhos e filtros

Defina o evento que iniciará a automação.

Exemplos de gatilhos disponíveis em modelos da Pluga incluem mudanças relacionadas a cobranças ou eventos originados em ferramentas externas.

Quando o modelo permitir filtros, utilize-os para impedir execuções que não atendam às regras da operação.

4. Mapeie os campos

Associe os dados da ferramenta de origem aos campos esperados pela ação.

Em uma automação que cria cobranças no Asaas, revise principalmente:

Campos obrigatórios ausentes ou inválidos podem impedir a execução da automação.

5. Teste a automação

Antes de ativar o fluxo:

1. revise as contas conectadas;
2. confira gatilhos e filtros;
3. valide o mapeamento;
4. utilize dados controlados;
5. execute o teste;
6. confirme o resultado na ferramenta de destino.

Se a ação criar uma cobrança no Asaas, confira principalmente:

• cliente;
• valor;
• vencimento;
• forma de pagamento;
• referência utilizada para conciliação.

Resultado esperado

A ação definida no modelo deve ser executada com os dados mapeados e aparecer corretamente na ferramenta de destino.

Se a automação criar uma cobrança, confirme também se ela foi registrada na conta Asaas esperada antes de ativar o fluxo.

6. Ative a automação

Após validar o teste, clique em Finalizar automatização.

A partir desse momento, a execução seguirá o gatilho, os filtros e os mapeamentos definidos na Pluga.

Exemplos de fluxo

Criar uma cobrança a partir de uma venda

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Registrar nova venda"] --> B["Pluga identifica o evento"]
    B --> C["Enviar os dados ao Asaas"]
    C --> D["Criar a cobrança"]
    D --> E["Disponibilizar a cobrança ao cliente"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px

    class A inicio
    class B,C,D validacao
    class E sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

Registrar uma cobrança recebida em uma planilha

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Cobrança recebida no Asaas"] --> B["Pluga identifica o evento"]
    B --> C["Enviar os dados ao Google Sheets"]
    C --> D["Criar uma linha na planilha"]
    D --> E["Registrar o recebimento"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px

    class A inicio
    class B,C,D validacao
    class E sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

Evite duplicidades

Em automações que criam cobranças ou clientes, utilize uma referência da ferramenta de origem sempre que o modelo permitir.

Antes de reprocessar uma execução:

• consulte o histórico da Pluga;
• confirme se o registro já foi criado no Asaas;
• revise filtros e gatilhos;
• evite reenviar o mesmo dado sem verificar o resultado anterior.

Alterações no mapeamento afetam as próximas execuções da automação e não alteram automaticamente registros que já foram criados.

Erros comuns

Se o fluxo falhar, consulte primeiro o histórico de execução da Pluga para identificar em qual etapa ocorreu o erro.

Ferramentas disponíveis

A lista de ferramentas e modelos compatíveis pode mudar conforme novos conectores são adicionados ou removidos pela Pluga.

Próximos passos

• Configure Split no Pluga
• Consulte o FAQ da Pluga
• Crie e gerencie suas chaves de API