FAQ - Make/Integromat

Consulte as principais dúvidas sobre autenticação, Sandbox, módulos, duplicidade, Split, Webhooks e falhas em cenários que utilizam o Asaas no Make.

Para configurar um fluxo completo, consulte os templates e guias específicos desta seção.

O Make é uma integração oficial do Asaas?

Sim.

O app do Asaas no Make é mantido pelo Asaas e disponibiliza módulos nativos para diferentes operações, além do módulo Fazer uma chamada API para recursos que precisem ser acessados diretamente pela API.

O Make substitui uma integração própria via API?

Depende da operação.

O Make atende cenários de automação e orquestração entre sistemas. Uma integração própria pode ser mais adequada quando você precisa de:

• regras de negócio específicas;
• controle próprio de idempotência;
• processamento assíncrono customizado;
• arquitetura e observabilidade próprias;
• controle mais granular sobre alto volume de requisições.

Como configurar Produção e Sandbox?

A conexão deve utilizar a API Key correspondente ao ambiente selecionado.

Nos templates desta seção:

• Real corresponde à Produção;
• Sandbox corresponde ao ambiente de testes.

As contas, dados e credenciais de Sandbox e Produção são independentes.

Consulte como criar e gerenciar Chaves de API.

Entenda o ambiente Sandbox.

Quais operações posso automatizar?

O app do Asaas no Make possui módulos para operações relacionadas a clientes, cobranças, assinaturas, parcelamentos e outros recursos.

Quando não houver um módulo adequado para a operação, utilize Fazer uma chamada API e siga as regras do endpoint correspondente.

Para conhecer os recursos e quando utilizá-los, consulte Vantagens e funcionalidades.

Posso criar cobranças pelo Google Sheets?

Sim.

O template desta seção utiliza uma nova linha do Google Sheets como início do cenário e consulta o cliente antes da criação da cobrança.

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Adicionar linha no Google Sheets"] --> B["Consultar cliente no Asaas"]
    B --> C{"Cliente encontrado?"}

    C --> Sim(("Sim"))
    C --> Nao(("Não"))

    Sim --> D["Utilizar o ID existente"]
    Nao --> E["Criar o cliente"]

    D --> F["Criar a cobrança"]
    E --> F

    F --> G["Registrar o resultado"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef decisao fill:#FEF3C7,stroke:#D97706,color:#78350F,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
    classDef respostaSim fill:#22C55E,stroke:#15803D,color:#FFFFFF,stroke-width:3px
    classDef respostaNao fill:#EF4444,stroke:#B91C1C,color:#FFFFFF,stroke-width:3px

    class A inicio
    class C decisao
    class B,D,E,F validacao
    class G sucesso
    class Sim respostaSim
    class Nao respostaNao

    linkStyle default stroke:#94A3B8,stroke-width:2px
    linkStyle 2 stroke:#22C55E,stroke-width:4px
    linkStyle 3 stroke:#EF4444,stroke-width:4px

Siga Criar uma cobrança avulsa a partir de uma linha no Google Sheets.

Posso criar assinaturas pelo Make?

Sim.

O Asaas possui módulo nativo para criação de assinaturas. O template desta seção também permite criar uma assinatura a partir do Google Sheets e utiliza chamada API nos ajustes necessários para o fluxo documentado com Split.

Após a criação, o Asaas gera novas cobranças conforme a recorrência configurada.

Siga Criar uma assinatura a partir de uma linha no Google Sheets.

Posso criar parcelamentos pelo Make?

Sim.

O Asaas possui módulo nativo para criação de cobranças parceladas. O template desta seção permite iniciar o fluxo pelo Google Sheets e utiliza chamada API nos ajustes necessários para o cenário documentado com Split.

Siga Criar um parcelamento a partir de uma linha no Google Sheets.

Posso utilizar Split de Pagamentos?

Sim.

O Split pode ser utilizado em cobranças, assinaturas e parcelamentos, desde que a configuração respeite as regras do recurso.

A forma de configurar os dados depende do módulo ou template utilizado. Em alguns cenários, pode ser necessário utilizar Fazer uma chamada API.

Consulte as regras do Split de Pagamentos.

Como evitar clientes duplicados?

A API permite criar mais de um cadastro para o mesmo cliente.

Quando a operação exigir reaproveitamento do cadastro existente:

• consulte o cliente antes da criação;
• utilize CPF/CNPJ ou outro identificador adequado ao cenário;
• armazene o ID retornado pelo Asaas;
• reutilize esse ID nas próximas operações.

A consulta prévia reduz duplicidades, mas não representa idempotência automática.

Como evitar cobranças, assinaturas ou parcelamentos duplicados?

O Make não garante idempotência automática dos cenários.

Antes de reprocessar uma linha ou evento:

• registre o ID retornado pelo Asaas;
• utilize uma referência da operação;
• confirme se o recurso já foi criado;
• configure filtros quando necessário;
• consulte o histórico da execução que falhou.

O que acontece se um módulo falhar?

Uma falha pode interromper o cenário depois que módulos anteriores já executaram suas ações.

Por exemplo:

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Identificar nova linha"] --> B["Criar o cliente"]
    B --> C["Falhar ao criar a cobrança"]
    C --> D["Interromper o cenário"]

    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

Nesse caso, o cliente pode ter sido criado mesmo que a cobrança não tenha sido concluída.

Antes de executar novamente:

1. consulte o histórico do Make;
2. identifique o último módulo concluído;
3. confirme quais recursos já existem no Asaas;
4. corrija a causa da falha;
5. só então reexecute o fluxo.

As notificações do Asaas continuam sendo enviadas?

Sim.

Se a operação criada estiver configurada para utilizar as notificações do Asaas, elas continuam seguindo as regras da conta, cliente e cobrança correspondente.

Posso utilizar Webhooks do Asaas com o Make?

Sim.

Use Webhooks quando um cenário precisar reagir a mudanças ocorridas no Asaas, em vez de executar consultas recorrentes para descobrir se um estado mudou.

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Evento ocorre no Asaas"] --> B["Enviar o Webhook"]
    B --> C["Receber o evento no Make"]
    C --> D["Processar os dados"]
    D --> E["Executar a próxima ação"]

    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

Os Webhooks do Asaas utilizam entrega at least once. Se o cenário executar uma ação que não pode ser repetida, utilize o id do evento para impedir processamento duplicado.

Para acompanhar cobranças, utilize os eventos de PAYMENT_*. Para o ciclo da assinatura, utilize os eventos de SUBSCRIPTION_*.

• Entenda como funcionam os Webhooks
• Consulte os eventos para cobranças
• Consulte os eventos para assinaturas

O Make está sujeito aos limites da API?

Sim.

As chamadas realizadas pelos módulos do Make continuam sujeitas aos limites, regras e validações da API do Asaas.

Quando um limite é excedido, a API pode retornar HTTP 429 Too Many Requests.

Consulte os Limites da API.

Erros comuns

O que validar antes de usar Produção?

Próximos passos

• Volte à visão geral do Make
• Conheça as funcionalidades do Make
• Escolha um template
• Entenda como funcionam os Webhooks
• Consulte as regras do Split de Pagamentos