FAQ - Pluga

Consulte as principais dúvidas sobre autenticação, Sandbox, mapeamento de campos, duplicidade, execução das automações e Split na integração entre Asaas e Pluga.

Para criar uma automação, consulte Introdução - Pluga.

Como funciona uma automação na Pluga?

As automações são baseadas em um gatilho e uma ação.

%%{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["Executar a ação"]
    C --> D["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 validacao
    class D sucesso

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

A disponibilidade de ferramentas, gatilhos, ações e campos é definida pela Pluga e pode variar conforme o modelo de automação escolhido.

Preciso saber programar para usar a integração?

Não.

A Pluga permite criar automações sem escrever código. Ainda assim, você precisa entender quais dados serão enviados entre as ferramentas e revisar:

• gatilho;
• ação;
• filtros;
• campos obrigatórios;
• mapeamento;
• conta Asaas conectada.

Para regras avançadas, alto volume, controle próprio de filas, retentativas, logs ou idempotência, considere uma integração direta com a API do Asaas.

Quais contas preciso ter?

Normalmente, você precisa de:

• uma conta ativa no Asaas;
• uma conta na Pluga;
• acesso à ferramenta que será conectada;
• permissão para conectar as contas envolvidas;
• uma chave de API válida do Asaas, quando exigida pelo modelo.

Em automações com Split, os recebedores também precisam possuir contas Asaas aptas a receber os valores.

Onde encontro a chave de API?

Crie e gerencie as credenciais pela interface web do Asaas.

Consulte Chaves de API.

Posso usar a mesma chave de API em mais de uma automação?

Sim.

A mesma chave pode ser utilizada em mais de uma automação, desde que continue válida e pertença à conta Asaas correta.

Utilize um nome que facilite a identificação da credencial, por exemplo:

Chave API - Pluga

Se a chave for desabilitada, expirada ou excluída, as automações que dependem dela deixarão de autenticar até que a credencial seja atualizada.

É possível utilizar Sandbox?

Depende do modelo de automação e da forma de conexão disponibilizada pela Pluga.

Confirme sempre qual conta e ambiente estão sendo utilizados antes de validar o fluxo.

Quais automações posso criar?

A disponibilidade depende da ferramenta conectada e dos modelos oferecidos pela Pluga.

Os fluxos podem incluir, por exemplo:

• criar uma cobrança no Asaas a partir de outra ferramenta;
• enviar informações de cobranças para planilhas, CRMs ou ERPs;
• executar ações a partir de mudanças relacionadas às cobranças;
• criar ou atualizar registros em outros sistemas;
• utilizar Split quando o modelo oferecer essa configuração.

Recursos existentes na API do Asaas não estão necessariamente disponíveis em todos os modelos da Pluga.

Quais campos preciso mapear para criar uma cobrança?

Os campos variam conforme a automação.

Revise principalmente:

• nome e identificação do cliente;
• e-mail e telefone;
• valor;
• vencimento;
• descrição;
• forma de pagamento;
• referência da venda ou pedido.

Se um campo obrigatório estiver ausente, inválido ou em formato incompatível, a ação poderá falhar.

Consulte o histórico de execução da Pluga para identificar a etapa do erro e revise o mapeamento antes de reprocessar o evento.

Alterar o mapeamento modifica registros já criados?

Não.

Alterações no mapeamento afetam apenas as novas execuções da automação.

Cobranças, clientes ou outros registros já criados no Asaas não são atualizados automaticamente quando a configuração da Pluga é alterada.

Como evitar cobranças duplicadas?

Evite reprocessar o mesmo evento sem verificar o resultado da execução anterior.

Quando o modelo permitir:

• utilize referência externa ou ID do pedido;
• mantenha uma coluna ou campo de controle;
• registre o ID retornado pelo Asaas;
• revise filtros e gatilhos;
• consulte o histórico de execução da Pluga antes de reenviar dados.

Exemplo:

É possível utilizar Split pela Pluga?

Sim, quando o modelo de automação escolhido disponibilizar esse recurso.

A configuração pode exigir:

• walletId do recebedor;
• valor fixo ou percentual;
• dados da cobrança;
• dados do cliente.

Consulte Split Asaas no Pluga para configurar o fluxo.

O Split é calculado sobre o valor bruto?

Não.

O percentual do Split é calculado sobre o valor líquido da cobrança (netValue), após as taxas aplicáveis.

Consulte Split de Pagamentos para as regras completas.

O que devo validar no walletId?

Antes de ativar a automação, confirme se cada walletId:

• pertence ao recebedor esperado;
• não pertence à própria conta emissora;
• está associado a uma conta Asaas apta a participar do Split.

O valor líquido que não for direcionado a outros recebedores permanece na conta que criou a cobrança.

Posso alterar o Split depois que a cobrança foi criada?

O Asaas permite atualizar a configuração de Split de cobranças existentes conforme o status e as regras da cobrança.

Depois da confirmação, existem condições específicas para permitir a alteração.

A possibilidade de executar essa atualização diretamente pela Pluga depende das ações oferecidas pelo modelo utilizado.

Consulte Atualizar cobrança existente para verificar as regras da API.

O que acontece quando uma cobrança com Split é estornada?

Os repasses relacionados ao Split também participam do fluxo de estorno.

Considere essa movimentação na conciliação entre:

• conta emissora;
• recebedores;
• Asaas;
• ferramenta conectada pela Pluga.

Para regras específicas de Split, consulte Split de Pagamentos.

A automação é executada imediatamente?

Não considere a execução instantânea como garantida.

O tempo depende:

• do gatilho;
• da ferramenta de origem;
• da Pluga;
• da ferramenta de destino.

Valide o comportamento real antes de criar processos que dependam de resposta imediata.

Como identificar uma falha?

Consulte primeiro o histórico ou log de execução da Pluga.

Verifique:

• se a automação está ativa;
• se o gatilho foi acionado;
• se os filtros permitiram a execução;
• se a credencial continua válida;
• se os campos obrigatórios foram enviados;
• qual erro foi retornado durante a ação.

Erros comuns

Próximos passos

• Crie sua automação na Pluga
• Configure Split pela Pluga
• Gerencie suas chaves de API
• Volte à visão geral da Pluga