# تكامل # SendGrid ## نظرة عامة 'sendgrid' هو تكامل يسمحchatbot Botpress بإرسال رسائل البريد الإلكتروني عبر واجهة برمجة تطبيقات SendGrid . ## التكوين ### توثيق المجال الخاص بكsendgrid 1. تسجيل الدخول إلى لوحة تحكم SendGrid sendgrid 2. في شريط التنقل على اليسار، افتح القائمة الفرعية "الإعدادات"، وانقر على "مصادقة المرسل" 3. في الجزء الأوسط الأيمن من الشاشة، انقر على زر "البدء" (مصادقة المجال الأول فقط) - (مصادقة المجال الثاني + مصادقة المجال الثاني) بالقرب من أسفل اليسار في قسم "مصادقة المجال"، انقر على "مصادقة المجال الخاص بك" 4. اختر موفر النطاق الخاص بك، إذا لم يكن الموفر مدرجًا، اختر "لست متأكدًا" (إنه أسهل من خيار "مضيف آخر") - تم اختباره أيضًا مع نطاقات SquareSpace 5. في حقل "من النطاق"، أدخل نطاقك (على سبيل المثالBotpress.com") 6. أضف سجلات DNS في بوابة مزوِّد النطاق الخاص بك (مثل Cloudflare وGoDaddy وSququare، إلخ) 7. حدِّد "لقد أضفتُ هذه السجلات" وانقر على "تحقق" وانتظر حتى تؤكد SendGrid أنه تم التحقق منها. - إذا استمر ظهور خطأ على الرغم من إضافة سجلات "CNAME" DNS بشكل صحيح إلى موفر النطاق الخاص بك، فحاول إزالة لاحقة النطاق من مفتاح المضيف. (مثل "em1234botpress.com" > "em1234") 8. أنت الآن جاهز لإرسال رسائل البريد الإلكتروني مع نطاقك. إرسال بريد إلكتروني سعيد! ### الحصول على مفتاح واجهة برمجة التطبيقاتsendgrid 1. تسجيل الدخول إلى لوحة تحكم SendGrid sendgrid 2. في شريط التنقل على اليسار، افتح القائمة الفرعية "الإعدادات"، وانقر على "مفاتيح API" 3. بالقرب من أعلى اليمين، انقر فوق "إنشاء مفتاح واجهة برمجة التطبيقات" 4. امنح المفتاح اسمًا 5. امنح المفتاح الأذونات إما "وصول كامل" أو إذا كنت تستخدم "وصول مقيّد" حدد ما يلي: - "إرسال بريد إلكتروني" (وصول كامل) 6. انقر على "إنشاء وعرض" ### إعداد خطافات الويبwebhook 1. تسجيل الدخول إلى لوحة تحكم SendGrid sendgrid 2. في شريط التنقل على اليسار، افتح القائمة الفرعية "الإعدادات"، انقر على "إعدادات البريد" 3. في إعدادات البريد، انقر على "خطافات الويب الخاصة بالأحداث" 4. في الجزء الأوسط الأيمن من الشاشة، انقر فوق "إنشاء webhook جديد" 5. (اختياري) امنح خطاف webhook "اسمًا مألوفًا" (على سبيل المثالBotpress Bot") 6. انسخ عنوان URL الخاص webhook من تهيئة تكامل Botpress والصقه في حقل "نشر عنوان URL" في Sendgrid 7. حدد "الإجراءات التي سيتم نشرها"، وستكون هذه هي الأحداث التي سيتلقاها تكامل Botpress . 1. ملاحظة: لا يدعم هذا التكامل جميع الأحداث حتى الآن 8. (اختياري، ولكن يوصى به) تمكين "التحقق من التوقيع" 1. إذا قمت بتمكين هذا، بمجرد حفظ webhook يب، انقر على الترس الموجود على webhook وانقر على "تحرير" 2. انسخ "مفتاح التحقق" من Sendgrid والصقه في حقلWebhook مفتاح التحقق منWebhook " في تكوين تكامل Botpress 9. انقر فوق "حفظ" وستكون جاهزًا لاستخدام الأحداث في روبوت Botpress الخاص بك ## ملاحظات جانبية يقتصر التنفيذ الحالي على إرسال رسائل البريد الإلكتروني النصية المنسقة [markdown] (https://spec.commonmark.org/0.31.2/) فقط، على الرغم من أنه سيتم التوسع في ذلك في المستقبل. ## الموارد - https://www.twilio.com/docs/sendgrid/for-developers - https://www.twilio.com/docs/sendgrid/api-reference - https://www.twilio.com/docs/sendgrid/ui/account-and-settings/api-keys - https://www.twilio.com/docs/sendgrid/ui/account-and-settings/how-to-set-up-domain-authentication