التهيئة
قبل إرسال رسائل SMS، تحتاج إلى ربط الوحدة بمزوّد بوابة SMS وتهيئة إعدادات المرسل. تشرح هذه الصفحة كل خيار من خيارات التهيئة.
الوصول إلى إعدادات الوحدة
- سجّل الدخول إلى لوحة إدارة Concord CRM
- انتقل إلى Custom SMS -> Settings من الشريط الجانبي
- تعرض صفحة الإعدادات جميع خيارات التهيئة منظمة حسب الأقسام
إعداد بوابة SMS
تتطلب وحدة SMS المخصص بوابة SMS خارجية لتوصيل الرسائل. قم بتهيئة بيانات اعتماد المزوّد في قسم البوابة.
البوابات المدعومة
| المزوّد | بيانات الاعتماد المطلوبة |
|---|---|
| Twilio | Account SID, Auth Token, رقم هاتف المرسل |
| Vonage | API Key, API Secret, رقم هاتف المرسل |
| أخرى | API Key/Token, معرّف المرسل (يختلف حسب المزوّد) |
ربط البوابة
- انتقل إلى Custom SMS -> Settings -> Gateway
- اختر مزوّد SMS من القائمة المنسدلة
- أدخل بيانات الاعتماد المطلوبة للمزوّد المختار
- حدد رقم هاتف المرسل أو معرّف المرسل
- انقر على Save
- استخدم زر Send Test SMS للتحقق من الاتصال
أدخل أرقام الهواتف بتنسيق E.164 (مثال: +1234567890). معظم حالات فشل التوصيل سببها أرقام مرسل أو مستلم بتنسيق غير صحيح.
SMS تجريبي
بعد حفظ بيانات اعتماد البوابة، أرسل دائماً رسالة تجريبية:
- انقر على Send Test SMS
- أدخل رقم هاتف يمكنك الوصول إليه
- انقر على Send
- تحقق من وصول الرسالة إلى هاتفك
إذا فشل الاختبار، تحقق مرة أخرى من بيانات الاعتماد وتأكد من أن حساب البوابة نشط ولديه رصيد كافٍ.
إعدادات المرسل
معرّف المرسل / رقم الهاتف
هوية المرسل التي يراها المستلمون عند تلقي رسالتك. حسب المزوّد والبلد:
- رقم هاتف -- رقم مُشترى من مزوّد البوابة (الأكثر شيوعاً)
- معرّف مرسل أبجدي رقمي -- تسمية نصية مخصصة (مثال: "MyCRM") مدعومة في بعض المناطق
معرّفات المرسل الأبجدية الرقمية غير مدعومة في جميع البلدان. تحقق من وثائق مزوّد البوابة للتوفر الإقليمي. لا يمكن للمستلمين الرد على الرسائل المرسلة من معرّفات أبجدية رقمية.
رمز البلد الافتراضي
حدد رمز بلد افتراضي حتى لا تحتاج إلى تضمينه في كل مرة. ستقوم الوحدة تلقائياً بإضافة رمز البلد للأرقام التي تفتقر إليه.
- انتقل إلى Custom SMS -> Settings -> General
- حدد رمز البلد الافتراضي (مثال:
+1للولايات المتحدة،+44للمملكة المتحدة) - انقر على Save
تهيئة الجدولة
تدعم وحدة SMS المخصص جدولة الرسائل للتوصيل المستقبلي. لضمان إرسال الرسائل المجدولة في الوقت المحدد، تأكد مما يلي:
إعداد مهمة Cron
يتم إرسال رسائل SMS المجدولة بواسطة مهمة cron في Concord CRM. تحقق من أن cron مُهي ّأ وقيد التشغيل:
* * * * * php /path/to/concord/artisan schedule:run >> /dev/null 2>&1
إذا لم تكن مهمة cron قيد التشغيل، ستبقى الرسائل المجدولة في قائمة الانتظار ولن يتم تسليمها حتى يتم تنفيذ cron.
المنطقة الزمنية
يستخدم نظام الجدولة المنطقة الزمنية المُهيّأة في إعدادات Concord CRM. للتحقق أو التحديث:
- انتقل إلى Settings -> General في Concord CRM
- تحقق من إعداد المنطقة الزمنية
- تأكد من تطابقها مع منطقتك الزمنية المحلية حتى يتم إرسال الرسائل المجدولة في الوقت المتوقع
تكامل إجراءات CRM
يمكن تشغيل الوحدة من إجراءات CRM المختلفة. قم بتهيئة الإجراءات التي تعرض خيار SMS:
- انتقل إلى Custom SMS -> Settings -> Integrations
- فعّل أو عطّل SMS لكل نوع إجراء CRM:
- المكالمات -- إرسال SMS بعد تسجيل مكالمة
- المهام -- إرسال SMS متعلق بتحديثات المهام
- رسائل البريد الإلكتروني -- استكمال التواصل عبر البريد الإلكتروني بـ SMS
- الاجتماعات -- إرسال تأكيدات أو تذكيرات الاجتماعات
- المواعيد النهائية -- إخطار جهات الاتصال بالمواعيد النهائية القادمة
- انقر على Save
عند تفعيل نوع إجراء، سيظهر زر Send SMS في سجل CRM المقابل.
تتبع حالة التوصيل
تتتبع الوحدة تلقائياً حالة التوصيل من مزوّد البوابة. يتم تلقي تحديثات الحالة عبر webhooks:
| الحالة | المعنى |
|---|---|
| في الانتظار | تم قبول الرسالة من البوابة، في انتظار التوصيل |
| مُرسلة | تم إرسال الرسالة إلى شبكة الناقل |
| تم التوصيل | تم تأكيد توصيل الرسالة إلى المستلم |
| فشلت | فشل التوصيل (رقم غير صالح، مشكلة في الناقل) |
بعض مزوّدي البوابات يدعمون إيصالات التوصيل (DLR) لتتبع أكثر دقة. فعّل DLR في لوحة تحكم المزوّد للحصول على أدق تحديثات الحالة.
استكشاف أخطاء التهيئة
| المشكلة | الحل |
|---|---|
| SMS التجريبي لا يصل | تحقق من بيانات الاعتماد؛ تحقق من رصيد حساب البوابة |
| خطأ "مرسل غير صالح" | تأكد من أن رقم المرسل موثّق/مُشترى على بوابتك |
| الرسائل المجدولة لا تُرسل | تأكد من أن مهمة cron نشطة وتعمل كل دقيقة |
| حالة التوصيل لا تتحدث | تحقق من تهيئة webhook على لوحة تحكم مزوّد البوابة |
| رمز البلد لا يُطبّق | تحقق من حفظ رمز البلد الافتراضي في الإعدادات العامة |