Apprendre mokapen

Read.ai

L'intégration Read.ai apporte automatiquement les transcriptions de réunions et les notes d'IA dans Mokapen. Lorsqu'un appel est traité dans Read.ai, Mokapen peut créer un document, une note, ou conserver uniquement l'URL de la réunion, et — lorsque c'est possible — lier le résultat au rendez-vous correspondant déjà présent dans votre calendrier.

Elle est conçue pour les équipes commerciales et de customer success qui enregistrent déjà leurs appels dans Read.ai et veulent que le résultat (résumé, actions, dialogue complet) soit disponible à côté du rendez-vous CRM, sans exporter les fichiers à la main.

Aperçu général des intégrations : Intégrations.

Prérequis

• Un forfait Mokapen qui inclut l'intégration Read.ai (Premium — icône médaille sur la page si non disponible sur votre forfait).
• Un compte Read.ai actif avec l'autorisation d'ajouter des webhooks dans Integrations.
• Facultatif mais recommandé : Google Calendar ou Outlook Calendar synchronisé avec Mokapen, afin que les rendez-vous puissent être associés par identifiant d'événement ou URL de réunion.

Connexion

Read.ai n'utilise pas une simple connexion par clé API dans Mokapen. Vous activez d'abord l'intégration, puis collez l'URL du webhook Mokapen dans Read.ai pour que les rapports de réunion soient livrés lorsqu'ils sont prêts.

1. Menu utilisateur → Intégrations → Read.ai.
2. Cliquez sur Sync / Connect pour activer l'intégration dans Mokapen (nécessite Premium).
3. Copiez l'URL du webhook affichée sur la page des paramètres.
4. Dans Read.ai → Integrations, créez un webhook pour l'événement meeting_end et collez cette URL.
5. Facultatif : copiez la clé de signature depuis Read.ai dans le champ Webhook secret de Mokapen, puis enregistrez.

Webhook

L'URL du webhook sur la page Intégrations → Read.ai est le point de terminaison que Read.ai doit appeler. Collez-la dans les paramètres Integrations de Read.ai pour l'événement meeting_end. Si Read.ai affiche une clé de signature, collez-la dans Webhook secret dans Mokapen afin que les requêtes puissent être vérifiées via X-Read-Signature.

Paramètres d'enregistrement

Toujours sur Intégrations → Read.ai, choisissez comment chaque réunion traitée est stockée dans Mokapen :

• Document — crée un document avec le contenu de la réunion (idéal pour partager de longues transcriptions avec l'équipe).
• Note — crée une note liée au rendez-vous associé ou disponible dans votre flux de notes.
• URL — conserve principalement le lien vers l'enregistrement dans Read.ai, sans importer le texte complet.

Vous pouvez aussi activer ou non l'inclusion du résumé et de la transcription (résumé IA, actions et transcription complète). Désactiver les deux en mode URL ne conserve qu'un pointeur léger vers l'enregistrement externe.

Association aux rendez-vous

Lorsqu'une transcription arrive, Mokapen tente de l'attacher à un rendez-vous existant :

1. D'abord, il recherche un identifiant de sync calendrier déjà stocké pour cette réunion (intégrations Google Calendar ou Outlook Calendar).
2. En cas d'échec, il compare l'URL de réunion de Read.ai avec le champ URL des rendez-vous.
3. Si aucun rendez-vous ne correspond, le document ou la note est quand même créé — il n'est simplement pas lié à un événement du calendrier.

Conseil : conservez sur la fiche rendez-vous le même lien de réunion que Read.ai enregistre (Zoom, Meet, Teams…), et maintenez la sync calendrier active pour l'association la plus fiable.

Partage avec l'équipe

Comme pour les autres intégrations Mokapen, vous pouvez partager la connexion Read.ai avec des collègues ou des équipes sélectionnés via les contrôles de partage sync sur la page des paramètres. Les utilisateurs partagés bénéficient des transcriptions dans l'organisation sans que chacun connecte sa propre clé.

Que se passe-t-il après une réunion

1. Read.ai termine le traitement de l'enregistrement et déclenche le webhook (ou Grain livre meeting_end).
2. Mokapen reçoit la charge utile, vérifie éventuellement la signature/le secret, et met en file un job en arrière-plan.
3. Le job récupère via API le résumé/la transcription si besoin, applique vos options d'enregistrement et crée l'enregistrement document/note/URL.
4. Si un rendez-vous correspondant est trouvé, le nouvel élément y est lié pour apparaître dans le contexte.
5. Les livraisons en double pour le même enregistrement sont ignorées via la déduplication sync, afin que les nouvelles tentatives ne créent pas de documents en double.

Problèmes courants

• Rien n'apparaît après un appel — vérifiez que le webhook est correctement collé dans Read.ai (sauf Grain, où c'est automatique), que l'intégration est toujours connectée, et que le forfait Premium inclut cette application.
• Document créé mais pas sur le rendez-vous — l'URL de réunion ou l'identifiant d'événement calendrier n'ont pas correspondus. Ouvrez le rendez-vous, vérifiez l'URL et assurez-vous que la sync calendrier est active.
• Webhook rejeté / erreurs de signature — le secret dans Mokapen doit correspondre exactement à celui configuré dans Read.ai ; régénérez les deux côtés en cas de doute.
• Seul le lien est enregistré — vérifiez Save as et les cases résumé/transcription ; le mode URL ignore volontairement le corps complet.
• Clé API invalide — régénérez la clé dans Read.ai et reconnectez depuis Intégrations → Read.ai.

Déconnexion

Utilisez Disconnect sur la page Intégrations → Read.ai (disponible pour l'utilisateur qui a connecté l'intégration). Supprimez ou désactivez aussi le webhook dans Read.ai si vous ne souhaitez plus de livraisons.

Les documents et notes déjà créés restent dans Mokapen ; la déconnexion arrête uniquement l'arrivée de nouvelles transcriptions.

Cas d'usage

• Suivi d'appel commercial — après un appel de discovery enregistré dans Read.ai, le résumé arrive en document sur le rendez-vous : l'AE peut partager les actions sans réécrire les notes.
• Archive QBR CS — les revues business trimestrielles restent recherchables dans les documents Mokapen, liées au rendez-vous client.
• Passage de relais entre rôles — les SDR enregistrent les démos dans Read.ai ; les closers ouvrent le rendez-vous associé et lisent la transcription sans changer d'outil.
• Pointeur CRM léger — utilisez le mode d'enregistrement URL lorsque vous n'avez besoin que d'un lien profond vers Read.ai depuis la fiche rendez-vous.

Questions fréquentes

Q : Mokapen enregistre-t-il la réunion lui-même ?

R : Non. L'enregistrement et la transcription se font dans Read.ai. Mokapen ne reçoit que le résultat via webhook et le stocke selon vos paramètres.

Q : Une clé API est-elle toujours obligatoire ?

R : Pas de clé API dans Mokapen pour Read.ai : activez l'intégration et configurez le webhook dans Read.ai.

Q : Que se passe-t-il s'il n'y a pas de rendez-vous correspondant ?

R : Le document ou la note est quand même créé. Vous pouvez le lier manuellement plus tard, ou corriger l'URL de réunion / la sync calendrier pour les appels suivants.

Q : Les collègues peuvent-ils utiliser ma connexion ?

R : Oui, si vous partagez l'intégration avec eux depuis les paramètres de partage sync sur la page Intégrations.

Q : Une reconnexion va-t-elle dupliquer d'anciennes réunions ?

R : Mokapen déduplique par identité de sync les enregistrements déjà importés. Les nouvelles réunions continuent de créer de nouveaux documents/notes.

Q : Où retrouver les paramètres plus tard ?

R : Menu utilisateur → Intégrations → Read.ai. L'URL du webhook, les secrets et les options d'enregistrement sont sur cette page après connexion.