Make/Integromat


O Make, anteriormente conhecido como Integromat, é uma plataforma de integração como serviço, também chamada de iPaaS, que permite conectar aplicativos e automatizar fluxos de trabalho sem necessidade de desenvolvimento avançado.

Com o Make, é possível criar automações chamadas de cenários, que movem dados entre sistemas, processam informações e executam ações automaticamente.

A integração entre Make e Asaas permite conectar recursos do Asaas a outras ferramentas, como planilhas, CRMs, bancos de dados, sistemas de mensageria, formulários, ERPs e plataformas de produtividade.


Quando utilizar

A integração com Make é indicada quando sua operação precisa automatizar processos envolvendo o Asaas sem desenvolver uma integração própria.

Alguns cenários comuns incluem:

  • criar cobranças a partir de linhas em uma planilha;
  • cadastrar clientes automaticamente no Asaas;
  • criar assinaturas ou parcelamentos;
  • enviar notificações para canais como Slack, Telegram ou e-mail;
  • sincronizar dados entre o Asaas e CRMs;
  • conectar formulários, planilhas e bancos de dados aos recursos do Asaas;
  • criar fluxos internos de conciliação, acompanhamento ou cobrança.

Essa integração é especialmente útil para operações que desejam validar fluxos rapidamente, automatizar tarefas repetitivas ou conectar o Asaas a ferramentas que já fazem parte da rotina do negócio.


Como funciona a integração

No Make, cada automação é construída através de um cenário.

Um cenário normalmente possui:

  • um gatilho inicial, como uma nova linha em uma planilha;
  • módulos intermediários para consulta, criação ou atualização de dados;
  • filtros e rotas condicionais;
  • ações executadas no Asaas ou em outros sistemas conectados.

Um fluxo típico pode seguir a estrutura abaixo:

Evento ocorre em um sistema externo
↓
Make inicia o cenário
↓
Dados são tratados e validados
↓
Make executa uma ação no Asaas
↓
Resultado é enviado para outro sistema
↓
Cenário registra a execução

Dependências para utilização

Antes de utilizar o Make com o Asaas, é necessário possuir:

  • uma conta ativa no Asaas;
  • uma conta ativa no Make;
  • API Key do Asaas;
  • acesso aos sistemas que serão conectados ao cenário;
  • permissões necessárias para criar conexões no Make;
  • definição clara dos dados que serão enviados para o Asaas.
📘

Importante

Ao configurar a conexão com o Asaas no Make, selecione corretamente o ambiente desejado, como produção ou sandbox, e utilize a API Key correspondente ao ambiente selecionado.


Recursos que podem ser automatizados

A integração com Make pode ser utilizada para automatizar diferentes operações relacionadas ao Asaas, como:

  • criação de clientes;
  • consulta de clientes existentes;
  • criação de cobranças;
  • criação de cobranças com split;
  • criação de assinaturas;
  • criação de parcelamentos;
  • envio de notificações;
  • integração com planilhas, formulários, CRMs e bancos de dados.

Dependendo do recurso utilizado, pode ser necessário configurar módulos específicos ou utilizar o módulo de chamada API para realizar requisições diretamente à API do Asaas.


Parâmetros e configurações importantes

Durante a criação de cenários no Make, alguns campos influenciam diretamente o funcionamento da integração:

ConfiguraçãoFinalidade
API KeyCredencial utilizada para conectar o Make à conta Asaas.
EnvironmentDefine se a integração utilizará o ambiente de produção ou sandbox.
Módulo AsaasDefine qual ação será executada no Asaas.
Campos obrigatóriosDados necessários para criação de clientes, cobranças, assinaturas ou parcelamentos.
Filtros e rotasDeterminam qual caminho o cenário seguirá conforme os dados recebidos.
AgendamentoDefine quando ou com qual frequência o cenário será executado.
Tratamento de errosDefine como o cenário deve se comportar em caso de falha.

Comportamentos importantes

Ao utilizar Make com Asaas, considere que:

  • os cenários executam ações conforme a ordem dos módulos configurados;
  • falhas em um módulo podem interromper a execução do cenário;
  • dados obrigatórios ausentes podem impedir a criação de clientes, cobranças ou assinaturas;
  • filtros e rotas mal configurados podem direcionar dados para caminhos incorretos;
  • chamadas realizadas pelo Make continuam sujeitas às regras e limites da API do Asaas;
  • integrações que criam registros no Asaas devem evitar duplicidade de clientes e cobranças;
  • logs de execução do Make devem ser monitorados para identificar falhas de automação.

Exemplo de fluxo

Um exemplo comum de integração consiste em criar cobranças no Asaas a partir de uma nova linha no Google Sheets:

Nova linha adicionada no Google Sheets
↓
Make identifica os dados da linha
↓
Make consulta se o cliente já existe no Asaas
↓
Se o cliente existir, utiliza o ID existente
↓
Se o cliente não existir, cria um novo cliente
↓
Make cria a cobrança no Asaas
↓
Make registra ou notifica o resultado da operação

Esse modelo pode ser adaptado para formulários, CRMs, bancos de dados ou outros sistemas conectados ao Make.


Boas práticas

  • Utilize a API Key correspondente ao ambiente correto.
  • Teste o cenário em sandbox antes de operar em produção.
  • Valide os dados obrigatórios antes de criar registros no Asaas.
  • Utilize filtros para evitar duplicidade de clientes e cobranças.
  • Monitore os logs de execução dos cenários.
  • Configure tratamento de erros para falhas temporárias.
  • Evite expor API Keys em campos públicos, planilhas compartilhadas ou logs.
  • Revise periodicamente os cenários ativos.

Erros comuns

API Key inválida

Pode ocorrer quando a chave informada está incorreta ou não corresponde ao ambiente selecionado.

Cliente duplicado

Pode ocorrer quando o cenário cria clientes sem consultar previamente se o cadastro já existe no Asaas.

Campos obrigatórios ausentes

Pode ocorrer quando a origem dos dados, como uma planilha ou formulário, não possui todas as informações necessárias para a operação.

Cenário interrompido

Pode ocorrer quando algum módulo falha e não há tratamento de erro configurado.

Ambiente incorreto

Pode ocorrer quando o cenário é configurado em sandbox utilizando uma chave de produção, ou o contrário.


Impactos operacionais

Cenários configurados no Make podem executar ações automaticamente na conta Asaas.

Por isso, alterações em planilhas, formulários, CRMs ou bancos de dados conectados podem gerar cobranças, clientes, assinaturas ou outras operações financeiras.

Antes de ativar um cenário em produção, recomenda-se validar:

  • origem dos dados;
  • campos obrigatórios;
  • regras de duplicidade;
  • ambiente configurado;
  • comportamento em caso de erro;
  • logs de execução;
  • permissões das contas conectadas.

Integrações mais utilizadas

Através do Make, é possível integrar o Asaas a mais de 500 sistemas.

Algumas integrações utilizadas com frequência são:

Para visualizar a lista completa de sistemas disponíveis através do Make, clique aqui.


Próximos passos

Para continuar a implementação, consulte os conteúdos desta seção:

  • Vantagens e funcionalidades;
  • Templates;
  • Criar uma cobrança avulsa a partir de uma linha no Google Sheets;
  • Criar uma assinatura a partir de uma linha no Google Sheets;
  • Criar um parcelamento a partir de uma linha no Google Sheets;
  • Autenticação da API;
  • Webhooks.