Gmail

Gmail est un connecteur : il relie une application MeDo à un compte Gmail, afin que l'application puisse rechercher et lire des conversations, envoyer un e-mail en texte brut, et déplacer des messages entre des libellés existants. Tout ce que l'application voit provient du compte que vous avez connecté.

#Ce que vous pouvez construire

• Un espace de suivi client. Trouvez des conversations par adresse client, mot-clé, date ou statut non lu, ouvrez la conversation complète, et conservez les notes de suivi et le statut dans l'application.
• Une page de communication projet. Récupérez les conversations qui correspondent à un mot-clé de projet ou à une fenêtre de dates, et affichez-les à côté du contexte propre au projet.
• Un suivi des demandes. Enregistrez des messages entrants sélectionnés comme demandes, suivez le statut ouvert ou résolu, et revenez à la conversation d'origine.
• Un outil de relecture avant envoi. Rédigez un message en texte brut, prévisualisez le destinataire, l'objet et le corps, puis n'envoyez qu'après confirmation.

Gmail convient lorsque l'application doit travailler avec une vraie boîte de réception : support, suivi commercial, correspondance de projet. Ce n'est pas un serveur de messagerie, et il ne peut pas faire tourner une application d'envoi de campagnes de masse — voir Limites.

#Exemples de construction

Copiez l'un de ces textes dans la zone de saisie. Le premier est le point de départ le plus simple et déjà utile.

Use @Gmail to build a private customer follow-up workspace where I can find conversations by customer email address, filter unread messages, and open the full conversation.

Use @Gmail to build a private project communication page with a project keyword and date filter, related email conversations, and project notes saved in the app.

Use @Gmail to build a private customer follow-up tool where I can compose a message, preview the recipient, subject, and email, then confirm before sending.

Use @Gmail to build a private inquiry tracker where I can select incoming emails, save them as inquiries in the app, track open or resolved status, and open the original conversation.

La formulation compte : dites pour qui est l'outil et ce qu'il doit faire. « Un espace de suivi privé pour l'équipe support » produit une application différente de « une page qui liste des e-mails ».

#Préparer et connecter

Vous avez besoin d'un compte Google avec accès à la boîte de réception que l'application doit utiliser. Aucune clé API, aucun projet Google Cloud, aucune configuration de facturation.

1. Ouvrez Skills & Connectors dans la barre latérale et recherchez Gmail.
2. Ouvrez la carte Gmail et cliquez sur Connect.
3. Connectez-vous au compte Google et autorisez l'accès demandé par MeDo.
4. Le bouton passe à Connected. C'est l'état de succès ; vous n'avez rien à recopier dans l'application.

Si vous commencez à construire avant de connecter, MeDo le détecte et affiche un bouton de connexion Gmail sous sa réponse. Vous pouvez connecter depuis là. Si aucun bouton n'apparaît, utilisez la carte du connecteur décrite ci-dessus.

#Utilisation dans votre application

• L'application utilise votre boîte de réception connectée, pas le compte Gmail de chaque visiteur. Chaque visiteur qui atteint une vue de messagerie voit la même boîte. Placez les pages de messagerie, la recherche et l'envoi derrière la propre connexion de votre application, et limitez-les aux personnes qui doivent y avoir accès. Une page intitulée « privée » n'est pas un contrôle d'accès à elle seule.
• Choisissez la portée de la boîte dans le prompt. Nommer une adresse client, un mot-clé de projet, un libellé ou une fenêtre de dates rend les résultats pertinents et vérifiables.
• Le courrier est lu au chargement ou à l'actualisation de l'application. Il n'y a ni synchronisation en arrière-plan ni déclencheur de nouveau message : prévoyez un contrôle d'actualisation explicite plutôt que d'attendre des mises à jour en direct.
• L'envoi et les changements de libellé sont d'abord confirmés. MeDo prévisualise le destinataire, l'objet et le corps avant un envoi, ainsi que le message cible et le changement de libellé avant une mise à jour.
• Les données propres à l'application restent dans l'application. Le statut des demandes, les notes internes et les dates de suivi appartiennent aux tables de votre application, avec pour clé le vrai message ou fil. Ce ne sont pas des champs Gmail.

#Limites et dépannage

« Connexion requise » s'affiche dans l'application. La connexion Gmail appartient au propriétaire de l'application. Demandez-lui d'ouvrir la carte du connecteur et de cliquer sur Connect, puis de recharger.

Un envoi semble avoir échoué mais rien n'est dans Envoyés. MeDo ne réessaie pas un envoi automatiquement, car une nouvelle tentative peut livrer le même message deux fois. Vérifiez le dossier Envoyés avant de renvoyer.

La recherche renvoie moins de messages que prévu. La recherche couvre la portée de la boîte et les limites ci-dessus ; le spam et la corbeille sont exclus. Élargissez la fenêtre de dates ou utilisez un libellé plutôt que de supposer que des messages manquent.

Les visiteurs voient la boîte alors qu'ils ne devraient pas. La connexion est partagée. Ajoutez une connexion et des restrictions côté serveur à l'application ; voir Gérer l'accès et les rôles.

#Voir aussi

• Catalogue de connecteurs — les autres connecteurs et leur usage.
• Skills et Connecteurs — comment les Skills sont appelés, tarifés et limités.
• Gérer la connexion et les utilisateurs — donnez à une application ses propres comptes avant d'exposer des données connectées.