Өзңіздің SendGrid тіркелгіңіз арқылы электрондық пошта жіберу

Өзіңіздің SendGrid тіркелгіңізді қосыңыз: доменді аутентификациялау және оның CNAME жазбалары, толық қолжетімділіктің орнына шектеулі Mail Send кілті, Cloudflare сұр бұлт тұзағы және жарамды кілттегі 403 қатесінің шынайы мәні.

SendGrid (Twilio SendGrid) тіркелгісі және доменіңіздің DNS жүйесіне кіру мүмкіндігі қажет болады.

SendGrid өз құжаттамасы: Жіберушіні аутентификациялау · API кілттері · Тіркелу

1. Доменіңізді аутентификациялаңыз

Settings → Sender Authentication → Authenticate Your Domain.

Тізімнен DNS хостыңызды таңдаңыз да, "Would you like to also brand the links for this domain?" сұрағына Yes деп жауап беріңіз — сілтеме брендтеуі бақыланатын сілтемелерді sendgrid.net орнына өзіңіздің доменіңізге қайта бағыттайды, ал шот-фактураңыздағы сілтемеге меңзерді апарған клиент сіздің атыңызды көруі тиіс.

Хабар жіберетін домен сралған кезде mail.yourdomain.com сияқты салдарлы доменді (subdomain) енгізіңіз.

2. CNAME жазбаларын жариялаңыз

SendGrid сізге үш немесе бес CNAME жазбасын береді. Олардың барлығын қосыңыз.

| Түрі | Хост | Мақсаты | | --- | --- | --- | | CNAME | em1234.yourdomain.com | Қайту жолы (bounce) домені | | CNAME | s1._domainkey.yourdomain.com | DKIM кілті 1 | | CNAME | s2._domainkey.yourdomain.com | DKIM кілті 2 |

⭐ SendGrid TXT жазбаларының орнына CNAME жазбаларын қасақана пайдаланады, және бұл әлдеқайда тиімді: нақты кілт мәндері SendGrid жүйесінде сақталады, сондықтан олар DNS жүйесіне қайта қол тигізбестен өздерінің қол қою кілттерін ауыстыра алады.

⚠️ Егер DNS провайдеріңіз Cloudflare болса, бұл жазбаларды прокси арқылы емес, тек DNS (сұр бұлт) ретінде орнатыңыз. Прокси арқылы жұмыс істейтін CNAME жазбасы Cloudflare мекенжайларына бағытталады және SendGrid тексеруі сәтсіз аяқталады.

SendGrid жүйесінде Verify түймесін басыңыз. Бір сағатқа дейін уақыт алуы мүмкін.

3. API кілтін жасаңыз

Settings → API Keys → Create API Key.

Restricted Access тармағын таңдап, тек Mail Send → Full Access рұқсатын беріңіз. Басқа ештеңе керек емес.

⛔ Толық қолжетімділік (Full Access) кілтін пайдаланбаңыз. Толық қолжетімділік кілті контактілеріңізді оқи алады, тіркелгі параметрлеріңізді өзгерте алады және басқа кілттерді жасай алады; бізге тек хабарлама жіберу қажет. Егер кілтіңіздің көшірмесі кездейсоқ жария болып кетсе, бұл екі кілттің айырмашылығы қалаусыз электрондық пошта мен бұзылған тіркелгі арасындағы айырмашылықпен бірдей.

⚠️ Кілт тек бір рет көрсетіледі. Беттен шықпай тұрып оны көшіріп алыңыз — SendGrid оны сізге қайта көрсете алмайды, тек ауыстыра алады.

4. Оны Zinn® жүйесінде қосыңыз

Бақылау тақтасынан Email sending бөлімін ашыңыз:

Provider — SendGrid
Send from this domain — mail.yourdomain.com (мекенжай емес, домен)
SendGrid API key — 3-қадамдағы кілт

SendGrid жүйесіне сізден басқа параметрлер қажет емес.

5. Сынақты жіберіп, кодты енгізіңіз

Басқа домендегі кіріс жәшігіне Send test message түймесін басып, хабарламадан кодты оқып алыңыз да, оны енгізіңіз.

Жұмыс істемеген жағдайда

403 Forbidden — API кілтіңізде Mail Send рұқсаты жоқ. Бұл — ең жиі кездесетін қателік: ешбір ауқым (scope) белгіленбей жасалған шектеулі қолжетімділік кілті мінсіз аутентификациядан өтеді, бірақ ешбір әрекетті орындауға рұқсаты жоқ.

"The from address does not match a verified Sender Identity" — домендік аутентификацияңыз әлі жасыл түске боялған жоқ немесе Send from this domain өрісіндегі домен сіз аутентификациядан өткізген домен емес. SendGrid нақты доменді тексереді: mail.yourdomain.com доменін аутентификациялау yourdomain.com арқылы хат жіберуге рұқсат бермейді.

Қабылданды, бірақ жеткізілмеді — SendGrid ішіндегі Activity бөлімін қараңыз. Жаңа тіркелгі бірінші күн немесе соған жақын уақыт ішінде тексеру үшін ұсталып тұруы мүмкін, бұл кезде хабарламалар кері қайтарылмай, сол жерде тұрады.

Бірнеше хабарлама жіберілгеннен кейін тіркелгіңіз бұғатталды — SendGrid кері қайтарылатын мекенжайларға хат жіберетін жаңа тіркелгілерге қатысты өте қатаң ұстанымда. Қызметке ауыспастан бұрын клиенттер тізімінің таза екеніне көз жеткізіңіз.