Share
Mes outils de productivité populaires préférés, iDoneThis et TeamSnippets, me permettent d’enregistrer et de partager simplement les tâches que j’ai accomplies chaque jour avec mes coéquipiers. Chaque jour, les services m'envoient un courrier électronique me demandant ce que j'ai complété aujourd'hui. À partir de mon compte de messagerie, je peux facilement répondre aux tâches terminées sans avoir à me connecter au site Web. Remarquablement, une majorité de mes coéquipiers effectuent la plupart des mises à jour de leur site Web par courrier électronique..
Vous pouvez également créer la même fonctionnalité puissante en commentant, en recevant du contenu par courrier électronique et en permettant aux réponses de créer, de continuer et de résoudre des tickets de support. Avec Inbound Parse Webhook, à partir du service SMTP de SendGrid, vous pouvez rendre vos applications interactives en invitant des réponses et en répondant aux utilisateurs par courrier électronique..
SendGrid Parse Webhook vous permet d’analyser le contenu des courriers électroniques et les pièces jointes de tous les courriers électroniques entrants et d’envoyer les données via JSON à votre application. Cette fonctionnalité vous permet d’accomplir les tâches suivantes, à partir des réponses par courrier électronique à votre application de site Web:
Les instructions ci-dessous permettent d’obtenir Inbound Parse Webhook et son exécution locale. Commencez par cloner ce référentiel GitHub et cd dans son répertoire:
$ git clone https://github.com/scottmotte/sendgrid-parse-api-example.git $ cd sendgrid-parse-api-example
$ mv .env.example .env
SENDGRID_USERNAME = votre_sendgrid_username SENDGRID_PASSWORD = votre_password_sendgrid
$ npm install $ node app.js
Si l'installation de npm ne fonctionne pas pour vous, vous pouvez essayer d'installer via MacPorts:
$ sudo port npm install
Si vous recevez des erreurs suggérant qu'il vous manque un module, cela signifie que vous devez l'installer. Par exemple, j'ai reçu une erreur qui app.js n'est pas capable d'instancier le DOTENV variable, et après l'installation DOTENV, il a résolu le problème tout à fait.
$ npm install dotenv
Utilisez un tunnel local tel que ngrok pour tester localement et rapidement, plutôt que de déployer du code sur un serveur actif.
Ngrok vous permet d’exposer en toute sécurité un serveur Web local sur le Web et de capturer le trafic pour une inspection détaillée et la relecture. Téléchargez, décompressez et démarrez le processus ngrok. Après avoir démarré le processus, ngrok vous donnera une URL unique que vous pourrez inspecter localement sur.
Les instructions ci-dessous expliquent comment faire fonctionner ngrok localement sur un Mac. Visitez ngrok.com pour installer une configuration locale pour d'autres systèmes d'exploitation.
$ wget https://dl.ngrok.com/darwin_amd64/ngrok.zip $ unzip ngrok.zip -d / usr / local / bin $ ngrok 3000
Notez que cela peut prendre jusqu'à 48 heures.
Une fois que vos enregistrements MX sont entièrement propagés, vous pouvez envoyer des courriels en production en moins de 48 heures..
Tout d'abord, une fois votre compte SendGrid approvisionné, vous pouvez configurer votre paramètre SendGrid Parsing Emoming Emails. Cliquez sur l'onglet «Développeurs» pour le lien «Analyse des courriels entrants». Dans le champ Nom d'hôte, spécifiez votrenomhôte (c'est-à-dire votre domaine.com) que vous souhaitez. Dans le champ URL, entrez l'URL unique que ngrok vous donne.
Configurez un enregistrement MX sur le nom d'hôte que vous avez défini ci-dessus pour qu'il pointe vers mx.sendgrid.net. Il devrait ressembler à ceci.
Maintenant, dans deux jours, vos enregistrements MX se propageront complètement.
Si vous envoyez un email à [email protected],dans quelques minutes, l'application en cours d'exécution analysera et vous livrera le contenu au format JSON.
Félicitations, vous avez mis en place un moyen simple d’analyser efficacement vos emails! Vous êtes maintenant prêt à explorer et à appeler l'API..
Si vous avez juste besoin d’un moyen rapide d’inspecter le contenu de la charge utile de Parse Webhook, vous pouvez utiliser RequestBin, un outil gratuit, après avoir configuré vos enregistrements MX..
Si vous souhaitez vous salir les mains à partir de la ligne de commande, vous pouvez utiliser l'outil gratuit de débogage webhook de SendGrid, qui est un moyen rapide de voir comment les événements apparaissent..
Au cœur de l'outil se trouve une URL que vous pouvez définir comme point de terminaison de Parse Webhook. Chaque fois que vous chargez l'URL, vous obtenez un identifiant unique dans l'URL..
Vous trouverez ci-dessous deux exemples pour démarrer avec votre Webhook. le OBTENIR exemple va commencer à écouter de nouvelles données. Depuis votre terminal de ligne de commande, collez le texte suivant: OBTENIR Exemple:
$ curl -X GET \ http://hookdebug.sendgrid.com/v1/events/e6a20fffc9c1968dd64684f0b11b9c29
Pour coller si votre Parse Webhook reçoit des données, tapez le boucle commande du POSTER exemple dans un deuxième écran de terminal:
$ curl -X POST \ -d "foo = bar" \ -d "alice = bob" \ http://hookdebug.sendgrid.com/v1/events/e6a20fffc9c1968dd64684f0b11b9c29
La réponse sur votre fenêtre de terminal devrait maintenant avoir un nouveau contenu:
“Event_id”: “e6a20fffc9c1968dd64684f0b11b9c29”
Ensuite, envoyez un courrier électronique au domaine ou au sous-domaine que vous utilisez pour l'analyse entrante. En quelques minutes, vous devriez voir le courrier analysé sous la forme JSON dans la fenêtre de votre terminal..
Comme vous pouvez le constater, les détails de la séparation des données de courrier électronique et du routage d'un message entrant vers le script SendGrid sont effectués en arrière-plan pour vous. En partant de zéro, vous pouvez utiliser Parse Webhook de nombreuses manières créatives. Vous êtes maintenant prêt à placer de véritables données de courrier électronique via ce Webhook.!
Pour personnaliser l'analyse de vos emails, vous pouvez commencer à personnaliser le code dans routes / inbound.js..
Par exemple, vous pouvez réécrire le fichier inbound.js pour stocker les pièces jointes d’une manière qui conviendrait à votre application et à votre base de données ou même effectuer une action si le contenu de l’e-mail contient un mot..
Pour des cas d'utilisation, des études de cas et des exemples, téléchargez le guide de Parse Webhook ou consultez la bibliothèque d'API de Parse Webhook..
En examinant les exemples de Parse Webhook, vous remarquerez que les deux méthodes les plus couramment utilisées sont les suivantes: interaction avec vos utilisateurs et collecte de données dans vos applications par courrier électronique..
Avec Webhook, vous pouvez développer des fonctionnalités qui rendent les tâches fréquentes plus productives pour vos utilisateurs sans les laisser quitter leur boîte de réception. Collecter des informations et rendre vos emails interactifs n'a jamais été aussi simple.
Accentsconagua