Vue d'ensemble des options d'intégration
Cortex Voice propose trois niveaux d'intégration selon votre maturité technique et vos besoins :
| Méthode | Complexité | Idéal pour |
|---|---|---|
| Zapier | Faible — sans code | PME sans développeur, flux CRM simples |
| Webhooks | Moyenne — JSON basique | Équipes techniques, flux temps réel personnalisés |
| API REST | Élevée — développement requis | Intégrations sur mesure, synchronisation bidirectionnelle |
Si vous utilisez un CRM (HubSpot, Salesforce, Pipedrive) ou un outil de gestion de tâches (Notion, Asana, Monday), commencez par Zapier — la configuration prend moins de 30 minutes et ne requiert aucune compétence technique. L'API est documentée dans Ressources & Documentation.
Intégration via Zapier
Paramètres → Intégrations → Clés API → Générer une clé. Nommez la clé (ex : Zapier — Production) et copiez-la immédiatement — elle ne sera affichée qu'une seule fois. Conservez-la dans votre gestionnaire de mots de passe.
Dans Zapier, cherchez Cortex Voice by Comulead dans les applications. Sélectionnez le déclencheur (New NPS Response) et connectez votre compte avec la clé API générée. Testez la connexion — Zapier chargera les 3 dernières réponses pour valider.
Exemples de flux recommandés :
- Détracteur → HubSpot : créer une tâche de suivi assignée au responsable du compte + ajouter une note sur la fiche contact avec le score et le verbatim
- Promoteur → Slack : envoyer un message dans le canal #nps-wins avec le verbatim positif
- Toute réponse → Google Sheets : ajouter une ligne avec score, segment, verbatim et date pour analyse externe
Ajoutez une étape Filter dans votre Zap pour n'activer l'action que pour un segment précis. Exemple : Filter → Score is less than 7 → créer la tâche HubSpot. Sans ce filtre, chaque réponse (y compris les promoteurs) déclenchera la tâche de suivi.
Intégration via Webhooks
Paramètres → Intégrations → Webhooks → Ajouter un webhook. Saisissez l'URL de votre endpoint (doit accepter des requêtes POST en JSON) et sélectionnez les événements à écouter : response.created, response.detractor, response.promoter.
Chaque événement envoie un payload structuré contenant :
event— type d'événement (response.created, etc.)respondent.email— adresse courriel du répondantresponse.score— score NPS donné (0–10)response.segment— promoter / neutral / detractorresponse.verbatim— texte de la réponse ouverteresponse.themes— tableau des thèmes Cortex AIsurvey.idetsurvey.name— identifiant de l'enquête source
Cortex Voice signe chaque payload avec un HMAC-SHA256 en utilisant votre secret webhook. Vérifiez la signature dans l'en-tête X-Cortex-Signature avant de traiter le payload — cela prévient les injections de données frauduleuses.
Votre endpoint doit retourner un code HTTP 200 dans les 5 secondes. Si Cortex Voice ne reçoit pas de 200, il réessaie 3 fois à intervalles croissants (1 min, 5 min, 30 min). Après 3 échecs, le webhook est désactivé automatiquement et vous recevez un courriel d'alerte.
Bonnes pratiques de sécurité
- Ne partagez jamais votre clé API dans un dépôt de code public (GitHub, GitLab)
- Créez une clé API distincte par intégration — facilitez la révocation en cas de compromission
- Activez la rotation automatique des clés dans Paramètres → Intégrations → Sécurité
- Vérifiez systématiquement la signature HMAC-SHA256 sur tous les webhooks entrants
- Consultez les journaux d'accès API dans Paramètres → Intégrations → Journaux
Ce qu'il faut retenir
- Débutez avec Zapier — sans code, moins de 30 minutes de configuration, compatible avec 6 000+ outils
- La clé API n'est affichée qu'une seule fois — conservez-la dans un gestionnaire de mots de passe
- Utilisez le filtre par segment dans Zapier pour éviter de déclencher des actions sur toutes les réponses
- Les webhooks envoient le payload Cortex AI (thèmes inclus) — exploitez le champ
response.themespour enrichir votre CRM - Votre endpoint webhook doit retourner HTTP 200 en moins de 5 secondes pour éviter les désactivations automatiques
