So machen Sie E-Mails zu einem leistungsstarken Teil Ihrer Webanwendung

Meine beliebtesten Produktivitätswerkzeuge, iDoneThis und TeamSnippets, geben mir eine einfache Möglichkeit, die Aufgaben, die ich jeden Tag erledigt habe, mit meinen Teamkollegen aufzuzeichnen und zu teilen. Jeden Tag senden mir die Dienste eine E-Mail mit der Frage, was ich heute fertiggestellt habe. Von meinem E-Mail-Konto aus kann ich problemlos mit meinen erledigten Aufgaben antworten, ohne mich bei der Website anmelden zu müssen. Bemerkenswert ist, dass eine Mehrheit meiner Teamkollegen die meisten Website-Updates durch E-Mail-Antworten abschließt. 

Sie können auch dieselbe leistungsstarke Funktion erstellen, indem Sie Kommentare kommentieren, Inhalte per E-Mail empfangen und Antworten aktivieren, um Support-Tickets zu erstellen, fortzusetzen und aufzulösen. Mit dem Inbound Parse Webhook aus dem SendGrid-SMTP-Dienst können Sie Ihre Anwendungen interaktiv machen, indem Sie Antworten einladen und den Benutzern per E-Mail antworten. 

Mit dem SendGrid Parse-Webhook können Sie E-Mail-Inhalte und Anhänge aus eingehenden E-Mails analysieren und die Daten über JSON in Ihre Anwendung buchen. Mit dieser Funktion können Sie Folgendes erledigen, von E-Mail-Antworten auf Ihre Website-Anwendung:

  • Blogeinträge veröffentlichen
  • Verwenden Sie E-Mail-Antworten, um Ihre Mailingliste oder Datenbank zu aktualisieren
  • Laden Sie Fotos und Videos hoch
  • Starten und lösen Sie Support-Ticketanfragen

Fertig machen

Die folgenden Anweisungen beschreiben den Inbound Parse Webhook und die lokale Ausführung. Beginnen Sie mit dem Klonen dieses GitHub-Repositorys und der CD in sein Verzeichnis:

$ git clone https://github.com/scottmotte/sendgrid-parse-api-example.git $ cd sendgrid-parse-api-example

Richten Sie Ihre Anmeldeinformationen ein

$ mv .env.example .env 

Ändern Sie den Inhalt von .env in Ihren SendGrid-Benutzernamen und Ihr Kennwort

SENDGRID_USERNAME = Ihr_Sendgrid_Benutzername SENDGRID_PASSWORD = Ihr_Sendgrid_Passwort 

Führen Sie die Anwendung aus

$ npm Installiere $ node app.js 

Wenn npm install für Sie nicht funktioniert, können Sie die Installation über MacPorts versuchen: 

$ sudo port npm install

Wenn Sie Fehler erhalten, die darauf schließen lassen, dass Sie ein Modul vermissen, sollten Sie es installieren. Zum Beispiel habe ich einen Fehler erhalten app.js kann die Instanz nicht instanziieren dotenv variabel und nach der Installation dotenv, es hat das Problem insgesamt gelöst.

$ npm dotenv installieren

Richten Sie einen Tunnel ein

Verwenden Sie einen lokalen Tunnel wie ngrok, um lokal und schnell zu testen, anstatt Code auf einem Live-Server bereitzustellen. 

Mit Ngrok können Sie einen lokalen Webserver sicher für das Web verfügbar machen und den Datenverkehr erfassen, um eine detaillierte Prüfung und Wiedergabe zu ermöglichen. Laden Sie den Ngrok-Prozess herunter, entpacken Sie ihn und starten Sie ihn. Nachdem Sie den Vorgang gestartet haben, gibt Ihnen ngrok eine eindeutige URL, über die Sie lokal prüfen können. 

Die folgenden Anweisungen beschreiben, wie Sie ngrok lokal auf einem Mac verwenden können. Besuchen Sie ngrok.com, um ein lokales Setup für andere Betriebssysteme zu installieren. 

$ wget https://dl.ngrok.com/darwin_amd64/ngrok.zip $ unzip ngrok.zip -d / usr / local / bin $ ngrok 3000

Richten Sie SendGrid- und MX-Datensätze ein

Beachten Sie, dass dies bis zu 48 Stunden dauern kann. 

Sobald Ihre MX-Datensätze vollständig übertragen wurden, können Sie in der Produktion in bis zu 48 Stunden E-Mails senden. 

Nachdem Sie Ihr SendGrid-Konto eingerichtet haben, können Sie zunächst die Einstellung für eingehende E-Mails für SendGrid-Analyse einrichten. Klicken Sie auf die Registerkarte "Entwickler" für den Link "Analyse eingehender E-Mails". Geben Sie im Feld Hostname Ihren Namen anHostname (d. h. IhreDomain.com), den Sie möchten. Geben Sie im URL-Feld die eindeutige URL ein, die Sie von ngrok erhalten haben. 

Konfigurieren Sie einen MX-Eintrag für den oben angegebenen Hostnamen so, dass er auf mx.sendgrid.net verweist. Es sollte ungefähr wie folgt aussehen. 

In zwei Tagen werden sich Ihre MX-Datensätze vollständig ausbreiten. 

Senden Sie eine E-Mail von Ihrem persönlichen E-Mail-Konto

Wenn Sie eine E-Mail an senden [email protected],In wenigen Minuten wird die von Ihnen ausgeführte App den Inhalt im JSON-Format analysieren und bereitstellen.

Testen und spielen Sie mit der API

Glückwunsch, Sie haben eine einfache Methode eingerichtet, um Ihre E-Mails effizient zu analysieren! Jetzt können Sie die API erkunden und aufrufen. 

Inhalt der Nutzlast prüfen

Wenn Sie nur eine schnelle Möglichkeit zur Überprüfung der Payload-Inhalte des Parse Webhook benötigen, können Sie RequestBin, ein kostenloses Tool, verwenden, nachdem Sie Ihre MX-Datensätze eingerichtet haben.

Über die Befehlszeile buchen

Wenn Sie sich die Hände von der Befehlszeile verschmutzen möchten, können Sie das kostenlose Webhook-Debugger-Tool von SendGrid ausprobieren, mit dem Sie schnell sehen können, wie Ereignisse angezeigt werden. 

Das Herzstück des Tools ist eine URL, die Sie als Parse Webhook-Endpunkt festlegen können. Jedes Mal, wenn Sie die URL laden, erhalten Sie eine eindeutige ID innerhalb der URL. 

Im Folgenden finden Sie zwei Beispiele, um mit Ihrem Webhook zu beginnen. Das ERHALTEN Das Beispiel beginnt mit dem Abhören neuer Daten. Fügen Sie an Ihrem Befehlszeilenterminal Folgendes ein ERHALTEN Beispiel: 

$ curl -X GET \ http://hookdebug.sendgrid.com/v1/events/e6a20fffc9c1968dd64684f0b11b9c29 

Um einzufügen, ob Ihr Parse Webhook Daten empfängt, geben Sie das ein locken Befehl von der POST Beispiel in ein zweites Terminalfenster:

$ curl -X POST \ -d "foo = bar" \ -d "alice = bob" \ http://hookdebug.sendgrid.com/v1/events/e6a20fffc9c1968dd64684f0b11b9c29

Die Antwort in Ihrem Terminalfenster sollte jetzt neuen Inhalt haben:

"Event_id": "e6a20fffc9c1968dd64684f0b11b9c29"

Senden Sie anschließend eine E-Mail an die Domäne oder Unterdomäne, die Sie für die eingehende Analyse verwenden. Innerhalb weniger Minuten sollten Sie die geparste E-Mail als JSON in Ihrem Terminalfenster sehen. 

Passen Sie Ihren Parser an

Wie Sie sehen, werden die Details der E-Mail-Datentrennung und der Weiterleitung einer eingehenden Nachricht an das SendGrid-Skript für Sie hinter den Kulissen erledigt. Sie können den Parse-Webhook auf verschiedene Weise kreativ einsetzen. Sie können jetzt einige echte E-Mail-Daten über diesen Webhook eingeben! 

Um Ihre E-Mails benutzerdefiniert zu analysieren, können Sie den Code in routen / inbound.js anpassen.

Sie können die Datei inbound.js beispielsweise so umschreiben, dass Anhänge auf eine für Ihre Anwendung und Datenbank passende Weise gespeichert werden, oder sogar eine Aktion ausgeführt werden, wenn der E-Mail-Inhalt ein Wort enthält. 

Fazit

Laden Sie für Anwendungsfälle, Fallstudien und Beispiele den Parse Webhook Guide herunter, oder überprüfen Sie die Parse Webhook API-Bibliothek. 

Wenn Sie sich die Parse Webhook-Beispiele ansehen, werden Sie feststellen, dass die beiden häufigsten Verwendungsweisen die Interaktion mit Ihren Benutzern und das Sammeln von Daten in Ihren Anwendungen per E-Mail sind.

Mit dem Webhook können Sie Funktionen entwickeln, die häufige Aufgaben für Ihre Benutzer produktiver machen, ohne dass sie ihren E-Mail-Posteingang hinterlassen müssen. Es war noch nie einfacher, Erkenntnisse zu sammeln und Ihre E-Mails interaktiv zu gestalten.