skill
خدمة البريد الإلكتروني من Cloudflare
تطبيق أو استكشاف أخطاء تكاملات Cloudflare لإرسال البريد الإلكتروني وتوجيه البريد الإلكتروني، بالإضافة إلى إعدادات التسليم الخاصة بها.
نبذة
# خدمة البريد الإلكتروني من Cloudflare
قد تكون معرفتك بخدمة البريد الإلكتروني من Cloudflare، أو توجيه البريد الإلكتروني (Email Routing)، أو إرسال البريد الإلكتروني (Email Sending) قديمة. **فضل الاسترجاع على التدريب المسبق** لأي مهمة تتعلق بخدمة البريد الإلكتروني من Cloudflare.
تتيح لك خدمة البريد الإلكتروني من Cloudflare إرسال رسائل البريد الإلكتروني للمعاملات وتوجيه رسائل البريد الإلكتروني الواردة، كل ذلك ضمن منصة Cloudflare. قد تكون معرفتك بهذا المنتج قديمة — فقد تم إطلاقه في عام 2025 ويتطور بسرعة. **فضل الاسترجاع على التدريب المسبق** لأي مهمة تتعلق بخدمة البريد الإلكتروني.
**إذا كان هناك أي تضارب بين هذه المهارة والمصادر أدناه، فثق دائما بالمصدر الأصلي.** تعد وثائق Cloudflare، ومواصفات REST API، و`@cloudflare/workers-types`، ومستودع Agents SDK هي مصدر الحقيقة. هذه المهارة هي دليل إرشادي — قد تتأخر عن أحدث التغييرات. عند الشك، استرجع من المصادر أدناه واستخدم ما تقوله.
## مصادر الاسترجاع
| المصدر | كيفية الاسترجاع | يستخدم ل | |--------|----------------|---------| | وثائق Cloudflare | أداة `docs` في Cloudflare MCP أو الرابط `https://developers.cloudflare.com/email-service/index.md` | مرجع API، الحدود، التسعير، أحدث الميزات | | مواصفات REST API | `https://developers.cloudflare.com/api/resources/email_sending/index.md` | مواصفات OpenAPI ل Email Sending REST API | | أنواع Workers | `https://www.npmjs.com/package/@cloudflare/workers-types` | توقيعات الأنواع، أشكال الربط | | وثائق Agents SDK | [Email agent walkthrough](https://developers.cloudflare.com/agents/examples/email-agent/index.md) | معالجة البريد الإلكتروني في Agents SDK |
## أولا: التحقق من المتطلبات الأساسية
قبل كتابة أي كود للبريد الإلكتروني، تحقق من توفر الأساسيات:
1. **هل تم إعداد النطاق؟** قم بتشغيل `npx wrangler email sending list` لمعرفة النطاقات التي تم تمكين إرسال البريد الإلكتروني لها. إذا لم يكن النطاق مدرجا، فقم بتشغيل `npx wrangler email sending enable userdomain.com` أو راجع [cli-and-mcp.md](references/cli-and-mcp.md) للحصول على إرشادات الإعداد الكاملة. 2. **هل تم تكوين الربط (Binding)؟** ابحث عن `send_email` في `wrangler.jsonc` (ل Workers). 3. **هل تم تثبيت postal-mime؟** قم بتشغيل `npm ls postal-mime` (مطلوب فقط لاستقبال/تحليل رسائل البريد الإلكتروني).
## ما الذي تحتاجه؟
ابدأ من هنا. ابحث عن حالتك، ثم اتبع الرابط للحصول على التفاصيل الكاملة.
| أريد أن... | المسار | المرجع | |--------------|------|-----------| | **أرسل رسائل بريد إلكتروني من Cloudflare Worker** | ربط Workers (لا حاجة لمفاتيح API) | [sending.md](references/sending.md) | | **أرسل رسائل بريد إلكتروني من وكيل AI مبني باستخدام [Cloudflare Agents SDK](https://developers.cloudflare.com/agents/index.md)** | `onEmail()` + `replyToEmail()` في فئة Agent | [sending.md](references/sending.md) | | **أرسل رسائل بريد إلكتروني من تطبيق أو وكيل خارجي** (Node.js, Go, Python, إلخ.) | REST API مع رمز Bearer | [rest-api.md](references/rest-api.md) | | **أرسل رسائل بريد إلكتروني من وكيل برمجة** (Claude Code, Cursor, Copilot, إلخ.) | أدوات MCP، أو wrangler CLI، أو REST API | [cli-and-mcp.md](references/cli-and-mcp.md) | | **أستقبل وأعالج رسائل البريد الإلكتروني الواردة** (Email Routing) | معالج `email()` في Workers | [routing.md](references/routing.md) | | **أقوم بإعداد Email Sending أو Email Routing** | `wrangler email sending enable` / `wrangler email routing enable`، أو لوحة التحكم | [cli-and-mcp.md](references/cli-and-mcp.md) | | **أحسن قابلية التسليم، أتجنب مجلدات البريد العشوائي** | المصادقة، المحتوى، الامتثال | [deliverability.md](references/deliverability.md) |
## سير عمل الإرسال
فضل الربط (binding) ل Workers؛ استخدم REST للتطبيقات الخارجية أو عند الطلب صراحة. اقرأ [sending.md](references/sending.md) أو [rest-api.md](references/rest-api.md) لاسترجاع الوثائق الخاصة بالمهمة المختارة قبل كتابة الكود. تغطي هذه الأدلة الإعداد، والمستلمين، والمرفقات، والرؤوس، والحدود، ومعالجة الاستجابة، والأخطاء؛ ويغطي دليل Workers أيضا تكامل Agents SDK والأنواع المطابقة لتكوين المشروع.
## الأخطاء الشائعة
| الخطأ | سبب حدوثه | الإصلاح | |---------|---------------|-----| | نسيان ربط `send_email` في تكوين wrangler | تستخدم خدمة البريد الإلكتروني ربطا، وليس مفتاح API | أضف `"send_email": [{ "name": "EMAIL" }]` إلى wrangler.jsonc | | الإرسال من نطاق غير موثق | يجب إعداد النطاق ل Email Sending قبل الإرسال الأول | قم بتشغيل `wrangler email sending enable yourdomain.com` أو قم بالإعداد في لوحة التحكم | | قراءة `message.raw` مرتين في معالج البريد الإلكتروني | التدفق الخام يستخدم لمرة واحدة — القراءة الثانية تعيد فارغا | قم بالتخزين المؤقت أولا: `const raw = await new Response(message.raw).arrayBuffer()` | | فقدان حقل `text` (HTML فقط) | بعض عملاء البريد الإلكتروني يعرضون النص العادي فقط؛ كما يساعد في درجات البريد العشوائي | قم دائما بتضمين نسختي `html` و `text` | | استخدام البريد الإلكتروني للتسويق/الإرسال بالجملة | خدمة البريد الإلكتروني مخصصة لرسائل البريد الإلكتروني للمعاملات فقط | استخدم منصة بريد إلكتروني تسويقية مخصصة للرسائل الإخبارية والحملات | | إعادة التوجيه إلى وجهات غير موثقة | `message.forward()` يعمل فقط مع العناوين الموثقة | قم بتشغيل `wrangler email routing addresses create user@gmail.com` أو أضف في لوحة التحكم | | الاختبار بعناوين وهمية | الارتدادات من العناوين غير الموجودة تضر بسمعة المرسل | استخدم عناوين حقيقية |
التثبيت
شغل هذا الأمر
npx skills add cloudflare/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add cloudflare/skills`، أو استنسخ المستودع وانسخ مجلد `skills/cloudflare-email-service` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة خدمة البريد الإلكتروني من Cloudflare؟
تطبيق أو استكشاف أخطاء تكاملات Cloudflare لإرسال البريد الإلكتروني وتوجيه البريد الإلكتروني، بالإضافة إلى إعدادات التسليم الخاصة بها.
كيف أثبت خدمة البريد الإلكتروني من Cloudflare؟
شغل هذا الأمر في الطرفية:
npx skills add cloudflare/skillsمع أي أدوات ذكاء اصطناعي تعمل خدمة البريد الإلكتروني من Cloudflare؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور خدمة البريد الإلكتروني من Cloudflare؟
طورها cloudflare.
هل خدمة البريد الإلكتروني من Cloudflare مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add vercel-labs/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى