Your AI Connector Docs

هاتف أندرويد كبوابة للرسائل القصيرة (إصدار تجريبي)

استخدم هاتف أندرويد الخاص بك كمرسل للرسائل القصيرة (SMS). بدلاً من ربط حساب Twilio، يمكنك تثبيت تطبيق صغير مفتوح المصدر على هاتف أندرويد، وإقرانه بمساحة العمل الخاصة بك، وسيتم إرسال واستقبال رسائلك النصية من خلال رقم الهاتف وباقة شركة الاتصالات الخاصة بذلك الهاتف.

قناة الإصدار التجريبي (Beta). أصبحت بوابة Android SMS متاحة الآن للجميع ضمن خطة تتضمن مخصصات للقنوات، ولكنها لا تزال جديدة — توقع وجود بعض الجوانب غير المكتملة، ولاحظ أن السلوك والحدود قد تتغير مع نضوج القناة. إذا لم يعمل شيء ما كما هو موضح، يرجى إبلاغ فريق الدعم.


لماذا تستخدم هذه الميزة

تم تصميم بوابة Android لـ الرسائل النصية القصيرة (SMS) ذات الحجم المنخفض والمحادثات — مثل الرد على العملاء المحتملين، ومحادثات الذكاء الاصطناعي، والمراسلة الفردية. إنها خيار مناسب عندما:

  • ترغب في الاستمرار في المراسلة من رقمك الشخصي أو التجاري الحالي.
  • تعتبر Twilio مكلفة للغاية أو غير مناسبة السعر لبلدك أو لحجم رسائلك.
  • تفضل استخدام باقة الرسائل القصيرة الحالية الخاصة بشركة الاتصالات بدلاً من دفع رسوم لكل رسالة.
  • ترغب في تجنب الإجراءات الورقية لتسجيل شركة الاتصالات (مثل A2P 10DLC وما شابه) التي تطلبها Twilio.

إنها غير مصممة للبث الجماعي للرسائل — راجع القيود أدناه.

يفضل استخدام Twilio لضمان النطاق والموثوقية. إذا كنت ترسل رسائل بكميات كبيرة، أو تحتاج إلى ضمان وقت التشغيل، أو تقوم بإجراء بث جماعي للرسائل القصيرة، فقم بتوصيل رقم Twilio بدلاً من ذلك — راجع مراسلة SMS. كلاهما وسيلتان بديلتان لنقل الرسائل القصيرة؛ حيث تعمل الرسائل وجهات الاتصال والذكاء الاصطناعي وصندوق الوارد بنفس الطريقة في كلتا الحالتين.


ما تحتاجه

  • هاتف يعمل بنظام Android مزود ببطاقة SIM نشطة وباقة رسائل نصية قصيرة (يُنصح بشدة باستخدام باقة غير محدودة أو سخية من الرسائل النصية).
  • تطبيق “SMS Gateway for Android” المجاني ومفتوح المصدر من sms-gate.app — يمكنك تنزيله من الموقع أو من إصدارات GitHub الخاصة به. نحن لا نطور هذا التطبيق — فهو مشروع تابع لجهة خارجية.
  • يجب إبقاء الهاتف قيد التشغيل ومتصلاً بالإنترنت وغير مقيد — راجع الحفاظ على موثوقية الهاتف.
  • باقة مدفوعة — بوابة Android مشمولة في رصيد قنواتك.

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


إعداد تطبيق البوابة

  1. قم بتثبيت SMS Gateway for Android من sms-gate.app على الهاتف الذي تريد استخدام رقمه.
  2. افتح التطبيق.
  3. قم بتشغيل وضع Cloud Server (وهو الخيار الأبسط — حيث يتم الترحيل عبر الخادم المستضاف للمشروع، لذا لا يحتاج هاتفك إلى عنوان عام).
  4. سيقوم التطبيق بإنشاء اسم مستخدم وكلمة مرور على الشاشة الرئيسية. ستقوم بلصقهما في المنصة في القسم التالي.
  5. (موصى به) في التطبيق، افتح Settings → Webhooks. الـ Webhook هو إشعار تلقائي يرسله التطبيق إلى المنصة كلما حدث شيء ما — في هذه الحالة، عند وصول رسالة.
  6. انسخ مفتاح التوقيع (Signing Key). سيؤدي لصقه في المنصة إلى إضافة فحص توقيع إضافي على الرسائل الواردة.

الوضع المحلي (للمتقدمين). إذا كنت تفضل أن يتصل الهاتف بالمنصة مباشرة عبر شبكتك الخاصة بدلاً من الترحيل السحابي، فإن التطبيق يدعم أيضاً وضع Local Server. ستحتاج إلى جعل الهاتف متاحاً على عنوان HTTPS يمكن الوصول إليه وإدخال ذلك العنوان كعنوان أساسي (base URL) عند الاتصال. يُنصح بالوضع السحابي لمعظم المستخدمين.


ربط الهاتف بالمنصة

  1. في الشريط الجانبي الأيسر، انقر على الإعدادات (Settings) بالقرب من الأسفل.
  2. في القائمة الجانبية للإعدادات، تحت القنوات (Channels)، انقر على القنوات (Channels).
  3. ابحث عن بطاقة بوابة رسائل SMS لنظام Android (Android SMS Gateway) وانقر على اتصال (Connect).
  4. أدخل رقم الهاتف (Phone number) — رقم الهاتف نفسه بالتنسيق الدولي (E.164)، على سبيل المثال +14155551234.
  5. أدخل اسم مستخدم البوابة (Gateway username) وكلمة مرور البوابة (Gateway password) من الشاشة الرئيسية لتطبيق البوابة.
  6. اختياريًا، الصق مفتاح توقيع الويب هوك (Webhook signing key) (موصى به) من إعدادات الويب هوك في التطبيق.
  7. انقر على اتصال (Connect).

تقوم المنصة بالتحقق من بيانات الاعتماد، وتسجيل رسائل الويب (webhooks) الخاصة بالرسائل والتسليم على البوابة نيابةً عنك، ثم تغير الحالة إلى متصل (Connected). لا حاجة لنسخ ولصق روابط webhooks في التطبيق — فالتسجيل يتم تلقائياً.

التحقق من الحالة

بمجرد الاتصال، يتغير زر البطاقة من Connect (اتصال) إلى Manage (إدارة). انقر عليه لإعادة فتح لوحة البوابة، حيث ستجد Refresh status (تحديث الحالة) في أي وقت. يقوم هذا الخيار بإعادة التحقق من إمكانية الوصول إلى البوابة ويوضح ما إذا كان الهاتف متصلاً حاليًا. إذا كان الهاتف في وضع السكون أو غير متصل، فسترى مؤشرًا واضحًا لحالة عدم الاتصال حتى تعرف أن الرسائل النصية لن يتم إرسالها حتى يعود للاتصال.

قطع الاتصال

انقر على Manage (إدارة) في البطاقة لإعادة فتح لوحة البوابة، ثم انقر على Disconnect (قطع الاتصال). تقوم المنصة بإزالة الويب هوك التي سجلتها على البوابة وتمسح الاتصال. ستعود رسائلك النصية بعد ذلك إلى Twilio إذا كان لديك رقم Twilio SMS متصل، أو سيتم إيقاف تشغيل خدمة الرسائل القصيرة (SMS) إذا لم يكن لديك رقم متصل.


كيف تتدفق الرسائل

الرسائل الواردة

  1. يقوم شخص ما بإرسال رسالة نصية إلى رقم هاتفك.
  2. يكتشف تطبيق البوابة الموجود على الهاتف الرسالة النصية ويخطر المنصة.
  3. تنشئ المنصة جهة اتصال (إذا كانت جديدة)، وتضع الرسالة في صندوق الوارد الخاص بك، وإذا كان وكيل الذكاء الاصطناعي ذو الصلة نشطاً، فإنه يقوم بالرد.

الرسائل الصادرة

  1. تقوم أنت أو الذكاء الاصطناعي بإرسال رد من المنصة.
  2. تسلم المنصة الرسالة إلى بوابتك.
  3. يرسلها الهاتف كرسالة SMS عادية من رقمك، عبر شركة الاتصالات الخاصة بك.
  4. بمجرد أن تبلغ شركة الاتصالات بالنتيجة، يتم تحديث حالة الرسالة إلى Sent (تم الإرسال)، ثم Delivered (تم التسليم) أو Failed (فشل).

تتمتع بوابة Android بالأولوية في الإرسال. أثناء اتصالها، تمر رسائل المحادثات الفردية وردود الذكاء الاصطناعي عبر هاتفك. إذا كان لديك أيضًا رقم Twilio SMS متصل، فافصل بوابة Android لإرسال تلك الرسائل عبر Twilio مرة أخرى. استثناء واحد في كلتا الحالتين: رسائل الحملات والبث الجماعي عبر SMS تمر دائمًا عبر رقم Twilio الخاص بك، وليس عبر هاتف Android أبدًا — فالإرسال الجماعي من هاتف شخصي هو بالضبط ما يؤدي إلى حظر الأرقام، لذا لا تقوم المنصة بذلك.


القيود

تعتمد بوابة Android على هاتف فعلي تتحكم فيه، لذا فهي تأتي مع قيود لن تجدها في Twilio. راجع هذه القيود قبل الاعتماد عليها في المراسلات المهمة.

  • يجب أن يظل الهاتف قيد التشغيل ومتصلاً بالإنترنت. لا هاتف، لا رسائل. حافظ على شحنه، واتصاله بشبكة Wi-Fi أو البيانات، واستثنائه من تحسين البطارية.
  • حجم منخفض فقط. تقوم شركات الاتصالات بوضع علامات وتقييد الهواتف التي ترسل فجأة الكثير من الرسائل النصية. هذه القناة مخصصة للمحادثات والردود الفردية — وليس للبث الجماعي.
  • بث الرسائل القصيرة الجماعي غير مدعوم في هذه القناة. تتطلب عمليات إرسال الرسائل القصيرة الجماعية رقم Twilio متصلاً؛ ستخبرك المنصة بذلك إذا حاولت إطلاق بث بدون Twilio. قم بإجراء عمليات البث عبر Twilio واحتفظ ببوابة Android للردود المحادثات.
  • نصوص فقط. إرسال واستقبال رسائل الوسائط المتعددة (MMS) غير مدعوم في هذه القناة.
  • تطبق قيود شركة الاتصالات. بدل الرسائل القصيرة الخاص بخطة هاتفك، وحدود الاستخدام العادل، وأي رسوم لكل رسالة هي أمور بينك وبين شركة الاتصالات الخاصة بك.
  • تأكيد التسليم يعتمد على شركة الاتصالات الخاصة بك. بعض شركات الاتصالات تبلغ عن التسليم بشكل موثوق؛ والبعض الآخر لا يفعل ذلك. حالة “تم الإرسال” تعني أن الهاتف قد أرسل الرسالة النصية.
  • مخاطر الحساب / الرقم. قد يؤدي استخدام رقم شخصي للمراسلة التجارية المؤتمتة إلى انتهاك شروط شركة الاتصالات الخاصة بك وقد يؤدي إلى تقييد الرقم أو تعليقه في حالة إساءة الاستخدام. استخدمه بمسؤولية، واحصل على الموافقة، وقم بتضمين تعليمات إلغاء الاشتراك.

الحفاظ على موثوقية الهاتف

للحفاظ على تدفق الرسائل دون انقطاع:

  • تعطيل تحسين البطارية لتطبيق SMS Gateway (إعدادات Android ← التطبيقات ← SMS Gateway ← البطارية ← غير مقيد). وإلا فقد يقوم نظام Android بإيقافه في الخلفية.
  • حافظ على إمكانية الوصول إلى الشاشة / السماح للتطبيق بالعمل في الخلفية. الهاتف المخصص الموصول بالشاحن هو الخيار المثالي.
  • ابقَ على شبكة Wi-Fi أو بيانات مستقرة. إذا فقد الهاتف الاتصال، فسيتم وضع الرسائل في قائمة الانتظار أو تفشل حتى يعود الاتصال.
  • حافظ على نشاط بطاقة SIM ووضعها الجيد مع شركة الاتصالات الخاصة بك.

استكشاف الأخطاء وإصلاحها

“تعذر التحقق من بيانات اعتماد البوابة”

  • أعد التحقق من اسم المستخدم وكلمة المرور مقابل الشاشة الرئيسية لتطبيق البوابة — حيث يتم تجديدهما إذا قمت بإعادة تثبيت التطبيق أو إعادة تعيينه.
  • تأكد من أن الهاتف لديه إنترنت وأن وضع خادم السحابة (Cloud Server) مفعل في التطبيق.

الحالة تظهر غير متصل / الرسائل لا يتم إرسالها

  • افتح التطبيق على الهاتف وتأكد من أنه يعمل ويظهر أنه متصل بخادم السحابة.
  • تأكد من أن الهاتف ليس في وضع السكون / توفير البطارية وأن التطبيق مستثنى من تحسين البطارية.
  • اضغط على Refresh status في البطاقة بعد إعادة الهاتف للاتصال بالإنترنت.

الرسائل النصية الواردة لا تظهر

  • تأكد من أن الاتصال لا يزال يظهر متصل (اضغط على تحديث الحالة).
  • أرسل رسالة نصية تجريبية إلى رقم الهاتف من هاتف آخر.
  • تأكد من أن تطبيق الرسائل الافتراضي على الهاتف لا يقوم بحظر أو تصفية المرسل.

تظهر الرسالة النصية “فشل” (Failed)

  • رفضت شركة الاتصالات الرسالة — تأكد من أن رقم المستلم صالح وبالتنسيق الدولي.
  • تأكد من أن شريحة SIM الخاصة بك لا تزال تحتوي على رصيد رسائل نصية (SMS) وأن الرقم ليس معلقاً.
  • معدلات الإرسال العالية جداً قد تؤدي إلى تقييد من قبل شركة الاتصالات؛ قلل السرعة وحافظ على حجم إرسال منخفض.

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

بوابة الرسائل النصية (SMS) لنظام أندرويد في مرحلة تجريبية (Beta). إذا واجهت مشكلة لم يتم تناولها هنا، تواصل مع hi@youraiconnector.com مع توفير:

  • رقم الهاتف الذي قمت بتوصيله (وليس كلمة المرور).
  • ما إذا كان تطبيق البوابة يظهر متصلاً على الهاتف.
  • وصف للمشكلة ومتى حدثت.

سنلقي نظرة على الأمر في أقرب وقت ممكن.