Notion, Airtable e Mailchimp

Sem a integração, o app não fala com essas ferramentas: a ação é recusada com o aviso de que ela não está configurada neste app. Nenhuma das três exige autorizar no navegador: basta gerar o token no provedor e colar no card.

Antes de começar

• Plano: Builder. O plano é conferido a cada uso: se a conta sair do Builder, o app para de falar com elas;
• Custo: as três têm planos gratuitos que servem para começar. Cada chamada que o app faz consome créditos de integração, e só quando o provedor aceita;
• Permissão mínima. Dê ao token só o acesso que o app usa, e só às bases ou listas que o app precisa. Os passos abaixo dizem qual é o mínimo em cada uma.

Os três cards ficam na aba Integrações: Notion e Airtable na categoria Produtividade, Mailchimp em Comunicação.

Notion

Campo do card: Internal Integration Token.

O que o app faz: cria páginas numa base (database) do Notion, preenchendo as propriedades da base. Por exemplo, cada formulário enviado no app vira uma linha na base.

1. em app.notion.com/developers, crie uma connection. É preciso ser owner do workspace;
2. na aba Configuration da connection, copie o token;
3. se a connection pedir capacidades, a de inserir conteúdo é a única de que o app precisa;
4. abra no Notion a base que o app vai usar, clique em ••• e em Add connections, e escolha a sua connection;
5. no card Notion, cole o token e clique em Salvar e ativar.

O passo 4 é o que trava quase todo mundo: um token novo não enxerga nenhuma página. Sem dar acesso à base, o Notion responde que a base não existe, mesmo com o token certo.

Para o app saber em qual base gravar, ele precisa do ID da base: é o código longo no endereço da base, quando aberta como página inteira. Informe no chat junto com o pedido.

Airtable

Campo do card: Personal Access Token.

O que o app faz: lista registros de uma tabela (com filtro, ordem e visualização) e cria registros nela.

1. em airtable.com/create/tokens, clique em Create new token;
2. em Scopes, adicione data.records:read (para listar) e data.records:write (para criar). Se o app só lê, o primeiro basta;
3. em Access, adicione só a base que o app vai usar. Sem esse passo o token não enxerga nada;
4. clique em Create token e copie o valor. Ele só aparece uma vez;
5. no card Airtable, cole o token e clique em Salvar e ativar.

Para o app saber onde ler e gravar, ele precisa do ID da base e do nome da tabela. O ID é o trecho que começa com app no endereço da base aberta (airtable.com/appXXXXXXXX/…). Informe os dois no chat.

As antigas API keys do Airtable foram descontinuadas: só o Personal Access Token funciona.

Mailchimp

Campos do card: API key e Server prefix, marcado como opcional.

O que o app faz: inscreve um contato numa audiência (lista). Inscrever de novo um e-mail que já está na lista não dá erro.

1. no Mailchimp, clique no seu avatar → Account & billing → Extras → API keys → Create A Key;
2. copie a chave inteira, com o sufixo (algo como …-us21). É do sufixo que sai o data center, e por isso o Server prefix pode ficar em branco;
3. em Audience → All contacts → Settings → Audience name and defaults, copie o Audience ID;
4. no card Mailchimp, cole a chave e clique em Salvar e ativar;
5. informe o Audience ID no chat quando pedir ao app para inscrever contatos.

A chave do Mailchimp dá acesso à conta inteira, sem escolha de escopo. Crie uma chave só para este app, para poder apagá-la sem afetar outros usos.

Para testar, use uma audiência descartável: a inscrição é real e pode disparar o e-mail de boas-vindas da lista.

Como saber que funcionou

Estes três cards não testam o token ao salvar: Conectado quer dizer que o token foi salvo. A prova é a primeira ação real:

• Notion: envie o formulário do app e veja se a linha apareceu na base;
• Airtable: veja se o app lista os registros da tabela;
• Mailchimp: inscreva um e-mail de teste e confira na audiência.

Se falhar, o erro que aparece traz a mensagem do próprio provedor.

Como revogar

Abra o card e clique em Desconectar. Depois apague o token no mesmo lugar em que o criou: a connection no Notion, o token em airtable.com/create/tokens, a chave em API keys no Mailchimp.

Problemas comuns

• Notion diz que a base não existe. Falta o passo Add connections na base, ou o ID informado é de uma página e não de uma base;
• Notion recusa as propriedades. Os nomes e tipos têm de bater com as colunas da base. Diga ao assistente os nomes exatos das colunas;
• Airtable responde sem permissão. O token não tem o escopo necessário ou não recebeu acesso àquela base;
• Airtable recusa um valor de lista de opções. Peça ao assistente que grave pelo nome da opção; a integração aceita isso quando o app pede;
• Mailchimp recusa a chave. Confira se copiou a chave inteira, com o sufixo. Se preencheu o Server prefix, ele tem de ser igual ao sufixo da chave (ou deixe em branco);
• Muitas chamadas seguidas ao Airtable falham. O Airtable limita a quantidade de chamadas por segundo por base. Espere alguns segundos e tente de novo.