Criar uma assinatura à partir de uma linha no Google Sheets

Este template permite automatizar a criação de assinaturas no Asaas a partir do preenchimento de uma linha em uma planilha do Google Sheets.

Sempre que uma nova linha for adicionada na planilha monitorada pelo Make, o cenário poderá localizar ou criar o cliente no Asaas e criar automaticamente uma assinatura, incluindo split de pagamentos quando necessário.

Esse modelo é indicado para operações recorrentes que desejam automatizar cobranças periódicas sem necessidade de desenvolvimento.

Quando utilizar

Este template é recomendado para:

• cobrança recorrente de clientes;
• mensalidades e assinaturas;
• serviços por recorrência;
• operações com split de pagamentos;
• automações utilizando Google Sheets e Make.

Dependências para utilização

Antes de configurar o template, é necessário:

• possuir uma conta no Make;
• possuir uma conta Asaas ativa;
• possuir uma API Key válida;
• possuir acesso ao Google Drive;
• possuir uma conta Google;
• utilizar a planilha modelo;
• possuir os dados necessários para criação do cliente e da assinatura.

📘

Importante

O ambiente selecionado no Make deve corresponder à API Key utilizada.

Fluxo da integração

Nova linha no Google Sheets
↓
Make identifica os dados
↓
Consulta cliente
↓
Cliente existe?
↓
Sim → Criar assinatura
Não → Criar cliente → Criar assinatura
↓
Assinatura criada
↓
Cobranças recorrentes passam a ser geradas automaticamente

Regras importantes

Para criação correta da assinatura:

• o cliente deve possuir informações válidas;
• a assinatura utilizará as configurações definidas no cenário;
• clientes duplicados são evitados através da consulta prévia;
• alterações na estrutura da planilha podem exigir ajustes no template;
• assinaturas criadas em ambiente Real possuem efeito financeiro real.

Parâmetros importantes

A planilha deve conter informações necessárias para criação do recurso.

Normalmente são utilizados:

Configuração do template

Faça o download da planilha modelo:

https://docs.google.com/spreadsheets/d/1tQXPy4h04JACJWHR3gO_vNaxvSx0EsgTaIuHrKuyt-U/edit?gid=0#gid=0

Caso prefira, faça uma cópia para o seu Google Drive.

1º Passo

Acesse o template:

https://us1.make.com/templates/11906-criacao-de-assinatura-com-split-de-pagamentos

2º Passo

Caso ainda não possua conta no Make, realize o cadastro:

https://www.make.com/en/register

Após acessar o template, clique em Start Guided Setup.

3º Passo

Conecte sua conta Google.

Selecione Create a Connection, informe um nome e realize o login.

4º Passo

Selecione a planilha hospedada no Google Drive.

5º Passo

Informe a localização da planilha e finalize a configuração do módulo Google Sheets.

6º Passo

Configure a conexão com o Asaas.

No campo Environment, selecione:

• Real (Produção); ou
• Sandbox.

Em seguida, informe sua API Key.

Após isso, o cenário estará pronto para utilização.

Exemplo de utilização

Google Forms
↓
Google Sheets
↓
Make
↓
Asaas
↓
Assinatura criada
↓
Cobranças recorrentes geradas automaticamente

Comportamentos importantes

Durante a execução:

• o Make consulta se o cliente já existe;
• caso o cliente não exista, ele será criado;
• a assinatura é criada apenas após a identificação do cliente;
• módulos com falha interrompem o fluxo;
• execuções repetidas podem gerar assinaturas duplicadas.

🚧

Atenção

Recomenda-se utilizar referências internas e validações para evitar duplicidade de assinaturas.

Módulos presentes na integração

Google Sheets (Watch New Rows)

Monitora novas linhas inseridas na planilha.

Asaas - Listar clientes

Verifica se o cliente já existe.

Asaas - Criar cliente

Cria o cliente caso ele ainda não exista.

Asaas - Fazer uma chamada API

Atualmente, a criação de assinaturas com split requer ajustes utilizando chamadas diretas para a API do Asaas.

Documentação:

https://docs.asaas.com/

Router

Controla o fluxo de criação.

Caminho 1

Cliente já cadastrado:

Google Sheets
↓
Localizar cliente
↓
Criar assinatura

Caminho 2

Cliente não cadastrado:

Google Sheets
↓
Criar cliente
↓
Criar assinatura

Impactos operacionais

Quando utilizado em ambiente Real:

• assinaturas reais serão criadas;
• cobranças recorrentes serão geradas automaticamente;
• notificações poderão ser enviadas aos clientes;
• erros de configuração podem gerar cobranças indevidas.

Por esse motivo, recomenda-se testar inicialmente em Sandbox.

Erros comuns

API Key inválida

A autenticação não corresponde ao ambiente selecionado.

Cliente não encontrado

Pode ocorrer quando os dados enviados estão incorretos.

Assinaturas duplicadas

Pode ocorrer devido à ausência de validações adicionais.

Erros no split

Podem ocorrer quando a configuração de distribuição não é válida.

Boas práticas

• Teste inicialmente em Sandbox.
• Utilize referências internas.
• Monitore os logs do Make.
• Implemente validações contra duplicidade.
• Revise periodicamente os cenários.
• Evite alterar a estrutura da planilha sem revisar os módulos.

Conteúdos relacionados

• Templates do Make;
• Vantagens e funcionalidades do Make;
• Criar clientes;
• Criar assinaturas;
• Split de pagamentos;
• Webhooks;
• Limites da API.