Connecteurs et domaine

Votre CRM ne vit pas seul. Ce guide couvre ce qui le relie au reste de vos outils : les comptes Google et Microsoft de vos collaborateurs, l’API publique, les webhooks sortants et, en mode illimité, votre propre nom de domaine.

Connecter un compte Google ou Microsoft

Chaque collaborateur peut connecter son compte Google ou Microsoft depuis « Paramètres → Intégrations ». La connexion demande seulement l’identité du compte (nom, adresse e-mail) : c’est le socle sur lequel s’appuient les fonctions qui utilisent ce compte.

Pour connecter votre compte :

1. Ouvrez « Paramètres → Intégrations ».
2. Choisissez Google ou Microsoft et acceptez la demande du fournisseur.
3. De retour dans le CRM, le compte apparaît comme connecté.

Un compte que le fournisseur ne reconnaît plus s’affiche « À reconnecter » : il suffit de le connecter de nouveau. La déconnexion est immédiate.

Mode illimité et mode test

• En mode illimité, la connexion passe par nos propres applications Google et Microsoft : vous n’avez rien à enregistrer chez le fournisseur.
• En mode test, un administrateur doit d’abord déclarer l’application de votre organisation dans « Intégrations » → Applications OAuth de votre organisation (identifiant et secret), avec l’adresse de redirection affichée sur la page.

Si votre espace repasse en mode test, les comptes connectés par nos applications cessent de se rafraîchir jusqu’au retour en illimité, ou jusqu’à ce que vous déclariez votre propre application.

L’API publique et les clés d’API

L’API REST permet à vos autres outils (Zapier, Make, un ERP, vos scripts) de lire et d’écrire les contacts, les entreprises, les transactions et les activités, et de lire les listes et les propriétés.

Pour créer une clé :

1. Ouvrez « Paramètres → Clés d’API ».
2. Donnez-lui un nom, choisissez ses portées (par exemple contacts:read ou deals:write) et, si vous le souhaitez, une date d’expiration.
3. Copiez le secret : il n’est affiché qu’une fois.

Une clé voit et modifie toutes les fiches de l’organisation, quels que soient les rôles : ses portées limitent les ressources, pas le périmètre. Gardez-la sur un serveur, jamais dans une page web. Une clé se révoque sans délai, et chaque écriture apparaît dans le fil des fiches sous le nom de la clé.

L’API répond sur l’adresse technique de votre espace, en .convex.site, et non sur <slug>.fabulous-crm.com ; écrivez-nous si vous ne la connaissez pas. La référence de l’API et la présentation de l’API publique décrivent les routes, la pagination, l’idempotence et les limites de débit. En mode test, votre espace compte jusqu’à 5 000 appels API par mois.

Les webhooks sortants (mode illimité)

Un webhook prévient un autre outil à chaque création, modification ou suppression d’un contact, d’une entreprise, d’une transaction ou d’une activité, que le changement vienne de l’interface, de l’API, d’un import ou d’un workflow.

Pour ajouter un webhook :

1. Ouvrez « Paramètres → Webhooks ». En mode test, la page propose de passer en illimité.
2. Saisissez l’adresse de destination, obligatoirement en https et publique.
3. Choisissez les événements, par exemple « Contacts · Créé » ou « Transactions · Étape du pipeline modifiée », ou tous.
4. Enregistrez et copiez le secret de signature : il n’est affiché qu’une fois.
5. Envoyez un événement de test pour vérifier la réception.

Chaque envoi est un POST signé : l’en-tête X-Fabulous-Signature vaut v1= suivi du HMAC-SHA256, calculé avec votre secret, de <timestamp>.<corps>, où le timestamp est celui de l’en-tête X-Fabulous-Timestamp. Vérifiez cette signature et refusez un timestamp de plus de cinq minutes.

Votre outil a dix secondes pour répondre. Un envoi qui échoue est réessayé six fois, de une minute à douze heures plus tard. Après trente échecs de suite, le webhook est désactivé jusqu’à ce qu’un administrateur le réactive. Un même événement peut arriver deux fois : classez-les par date de création.

La page montre l’état de chaque webhook et un journal des envois, conservé trente jours, avec le corps envoyé. Vous pouvez y mettre un webhook en pause, changer son secret ou renvoyer un envoi. Un espace compte au plus dix webhooks.

Votre propre nom de domaine (mode illimité)

En mode illimité, votre CRM peut aussi répondre à votre propre adresse, par exemple crm.votre-entreprise.fr.

Pour l’obtenir :

1. Chez votre hébergeur DNS, créez un enregistrement CNAME du sous-domaine choisi vers l’adresse que nous vous indiquons, ou à défaut vers <slug>.fabulous-crm.com.
2. Écrivez-nous à contact@fabulous-crm.com avec le nom choisi : nous le mettons en place.
3. Le certificat HTTPS est obtenu automatiquement à la première visite.

Préférez un sous-domaine : un domaine nu (votre-entreprise.fr) demande un enregistrement ALIAS ou ANAME, que tous les hébergeurs DNS ne proposent pas.

Les deux adresses continuent de fonctionner, et les e-mails de connexion et d’invitation pointent ensuite vers votre domaine. Si votre espace repasse en mode test, le domaine cesse d’être servi ; il revient avec l’abonnement.