Si les emails n'apparaissent pas dans la Boîte de réception, ce guide passe en revue les causes les plus courantes : connexion/synchronisation du fournisseur, configuration de transfert/webhook et corrélation avec le CRM.
Énoncé du problème
Le problème
Vous avez configuré Boîte de réception, mais les emails n'apparaissent pas dans Piraja CRM. Cela pourrait signifier :
- La synchronisation du fournisseur n'est pas connectée (Gmail/Outlook) ou ne fonctionne pas
- L'ingestion par transfert n'atteint pas le point de terminaison du webhook
- Les messages sont ingérés mais ne sont pas corrélés aux bons enregistrements
- Des filtres/le mode d'affichage cachent les messages que vous vous attendez à voir
Scénarios courants
Scénario 1 : Synchronisation du fournisseur non connectée
- Gmail/Outlook n'est pas connecté pour votre utilisateur
- La synchronisation est en pause ou échoue
- Aucun nouveau fil/message n'apparaît
Scénario 2 : Problèmes de transfert/webhook
- L'adresse de transfert reçoit des mails, mais rien n'apparaît dans la Boîte de réception
- Le fournisseur entrant ne publie pas sur le webhook
- L'authentification ou la configuration est incorrecte
Scénario 3 : Problèmes de corrélation
- Les emails apparaissent dans la Boîte de réception mais ne sont pas liés à un Individu/Organisation
- Le fil n'est pas associé à un Ticket/Opportunité/Tâche
- Vous vous attendez à un historique d'activité sur un enregistrement, mais le message reste non attribué
Scénario 4 : Les filtres cachent les messages
- Mauveau dossier sélectionné (Boîte de réception/Envoyés/Archivés, etc.)
- Vous êtes dans un mode d'affichage différent (Conversations vs Messages)
- Un filtre de recherche est actif
Pourquoi BCC seul ne fonctionne pas (Transfert)
La méprise
De nombreux utilisateurs pensent qu'il suffit d'ajouter une adresse de transfert en BCC pour que les emails soient automatiquement enregistrés. Cela ne fonctionne que si l'adresse de transfert est une vraie boîte aux lettres/route qui reçoit le message et le transfère à Piraja.
Comment fonctionne l'ingestion de la Boîte de réception
Pour qu'un email apparaisse dans la Boîte de réception, il arrive généralement par l'un de ces chemins :
- Synchronisation du fournisseur (Gmail/Outlook connecté dans la Boîte de réception)
- Ingestion par transfert (un service de messagerie reçoit le message et le publie sur le webhook de Piraja)
Pourquoi BCC seul échoue
Lorsque vous BCC une adresse :
- L'email est envoyé à cette adresse
- S'il n'y a pas de boîte aux lettres/route de réception derrière, le message n'est jamais ingéré
- Piraja ne voit jamais le message, donc rien ne peut apparaître dans la Boîte de réception
La solution : utiliser la synchronisation du fournisseur ou un transfert approprié
Si vous utilisez le transfert, vous avez besoin d'un service/fournisseur de messagerie qui :
- Reçoit les emails envoyés à l'adresse de transfert
- Transfère/publique l'email brut sur le webhook de Piraja (certaines configurations utilisent encore le point de terminaison de compatibilité hérité sous /api/integrations/email-logging/webhook, qui transfère vers l'ingestion actuelle de la Boîte de réception)
Si vous utilisez Gmail/Outlook, connectez le fournisseur dans la Boîte de réception et laissez la synchronisation ingérer les messages directement.
Sans une véritable configuration de réception + transfert, BCC ne fonctionnera pas.
Synchronisation du fournisseur (Gmail/Outlook) : que vérifier
Si vous utilisez la synchronisation Gmail ou Outlook, les emails devraient arriver dans la Boîte de réception sans aucune configuration de transfert/webhook.
Que vérifier
- Le fournisseur est connecté pour votre utilisateur dans la Boîte de réception
- L'état de synchronisation est sain (aucune erreur)
- Vous visualisez le bon dossier (Boîte de réception vs Envoyés)
- Vous n'avez pas de requête de recherche ou de filtre cachant les résultats
Si c'est connecté mais toujours vide
- Envoyez un nouvel email de test et vérifiez la vue Messages dans Tout
- Déconnectez et reconnectez le fournisseur si la synchronisation semble bloquée
- Si seuls certains messages manquent, cela peut être un retard ou un problème de portée côté fournisseur
Ingestion par transfert/webhook : que vérifier
Si vous utilisez le transfert au lieu de la synchronisation du fournisseur, votre service de messagerie récepteur doit publier les messages entrants sur Piraja.
Causes courantes
- L'adresse de transfert ne reçoit pas l'email (problème de routage/MX)
- Le fournisseur reçoit des mails mais ne POSTE pas sur Piraja
- L'authentification ou la configuration est incorrecte
Étapes de vérification pratiques
- Envoyez un email de test à l'adresse de transfert
- Vérifiez que le fournisseur montre que le message a été reçu
- Vérifiez que le fournisseur montre un POST réussi vers Piraja
- Actualisez la Boîte de réception et vérifiez la vue Tout + Messages
Remarque : Certaines configurations utilisent encore le point de terminaison de compatibilité hérité sous /api/integrations/email-logging/webhook, qui transfère vers l'implémentation actuelle de l'ingestion de la Boîte de réception.
Corrélation et « manquant dans les enregistrements CRM »
L'ingestion de la Boîte de réception et la corrélation CRM sont des étapes distinctes.
Si vous pouvez voir l'email dans la Boîte de réception, mais pas sur un contact (Individu/Organisation)
- Vérifiez que le contact a la bonne adresse email enregistrée
- Si le message a été envoyé à un alias ou à une liste de distribution, la corrélation peut nécessiter un lien manuel
Si vous vous attendez à ce que les emails apparaissent sous Tickets/Opportunités/Tâches
- Un fil doit être corrélé à cet élément de travail
- S'il n'est pas encore corrélé, vous pouvez toujours voir l'email dans la Boîte de réception mais pas dans les onglets des éléments de travail
Astuce : Toujours confirmer que l'email existe dans Boîte de réception → Vue des messages → Dossier Tout avant de le considérer comme un problème d'ingestion.
Visibilité et filtres (il pourrait déjà être là)
Avant de supposer que l'ingestion est cassée, confirmez que le message n'est pas caché par l'état de l'interface utilisateur.
Choses qui cachent couramment les messages
- Mauveau dossier sélectionné (Boîte de réception vs Envoyés vs Archivés)
- Vous êtes en vue Conversations mais vous attendez une seule ligne de message (essayez la vue Messages)
- Une requête de recherche est active (effacez-la)
- Vous regardez un fournisseur/compte différent de celui attendu
Meilleure pratique
Vérifiez toujours :
- Boîte de réception → Vue des messages
- Dossier Tout
- Effacez la recherche
Si vous ne trouvez toujours pas le message là, passez aux vérifications de synchronisation du fournisseur ou de transfert.
Problèmes courants
Problème : Le fournisseur est connecté mais rien de nouveau n'arrive
- Déconnectez/reconnectez Gmail ou Outlook
- Envoyez un tout nouveau message de test et vérifiez à nouveau Messages → Tout
Problème : Le transfert reçoit des mails, mais la Boîte de réception est vide
- Confirmez que le fournisseur de transfert publie avec succès sur Piraja
- Vérifiez que le fournisseur ne supprime pas la charge utile de l'email brut
Problème : Les emails apparaissent mais ne sont pas liés aux bons enregistrements
- Confirmez que les adresses emails des contacts sont correctes
- Liez les participants/entités lorsque cela est demandé dans la Boîte de réception
Problème : « Je ne peux pas le trouver »
- Changez le mode d'affichage (Conversations ↔ Messages)
- Vérifiez les dossiers (Boîte de réception/Envoyés/Tout)
- Effacez la recherche et actualisez
Conseils de prévention
Comment éviter les surprises de « emails manquants »
- Préférez la synchronisation du fournisseur (Gmail/Outlook) lorsque cela est possible
- Si vous utilisez le transfert, testez le chemin de transfert de bout en bout avant de vous y fier
- Gardez les adresses emails des contacts à jour pour améliorer la corrélation
- Utilisez Messages + Tout comme votre vue de « vérité fondamentale » lors du dépannage
- Évitez de sauvegarder des flux de travail critiques derrière des filtres/requêtes de recherche ponctuels
Toujours pas de fonctionnement ?
Quand contacter le support
Si vous avez essayé toutes les solutions et que les emails n'apparaissent toujours pas :
1. Rassemblez des informations Avant de contacter le support :
- État de l'intégration
- Clé API (masquée pour la sécurité)
- URL du webhook (sans clé API)
- Service de transfert d'email utilisé
- Messages d'erreur
- Étapes que vous avez déjà essayées
- Captures d'écran de la configuration
2. Contactez le support
- Email : support@piraja.io
- Dans l'application : Utilisez l'icône d'aide (?) dans l'interface
- Base de connaissances : Recherchez des articles connexes
3. Ce dont le support aura besoin
- Votre email de compte
- Nom de l'entreprise
- Type d'intégration (Boîte de réception)
- Fournisseur (Gmail/Outlook/Transfert)
- Messages d'erreur
- Étapes que vous avez essayées
- Captures d'écran de configuration (masquez les clés/tokens sensibles)
Articles connexes
- Module Boîte de réception : Guide complet sur la gestion des emails
- Comprendre le système de modules
Ressources supplémentaires
- Aide à l'intégration : Dépannage général de l'intégration
- Documentation du service d'email : Guides SendGrid, Mailgun, AWS SES
- Test de webhook : Outils pour tester les points de terminaison webhook