Entenda os recursos do Make

Use cenários, módulos, filtros, rotas, Webhooks e agendamentos do Make para automatizar fluxos entre o Asaas e outras ferramentas.

Escolha os recursos conforme o comportamento necessário no cenário. Para implementações prontas, utilize os templates e guias desta seção.

Principais recursos

Cenários

Um cenário representa um fluxo de automação composto por módulos conectados.

Exemplo:

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Receber dados do Google Forms"] --> B["Registrar no Google Sheets"]
    B --> C["Executar ação no Asaas"]
    C --> D["Enviar mensagem no Slack"]

    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

Utilize cenários quando uma operação precisar combinar etapas entre o Asaas e outros sistemas.

Módulos

Os módulos são os componentes executados dentro de um cenário.

O app oficial do Asaas no Make disponibiliza módulos para operações como:

• criar e consultar clientes;
• criar e atualizar cobranças;
• criar assinaturas;
• criar parcelamentos;
• criar cobranças com Split;
• obter QR Code Pix;
• consultar recursos do Asaas;
• realizar uma chamada autenticada à API.

Quando houver um módulo nativo para a operação, prefira utilizá-lo. Para recursos não cobertos pelo conector, avalie o módulo Fazer uma chamada API.

Gatilhos e ações

O gatilho inicia o cenário. A ação executa uma operação após esse início.

Por exemplo:

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Adicionar linha na planilha"] --> B["Criar cliente no Asaas"]
    B --> C["Criar cobrança"]
    C --> D["Enviar notificaçã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 validacao
    class D sucesso

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

O app do Asaas no Make também disponibiliza o gatilho Monitorar Cobranças para fluxos relacionados a alterações em cobranças.

Filtros e rotas

Use filtros quando o cenário só deve continuar se os dados atenderem a determinadas condições.

Use rotas quando o processo precisar seguir caminhos diferentes.

Por exemplo, antes de criar uma cobrança, o cenário pode verificar se o cliente já foi localizado:

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Consultar o cliente"] --> B{"Cliente encontrado?"}

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

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

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

    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 B decisao
    class C,D validacao
    class E sucesso
    class Sim respostaSim
    class Nao respostaNao

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

Filtros também podem ser utilizados para validar dados obrigatórios ou evitar que um registro siga para uma etapa indevida.

Webhooks

Use Webhooks quando o cenário precisar reagir automaticamente a eventos enviados pelo Asaas.

Esse modelo é indicado, por exemplo, para atualizar outro sistema após uma mudança relevante em cobranças ou outros recursos.

Quando o objetivo for acompanhar mudanças de estado, prefira Webhooks a cenários que executam consultas periódicas à API.

Entenda como funcionam os Webhooks do Asaas.

Consulte os eventos disponíveis.

Agendamento

O agendamento executa um cenário em horários ou intervalos definidos.

Utilize-o para tarefas que realmente dependem de processamento periódico, como:

• importar dados em lote;
• gerar relatórios;
• executar rotinas administrativas;
• processar uma fonte que não oferece eventos.

Não utilize agendamento com consultas recorrentes apenas para descobrir alterações que podem ser recebidas por Webhook.

Tratamento de erros

Falhas em um módulo podem impedir a continuidade do cenário.

Configure o tratamento conforme a criticidade do fluxo e utilize o histórico de execução para identificar:

• qual módulo falhou;
• quais dados foram processados;
• qual erro foi retornado;
• quais etapas foram executadas antes da falha.

Antes de reprocessar um cenário que cria registros no Asaas, confirme se a operação anterior foi concluída para evitar duplicidades.

Regras da API continuam válidas

As chamadas executadas pelo Make continuam sujeitas às regras da API do Asaas.

Isso inclui:

• autenticação;
• ambiente da API Key;
• campos obrigatórios;
• regras dos recursos utilizados;
• limites de requisição e cota.

Se o cenário realizar muitas chamadas, consulte Limites da API.

Escolha o próximo fluxo

Quero partir de um cenário pronto

Consulte Templates.

Quero criar uma cobrança pelo Google Sheets

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

Quero criar uma assinatura

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

Quero criar um parcelamento

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

Próximos passos

• Utilize um template
• Crie uma cobrança pelo Google Sheets
• Crie uma assinatura pelo Google Sheets
• Crie um parcelamento pelo Google Sheets
• Consulte o FAQ do Make
• Conheça os Webhooks do Asaas