Apprendre mokapen

Fireflies

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

Ceci est conçu pour les équipes de vente et de réussite client qui enregistrent déjà des appels dans Fireflies et souhaitent que le résultat (résumé, éléments d'action, dialogue complet) soit disponible à côté du rendez-vous CRM, sans exporter les fichiers manuellement.

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

Exigences

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

Connexion

Contrairement aux applications de calendrier OAuth, Fireflies se connecte avec une API key. Vous collez la clé une fois dans Mokapen, puis configurez le webhook qui avertit Mokapen lorsqu'une transcription est prête.

1. Menu utilisateur → Intégrations → Lucioles.
2. Cliquez sur Sync / Connect (nécessite un forfait Premium adéquat).
3. Créez ou copiez votre clé API depuis Fireflies (documentation développeur).
4. Collez la clé dans Mokapen et confirmez Connect.
5. Lorsque le lien réussit, la page affiche le compte connecté, déverrouille le webhook et enregistre les paramètres.

Webhook

Après avoir connecté la clé API, la page Intégrations → Lucioles affiche une URL de webhook à copier. Collez-le dans les paramètres du développeur Fireflies et abonnez-vous à l'événement qui se déclenche lorsqu'une transcription est prête (généralement réunion transcrite/résumée).

Définissez éventuellement un Webhook secret dans Mokapen et utilisez la même valeur que le secret de signature de webhook facultatif configuré dans les paramètres du développeur Fireflies. Ceci est recommandé en production, donc seules les demandes authentiques de Fireflies sont acceptées.

Appuyez sur Enregistrer sur la page Mokapen après avoir modifié le secret du webhook ou enregistré les options.

Enregistrer les paramètres

Toujours sur Intégrations → Lucioles, 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 correspondant ou disponible dans votre flux de notes.
• URL — stocke principalement le lien vers l'enregistrement dans Fireflies, sans importer le corps du texte intégral.

Vous pouvez également choisir d'inclure ou non le summary et le transcript (résumé AI, éléments d'action et transcription complète). La désactivation des deux avec le mode URL ne conserve qu'un pointeur léger vers l'enregistrement externe.

Rendez-vous concordants

Lorsqu'un relevé de notes arrive, Mokapen essaie de le joindre à un rendez-vous existant :

1. Tout d'abord, il recherche un identifiant de synchronisation de calendrier déjà stocké pour cette réunion (intégrations Google Calendar ou Outlook Calendar).
2. Si cela échoue, il compare l'URL de la réunion de Fireflies 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 tout simplement pas lié à un événement du calendrier.

Astuce : conservez le même lien de réunion sur la carte de rendez-vous que Fireflies enregistre (Zoom, Meet, Teams…), et gardez la synchronisation du calendrier active pour la correspondance la plus fiable.

Partage avec des coéquipiers

Comme les autres intégrations Mokapen, vous pouvez partager la connexion Fireflies avec des coéquipiers ou des équipes sélectionnés à partir des contrôles de partage de synchronisation sur la page des paramètres. Les utilisateurs partagés peuvent bénéficier des transcriptions arrivant dans l'organisation sans que chaque personne connecte sa propre clé.

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

1. Fireflies termine le traitement de l'enregistrement et déclenche le webhook (ou Grain livre réunion transcrite / résumée).
2. Mokapen reçoit la charge utile, vérifie éventuellement la signature/le secret et met en file d'attente une tâche en arrière-plan.
3. Le travail récupère les détails du résumé/transcription via l'API si nécessaire, applique vos options de sauvegarde et crée l'enregistrement de document/note/URL.
4. Si une correspondance de rendez-vous est trouvée, le nouvel élément est lié à ce rendez-vous afin qu'il apparaisse dans son contexte.
5. Les livraisons en double pour le même enregistrement sont ignorées via la déduplication synchronisée, donc les nouvelles tentatives ne créent pas de documents doubles.

Problèmes courants

• Rien n'apparaît après un appel — vérifiez que le webhook est correctement collé dans Fireflies (sauf Grain, où il 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 la réunion ou l'identifiant de l'événement du calendrier ne correspondent pas. Ouvrez le rendez-vous, confirmez l'URL et assurez-vous que la synchronisation du calendrier est active.
• Webhook rejeté / erreurs de signature — le secret dans Mokapen doit correspondre exactement à ce qui est configuré dans Fireflies ; régénérez les deux côtés en cas de doute.
• Seul le lien est enregistré — cochez Enregistrer sous et les cases résumé/transcription ; Le mode URL ignore intentionnellement le corps entier.
• Clé API invalide — régénérez la clé dans Fireflies et reconnectez-vous depuis Intégrations → Fireflies.

Déconnexion

Utilisez Déconnecter sur la page Intégrations → Lucioles (disponible pour l'utilisateur qui a connecté l'intégration). Supprimez ou désactivez également le webhook dans Fireflies si vous ne souhaitez plus de livraisons.

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

Cas d'utilisation

• Suivi de l'appel commercial — après un appel de découverte enregistré dans Fireflies, le résumé atterrit comme un document sur le rendez-vous : l'AE peut partager des actions sans réécrire les notes.
• Archive CS QBR — les revues commerciales trimestrielles restent consultables dans les documents Mokapen, liées au rendez-vous client.
• Transfert entre les rôles — Les SDR enregistrent des démos dans Fireflies ; les ferme-portes ouvrent le rendez-vous correspondant et lisent la transcription sans changer d'outil.
• Pointeur CRM léger — utilisez le mode de sauvegarde URL lorsque vous n'avez besoin que d'un lien profond vers Fireflies à partir de la carte de rendez-vous.

Questions fréquemment posées

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

A : Non. L'enregistrement et la transcription ont lieu dans Fireflies. Mokapen reçoit uniquement le résultat via webhook et le stocke selon vos paramètres.

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

A : Oui pour les lucioles : collez-le une fois pour vous connecter. Le webhook délivre ensuite chaque transcription complétée.

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

A : Le document ou la note est toujours créé. Vous pouvez le lier manuellement plus tard ou corriger la synchronisation de l'URL de la réunion/du calendrier pour les futurs appels.

Q : Les coéquipiers peuvent-ils utiliser ma connexion ?

A : Oui, si vous partagez l'intégration avec eux à partir des paramètres de partage de synchronisation sur la page Intégrations.

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

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

Q : Où puis-je trouver les paramètres plus tard ?

A : Menu utilisateur → Intégrations → Fireflies. L'URL du webhook, les secrets et les options de sauvegarde se trouvent sur cette page après la connexion.