أرسل أول رسالة

أنشئ مفتاحًا، وتحقق من نطاق، وأرسل رسالة. يبدأ معظم الفرق الإرسال خلال ساعة؛ والخطوة البطيئة الوحيدة هي انتظار DNS.

قبل أن تبدأ

تحتاج إلى حساب MigoSMTP ونطاق تملكه، مثل example.com. الإرسال من نطاق فرعي مثل mail.example.com يفصل بريدك التسويقي وبريد منتجك عن نطاقك الرئيسي، وهو خيار افتراضي جيد.

1. أنشئ مفتاح API

من لوحة التحكم افتح مفاتيح API وأنشئ مفتاحًا بصلاحية الإرسال. امنح كل تطبيق مفتاحه الخاص لتتمكن من إلغاء مفتاح دون المساس بالبقية. احفظه كسر، ولا تضعه أبدًا في نظام التحكم بالإصدارات.

export MIGOSMTP_KEY="YOUR_API_KEY"

2. تحقق من نطاق

أضف نطاق الإرسال في لوحة التحكم وانشر سجلات DNS التي تعرضها: SPF وDKIM، ويُنصح بإضافة سياسة DMARC. قد يستغرق انتشار تغييرات DNS بعض الوقت، لذا انتظر حتى تصبح حالة النطاق «تم التحقق» قبل الإرسال.

3. أرسل رسالة

استدعِ نقطة نهاية الإرسال بعنوان مرسل (from) على نطاقك الموثّق. استبدل العناوين التجريبية بعناوينك.

curl -X POST https://api.migosmtp.com/v1/send \
  -H "Authorization: Bearer $MIGOSMTP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"hello@example.com","to":"you@example.com","subject":"Hello","text":"It works."}'

4. تحقق من النتيجة

تتضمن الاستجابة معرّف الرسالة. استخدمه للبحث عن الرسالة وأحداثها في لوحة التحكم، أو استقبلها في نظامك عبر webhooks.

هل تفضّل SMTP؟

إذا كان تطبيقك يتحدث SMTP أصلًا، فوجّهه إلى مضيف SMTP الظاهر في لوحة التحكم. لا يلزم تغيير في الشيفرة سوى إعدادات الاتصال. راجع دليل تكامل SMTP.

قبل الإطلاق

تحقق من هذه النقاط أولًا: أرسل من نطاق موثّق، وانشر سجل DMARC، وتعامل مع استجابات 429 بتراجع تدريجي، واشترك في webhooks الارتداد والشكاوى لتتوقف عن مراسلة العناوين الفاشلة، وأبقِ مفاتيح API خارج مستودعك.

إلى أين بعد ذلك

اقرأ مرجع API لكل نقطة نهاية، وأعدّ webhooks لأحداث التسليم، وراجع رموز الأخطاء وحدود المعدل ليتعامل تكاملك مع الإخفاق بشكل سليم.