თქვენ დაგჭირდებათ SendGrid-ის (Twilio SendGrid) ანგარიში და წვდომა თქვენი დომენის DNS-ზე.
SendGrid-ის საკუთარი დოკუმენტაცია: გამგზავნის აუტენტიფიკაცია · API გასაღებები · რეგისტრაცია
1. გაიარეთ თქვენი დომენის აუტენტიფიკაცია
Settings → Sender Authentication → Authenticate Your Domain.
აირჩიეთ თქვენი DNS ჰოსტი სიიდან და უპასუხეთ Yes კითხვაზე "Would you like to also brand the links for this domain?" — ბმულების ბრენდირება ცვლის მეთვალყურეობის ქვეშ მყოფ ბმულებს თქვენი საკუთარი დომენით sendgrid.net-ის ნაცვლად, და კლიენტი, რომელიც თქვენს ინვოისში ბმულზე მიიტანს კურსორს, დაინახავს თქვენს სახელს.
შეიყვანეთ ქვედომენი, მაგალითად mail.yourdomain.com, როდესაც მოგეთხოვებათ დომენი, საიდანაც აგზავნით.
2. გამოაქვეყნეთ CNAME ჩანაწერები
SendGrid მოგცემთ სამ ან ხუთ CNAME ჩანაწერს. დაამატეთ ყველა მათგანი.
| ტიპი | ჰოსტი | დანიშნულება |
|---|
CNAME | em1234.yourdomain.com | Return-path (bounce) დომენი |
CNAME | s1._domainkey.yourdomain.com | DKIM გასაღები 1 |
CNAME | s2._domainkey.yourdomain.com | DKIM გასაღები 2 |
⭐ SendGrid განზრახ იყენებს CNAME-ებს TXT ჩანაწერების ნაცვლად, და ეს ნამდვილად უკეთესია: რეალური გასაღების მნიშვნელობები ინახება SendGrid-ში, ასე რომ მათ შეუძლიათ განაახლონ ხელმოწერის გასაღებები თქვენ მიერ DNS-ის ხელახალი რედაქტირების საჭიროების გარეშე.
⚠️ თუ თქვენი DNS პროვაიდერი არის Cloudflare, დააყენეთ ეს ჩანაწერები რეჟიმზე DNS only (ნაცრისფერი ღრუბელი) და არა პროქსირებულზე (proxied). პროქსირებული CNAME რეზოლვდება Cloudflare-ის მისამართებზე და SendGrid-ის შემოწმება ვერ განხორციელდება.
დააჭირეთ Verify-ს SendGrid-ში. დაიცადეთ ერთ საათამდე.
3. შექმენით API გასაღები
Settings → API Keys → Create API Key.
აირჩიეთ Restricted Access და მიანიჭეთ მხოლოდ Mail Send → Full Access. სხვა არაფერი.
⛔ არ გამოიყენოთ Full Access გასაღები. Full Access გასაღებს შეუძლია წაიკითხოს თქვენი კონტაქტები, შეცვალოს თქვენი ანგარიშის პარამეტრები და შექმნას დამატებითი გასაღებები; ერთადერთი, რაც ჩვენ გვჭირდება, არის შეტყობინების გაგზავნა. თუ ჩვენთან არსებული თქვენი გასაღების ასლი ოდესმე გამჟღავნდება, განსხვავება ამ ორ გასაღებს შორის არის განსხვავება რამდენიმე არასასურველ წერილსა და კომპრომეტირებულ ანგარიშს შორის.
⚠️ გასაღები ნაჩვენებია მხოლოდ ერთხელ. დააკოპირეთ იგი გვერდის დატოვებამდე — SendGrid-ს არ შეუძლია მისი ხელახლა ჩვენება, მხოლოდ ჩანაცვლება.
4. დააკავშირეთ იგი Zinn®-ში
გახსენით Email sending თქვენს სამართავ პანელში:
- პროვაიდერი — SendGrid
- გაგზავნა ამ დომენიდან —
mail.yourdomain.com (დომენი და არა მისამართი)
- SendGrid-ის API გასაღები — გასაღები მე-3 ნაბიჯიდან
SendGrid-ს თქვენგან სხვა პარამეტრები არ სჭირდება.
5. გაგზავნეთ ტესტი და შეიყვანეთ კოდი
დააჭირეთ Send test message-ს სხვა დომენზე არსებულ საფოსტო ყუთზე, ამოიკითხეთ კოდი მისგან და შეიყვანეთ იგი.
როდესაც ეს არ მუშაობს
403 Forbidden — თქვენს API გასაღებს არ აქვს Mail Send ნებართვა. ეს არის ყველაზე გავრცელებული შეცდომა დიდი უპირატესობით: Restricted Access გასაღები, რომელიც შექმნილია მონიშნული სფეროების გარეშე, გადის აუტენტიფიკაციას იდეალურად, მაგრამ არაფრის გაკეთების უფლება არ აქვს.
"The from address does not match a verified Sender Identity" — თქვენი დომენის აუტენტიფიკაცია ჯერ არ გამწვანებულა, ან დომენი ველში Send from this domain არ არის ის, რომლის აუტენტიფიკაციაც გაიარეთ. SendGrid ამოწმებს ზუსტ დომენს: mail.yourdomain.com-ის აუტენტიფიკაცია არ იძლევა yourdomain.com-იდან გაგზავნის უფლებას.
Accepted but never delivered — შეამოწმეთ Activity SendGrid-ში. სრულიად ახალი ანგარიში ზოგჯერ რჩება განხილვის პროცესში პირველი დღის განმავლობაში, და შეტყობინებები რჩება იქ უარყოფის (bounce) ნაცვლად.
თქვენი ანგარიში შეჩერდა რამდენიმე გაგზავნის შემდეგ — SendGrid მკაცრია ახალი ანგარიშების მიმართ, რომლებიც აგზავნიან წერილებს ისეთ მისამართებზე, საიდანაც წერილები უკან ბრუნდება (bounce). დარწმუნდით, რომ თქვენი კლიენტების სია სუფთაა გადართვამდე.