Cum se face e-mail o parte puternică a aplicației dvs. Web

Instrumentele mele populare de productivitate preferate, iDoneThis și TeamSnippets, îmi dau o modalitate simplă de a înregistra și de a împărți cu colegii mei sarcinile pe care le-am încheiat în fiecare zi. În fiecare zi, serviciile îmi trimit un e-mail, întrebându-mă ce am terminat astăzi. Din contul meu de e-mail, pot răspunde cu ușurință la sarcinile mele finalizate, fără a fi nevoie să mă înregistrez pe site. În mod remarcabil, majoritatea colegilor mei completează cea mai mare parte a actualizărilor site-ului prin răspunsuri prin e-mail. 

Puteți, de asemenea, crea aceleași funcții puternice, comentând, primind conținut prin e-mail și permițând răspunsuri pentru a crea, continua și rezolva bilete de suport. Cu Inbound Parse Webhook, de la serviciul SMTP al SendGrid, puteți face aplicațiile interactive, invitând răspunsurile și răspunzând la utilizatori prin e-mailul lor. 

SendGrid Parse Webhook vă permite să analizați conținutul și atașamentele de e-mail de la orice e-mailuri primite și să postați datele prin intermediul JSON la aplicația dvs. Capacitatea vă permite să realizați următoarele, din răspunsurile de e-mail la aplicația dvs. de pe site:

  • Postați intrări în blog
  • Utilizați răspunsurile de e-mail pentru a vă actualiza lista de corespondență sau baza de date
  • Încărcați fotografii și videoclipuri
  • Începeți și rezolvați cererile de bilete de suport

Noțiuni de bază

Instrucțiunile de mai jos se referă la obținerea și utilizarea locală a Inbound Parse Webhook. Începeți prin a clona acest depozit GitHub și cd în directorul său:

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

Configurați-vă acreditările

$ mv .env.example.env 

Modificați conținutul .env la numele și parola dvs. SendGrid

SENDGRID_USERNAME = numele dvs._sendgrid_username SENDGRID_PASSWORD = fișierul dvs._sendgrid_password 

Rulați aplicația

$ npm instalați $ node app.js 

Dacă instalarea npm nu funcționează pentru dvs., puteți încerca instalarea prin MacPorts: 

$ sudo port npm instalare

Dacă primiți erori care sugerează că lipsește un modul, înseamnă că trebuie să îl instalați. De exemplu, am primit o eroare app.js nu este capabil să instanțizeze dotenv variabilă și după instalare dotenv, a rezolvat problema în totalitate.

$ npm install dotenv

Configurați un tunel

Utilizați un tunel local ca ngrok pentru a testa local și rapid, mai degrabă decât să implementați codul pe un server live. 

Ngrok vă permite să expuneți în siguranță un server web local pe web și să captați trafic pentru o inspecție detaliată și replay. Descărcați, dezarhivați și porniți procesul ngrok. După ce începeți procesul, ngrok vă va oferi o adresă URL unică pentru a vă inspecta local. 

Instrucțiunile de mai jos se referă la achiziționarea ngrok pentru a lucra local pe un Mac. Vizitați ngrok.com pentru a instala o configurație locală pentru alte sisteme de operare. 

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

Configurați SendGrid și MX Records

Rețineți că acest lucru poate dura până la 48 de ore. 

Odată ce înregistrările dvs. MX s-au propagat pe deplin, puteți trimite e-mailuri la producție în maximum 48 de ore. 

Mai întâi, după ce contul dvs. SendGrid este furnizat, puteți configura setarea de parcurgere a mesajelor de e-mail SendGrid. Faceți clic pe fila "Dezvoltatori" pentru linkul "Parsarea e-mailurilor primite". În câmpul Nume gazdă, specificați-văhostname (adică yourdomain.com) pe care doriți. În câmpul URL, introduceți adresa URL unică pe care ngrok o dă. 

Configurați o înregistrare MX pe numele de gazdă pe care l-ați setat mai sus pentru a indica spre mx.sendgrid.net. Ar trebui să arate ceva de genul următor. 

Acum, în două zile, înregistrările dvs. MX se vor propaga complet. 

Trimiteți un e-mail din contul personal de e-mail

Dacă trimiteți un e-mail la [email protected],în câteva minute, aplicația pe care o executați va analiza și va livra conținutul în format JSON.

Testați și jucați cu API

Felicitări, ați stabilit o modalitate simplă de a vă analiza e-mailurile în mod eficient! Acum, sunteți gata să explorați și să efectuați apeluri către API. 

Inspectarea conținutului încărcăturii utile

Dacă aveți nevoie doar de o cale rapidă de a inspecta conținutul încărcăturii utile a Parsei Webhook, puteți utiliza instrumentul RequestBin, un instrument gratuit, după configurarea înregistrărilor dvs. MX.

Postarea de pe linia de comandă

Dacă doriți să vă murdăriți mâinile din linia de comandă, puteți încerca instrumentul de depanare a webhook gratuit al SendGrid, care este o modalitate rapidă de a începe să vedeți cum apar evenimentele. 

În centrul instrumentului este o adresă URL pe care o puteți seta ca punct final Parse Webhook. De fiecare dată când încărcați adresa URL, veți primi un cod unic în cadrul adresei URL. 

Mai jos sunt două exemple pentru a începe cu dvs. Webhook. OBȚINE exemplu va începe să ascultați date noi. Din terminalul de linie de comandă, lipiți în următoarele OBȚINE exemplu: 

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

Pentru a lipi dacă Parse Webhook primește date, tastați răsuci comanda de la POST exemplu într-un al doilea ecran terminal:

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

Răspunsul din fereastra terminalelor ar trebui să aibă acum un conținut nou:

"Event_id": "e6a20fffc9c1968dd64684f0b11b9c29"

Apoi, trimiteți un e-mail domeniului sau subdomeniului pe care îl utilizați pentru analiza inbound. În câteva minute, ar trebui să vedeți e-mailul parsat ca JSON în fereastra terminalului. 

Personalizați parserul dvs.

După cum puteți vedea, detaliile separării datelor de pe e-mail și rutarea unui mesaj primit în scriptul SendGrid se fac în spatele scenei pentru dvs. Pornind de la zero, puteți utiliza Parse Webhook în multe moduri creative. Sunteți gata să plasați date reale prin e-mail! 

Pentru a personaliza paralele e-mailurile, puteți începe să personalizați codul în rute / inbound.js.

De exemplu, puteți să rescrieți fișierul inbound.js pentru a stoca fișiere atașate într-un mod care să se potrivească cu aplicația și baza dvs. de date sau chiar să finalizeze o acțiune dacă conținutul e-mailului conține un cuvânt. 

Concluzie

Pentru cazuri de utilizare, studii de caz și exemple, descărcați Parse Webhook Guide sau verificați biblioteca Parse Webhook API. 

Când examinați exemplele Parse Webhook, veți observa că cele două moduri cele mai comune pe care le folosiți sunt: ​​interacționarea cu utilizatorii dvs. și colectarea datelor în aplicațiile dvs. prin e-mail.

Cu ajutorul webhook, puteți dezvolta funcții care fac ca sarcinile frecvente să fie mai productive pentru utilizatorii dvs., fără ca aceștia să-și lase căsuța de e-mail. Colectarea de informații și crearea de mesaje interactive nu au fost niciodată mai ușoare. 

Cod