Notion, Airtable et Mailchimp

Sans l’intégration, l’app ne communique pas avec ces outils : l’action est refusée avec l’avertissement que l’intégration n’est pas configurée dans cette app. Aucun des trois n’exige d’autorisation dans le navigateur : il suffit de générer le jeton chez le fournisseur et de le coller sur la carte.

Avant de commencer

• Plan : Builder. Le plan est vérifié à chaque utilisation : si le compte quitte le Builder, l’app cesse de communiquer avec eux ;
• Coût : les trois ont des offres gratuites suffisantes pour commencer. Chaque appel de l’app consomme des crédits d’intégration, et seulement quand le fournisseur accepte ;
• Permission minimale. Ne donnez au jeton que l’accès dont l’app se sert, et seulement aux bases ou listes dont l’app a besoin. Les étapes ci-dessous indiquent le minimum pour chacun.

Les trois cartes se trouvent dans l’onglet Intégrations : Notion et Airtable dans la catégorie Productivité, Mailchimp dans Communication.

Notion

Champ de la carte : Internal Integration Token.

Ce que fait l’app : créer des pages dans une base (database) Notion, en remplissant les propriétés de la base. Par exemple, chaque formulaire envoyé dans l’app devient une ligne de la base.

1. sur app.notion.com/developers, créez une connection. Il faut être owner du workspace ;
2. dans l’onglet Configuration de la connection, copiez le jeton ;
3. si la connection demande des capacités, celle d’insérer du contenu est la seule dont l’app a besoin ;
4. ouvrez dans Notion la base que l’app utilisera, cliquez sur ••• puis sur Add connections, et choisissez votre connection ;
5. sur la carte Notion, collez le jeton et cliquez sur Enregistrer et activer.

L’étape 4 est celle qui bloque presque tout le monde : un jeton neuf ne voit aucune page. Sans donner accès à la base, Notion répond que la base n’existe pas, même avec le bon jeton.

Pour que l’app sache dans quelle base écrire, elle a besoin de l’ID de la base : c’est le long code dans l’adresse de la base, ouverte en pleine page. Indiquez-le dans le chat avec votre demande.

Airtable

Champ de la carte : Personal Access Token.

Ce que fait l’app : lister les enregistrements d’une table (avec filtre, tri et vue) et créer des enregistrements dans celle-ci.

1. sur airtable.com/create/tokens, cliquez sur Create new token ;
2. dans Scopes, ajoutez data.records:read (pour lister) et data.records:write (pour créer). Si l’app ne fait que lire, le premier suffit ;
3. dans Access, ajoutez uniquement la base que l’app utilisera. Sans cette étape, le jeton ne voit rien ;
4. cliquez sur Create token et copiez la valeur. Elle n’apparaît qu’une seule fois ;
5. sur la carte Airtable, collez le jeton et cliquez sur Enregistrer et activer.

Pour que l’app sache où lire et écrire, elle a besoin de l’ID de la base et du nom de la table. L’ID est la partie qui commence par app dans l’adresse de la base ouverte (airtable.com/appXXXXXXXX/…). Indiquez les deux dans le chat.

Les anciennes API keys d’Airtable ont été abandonnées : seul le Personal Access Token fonctionne.

Mailchimp

Champs de la carte : API key et Server prefix (facultatif, déduit de la clé).

Ce que fait l’app : inscrire un contact dans une audience (liste). Réinscrire un e-mail déjà présent dans la liste ne provoque pas d’erreur.

1. dans Mailchimp, cliquez sur votre avatar → Account & billing → Extras → API keys → Create A Key ;
2. copiez la clé entière, avec le suffixe (quelque chose comme …-us21). C’est du suffixe que vient le data center, et c’est pourquoi le Server prefix peut rester vide ;
3. dans Audience → All contacts → Settings → Audience name and defaults, copiez l’Audience ID ;
4. sur la carte Mailchimp, collez la clé et cliquez sur Enregistrer et activer ;
5. indiquez l’Audience ID dans le chat quand vous demandez à l’app d’inscrire des contacts.

La clé Mailchimp donne accès au compte entier, sans choix de portée. Créez une clé réservée à cette app, pour pouvoir la supprimer sans affecter d’autres usages.

Pour tester, utilisez une audience jetable : l’inscription est réelle et peut déclencher l’e-mail de bienvenue de la liste.

Savoir que cela a fonctionné

Ces trois cartes ne testent pas le jeton à l’enregistrement : Connectée veut dire que le jeton a été enregistré. La preuve est la première action réelle :

• Notion : envoyez le formulaire de l’app et regardez si la ligne est apparue dans la base ;
• Airtable : regardez si l’app liste les enregistrements de la table ;
• Mailchimp : inscrivez un e-mail de test et vérifiez-le dans l’audience.

En cas d’échec, l’erreur affichée contient le message du fournisseur lui-même.

Révoquer

Ouvrez la carte et cliquez sur Déconnecter. Supprimez ensuite le jeton là où vous l’avez créé : la connection dans Notion, le jeton sur airtable.com/create/tokens, la clé dans API keys sur Mailchimp.

Problèmes courants

• Notion dit que la base n’existe pas. L’étape Add connections manque sur la base, ou l’ID indiqué est celui d’une page et non d’une base ;
• Notion refuse les propriétés. Les noms et les types doivent correspondre aux colonnes de la base. Donnez à l’assistant les noms exacts des colonnes ;
• Airtable répond sans permission. Le jeton n’a pas la portée nécessaire ou n’a pas reçu l’accès à cette base ;
• Airtable refuse une valeur de liste d’options. Demandez à l’assistant d’écrire par le nom de l’option ; l’intégration l’accepte quand l’app le demande ;
• Mailchimp refuse la clé. Vérifiez que vous avez copié la clé entière, avec le suffixe. Si vous avez rempli le Server prefix, il doit être identique au suffixe de la clé (ou laissez-le vide) ;
• Beaucoup d’appels successifs à Airtable échouent. Airtable limite le nombre d’appels par seconde par base. Attendez quelques secondes et réessayez.