Avant de connecter une boîte de réception : liste de vérification des e-mails entrants pour les applications auto-hébergées
Avant de connecter une boîte de réception professionnelle à une application auto-hébergée, vérifiez la méthode de réception documentée, la manière dont l’application traite les messages, ainsi que la façon dont votre équipe gérera les accès et les défaillances.
Commencez par définir le rôle de la boîte de réception
« Connecter les e-mails » peut recouvrir différentes fonctions : créer une conversation d’assistance à partir d’un message reçu, associer une correspondance à la fiche d’un client ou permettre au personnel de répondre depuis une application. Décrivez le flux de travail souhaité avant de choisir une boîte de réception ou d’en modifier les paramètres.
Traitez la réception des messages et l’envoi d’e-mails comme deux besoins à vérifier séparément. Que doit recevoir ou importer l’application, et que doit-elle envoyer ? Consultez la documentation de l’application pour chaque besoin au lieu de supposer qu’une seule configuration couvre les deux.
Identifiez la boîte de réception, les messages que vous souhaitez inclure, l’action attendue dans l’application et les personnes qui doivent avoir accès aux fiches créées.
- Quel processus métier l’application doit-elle prendre en charge ?
- Quels messages faut-il inclure, et quelle règle documentée permet de les déterminer ?
- Le personnel doit-il pouvoir répondre depuis l’application ? Si oui, où cette fonctionnalité est-elle documentée ?
- Qui sera responsable de ce flux de travail et de sa configuration ?
Vérifiez la méthode de réception documentée
Avant de choisir une méthode de réception, consultez la documentation de l’application exacte et de son déploiement auto-hébergé. Quelles méthodes y sont décrites ? Que faut-il configurer en dehors de l’application, et les instructions s’appliquent-elles à votre déploiement ?
À titre d’exemple précis propre à un produit, le [guide de réception des e-mails en déploiement auto-hébergé de Chatwoot](https://developers.chatwoot.com/self-hosted/configuration/features/email-channel/ingress-providers) décrit le choix et la configuration d’un fournisseur de réception des e-mails entrants, la définition des variables d’environnement requises et l’utilisation de fournisseurs tels que Mailgun ou SendGrid. Cet exemple ne permet pas de déterminer ce que prennent en charge les autres applications ni comment elles doivent être configurées.
Ne déduisez pas la méthode de réception des seuls paramètres d’envoi de l’application. Recherchez les instructions dédiées aux e-mails entrants et vérifiez qu’elles correspondent à votre déploiement.
- Trouvez la documentation de l’application sur les e-mails entrants en déploiement auto-hébergé.
- Quelle méthode, quels services externes, quelles valeurs de configuration et quels prérequis indique-t-elle ?
- Où faut-il saisir la configuration, et comment les instructions indiquent-elles d’appliquer les changements ?
- Si la documentation ne répond pas à ces questions, demandez conseil au fournisseur ou au responsable de la maintenance de l’application avant de connecter une boîte de réception professionnelle.
Renseignez-vous sur les accès et le traitement des messages
Avant d’accorder un accès, demandez au responsable de la maintenance de l’application et au fournisseur de la boîte de réception quel compte, quelle méthode d’authentification et quelles autorisations l’intégration documentée exige. Ne présumez pas d’une méthode de connexion ni d’un niveau d’autorisation particulier.
Demandez ce que l’application stocke, affiche, indexe ou utilise d’une autre manière dans un message reçu. Vérifiez le traitement documenté du corps du message, des informations sur l’expéditeur et le destinataire, des en-têtes, des pièces jointes et des autres métadonnées. Si la documentation ne répond pas à cette question, considérez le comportement comme inconnu plutôt que de le déduire du fait qu’un message apparaît dans l’application.
Utilisez ces réponses pour décider si la boîte de réception convient au flux de travail. Déterminez qui peut accéder aux fiches créées et si l’application doit recevoir l’intégralité du contenu des messages ou une sélection plus limitée.
- Quel compte et quel niveau d’autorisation l’intégration documentée exige-t-elle ?
- Quels champs, contenus et pièces jointes l’application traite-t-elle, et où ce comportement est-il documenté ?
- Les limites de taille des pièces jointes, l’emplacement du stockage, la durée de conservation et les contrôles d’accès sont-ils précisés ?
- Qui est autorisé à accéder aux fiches créées ?
Prévoyez la responsabilité, les défaillances et la récupération
Avant le lancement, demandez à votre équipe comment elle pourra détecter un mauvais fonctionnement de l’intégration. L’application ou l’intégration documente-t-elle une vue d’état, des journaux, des alertes ou un autre moyen d’enquêter ? Confirmez ce qui est réellement disponible au lieu de supposer qu’une fonctionnalité de supervision particulière existe.
Demandez au responsable de la maintenance ce qui se passe en cas de réception de doublons, de traitement retardé ou de défaillance, et quelles mesures de récupération sont documentées. Si la documentation ne précise pas le comportement, consignez-le comme un point non résolu. Décidez qui enquêtera en cas de message manquant ou répété et ce que le personnel devra faire si la fiche attendue n’apparaît pas.
Mettez les informations sur les responsabilités et la récupération à la disposition des administrateurs autorisés. Réfléchissez à la façon dont votre organisation pourrait transférer la responsabilité, remplacer ou révoquer des accès si nécessaire et rétablir le flux de travail si la personne qui l’a configuré quitte l’organisation. Ne mettez pas de mots de passe, de jetons ni d’autres secrets dans le guide de procédure.
- Qui est responsable de l’exploitation, et qui est la personne de remplacement à contacter ?
- Où les administrateurs peuvent-ils vérifier l’état ou enquêter sur une défaillance, si ces options sont documentées ?
- Que dit le responsable de la maintenance au sujet des doublons, des retards, des nouvelles tentatives et de la récupération ?
- Comment les responsabilités et les accès seront-ils transférés si une personne responsable quitte l’organisation ou change de rôle ?
Effectuez un test contrôlé et consignez votre décision
Avant de connecter une boîte de réception de production, demandez au responsable de la maintenance de l’application s’il existe une configuration de test et suivez les instructions documentées. Utilisez des messages qui permettent de vérifier le comportement pertinent pour votre flux de travail sans exposer inutilement des données professionnelles.
Vérifiez si l’action ou la fiche attendue apparaît, et si le traitement des détails du message et des pièces jointes correspond aux attentes établies par la documentation. Demandez comment tester sans risque les réceptions répétées, les retards ou les défaillances ; ne supposez pas que l’application fournit une procédure de test pour chaque situation.
Si le comportement observé diffère de la documentation ou laisse une question importante sans réponse, suspendez l’utilisation en production et interrogez le responsable de la maintenance de l’application ou le fournisseur de la boîte de réception. Consignez la méthode utilisée, les réponses reçues, les questions non résolues, les responsables et les mesures de récupération, sans noter de secrets.
- Quelle configuration de test contrôlé la documentation de l’application recommande-t-elle, le cas échéant ?
- La fiche ou l’action attendue apparaît-elle, et le contenu pertinent du message est-il traité comme indiqué dans la documentation ?
- Quels contrôles documentés et sans risque permettent de vérifier les réceptions répétées, les retards ou les défaillances ?
- Consignez la méthode de réception, les réponses concernant le traitement des données, les responsables, les mesures de récupération et les questions non résolues.
Questions fréquentes
Dois-je utiliser le transfert, l’interrogation périodique de la boîte de réception ou un fournisseur de réception ?
Consultez la documentation de votre application en déploiement auto-hébergé pour connaître les méthodes prises en charge, leurs prérequis et les étapes de configuration. Si elle ne répond pas à vos besoins, demandez conseil au responsable de la maintenance.
Que dois-je vérifier avant de connecter une boîte de réception de production ?
Confirmez la méthode documentée, les accès requis, le traitement des messages concernés et les consignes disponibles pour les tests et la récupération. Demandez au responsable de la maintenance comment vérifier ces points dans votre configuration.
Que faut-il faire lorsque la personne qui a configuré la boîte de réception quitte l’organisation ?
Identifiez la configuration et la personne qui en prend la responsabilité. Convenez des étapes permettant de transférer la responsabilité, de remplacer ou révoquer des accès si nécessaire et de suivre les mesures de récupération documentées.
Sources et lectures complémentaires
- Configuring inbound mails in Chatwoot — Chatwoot
- How to Host your Own Email Server — Miguel Grinberg