MasomoJinsi ya kutuma barua pepe za kiotomatiki kutoka tovuti yako

Somo fupi 9 kati ya 30 · Fanya tovuti yako iwe na manufaa

Chagua kitendo kimoja cha barua pepe

Somo hili ni la nani?

Kwa watu wanaotaka kitendo cha tovuti kisababishe barua pepe. Msimbo wa seva umetolewa na msaidizi wa programu anaweza kuusanidi; huhitaji kuandika mfumo wa nyuma wa barua pepe.

Anza na uthibitisho usiobadilika unaodhibitiwa.

Utakachojifunza katika somo hili

  • Sanidi mtumaji na mpokeaji unaowadhibiti.
  • Anzisha barua pepe halisi ya jaribio na ukague uwasilishaji.
  • Shughulikia maombi yaliyoshindwa bila kujifanya ujumbe umefika.
Maelezo, mfano uliotatuliwa na zoezi

Kabla ya kuanza

Unahitaji akaunti yako ya Resend, mtumaji aliyethibitishwa na sanduku la jaribio. Tumia mradi kamili tofauti wa Netlify Functions na msaidizi kwa usanidi. Upatikanaji na masharti ya mtoa huduma yanatumika. Majibu ya mfano yanaonyesha namna ya kujibu, si majaribio yaliyofanywa katika akaunti yako. Badilisha matokeo ya mfano kwa uliyoyaona mwenyewe, au taja hatua ambayo bado imekwama.

Angalia ujuzi wa kuanzia

Huu ni ujuzi muhimu, si sharti la kumaliza kozi zilizofungwa. Ukiujua, anza hapa; la sivyo fungua maandalizi. Faili za kuanzia zimetolewa, kwa hiyo huhitaji tovuti yako ya awali.

  1. Jinsi ya kuchapisha tovuti yako kutoka GitHub

    Unganisha hifadhi ya mazoezi na huduma ya upangishaji.

  2. Jinsi ya kusanidi barua pepe kwenye kikoa chako

    Chagua na usanidi kisanduku halisi cha barua pepe cha kutuma na kupokea.

Muda unaokadiriwa: 21–38 dakika

Makadirio yanatumia faili za kuanzia zilizotolewa, huku akaunti na zana zinazohitajika zikiwa tayari. Usanidi, foleni za uchapishaji na kusubiri barua pepe au DNS huhitaji muda zaidi. Uthibitishaji wa mtumaji na kusubiri kufika kwa barua vinaongeza muda. Ada na mipaka ya huduma hutegemea akaunti.

Elewa wazo

Fungua mradi uliotolewa na msaidizi wako na uamue tukio litakalotuma uthibitisho wa jaribio. Tumia kisanduku cha mwenye tovuti kilichosanidiwa pekee; mgeni hapaswi kuchagua wapokeaji wowote.

Tofautisha ombi kukubaliwa na mtoa huduma na ujumbe kufika kwenye kisanduku pokezi.

Mfano halisi

Tendo lililotolewa linatuma Workshop confirmation kwa mpokeaji aliyewekwa kwenye seva. Mgeni anaweka jina, si lengwa lolote analotaka. Rejea ya ujumbe inayorudi inasaidia kufuatilia, haithibitishi kufika.

Fungua warsha hii kamili ya barua pepe. Fuata run-locally.txt na ueleze thamani binafsi za mtumaji, mpokeaji, ufunguo wa mtoa huduma na msimbo wa mazoezi. Zisiwe kwenye faili za umma. Nisaidie kuendesha mradi na kutuma kwenye kisanduku changu cha majaribio kilichosanidiwa pekee. Chunguza ukubali wa mtoa huduma na uwasilishaji halisi wa kisanduku tofauti, pamoja na jaribio lililokataliwa.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Nini kitaanzisha jaribio lako, na utahakiki ukubali na kuwasili wapi?

Onyesha mfano wa suluhisho

Mpango wa mfano: Nitaingiza msimbo wa zoezi na jina la kubuni Alex, kisha kubofya Request test email. TEST_RECIPIENT kwenye seva ni sanduku langu. Nitalinganisha rejea iliyorudi na tukio la mtoa huduma na barua iliyofika kweli.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anatambua tendo maalumu la fomu na mpokeaji aliyewekwa kwenye seva.
  • Anataja kukubaliwa na mtoa huduma na kufika kwenye sanduku kama ukaguzi tofauti.
Jinsi inavyofanya kazi (si lazima)

Tuma barua baada ya kitendo kwenye tovuti

Function, programu ndogo ya seva, hugeuza ombi lililokubaliwa kuwa ombi kwa mtoa huduma wa barua.

Kivinjari kiombe kitendo maalumu badala ya kushikilia ufunguo wako wa siri wa barua. Katika zoezi hili, hutuma jina kwa function ya seva inayotuma uthibitisho wa maandishi ya kawaida kwenye kisanduku chako ulichosanidi.

Resend ndiyo njia ya mfano. Huduma nyingine ya kutuma barua za programu inaweza kufanya kazi hiyo, lakini uthibitishaji, ukaguzi wa mtumaji na taarifa za kufikishwa hutofautiana. Kisanduku cha barua cha mtu ni huduma tofauti.

Mfano uliotatuliwa

Jibu “limekubaliwa” humaanisha mtoa huduma amekubali ombi la kutuma. Hauthibitishi kisanduku kimepokea ujumbe. Tutakagua hatua hiyo kando.

Resend: kutuma barua pepe

Zoezi la ziada la utekelezaji

Mtoa huduma amerudisha ID ya ujumbe lakini hujakagua kisanduku. Unaweza kudai nini kwa uaminifu?

Onyesha mfano wa suluhisho

Mtoa huduma amekubali ombi lenye rejeo hilo. Kufikishwa bado hakujathibitishwa hadi ukague ushahidi wa huduma na kisanduku cha majaribio.

  • Anadai kukubaliwa, si kufika kulikothibitishwa kwenye kisanduku.
  • Anahifadhi rejeo la ujumbe kwa ukaguzi wa kufikishwa.

Hatua 1 · Jinsi ya kutuma barua pepe za kiotomatiki kutoka tovuti yako

Sanidi na uanzishe mradi ulio tayari

Mruhusu msaidizi ashughulikie muunganisho wa seva.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Fuata run-locally.txt na msaidizi wako. Ingiza thamani binafsi za akaunti kwa kutumia server-env.example.txt, kisha anza mradi kamili na ufungue URL yake halisi ya ndani ya kifaa.

Weka ufunguo wa mtoa huduma na mpokeaji asiyebadilika kwenye seva. Msimbo wa mazoezi wa fomu ni tofauti na ufunguo wa mtoa huduma; mwonekano wa awali wa faili hauendeshi huduma ya barua pepe.

Mfano halisi

Thamani za seva huchagua mtumaji, mpokeaji na ufikiaji wa mtoa huduma. Msimbo tofauti unaruhusu jaribio hili la mwenyewe tu. Sehemu iliyofichwa kwenye kivinjari wala mwonekano wa faili havifanyi usanidi huo wa faragha wa seva.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Mradi ulianza, na ni hatua ipi ya usanidi imekamilika au bado imekwama?

Onyesha mfano wa suluhisho

Rekodi ya mfano: Proxy ya ndani ilianza na kutoa URL ya programu. Mazingira binafsi yana mtumaji aliyethibitishwa, mpokeaji wangu, ufunguo wa mtoa huduma na msimbo wa zoezi uliozalishwa tofauti. Msimbo huo tu unaingia fomu. Programu ikisema Mail not configured, mipangilio binafsi ya mtumaji/ufunguo/mpokeaji haijakamilika.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anaripoti kama mradi kamili unaotumia seva umeanza kwenye URL iliyoonyeshwa.
  • Anatofautisha ufunguo binafsi/mpokeaji wa kudumu na msimbo tofauti wa fomu wa zoezi.
Jinsi inavyofanya kazi (si lazima)

Sanidi mtumaji mmoja wa mazoezi mwenye mipaka

Weka taarifa za siri za mtumaji na mpokeaji wa majaribio nje ya folda ya umma.

Ukaguzi wa ndani: hakikisha Node na npm vimesakinishwa, sakinisha au hakiki Netlify CLI, kisha fuata run-locally.txt kabla ya kutuma fomu. Kufungua ukurasa tuli kwanza kunasaidia mpangilio, lakini hakujaribu function yake ya seva.

Soma netlify/functions/mini-mail.mjs. Sanidi vigezo vyake vya mazingira ya barua na LAB_TOKEN isiyoweza kukisiwa yenye angalau herufi 24 kwenye mradi wako wa hosting. MAIL_FROM lazima iruhusiwe na mtoa huduma; TEST_RECIPIENT ni kisanduku chako cha majaribio. Usiweke ufunguo wa API kwenye public/app.js.

Mtumiaji huingiza msimbo tofauti wa mazoezi kwa zoezi hili lenye mipaka; hauwekwi kamwe kwenye faili za ukurasa na si ufunguo wako wa Resend. Function hupuuza kwa makusudi malengo yanayotolewa na mwombaji. Hukagua sehemu ndogo ya jina na kutengeneza maandishi ya kawaida. Kabla ya ufikiaji wa umma, ongeza mipaka ya maombi inayodumu na ukague vikomo; zoezi la mmiliki pekee si mfumo kamili wa kuzuia matumizi mabaya.

Lengo linadhibitiwa na seva kimakusudi. Ombi lililotengenezwa kwenye kivinjari linaweza kuongeza to='somewhere-else', lakini function hutengeneza data yake ya huduma na kutumia TEST_RECIPIENT. Hii humzuia mwombaji wa zoezi kugeuza kipengele kuwa cha kutuma kwa anwani yoyote; ufikiaji wa umma bado ungehitaji vidhibiti endelevu vya matumizi mabaya.

Kwa mfuatano wote wa ndani, fungua run-locally.txt: andaa mazingira ya siri kwenye mzizi, unganisha mradi wa mazoezi pekee na uanzishe wakala wa functions wa Netlify. server-env.example.txt huorodhesha majina ya vigezo bila siri halisi. Kufungua HTML pekee hakuwezi kuendesha seva.

Mfano uliotatuliwa

Mshambuliaji anayebadilisha ombi la kivinjari hawezi kuelekeza barua ya zoezi kwingine kwa sababu mpokeaji anatoka mazingira ya seva. Kuficha anwani kwenye JavaScript hakutoi ulinzi huo.

const {RESEND_API_KEY, MAIL_FROM, TEST_RECIPIENT} = process.env;
// Send only to TEST_RECIPIENT in this lab.

Node.js: hali ya usaidizi wa matoleo

Zoezi la ziada la utekelezaji

Je, kuhamishia ufunguo kwenye sehemu iliyofichwa kungeufanya kuwa wa siri?

Onyesha mfano wa suluhisho

Hapana. Sehemu zilizofichwa za fomu bado hutumwa kwenye kivinjari. Weka ufunguo kwenye mazingira ya seva na ufanye ombi kwa mtoa huduma huko.

  • Anatambua thamani zilizotumwa kwenye kivinjari zinaweza kukaguliwa.
  • Anahamishia matumizi yenye mamlaka kwenye mazingira ya seva.

Hatua 2 · Jinsi ya kutuma barua pepe za kiotomatiki kutoka tovuti yako

Tuma jaribio moja linalotambulika

Tumia kiolesura na uhifadhi ushahidi ukiwa umeunganishwa.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Anzisha uthibitisho kwenye ukurasa unaoendeshwa kweli. Hifadhi rejea ya jaribio na ukague tukio linalolingana la mtoa huduma na nakala ya kisanduku pokezi.

Ombi likishindwa, hifadhi hitilafu ikionekana na maelezo ya kutosha kujaribu tena. Usirekebishe huduma isiyopatikana kwa kubuni ujumbe wa mafanikio.

Mfano halisi

Kwa jina la kubuni Alex, barua ya kuanzia inasema “Hello Alex. Your practice request was received.” Linganisha nakala halisi na jaribio lake, si barua ya zamani.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Ukurasa, mtoa huduma na kisanduku kila kimoja kilionyesha nini kwa jaribio lako?

Onyesha mfano wa suluhisho

Rekodi ya mfano: Ukurasa ulisema mtoa huduma amekubali na kutoa rejea. Tukio linalolingana lipo. Sanduku langu lina Workshop confirmation yenye “Hello Alex. Your practice request was received.” Nakala isingefika, ningeandika imekubaliwa lakini uwasilishaji haujatatuliwa.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anaunganisha jibu la ukurasa, tukio la mtoa huduma na matokeo ya sanduku kwa jaribio lilelile.
  • Anatambua hatua iliyoshindwa bila kugeuza kosa au ID iliyokubaliwa kuwa dai la kufika kwa barua.
Jinsi inavyofanya kazi (si lazima)

Fuata ombi na jibu yaliyotolewa

Kitufe hutuma JSON; seva huihakiki kisha kurudisha hali ya kweli.

Chapisha mradi tofauti au uendeshe kwa zana za hosting za functions za ndani. Kufungua index.html kama faili la kompyuta hakuendeshi backend. Tuma jina la kubuni la majaribio na ukague jibu la mtandao.

Seva hurudisha 400 kwa ingizo lenye makosa ya muundo, 503 kwa usanidi unaokosekana, 502 kwa ombi la huduma lililoshindwa na 202 mtoa huduma anapokubali ujumbe. Kivinjari hushughulikia kushindwa bila kujifanya barua imefika.

Mfano uliotatuliwa

Kiolesura cha mazoezi kinasema “Accepted by the mail provider. Check your test inbox.”, yaani imekubaliwa na huduma ya barua, kagua kisanduku chako cha majaribio. Hiyo inalingana na seva inachojua wakati huo.

Zoezi la ziada la utekelezaji

Endpoint inarudisha 503. Uanze kwa kubadilisha rangi ya kitufe au kukagua mazingira ya seva?

Onyesha mfano wa suluhisho

Kagua vigezo vya mazingira vilivyowekwa na usanidi wa mtumaji. Mwonekano wa kiolesura hauwezi kutoa taarifa za siri za seva zinazokosekana.

  • Anakagua kwanza usanidi wa seva unaokosekana.
  • Hachukulii ombi lililoshindwa kuwa barua iliyokamilika.

Hatua 3 · Jinsi ya kutuma barua pepe za kiotomatiki kutoka tovuti yako

Chunguza ujumbe uliokosekana

Tafuta hali ya uwasilishaji kabla ya kutuma mara kwa mara.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Tumia delivery-record.txt kulinganisha rejea ya jaribio na hali ya mtoa huduma, lengo na ukaguzi wa kisanduku pokezi na taka. Mwombe msaidizi akusaidie kwenye hatua iliyoshindwa.

Ujumbe uliorudishwa au lengo lililokataliwa linahitaji uchunguzi. Kurudia utumaji uleule bila uchunguzi kunaweza kuongeza fujo bila kurekebisha uwasilishaji.

Mfano halisi

Imekubaliwa → imerudishwa → hakuna nakala inaelekeza kuchunguza uwasilishaji. Msimbo wa zoezi umekataliwa → hakuna tukio kwa mtoa huduma inaelekeza usanidi wa ufikiaji. Matokeo haya yana hatua tofauti zinazofuata.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Ni hali ipi ya uwasilishaji uliyoiona inayoeleza kitendo kinachofuata kwa jaribio lako?

Onyesha mfano wa suluhisho

Utambuzi wa mfano: Mtoa huduma alikubali, lakini tukio sasa linasema ujumbe umerudishwa na sanduku halina nakala. Nitakagua lengwa na tukio hilo kabla ya kutuma tena. Hii ni tofauti na msimbo uliokataliwa, ambao haupaswi kufika kwa mtoa barua.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anatumia hali inayolingana ya mtoa huduma na ukaguzi wa lengwa/sanduku kutambua hali ya sasa ya uwasilishaji.
  • Anachagua hatua kwenye sehemu iliyoshindwa badala ya kutuma tena bila kuchunguza.
Jinsi inavyofanya kazi (si lazima)

Hakikisha kufikishwa na kushindwa

Unganisha mbofyo mmoja, rejeo lake kwa huduma na ujumbe uliopokelewa kweli.

Pata ujumbe uliokubaliwa kwenye shughuli za mtoa huduma na ukague hali yake ya kufikishwa. Kisha kagua kisanduku kilichowekwa, pamoja na spam. Rekodi kukubaliwa na kupatikana kwa nakala iliyopokelewa kama uchunguzi tofauti.

Jaribu jina tupu katika fomu ya kawaida na JSON yenye makosa kwa ombi la msanidi. Katika usanidi tofauti wa mazoezi unaoweza kuondolewa, hakikisha kukosekana kwa funguo kunashindwa kwa uwazi. Usishiriki majibu kamili ya mtoa huduma yanayoweza kuwa na taarifa za akaunti.

Mfano uliotatuliwa

Taarifa ya kufikishwa na ujumbe unaolingana uliopokelewa ni ushahidi wenye nguvu kuliko kitufe cha kijani. Kukubaliwa na huduma bila nakala iliyopokelewa ni tatizo la kufikishwa ambalo bado halijatatuliwa.

Zoezi la ziada la utekelezaji

Mtoa huduma anaonyesha barua imerudishwa kwa rejeo la majaribio. Je, kurudia kutuma ileile mara moja ndiyo hatua bora inayofuata?

Onyesha mfano wa suluhisho

Kagua kwanza tatizo lililoripotiwa na usanidi wa mpokeaji. Rudia baada ya kutambua kilichobadilika; kutuma maombi yanayofanana tena na tena hakurekebishi lengo lisilo sahihi.

  • Anachunguza sababu ya kurudishwa na lengo.
  • Haendelei kurudia maombi bila utambuzi uliobadilika.

Hatua 4 · Jinsi ya kutuma barua pepe za kiotomatiki kutoka tovuti yako

Ongeza mada yenye manufaa ya ujumbe

Eleza tabia na umwombe msaidizi aitekeleze.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Mwombe msaidizi aongeze mada mbili: Project na Question, zikiwa na thamani project na question. Thamani iliyochaguliwa ifike kwenye mwili wa barua huku mpokeaji na ufunguo binafsi vikibaki seva. Akuongoze kupima thamani isiyoruhusiwa other bila kuiongeza kama chaguo halali.

Tuma jaribio moja kwa kila chaguo halali na ukague maandishi yaliyopokelewa kweli. Mada isiyoruhusiwa na msimbo batili zikataliwe bila mtoa huduma kutuma; kagua majaribio hayo tofauti.

Mfano halisi

Kazi ina machaguo mawili halali: Project na Question, yaliyohifadhiwa kama project na question. Thamani iliyochaguliwa ifike kwenye barua. Other ni thamani ya jaribio lisiloruhusiwa, si chaguo la tatu la kuongeza.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Toa badiliko lako la mada na matokeo halisi ya majaribio yaliyofaulu na yaliyokataliwa.

Unachopaswa kuandaa: Kitendo cha jaribio kinachofanya kazi na rekodi ya mtoa huduma, kisanduku na hitilafu iliyofichwa taarifa nyeti.

Onyesha mfano wa suluhisho

Rekodi ya mfano: Project ilitoa “Hello Alex. Your project request was received.” Question ilitoa maandishi yanayolingana ya question kwenye barua tofauti. Thamani other na msimbo batili zilikataliwa bila tukio la kutuma linalolingana. Machaguo yote halali bado yanatumia mpokeaji yuleyule aliyesanidiwa.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anaongeza Project/Question pekee na kuhakiki thamani iliyochaguliwa kwenye barua iliyofika kweli.
  • Anakagua kuwa mada isiyoruhusiwa na msimbo batili havitumi ujumbe.
Jinsi inavyofanya kazi (si lazima)

Kazi yako: ongeza taarifa yenye maana kwenye uthibitisho

Jumuisha mada fupi ya ombi bila kuruhusu wapokeaji wowote au HTML.

Ongeza sehemu ya mada yenye thamani mbili zinazoruhusiwa. Kagua orodha ya ruhusa kwenye seva na ujumuishe thamani iliyochaguliwa kwenye uthibitisho wa maandishi ya kawaida. Mpokeaji abaki amewekwa kwenye mazingira.

Tuma jaribio kwa kila thamani inayoruhusiwa na moja isiyoruhusiwa. Rekodi rejeo la mtoa huduma na ushahidi halisi wa kufikishwa.

Hariri kwanza faili zako za mwanzo. Kisha linganisha chaguo la mada, JSON ya ombi na orodha ya ruhusa ya seva mstari kwa mstari na faili za marejeo. Folda ya marejeo ni toleo kamili mbadala la kukagua kazi yako, si folda nyingine ya kubandika kwenye public/ bila kufikiri.

Mfano uliotatuliwa

Kukubali “project” na “question” pekee kunarahisisha uhakiki kuliko kunakili maudhui yoyote ya mwombaji katika kila sehemu ya barua.

Maelezo kamili ya hatua za suluhisho yanapatikana katika reference/assignment-walkthrough.txt. Linganisha hatua zake na matokeo yako; jaza rekodi ya majaribio kwa ulichokiona katika mradi wako mwenyewe.

Zoezi la ziada la utekelezaji

Panua uthibitisho kwa mada iliyohakikiwa na uonyeshe maombi yaliyofaulu na yaliyokataliwa.

Onyesha mfano wa suluhisho

Upanuzi wa mada hutumia thamani mbili tu, “project” na “question”. Ongeza chaguo kwenye fomu, jumuisha topic kwenye JSON na uhakiki orodha hiyo kwenye seva kabla ya kuita huduma ya barua. Faili za kivinjari na function za marejeo zinaonyesha mabadiliko yote.

Weka TEST_RECIPIENT chini ya udhibiti wa seva hata ombi lililotengenezwa likitoa anwani nyingine. Mada inayoruhusiwa na msimbo sahihi wa mazoezi vinaweza kufikia kukubaliwa na huduma; mada isiyoruhusiwa lazima irudishe 400 bila ombi kwa huduma. Kukubaliwa si kupokelewa kwenye kisanduku.

Tuma kila mada inayoruhusiwa kupitia akaunti yako ya majaribio, linganisha rejeo la huduma na ujumbe uliopokelewa kweli na urekodi kwa uaminifu kurudishwa au kusubiri. Msimbo wa marejeo ni upanuzi wa zoezi lenye mipaka, si njia ya umma ya kutuma barua kwa yeyote.

  • Seva hukataa mada zisizoruhusiwa na huhifadhi mpokeaji yuleyule.
  • Mada zote mbili zinazoruhusiwa zinaonekana kwenye ujumbe unaolingana uliopokelewa.

Somo hili lilikufaa?

Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.