Configurer SPF et DKIM pour améliorer la délivrabilité
Les enregistrements SPF et DKIM permettent aux serveurs de messagerie destinataires de vérifier que vos courriels proviennent bien d'une source autorisée. Sans eux, vos enquêtes risquent d'atterrir en spam.
Dans le gestionnaire DNS de votre domaine, ajoutez ou modifiez l'enregistrement TXT suivant :
- Nom :
@(ou votre domaine) - Type : TXT
- Valeur :
v=spf1 include:mail.comulead.com ~all
Si un enregistrement SPF existe déjà, ajoutez include:mail.comulead.com avant le ~all final — ne créez pas un deuxième enregistrement SPF.
Dans Cortex Voice → Paramètres → Intégrations → Délivrabilité courriel, cliquez sur Générer la clé DKIM. Copiez la valeur affichée et créez un enregistrement DNS :
- Nom :
cortex._domainkey.votredomaine.com - Type : TXT
- Valeur : (la clé DKIM générée par Cortex Voice)
La propagation DNS prend de 15 minutes à 48 heures. Une fois propagée, revenez dans Cortex Voice → Délivrabilité courriel et cliquez sur Vérifier la configuration. Cortex Voice affichera un statut vert pour SPF et DKIM si la configuration est correcte.
Un domaine ne peut avoir qu'un seul enregistrement SPF. Si vous en créez un second, les deux s'invalident mutuellement et votre délivrabilité empire. Modifiez toujours l'enregistrement existant en y ajoutant le include de Cortex Voice.
Erreurs API fréquentes
| Code HTTP | Signification | Solution |
|---|---|---|
401 | Clé API invalide ou expirée | Régénérer la clé dans Paramètres → Intégrations → Clés API |
403 | Permissions insuffisantes | Vérifier que la clé a les droits requis (lecture / écriture) |
404 | Ressource introuvable | Vérifier l'ID de l'enquête ou du contact dans l'URL |
422 | Données de requête invalides | Vérifier le format JSON et les champs requis |
429 | Limite de requêtes atteinte | Attendre la réinitialisation horaire ou implémenter un backoff exponentiel |
500 | Erreur serveur Cortex Voice | Vérifier le statut à status.comulead.com — contacter le support si persistant |
Dépannage des webhooks
Paramètres → Intégrations → Webhooks → cliquez sur le webhook concerné → onglet Journaux. Vous verrez chaque tentative d'envoi avec le code de réponse reçu, le timestamp et le payload envoyé. Filtrez par statut Échec pour isoler les problèmes.
Dans les journaux, cliquez sur l'icône Rejouer à côté d'un événement en échec pour le renvoyer immédiatement. Utile si votre endpoint était temporairement indisponible (maintenance, redémarrage serveur) et que vous avez manqué des événements pendant la fenêtre de 3 tentatives automatiques.
Dans la configuration du webhook, cliquez sur Envoyer un événement test. Cortex Voice envoie un payload fictif avec des données de test à votre endpoint. Vérifiez que votre serveur reçoit le payload, retourne HTTP 200 et traite les données correctement avant de déployer en production.
Problèmes de connexion et d'authentification
Sur la page de connexion de Cortex Voice → Mot de passe oublié → saisissez votre adresse courriel → vous recevrez un lien de réinitialisation valide 30 minutes. Si vous ne recevez pas le courriel dans 5 minutes, vérifiez les courriels indésirables.
Si vos codes d'authentification à deux facteurs sont systématiquement refusés, la cause probable est un décalage d'horloge entre votre appareil et les serveurs Cortex Voice. Synchronisez l'heure de votre appareil (Paramètres → Date et heure → Automatique). Si le problème persiste, utilisez un code de récupération et reconfigurez l'A2F.
Avant de contacter le support pour un problème de connexion ou de performance, consultez status.comulead.com. Cette page affiche en temps réel le statut de chaque composant (API, interface, courriels, webhooks) et l'historique des incidents des 90 derniers jours.
Ce qu'il faut retenir
- SPF et DKIM sont essentiels pour la délivrabilité — un seul enregistrement SPF par domaine, modifiez l'existant
- Une erreur API 429 signifie que vous avez atteint la limite horaire — implémentez un backoff exponentiel
- Les journaux de webhook dans Cortex Voice permettent de rejouer les événements manqués individuellement
- Les codes A2F refusés sont généralement causés par un décalage d'horloge — synchronisez l'heure de votre appareil
- Consultez status.comulead.com avant de contacter le support pour un problème de performance ou de connexion
