# مزود خدمة الرسائل القصيرة (استخدم حساب Twilio الخاص بك)

تتحكم هذه الصفحة في حساب Twilio المستخدم لـ **WhatsApp Business API**. افتراضياً، يعمل WhatsApp Business API على حساب Twilio المُدار الخاص بالمنصة — فأنت لا ترى Twilio أبداً، ولا تحتاج إلى التسجيل في Twilio بنفسك. إذا قمت بربط مفتاح Anthropic الخاص بك (BYOK)، فإن تكلفة رسائل WhatsApp عبر Twilio المُدار تبلغ 0.05 رصيد لكل رسالة، سواء كانت واردة أو صادرة. في جميع الحسابات الأخرى، تكون تكاليف التوصيل هذه مغطاة بالفعل ضمن معدل رصيد الذكاء الاصطناعي الخاص بك، لذا لا توجد رسوم منفصلة لكل رسالة. (تتغير أسعار رسائل WhatsApp الخاصة بـ WhatsApp في 1 أكتوبر 2026 — راجع [تكاليف WhatsApp وتغيير أكتوبر 2026](../messaging-channels/whatsapp-pricing.md).) هذا الأمر ذو صلة فقط إذا كنت ترغب تحديداً في تشغيل WhatsApp Business API على حساب Twilio الخاص بك بدلاً من ذلك.


> **خدمة الرسائل القصيرة (SMS) تتطلب دائماً استخدام حساب Twilio الخاص بك.** يجب تقديم طلبات تنظيم الرسائل القصيرة (مثل A2P 10DLC، وتسجيل العلامة التجارية، والموافقة على معرف المرسل) باسم شركتك، لذا لا توفر المنصة أرقام SMS مُدارة. قم بإعداد خدمة SMS بشكل منفصل باستخدام بطاقة **SMS via Twilio** في الإعدادات ← القنوات (توجد أيضاً خيار بوابة SMS لهاتف Android). هذه الصفحة — بطاقة **حساب Twilio** — تتحكم في حساب WhatsApp Business API ولا تغير رقم الـ SMS الخاص بك.


## لماذا قد أرغب في تحويل WhatsApp Business API إلى حساب Twilio الخاص بي؟

معظم المستخدمين لا يحتاجون لذلك. الحساب المُدار أكثر بساطة:

- يتم التعامل مع استئجار رقم WhatsApp، وتقديم القوالب، وتسجيل المرسل، وصحة الرقم نيابةً عنك. تبلغ تكلفة الرقم المستأجر هنا 50 رصيداً على الأقل شهرياً، ويشمل هذا الإيجار اتصال WhatsApp — راجع [أرقام الهواتف](phone-numbers.md#monthly-phone-number-billing).
- لا توجد فاتورة Twilio منفصلة. إذا قمت بربط مفتاح Anthropic الخاص بك (BYOK)، فإن تكلفة رسائل WhatsApp عبر Twilio المُدار تبلغ 0.05 رصيد لكل رسالة، سواء كانت واردة أو صادرة. في جميع الحسابات الأخرى، تكون تكاليف التوصيل هذه مغطاة بالفعل ضمن معدل رصيد الذكاء الاصطناعي الخاص بك، لذا لا توجد رسوم منفصلة لكل رسالة. راجع [تكاليف WhatsApp وتغيير أكتوبر 2026](../messaging-channels/whatsapp-pricing.md) لمعرفة تغيير أسعار WhatsApp القادم في 1 أكتوبر 2026.
- يمكن للدعم المساعدة في تصحيح مشكلات التوصيل مباشرةً.

قد ترغب في استخدام حساب Twilio الخاص بك إذا:

- لديك بالفعل حساب Twilio قائم مع قوالب WhatsApp معتمدة وأرقام مُفعلة ترغب في الاستمرار في استخدامها.
- لدى شركتك سبب يتعلق بالمشتريات أو الامتثال للدفع لـ Twilio مباشرة.
- ترغب في الحصول على رؤية كاملة لاستخدام وتسعير مستوى الناقل الأساسي.

> **تعد عملية الحفاظ على رقم مُفعّل مهمة تتكون من خطوتين.** لا يؤدي تبديل الحساب (أدناه) إلا إلى تغيير حساب Twilio الذي نرسل من خلاله. لن يظهر رقم WhatsApp الحالي الخاص بك كقناة حتى تقوم بإرفاقه أيضًا - راجع [إرفاق رقم WhatsApp تمتلكه بالفعل](#attaching-a-whatsapp-number-you-already-have). قم بتنفيذ الخطوات بهذا الترتيب.

---

## كيفية التبديل

**كيفية الوصول إلى هناك:** الإعدادات ← مجموعة **القنوات** ← **القنوات**، ثم ابحث عن بطاقة **حساب Twilio**.

ما تراه يعتمد على إعدادك الحالي:

### إذا كنت تستخدم الحساب المُدار (الافتراضي)

سترى شرحاً موجزاً وزر **إدارة** (Manage) على بطاقة حساب Twilio. يؤدي النقر عليه إلى فتح نموذج **التبديل إلى حساب Twilio الخاص بك** (Switch to your own Twilio account)، والذي يطلب منك **معرف حساب Twilio** (Account SID) و**رمز المصادقة** (Auth Token) — مع ظهور تحذير الإجراء التدميري مباشرة في مربع الحوار.


قبل التأكيد، اقرأ التحذيرات بعناية — فهذا التبديل إجراء تدميري:

- **سيتم تحرير جميع الأرقام التي اشتريتها من خلال المنصة بشكل دائم.** إذا كنت ترغب في الاستمرار في استخدام رقم ما، فاحتفظ به في الحساب المُدار (لا تقم بالتبديل)، أو قم بشرائه/نقله إلى حساب Twilio الخاص بك أولاً.
- **لن يتم نقل قوالب WhatsApp المعتمدة.** القوالب مرتبطة بحساب WhatsApp Business الذي يمتلك المرسل — ستحتاج إلى إعادة تقديمها في حسابك الخاص وانتظار إعادة الموافقة عليها.
- **ستظل الدردشات وسجل الرسائل الحالي مرئياً**، لكن الردود الجديدة على الأرقام المحررة ستفشل (لأن الرقم لم يعد موجوداً).
- **يمكنك التبديل مرة أخرى لاحقاً**، ولكنك ستحصل على حساب مُدار جديد بدون أرقام وبدون قوالب — لن تعود قوالبك القديمة.

أين تجد Account SID و Auth Token: سجل الدخول إلى وحدة تحكم Twilio على [console.twilio.com](https://console.twilio.com). كلاهما موجود على لوحة التحكم الرئيسية، في لوحة "معلومات الحساب" (Account Info). يبدأ Account SID بـ `AC` وطوله 34 حرفاً.

بعد إدخال القيمتين والتأكيد، يقوم النظام بما يلي:

1. التحقق من صحة بيانات الاعتماد.
2. تحرير كل رقم هاتف مُدار من Twilio.
3. إغلاق الحساب الفرعي المُدار.
4. حفظ بيانات اعتمادك بحيث تستخدم جميع رسائل **WhatsApp** الصادرة مستقبلاً حسابك. يتم تخزين رقم **SMS via Twilio** المتصل بشكل منفصل بشكل مستقل ولا يتم تحريره أو تغييره بواسطة هذا التبديل.

قد يستغرق هذا من بضع ثوانٍ إلى دقيقتين إذا كان لديك عدة أرقام.

### إذا كنت تستخدم حساب Twilio الخاص بك بالفعل

تعرض البطاقة حسابك المتصل وتتيح لك التبديل مرة أخرى إلى الإعداد المُدار.

يؤدي التبديل مرة أخرى إلى الإعداد المُدار إلى توفير حساب فرعي مُدار جديد. كما هو مذكور أعلاه: لا يؤدي ذلك إلى استعادة الأرقام أو القوالب التي كانت لديك من قبل — ستبدأ من الصفر.

---

## إرفاق رقم WhatsApp تمتلكه بالفعل

بمجرد أن يصبح الحساب على حساب Twilio الخاص بك، يتغير ما يقدمه زر **Connect WhatsApp** الموجود في بطاقة **WhatsApp Business API**: يصبح الخيار المُدار هو **Through your Twilio account**، والذي يربط مرسل WhatsApp داخل حساب Twilio الذي قمت بربطه، ولم يعد شراء رقم مُدار متاحاً. هذا مقصود — فشراء رقم أو تشغيل عملية التسجيل في Meta سيؤدي إلى إنشاء حساب Twilio ثانٍ مُدار من قبل المنصة بجانب حسابك، وبالتالي سيتم إرسال رسائلك من حساب بينما يعيش الرقم في الحساب الآخر.

### قبل أن تبدأ

يجب أن يكون رقمك بالفعل مرسل WhatsApp يعمل **داخل حساب Twilio الخاص بك**:

- أن يكون مسجلاً كمرسل WhatsApp في Twilio، ومرفقاً بحساب WhatsApp Business الخاص بك.
- أن يظهر Twilio ذلك المرسل بحالة **متصل (Online)**.

هذه الشاشة لا تسجل أي شيء. فهي لا تنشئ مرسلاً، ولا تتواصل مع Meta، ولا تقدم رقمك للموافقة - بل تقوم بربط مرسل يعمل بالفعل. إذا لم يكن لديك واحد بعد، فقم بإعداد مرسل WhatsApp في Twilio أولاً.

### الخطوات

1. انتقل إلى **الإعدادات (Settings)** ← مجموعة **القنوات (Channels)** ← **القنوات (Channels)**.
2. في بطاقة **WhatsApp Business API**، انقر على **إرفاق المرسل الخاص بك (Attach your sender)**.
3. أدخل **رقم WhatsApp** بالتنسيق الدولي (على سبيل المثال `+31612345678`)، تماماً كما يظهر للمرسل في Twilio.
4. يمكنك اختيارياً إعطاؤه **تسمية (Label)** - وهو اسم للرقم داخل التطبيق. إذا تركته فارغاً، فسيستخدم الاسم الموجود في ملف تعريف المرسل الخاص بك على Twilio.
5. انقر على **إرفاق المرسل (Attach sender)**.

لا تحتاج إلى إعادة إدخال معرف الحساب (Account SID) أو رمز المصادقة (auth token): فنحن نمتلكهما بالفعل من عملية تبديل الحساب.

### ما يحدث في الخلفية

1. نقوم بالبحث عن المرسل لهذا الرقم في حساب Twilio الخاص بك ونتحقق من أن Twilio يجعله متصلاً بالإنترنت.
2. نتأكد من وجود خدمة مراسلة في حسابك ونوجه خطاف الويب (webhook) الوارد الخاص بها إلينا (مع إنشاء واحد، يحمل اسم التطبيق، إذا لم يكن لديك واحد بالفعل). هذا هو أيضاً ما يجعل إرسال القوالب يعمل.
3. نقوم بربط المرسل الخاص بك بخدمة المراسلة تلك.
4. نوجه خطاف الويب (webhook) الخاص بالمرسل إلينا، بحيث تصل الرسائل الواردة إلى هنا.
5. يظهر الرقم في قائمة أرقامك، مميزاً بـ **Your Twilio (BYO)**، وجاهزاً للتعيين لحملة أو وكيل.

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

### التكاليف

لا توجد رسوم صيانة شهرية على الرقم الذي ترفقه بهذه الطريقة - فأنت تدفع لـ Twilio مباشرة مقابل الرقم ورسوم الرسائل الخاصة به. لا تزال ردود الذكاء الاصطناعي تستخدم الأرصدة كالمعتاد.

### إذا لم ينجح الأمر

- **"No WhatsApp sender for … exists in your Twilio account"** — الرقم غير مسجل كمرسل WhatsApp هناك، أو تمت كتابته بشكل مختلف. تحقق من معرف المرسل الدقيق في وحدة تحكم Twilio وأعد إدخاله بالتنسيق الدولي.
- **"The WhatsApp sender … is not online in Twilio"** — تم تضمين سبب Twilio الخاص في الرسالة. قم بإصلاح المشكلة في Twilio أولاً؛ فربط مرسل غير متصل في Twilio سيؤدي فقط إلى فشل العملية لاحقاً بصمت.
- **"… is already connected to another account"** — الرقم مرتبط بحساب مختلف هنا. قم بإلغاء ربطه من هناك أولاً.
- **"This account is still on the managed Twilio account"** — قم بإجراء التبديل المذكور أعلاه أولاً.
- **"we could not update its webhook in Twilio"** — الرقم مرتبط وسيعمل، لكن المرسل لا يزال يشير إلى أي webhook كان لديك عليه. امسح هذا الـ webhook الخاص بالمرسل في وحدة تحكم Twilio حتى تصلنا الرسائل الواردة.

---

## الحدود

- يمكنك التبديل بين المزودين مرة واحدة كحد أقصى كل **24 ساعة**. هذا يمنع التبديل المتكرر من تراكم تكاليف واجهة برمجة تطبيقات Twilio وحدود المعدل.
- إرسال الرسائل القصيرة (SMS) لا يتأثر تماماً بهذا الإعداد — إذا كنت قد ربطت بالفعل حساب Twilio الخاص بك عبر بطاقة **SMS via Twilio**، فهذا اتصال مختلف ويبقى كما هو بغض النظر عما تفعله هنا.

---

## ماذا لو حدث خطأ ما؟

- **"تعذر المصادقة باستخدام بيانات اعتماد Twilio المقدمة"** — تحقق جيداً من SID (يبدأ بـ `AC`، 34 حرفاً) ورمز المصادقة (auth token). كلاهما حساس لحالة الأحرف.
- **"الحساب غير نشط"** — حساب Twilio الذي تحاول استخدامه معلق أو مغلق. استخدم حساباً نشطاً.
- **"يرجى الانتظار Xh قبل التبديل مرة أخرى"** — أنت ضمن فترة التهدئة التي تبلغ 24 ساعة. انتظر حتى تنتهي.
- **ترحيل جزئي (تم تحرير بعض الأرقام، والبعض الآخر لم يتم)** — أعد تشغيل التبديل. النظام متماثل (idempotent)؛ حيث يكمل من حيث توقف وينهي تحرير أي شيء لا يزال موجوداً في الحساب الفرعي المُدار.

إذا واجهت مشكلة بعد التبديل — مثل عدم إرسال الرسائل الصادرة أو عدم ظهور القوالب — اتصل بالدعم مع تزويدهم بمعرف الحساب (Account SID) الخاص بك (ولا تشارك رمز المصادقة أبداً).

---

## هل تحتاج إلى مساعدة؟

If you're not sure whether switching is right for you, or run into trouble, [contact support](mailto:hi@youraiconnector.com) and we can help you decide.