Somo fupi · Kiswahili

Jinsi ya kutuma barua pepe za kiotomatiki kutoka tovuti yako

Endesha mradi wa barua pepe uliotolewa kwa msaada wa msaidizi, tuma uthibitisho unaodhibitiwa na uhakiki kuwasili kwake kwenye kisanduku chako.

Anza somo shirikishiSoma maelezo ya somo

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.

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.

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.

Utakachojifunza

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

Faili za mazoezi

Hatua 1

Chagua kitendo kimoja cha barua pepe

Anza na uthibitisho usiobadilika unaodhibitiwa.

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.

Resend: kutuma barua pepe

Faili za hatua hii

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

Extra implementation exercise

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 2

Sanidi na uanzishe mradi ulio tayari

Mruhusu msaidizi ashughulikie muunganisho wa seva.

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.

Node.js: hali ya usaidizi wa matoleo

Faili za hatua hii

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

Extra implementation exercise

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 3

Tuma jaribio moja linalotambulika

Tumia kiolesura na uhifadhi ushahidi ukiwa umeunganishwa.

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

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 4

Chunguza ujumbe uliokosekana

Tafuta hali ya uwasilishaji kabla ya kutuma mara kwa mara.

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

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 5

Ongeza mada yenye manufaa ya ujumbe

Eleza tabia na umwombe msaidizi aitekeleze.

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

Start hereFaili za mazoezi

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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.

Endelea kujifunza

Angalia masomo mengine