أرسل أول بريد إلكتروني عبر Inbixio في 5 دقائق

تحوّل Inbixio حساب البريد الإلكتروني الذي تملكه بالفعل إلى واجهة API نظيفة عبر HTTPS ومحميّة بمفتاح. فبدلًا من فتح اتصالات SMTP من كل خدمة تشغّلها، ترسل شيفرتك طلب POST واحدًا، وتتولى Inbixio التخاطب مع خادم البريد الخاص بك.

ينقلك هذا الدليل من حساب جديد إلى بريد إلكتروني مُسلَّم. كل ما تحتاجه نحو خمس دقائق، وحساب بريد يدعم SMTP (يصلح صندوق بريد من Google Workspace أو Microsoft 365 أو Zoho أو من مزوّد الاستضافة)، وطرفية أوامر.

كيف تندمج Inbixio في منظومتك

قبل الخطوات، من المفيد أن ترى الأجزاء المتحركة:

1. تطبيقك يرسل طلب JSON إلى واجهة Inbixio مع مفتاح API.
2. Inbixio تتحقق من المفتاح وصلاحياته والحدّ الشهري لباقتك، ثم تضيف الرسالة إلى قائمة الإرسال.
3. خادم SMTP الخاص بك (الذي تربطه في الخطوة 2) يتولى تسليمها. تسجّل Inbixio الدخول إليه، وترقّي الاتصال إلى TLS، وتسلّمه الرسالة.
4. لوحة التحكم تعرض عدد الرسائل المُرسلة، ونسبة الفاشل منها، والمدة التي استغرقها خادمك لقبولها.

ولأن الرسالة تخرج عبر خادم البريد الخاص بك، فهي تُرسل من عنوانك ونطاقك أنت، وتبقى السمعة التي بنيتها لدى مزوّدي صناديق البريد ملكًا لك.

الخطوة 1: أنشئ حسابك واختر باقة

انتقل إلى app.inbixio.com/create-account واملأ اسمك وبريدك الإلكتروني واسم شركتك ورقم هاتفك وعنوان عملك، ثم اختر كلمة مرور.

ترسل Inbixio رابط تحقق إلى العنوان الذي استخدمته. افتحه ثم سجّل الدخول. في أول تسجيل دخول سيُطلب منك اختيار باقة، وتتم عملية الدفع بأمان عبر Stripe. تختلف الباقات أساسًا في حجم الإرسال الشهري. إن لم تكن متأكدًا من الباقة التي تحتاجها، فاقرأ كيف تقدّر حجم بريدك الإلكتروني.

الخطوة 2: اربط خادم SMTP

في لوحة التحكم، افتح Email Servers (خوادم البريد) واختر Add Server (إضافة خادم). سترى أربعة حقول ومفتاحَي تبديل:

تفصيلتان توفّران عليك الكثير من تتبّع الأخطاء لاحقًا:

• اسم المستخدم هو المُرسِل أيضًا. ترسل Inbixio من العنوان الذي تسجّل الدخول به، لذا استخدم صندوق بريد حقيقيًا على نطاقك مثل hello@ أو notifications@، بدلًا من صندوق بريد شخصي.
• كثير من المزوّدين يشترطون كلمة مرور تطبيق. فمثلًا تشترط Google تفعيل التحقق بخطوتين وكلمة مرور تطبيق من 16 حرفًا لاستخدام SMTP، وستُرفض كلمة مرورك العادية.

لست متأكدًا مما تُدخله؟ يشرح دليل إعدادات SMTP بالتفصيل المضيفات والمنافذ وTLS لدى المزوّدين الشائعين.

الخطوة 3: أنشئ مفتاح API

افتح API Keys (مفاتيح API) واختر Create Api Key (إنشاء مفتاح API). امنحه اسمًا يدلّ على مكان استخدامه، مثل production-backend أو staging-signup-service، ثم اضبط:

• Server Access (الوصول إلى الخادم): الخيار All Server (كل الخوادم) يرسل عبر أول خادم بريد ربطته، والخيار Selected Server (خادم محدّد) يربط المفتاح بخادم واحد. إن كان لديك أكثر من عنوان إرسال، فامنح كل خدمة مفتاحًا مربوطًا بخادمها؛ فبهذه الطريقة تتحكم في العنوان الذي ترسل منه.
• Permissions (الصلاحيات): حدّد Send (إرسال) ليتمكن المفتاح من إرسال البريد. لا تمنح أي مفتاح إلا الصلاحيات التي يحتاجها.

اختر Generate API Key (توليد مفتاح API)، ثم انسخ المفتاح. تبدأ مفاتيح Inbixio بـ ibx_. احفظه كما تحفظ كلمة المرور: في مدير الأسرار أو في متغيّر بيئة، ولا تضعه أبدًا في شيفرة الواجهة الأمامية أو في مستودع عام. يتناول دليل أمان مفاتيح API تدوير المفاتيح وتقييد نطاقها بمزيد من التفصيل.

الخطوة 4: أرسل أول بريد إلكتروني

صدّر المفتاح، ثم أرسل طلبًا باستخدام curl:

export INBIXIO_API_KEY="ibx_your_key_here"

curl -X POST https://backend.inbixio.com/api/send-email/ \
  -H "X-API-Key: $INBIXIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to_email": "you@example.com",
    "subject": "Hello from Inbixio",
    "message": "<h1>It works!</h1><p>My first email sent through the Inbixio API.</p>"
  }'

يُعيد الطلب الناجح رمز HTTP 200:

{ "message": "Email queued successfully." }

تفقّد صندوق بريدك. ستصل الرسالة من العنوان الذي استخدمته اسمَ مستخدم لـ SMTP.

أبقِ الشرطة المائلة في النهاية. نقطة النهاية هي /api/send-email/. فمن دون / الأخيرة يردّ الخادم بإعادة توجيه، وكثير من عملاء HTTP لا يعيدون إرسال جسم الطلب بعد إعادة التوجيه.

يتضمن جسم الطلب ثلاثة حقول إلزامية:

الخطوة 5: تأكّد من التسليم في لوحة التحكم

تعني حالة “Queued” أن Inbixio قبلت الطلب وبدأت التسليم في الخلفية. يحدث التسليم عبر SMTP بعد لحظات، وتتجمّع النتائج في Dashboard (لوحة التحكم):

• Email Sent (الرسائل المُرسلة) تحسب عمليات الإرسال الناجحة خلال آخر 7 أيام.
• Failed Deliveries (عمليات التسليم الفاشلة) تعرض نسبة الرسائل التي رفضها خادم SMTP خلال الأيام السبعة نفسها.
• Avg Latency (متوسط زمن الاستجابة) يعرض المدة التي يستغرقها خادم SMTP لقبول الرسائل.
• جدول logs (السجلات) يسرد كل استدعاء API مع معرّف الحدث ونقطة النهاية ورمز الحالة وزمن الاستجابة.

إن لم تصل رسالتك التجريبية وارتفع معدّل الفشل، فالسبب يكاد يكون دائمًا في إعدادات الخادم: كلمة مرور خاطئة، أو مزوّد يشترط كلمة مرور تطبيق، أو مضيف أو منفذ خاطئ. راجعها في Email Servers وأرسل رسالة تجريبية أخرى.

أخطاء شائعة في الطلب الأول

لإعادة المحاولة والحدود الشهرية ومعالجة الأخطاء بمستوى بيئة الإنتاج، راجع معالجة أخطاء واجهة برمجة البريد الإلكتروني وحدودها.

ما الخطوة التالية؟

أصبح لديك الآن مسار يعمل من شيفرتك إلى صناديق بريد مستخدميك. ومن هنا:

• أرسل من منظومتك الفعلية باستخدام أمثلة Node.js وPython وcURL.
• تأكّد من وصول رسائلك إلى صندوق الوارد باستخدام قائمة التحقق من SPF وDKIM وDMARC.
• أنشئ الرسائل التي ينتظرها المستخدمون: رموز OTP والتحقق وإعادة تعيين كلمة المرور.