Si les e-mails 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.
Déclaration du problème
Le problème
Vous avez configuré Boîte de réception, mais les e-mails 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
- Les 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 du courrier, mais rien ne s'affiche 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 e-mails 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 assigné
Scénario 4 : Les filtres cachent les messages
- Mauveau dossier sélectionné (Boîte de réception/Envoyé/Archivé, 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 misconception
De nombreux utilisateurs pensent qu'il suffit d'ajouter une adresse de transfert en BCC pour que les e-mails 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 e-mail 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 mettez une adresse en BCC :
- L'e-mail 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 e-mails envoyés à l'adresse de transfert
- Transfère/publique l'e-mail brut sur le webhook de Piraja (certaines configurations utilisent encore l'ancien point de terminaison de compatibilité sous /api/integrations/email-logging/webhook, qui transfère à 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 e-mails 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, Envoyé, Tous les e-mails, Archive, Spam, Corbeille ou personnalisé)
- Vous n'avez pas de requête de recherche ou de filtre cachant les résultats
- Pour Envoyé, laissez le temps de synchronisation — reconnectez Outlook si des messages envoyés manquent
Si c'est connecté mais toujours vide
- Envoyez un nouvel e-mail de test et vérifiez la vue Messages dans Tous les e-mails
- 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'e-mail (problème de routage/MX)
- Le fournisseur reçoit du courrier mais ne POSTE pas sur Piraja
- L'authentification ou la configuration est incorrecte
Étapes de vérification pratiques
- Envoyez un e-mail 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 Tous + Messages
Remarque : Certaines configurations utilisent encore l'ancien point de terminaison de compatibilité sous /api/integrations/email-logging/webhook, qui transfère à 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'e-mail dans la Boîte de réception, mais pas sur un contact (Individu/Organisation)
- Vérifiez que le contact a la bonne adresse e-mail 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 e-mails 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'e-mail dans la Boîte de réception mais pas dans les onglets des éléments de travail
Conseil : Confirmez toujours que l'e-mail existe dans Boîte de réception → Vue des messages → Dossier tous 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é vs Archivé)
- 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 autre fournisseur/compte que prévu
Meilleure pratique
Vérifiez toujours :
- Boîte de réception → Vue des messages
- Dossier tous
- Effacez la recherche
Si vous ne trouvez toujours pas le message là-bas, 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 → Tous
Problème : Le transfert reçoit du courrier, 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 brute de l'e-mail
Problème : Les e-mails apparaissent mais ne sont pas liés aux bons enregistrements
- Confirmez que les adresses e-mail 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 de mode d'affichage (Conversations ↔ Messages)
- Vérifiez les dossiers (Boîte de réception/Envoyé/Tous)
- Effacez la recherche et actualisez
Conseils de prévention
Comment éviter les surprises de « e-mails 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 compter dessus
- Gardez les adresses e-mail des contacts à jour pour améliorer la corrélation
- Utilisez Messages + Tous 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 uniques
Ça ne fonctionne toujours pas ?
Quand contacter le support
Si vous avez essayé toutes les solutions et que les e-mails 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'e-mail utilisé
- Messages d'erreur
- Étapes que vous avez déjà essayées
- Captures d'écran de la configuration
2. Contacter 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 e-mail 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 toute clé/token sensible)
Articles connexes
- Module Boîte de réception : Guide complet de la gestion des e-mails
- Comprendre le système de modules
Ressources supplémentaires
- Aide à l'intégration : Dépannage général des intégrations
- Documentation du service de messagerie : Guides SendGrid, Mailgun, AWS SES
- Test de webhook : Outils pour tester les points de terminaison des webhooks