Hur man gör e-post till en kraftfull del av din webbansökan

Mina favorit populära produktivitetsverktyg, iDoneThis och TeamSnippets, ger mig ett enkelt sätt att spela in och dela de uppgifter jag har genomfört varje dag med mina lagkamrater. Varje dag skickar tjänsterna mig ett mail som frågar mig vad jag avslutade idag. Från mitt e-postkonto kan jag enkelt svara med mina avslutade uppgifter utan att behöva logga in på webbplatsen. Anmärkningsvärt gör en majoritet av mina lagkamrater de flesta av sina hemsida uppdateringar genom att svara på e-post. 

Du kan också skapa samma kraftfulla funktionalitet genom att kommentera, ta emot innehåll via e-post och möjliggöra svar för att skapa, fortsätta och lösa supportbiljetter. Med Inbound Parse Webhook, från SendGrids SMTP-tjänst kan du göra dina program interaktiva genom att bjuda in svar och svara på användarna via deras email. 

Med SendGrid Parse Webhook kan du analysera e-postinnehåll och bilagor från inkommande e-post och skicka data via JSON till din ansökan. Funktionen gör att du kan göra följande, från e-post svar på din webbplats ansökan:

  • Post blogginlägg
  • Använd e-post svar för att uppdatera din e-postlista eller databas
  • Ladda upp foton och videoklipp
  • Starta och lösa supportbiljettbegäran

Komma igång

Anvisningarna nedan är att få Inbound Parse Webhook upp och köra lokalt. Börja med att klona GitHub-arkivet och cd-skivan i sin katalog:

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

Ange dina referenser

$ mv .env.example .env 

Ändra innehållet i .env till ditt SendGrid användarnamn och lösenord

SENDGRID_USERNAME = ditt_sendgrid_username SENDGRID_PASSWORD = ditt_sendgrid_password 

Kör programmet

$ npm installera $ node app.js 

Om npm-installationen inte fungerar för dig kan du försöka installera via MacPorts: 

$ sudo port npm installera

Om du får fel som tyder på att du saknar en modul betyder det att du ska installera det. Till exempel fick jag ett fel som app.js kan inte instansera dotenv variabel och efter installationen dotenv, det löste problemet helt och hållet.

$ npm installera dotenv

Ställ in en tunnel

Använd en lokal tunnel som ngrok för att testa lokalt och snabbt, istället för att distribuera kod till en live-server. 

Ngrok tillåter dig att säkert utsätta en lokal webbserver på webben och fånga trafik för detaljerad inspektion och återuppspelning. Hämta, pakka ut och starta ngrok-processen. När du har startat processen kommer ngrok att ge dig en unik URL för att du ska inspektera lokalt. 

Anvisningarna nedan är att få ngrok att arbeta lokalt på en Mac. Besök ngrok.com för att installera en lokal inställning för andra operativsystem. 

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

Ställ in SendGrid och MX Records

Observera att det kan ta upp till 48 timmar. 

När dina MX-poster har spridits fullständigt kan du skicka e-postmeddelanden på produktionen i upp till 48 timmar. 

Först, efter att ditt SkickaGrid-konto har gjorts, kan du ställa in din SendGrid Parsing Incoming Emails-inställning. Klicka på fliken "Utvecklare" för länken "Parsing Incoming Emails". I fältet Värdenamn anger du dinvärdnamn (dvs yourdomain.com) som du vill. I webbadressfältet anger du den unika webbadressen som ngrok ger dig. 

Konfigurera en MX-post på värdnamnet du anger ovan för att peka på mx.sendgrid.net. Det ska se ut som följande. 

Nu, om två dagar, kommer dina MX-poster att sprida sig helt. 

Skicka en e-post från ditt personliga e-postkonto

Om du skickar ett mail till [email protected],om några minuter kommer appen du kör att analysera och leverera innehållet till dig i JSON-format.

Test och spela med API: n

Grattis, du har skapat ett enkelt sätt att analysera dina e-postmeddelanden effektivt! Nu är du redo att utforska och ringa till API: n. 

Inspektera nyttolastinnehåll

Om du bara behöver ett snabbt sätt att inspektera nyttolastinnehållet i Parse Webhook kan du använda RequestBin, ett gratis verktyg, efter att du har konfigurerat dina MX-poster.

Inlägg från kommandoraden

Om du vill få dina händer smutsiga från kommandoraden kan du försöka SendGrids gratis webhook debugger-verktyg, vilket är ett snabbt sätt att börja se hur händelser visas. 

I hjärtat av verktyget finns en URL som du kan ställa in som din Parse Webhook-ändpunkt. Varje gång du laddar upp webbadressen får du ett unikt ID inom webbadressen. 

Nedan följer två exempel för att komma igång med din webbhake. De SKAFFA SIG Exempel börjar börja lyssna på nya data. Klistra in i följande i din kommandoterminalterminal SKAFFA SIG exempel: 

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

Om du vill klistra in om din Parse Webhook tar emot data skriver du in ringla kommando från POSTA Exempel på en andra terminalskärm:

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

Svaret på ditt terminalfönster ska nu ha nytt innehåll:

"Event_id": "e6a20fffc9c1968dd64684f0b11b9c29"

Skicka sedan ett mail till domänen eller underdomänen som du använder för inkommande analysering. Inom några minuter ska du se det analyserade e-postmeddelandet som JSON i ditt terminalfönster. 

Anpassa din parser

Som du kan se är detaljerna om e-postavskiljning och routing av ett inkommande meddelande till SendGrid-skriptet bakom kulisserna för dig. Från början kan du använda Parse Webhook på många kreativa sätt. Du är nu redo att placera några riktiga e-postdata via den webhook! 

För att anpassa dina e-postmeddelanden kan du börja anpassa koden i rutor / inbound.js.

Du kan till exempel skriva om filen inbound.js för att lagra bilagor på ett sätt som passar din ansökan och databas eller till och med slutföra en åtgärd om e-postinnehållet innehåller ett ord. 

Slutsats

För användarfall, fallstudier och exempel, ladda ner Parse Webhook Guide eller kolla på Parse Webhook API-biblioteket. 

När du tittar på Parse Webhook-exemplen kommer du att märka att de två vanligaste sätten det används är: interagerar med dina användare och samlar in data i dina applikationer via e-post.

Med webhook kan du utveckla funktioner som gör frekventa uppgifter mer produktiva för dina användare utan att de lämnar sin e-postbrevlåda. Att samla insikter och göra dina e-post interaktiva har aldrig varit enklare.