Prise de rendez-vous
Intégration Cal.com
Quand l'un de vos contacts prend rendez-vous avec Cal.com, arteemis l'enregistre sur le contact et passe son opportunité à l'étape de votre choix. L'entrée dans le pipeline arrête les séquences du contact : personne ne reçoit de relance après avoir pris rendez-vous. Cal.com se connecte avec une clé d'API de votre compte, sur cal.com ou sur votre propre Cal.com.
Ce qu'elle fait
Ce qu'arteemis fait d'un rendez-vous
- Chaque participant est rapproché d'un contact de votre espace par son adresse email, puis par une adresse depuis laquelle il a écrit. Personne n'est créé pour une adresse que l'espace ne connaît pas.
- Le rendez-vous est enregistré dans l'activité du contact, avec le nom et l'heure de la réunion.
- L'opportunité du contact passe à l'étape choisie (l'étape de rendez-vous au départ), jamais en arrière ni au-delà. Un contact absent du pipeline y entre à cette étape, ce qui arrête ses séquences en cours.
- Un rendez-vous déplacé compte comme un rendez-vous pris. Une annulation est enregistrée et ne déplace rien.
Ce qu'arteemis met en place dans Cal.com
- Un webhook pour les rendez-vous créés, annulés et déplacés, signé avec un secret qui lui est propre.
La clé d'API est vérifiée, puis chiffrée : arteemis ne s'en sert que pour lire votre compte et créer ou supprimer son webhook. Chaque appel de Cal.com est vérifié avec le secret du webhook avant que rien ne soit enregistré.
Prérequis
- Le rôle de propriétaire ou d'administrateur de votre espace arteemis : eux seuls connectent les intégrations.
- Une clé d'API Cal.com, créée dans Cal.com sous Settings > Developer > API keys (elle commence par cal_).
- Un Cal.com auto-hébergé doit être joignable en https à une adresse publique.
Installation
Créer une clé d'API
- 1Dans Cal.com, ouvrez Settings > Developer > API keys, créez une clé et copiez-la.
Connecter
- 1Connectez-vous à arteemis et ouvrez Paramètres > Intégrations.
- 2Sous Prise de rendez-vous, choisissez Connecter sur la carte Cal.com.
- 3Collez la clé dans Clé d'API. Pour un Cal.com auto-hébergé, indiquez son adresse dans Adresse auto-hébergée ; laissez vide pour cal.com. Puis choisissez Connecter.
- 4arteemis vérifie la clé et crée son webhook. La carte indique Connecté à, suivi de votre compte Cal.com.
Choisir l'étape
- 1Choisissez Réglages sur la carte Cal.com.
- 2Sous Quand un rendez-vous est pris, passer l'opportunité à, gardez l'étape de rendez-vous, choisissez-en une autre, ou choisissez Ne pas la déplacer pour seulement enregistrer le rendez-vous. La modification est enregistrée aussitôt.
Données échangées
| Données | Sens | Détails |
|---|---|---|
| Webhook | D'arteemis vers Cal.com | Créé à la connexion, pour les rendez-vous créés, annulés et déplacés ; supprimé à la déconnexion. |
| Rendez-vous | De Cal.com vers arteemis | Adresses email des participants, nom de la réunion, heure de début, s'il s'agit d'un déplacement ou d'une annulation. |
| Compte | De Cal.com vers arteemis | Votre utilisateur Cal.com, pour vérifier la clé et nommer la connexion. |
Déconnexion
- Dans Paramètres > Intégrations, choisissez Réglages sur la carte Cal.com, puis Déconnecter en bas, et confirmez.
- arteemis supprime son webhook dans Cal.com, puis la connexion, sa clé et ses réglages. Les rendez-vous déjà enregistrés restent sur les contacts.
- La clé elle-même reste valide dans Cal.com : supprimez-la sous Settings > Developer > API keys.
Dépannage
- La clé est refusée
- Vérifiez que vous avez copié toute la clé, qu'elle n'a pas été supprimée dans Cal.com, et, pour un Cal.com auto-hébergé, que l'adresse est juste et joignable en https.
- Un rendez-vous n'a pas été enregistré
- Aucune adresse email des participants n'est celle d'un de vos contacts, ni une adresse depuis laquelle il a écrit. arteemis ne crée personne à partir d'un rendez-vous.
- Une annulation n'a pas fait reculer l'opportunité
- C'est voulu : rien dans arteemis ne fait reculer une opportunité. L'annulation est enregistrée sur le contact.
Support
romain@arteemis.xyz
Une question sur cette intégration, ou quelque chose qui ne fonctionne pas comme décrit ici : écrivez-nous. Vous recevez une réponse sous un jour ouvré, en français ou en anglais.
Envoyer un email