Activer les intégrations

L’app peut avoir l’écran de paiement, le champ d’adresse ou le bouton d’envoi de message prêts et malgré tout ne pas fonctionner : c’est le fournisseur qui exécute ces actions, avec votre compte. Sans identifiant enregistré, l’écran existe et l’action n’a pas lieu.

Où cela se trouve

Onglet Intégrations, dans l’éditeur. Il comporte deux sous-onglets :

• Fournisseurs : une carte par service du catalogue, avec une recherche par nom, les filtres Toutes, Connectées et Non connectées, et les catégories (Paiements, Localisation, Notifications, Productivité et d’autres) ;
• APIs externes : pour enregistrer une API absente du catalogue, avec la clé conservée sur le serveur et utilisée par une fonction backend.

Deux sujets proches vivent dans d’autres onglets : la connexion sociale (Google, Apple, Microsoft et d’autres) se trouve dans Authentification, et le domaine d’envoi des e-mails se trouve dans Domaines.

Plan

L’onglet Intégrations s’ouvre dans tous les plans, et une partie des cartes fonctionne dans chacun d’eux, y compris en Free. Les autres demandent le plan Builder.

Dans les plans Free et Starter, les cartes qui demandent le Builder apparaissent grisées, le bandeau « Les intégrations sont une fonctionnalité du plan Builder » s’affiche en haut de l’onglet, et un clic sur l’une de ces cartes mène aux plans. Les autres s’ouvrent et se connectent normalement.

Le sous-onglet APIs externes relève aussi du plan Builder.

Le serveur vérifie également le plan à chaque utilisation pour WhatsApp, Telegram, Shopify, Meta, Notion, Airtable, Mailchimp et Webhook (sortant). Si le compte quitte le Builder, ces intégrations cessent de répondre dans l’app publiée, même avec l’identifiant toujours enregistré.

L’e-mail avec votre propre domaine est un cas à part : il se trouve dans l’onglet Domaines et vaut pour tout plan payant. Voir E-mail avec votre propre domaine.

Connecter une carte

1. cliquez sur la carte ;
2. remplissez les champs demandés (chaque guide ci-dessous indique où obtenir chacun) ;
3. cliquez sur Enregistrer et activer.

La plateforme enregistre et, chez les fournisseurs qui le permettent, teste l’identifiant sur-le-champ. Un champ secret déjà enregistré apparaît ensuite avec « · configuré » à côté de son nom. Déconnecter, en bas de la carte, efface l’identifiant de la plateforme.

Pour changer une clé d’une carte déjà connectée, saisissez seulement ce champ et enregistrez. Un champ laissé vide conserve sa valeur enregistrée, et ce que la plateforme enregistre elle-même (comme le secret du webhook Stripe et l’accès autorisé des connexions par autorisation) reste en place.

Les clés sont chiffrées sur le serveur et ne reviennent jamais à l’écran, ni ne partent vers le navigateur des personnes qui utilisent l’app.

Ce que signifie chaque état

Toutes les cartes ne peuvent pas tester l’identifiant à l’enregistrement, et cela change ce que Connectée garantit :

• testent réellement, en interrogeant le fournisseur : Stripe, Mercado Pago, Pagar.me, Hotmart et Google Maps ;
• vérifient seulement le format de l’ID : Meta Pixel, Google Analytics, Google AdSense, Google Tag Manager, Microsoft Clarity, Hotjar et les chats (Baseportal Chat, Crisp, Tawk.to) ;
• enregistrent seulement, sans test : SMS (Twilio), WhatsApp, Slack, Discord, Telegram, Notion, Airtable, Mailchimp, Webhook (sortant), Shopify, Meta (Facebook/Instagram) et Google Workspace. Pour celles-ci, Connectée veut dire « enregistrée », et la preuve que cela fonctionne est le premier envoi réel.

Quand le test échoue, la fenêtre affiche « Enregistré, mais la validation a échoué » suivi du motif donné par le fournisseur. La voie est de corriger l’identifiant chez le fournisseur, pas de recoller la même valeur.

Clés de test et de production

Plusieurs fournisseurs donnent deux jeux d’identifiants : un de test, qui ne déplace pas d’argent et ne livre rien pour de vrai, et un de production.

• Stripe, Mercado Pago et Pagar.me n’ont pas de bouton d’environnement sur la carte : ce qui décide, c’est la clé que vous collez. Clé de test, paiement de test. Remplacez-les par celles de production avant de vendre ;
• Hotmart propose l’option « Utiliser l'environnement de test (sandbox) ». Laissez-la décochée avec des identifiants de production ;
• WhatsApp et Twilio ont des limites en mode test (numéros de destination autorisés, jeton qui expire). Le guide de chacun les explique.

Crédits d’intégration

Configurer une intégration ne consomme aucun crédit. Ce qui consomme, ce sont les crédits d’intégration, la monnaie pour faire tourner l’app, quand l’app publiée utilise le fournisseur : chaque SMS (y compris le code de connexion par SMS), chaque e-mail d’automatisation ou de notification envoyé par l’app, chaque notification sur Slack ou Discord, chaque message WhatsApp ou Telegram et chaque appel à Shopify, Meta, Notion, Airtable, Mailchimp, Webhook (sortant), Google Workspace et aux APIs externes.

Le débit n’a lieu que lorsque le fournisseur accepte. Un appel qui échoue n’est pas facturé. Avec un solde à zéro, ces envois sont refusés jusqu’au retour du solde.

Les paiements et Google Maps ne consomment pas de crédits d’intégration. Maps utilise le quota et la facturation de votre projet chez Google.

Le solde et la consommation du mois se trouvent dans le panneau, sous Facturation. Voir Crédits.

L’assistant signale ce qui manque

Après un build, le chat affiche la carte Pour que ça marche vraiment, avec chaque intégration que le code de l’app utilise et qui n’est pas encore active. Chaque élément a deux boutons :

• Activer dans Intégrations : ouvre l’onglet Intégrations directement sur la carte de cette intégration (pour les paiements, dans la catégorie Paiements, où vous choisissez la passerelle) ;
• Comment activer : ouvre le guide de ce fournisseur, dans cette documentation.

Quand une intégration devient active, l’assistant le confirme dans le chat.

L’assistant lit aussi, à chaque conversation, l’état de vos intégrations : lesquelles sont connectées, lesquelles sont enregistrées mais en défaut et lesquelles n’ont pas été connectées. Vous pouvez demander dans le chat « Stripe est-il actif ? ». Il voit l’état, jamais la valeur des clés.

Guides par fournisseur

Les cartes Analytics (Meta Pixel, Google Analytics, Google Tag Manager, Microsoft Clarity, Hotjar), Chat et Consentement aux cookies ne demandent qu’un ID, et la description de la carte elle-même indique où le trouver.

Problèmes courants

• La carte est verte et rien ne se passe. Regardez dans quel groupe elle figure dans la liste ci-dessus : pour les cartes qui enregistrent seulement, Connectée ne prouve pas que la clé est la bonne. Faites un envoi réel et lisez l’erreur ;
• J’ai enregistré une passerelle et l’autre a disparu. Stripe, Mercado Pago et Pagar.me partagent la même place : une seule reste active par app, et en enregistrer une autre remplace la précédente. Les clés de l’ancienne passerelle ne passent pas à la nouvelle : remplissez les champs de la nouvelle passerelle ;
• La carte ouvre l’écran des plans. Le compte est en Free ou en Starter et cette carte demande le Builder. Voir le tableau de la section Plan ci-dessus.