دليل التواصل الخارجي · Outbound
كيف يعمل التواصل الخارجي (Outbound) في Safqat — وكيف تجهّزه خطوة بخطوة
في الأصل، يبدأ العميل المحادثة وأنت تردّ. التواصل الخارجي يقلب المعادلة: وكيلك هو من يبدأ — يرسل أول رسالة على واتساب في اللحظة المناسبة (تسجيل جديد، طلب تم شحنه، سلة متروكة، عرض موسمي)، وبمجرد أن يردّ العميل يتولّى الذكاء الاصطناعي المحادثة كاملةً: يبيع، يجيب، يعالج الاعتراضات، ويُصعّد لموظف بشري عند الحاجة.
الفكرة في سطر واحد
تربط قالباً معتمداً من ميتا بمحفّز API له رابط Webhook خاص. نظامك يستدعي الرابط لحظة وقوع أي حدث، فتُرسَل الرسالة فوراً، ثم يكمل وكيل Safqat المحادثة بنفسه.
البداية
ما هو التواصل الخارجي؟
«التواصل الوارد» (Inbound) هو أن يراسلك العميل أولاً. أما «التواصل الخارجي» (Outbound) فهو أن تبدأ أنت — تصل إلى العميل برسالة استباقية بدل انتظاره. على واتساب، لا يمكنك إرسال أول رسالة كيفما اتفق؛ يجب أن تكون قالباً معتمداً من ميتا. هنا يأتي دور «محفّزات API» في Safqat: كل محفّز يربط قالباً معتمداً برابط Webhook، فيكفي أن يستدعي نظامك هذا الرابط حتى تنطلق الرسالة.
الجزء الأهم يأتي بعد أن يردّ العميل: لا تتوقف القصة عند رسالة القالب. بمجرد أن يكتب العميل ردّاً، يتولّى وكيل Safqat المحادثة كأي محادثة واردة — يفهم القصد، يعرض المنتج، يعالج الاعتراضات، ويُتمّ الصفقة أو يُصعّد للفريق.
الفرق الأهم
نوعان من التواصل الخارجي: تسويقي وخدمة عملاء
ليست كل الرسائل الصادرة متشابهة. تصنّف ميتا قوالب واتساب إلى فئات، وهذه الفئة هي التي تحدّد نوع الرسالة وسعرها. في Safqat ينقسم التواصل الخارجي عملياً إلى نوعين:
تسويقي (Marketing)
عروض، تخفيضات، إطلاق منتج، إعادة تفعيل عميل بارد
- يستخدم قوالب من فئة MARKETING
- هدفه البيع والترويج وجذب العميل من جديد
- أمثلة: حملة تخفيضات، عرض العيد، «اشتقنا لك»
مدفوع بشكل منفصل
100$ لكل 1,000 رسالة مُرسَلة
فوق اشتراكك الشهري — تُحتسب فقط على الرسائل التسويقية المُرسَلة فعلاً.
خدمة العملاء (Utility / Service)
تحديثات الطلب، تذكير الموعد، استرجاع الدفع، رمز التحقق
- يستخدم قوالب من فئة UTILITY أو AUTHENTICATION
- هدفه إعلامي / تشغيلي مرتبط بمعاملة قائمة
- أمثلة: «تم شحن طلبك»، «تذكير بموعدك»، رمز الدخول (OTP)
مجاني
0$ — لا يُحتسب خارج باقتك
رسائل المرافق والمصادقة لا تُضاف إلى فاتورة التواصل الخارجي.
كيف يُحتسب السعر بالضبط؟
الفئة التي تختارها للقالب (وتعتمدها ميتا) هي ما يحدّد التسعير. يحتسب Safqat الرسائل التسويقية المُرسَلة بنجاح فقط — لا الفاشلة ولا المؤجّلة — بسعر 0.10$ للرسالة (أي 100$ لكل 1,000). أما رسائل الخدمة (UTILITY / AUTHENTICATION) فلا تُحتسب إطلاقاً. والفاتورة منفصلة تماماً عن باقة اشتراكك الشهرية.
التصنيف لا يغيّر السعر — العبرة بما تقرّره ميتا
لا يمكنك تفادي سعر التسويق بتصنيف قالب ترويجي على أنه «خدمي». فإذا أنشأت قالباً محتواه تسويقي وصنّفته على أنه UTILITY، تراجعه ميتا وتعيد تصنيفه تلقائياً إلى MARKETING متى وجدت محتواه ترويجياً — وعندها يعامله النظام كرسالة تسويقية ويُحتسب ضمن فاتورة التواصل التسويقي (0.10$ للرسالة). باختصار: الفئة الفعلية التي تعتمدها ميتا هي ما يُحدّد السعر، لا التسمية التي اخترتها أنت.
آلية العمل
كيف يعمل — ثلاث خطوات
خلف كل رسالة صادرة ثلاث حلقات مترابطة. ما إن تجهّزها مرة واحدة حتى تعمل تلقائياً مع كل حدث:
قالب معتمد من ميتا
تكتب قالب الرسالة الأولى (تسويقي أو خدمي) وترسله إلى ميتا للاعتماد، أو تستورد قالباً جاهزاً من مكتبتها.
محفّز API يطلق الـ Webhook
نظامك يستدعي رابط المحفّز لحظة الحدث (تسجيل، شحن، سلة متروكة)، فتُرسَل رسالة القالب خلال ثوانٍ.
الذكاء الاصطناعي يكمل المحادثة
ما إن يردّ العميل حتى يتولّى وكيل Safqat: يبيع، يجيب، يعالج الاعتراضات، ويُصعّد لموظف عند الحاجة.
الخطوة ١
جهّز قالبك واحصل على موافقة ميتا
بما أنّ أول رسالة لا بدّ أن تكون قالباً معتمداً، تبدأ الرحلة من تبويب «قوالب مخصّصة». اكتب نص القالب، اختر اللغة، وحدّد الفئة — تسويقي أو خدمي (هذا الاختيار هو ما يحدّد السعر لاحقاً) — ثم اضغط «إرسال إلى ميتا». يمكنك أيضاً استيراد قالب جاهز ومُعتمد مسبقاً من مكتبة قوالب ميتا لتوفير وقت المراجعة.
بعد الإرسال، يمرّ القالب بمراجعة ميتا وتظهر حالته في تبويب «قوالبي»: قيد المراجعة ← مُعتمد ← أو مرفوض (مع سبب الرفض لتصحيحه). لا يمكن استخدام القالب في محفّز قبل اعتماده.
الخطوة ٢
أنشئ محفّز API
من تبويب «محفّزات API» اضغط «إنشاء محفّز». أعطه اسماً، اختر القالب المعتمد، ثم اربط متغيّرات القالب: لكل {{n}} تحدّد قيمة افتراضية وهل هي إلزامية. ثم اضبط خيارين مهمّين:
- فترة الهدوء (Cooldown): تمنع إرسال الرسالة نفسها لنفس الرقم أكثر من مرة خلال مدة تحدّدها (مثلاً كل 24 ساعة) — حماية من التكرار العرضي وحلقات الـ cron.
- سبب الإرسال (Context): يخبر الذكاء الاصطناعي لماذا تواصلت، فيبدأ المحادثة بالأسلوب المناسب بدل أن يردّ كأن العميل راسلك أولاً.
الخطوة ٣
نادِ الـ Webhook من نظامك
عند الحفظ يمنحك Safqat رابط Webhook فريداً ومفتاحاً سرياً (Bearer)يظهر مرة واحدة فقط. أيّ نظام عندك — متجر إلكتروني، CRM، نموذج تسجيل — يستطيع استدعاء هذا الرابط بسطر واحد لحظة وقوع الحدث، ممرّراً رقم العميل وقيم المتغيّرات:
curl -X POST https://safqat.ai/api/outreach/trigger/out_marketing_01 \
-H "Authorization: Bearer <your_bearer_token>" \
-H "Content-Type: application/json" \
-d '{
"to": "+966500000001",
"variables": { "1": "Ahmad", "2": "20%" }
}'قبل الإطلاق الفعلي، استخدم زر «اختبار» لإرسال رسالة إلى رقمك الخاص والتأكد من أن القالب والمتغيّرات تظهر كما تريد. كل محادثة ناتجة تُفتح تلقائياً في صندوق الوارد ويكملها الوكيل.
بعد الإطلاق
راقب الأداء والتكلفة
لكل محفّز لوحة إحصاءات: عدد مرات الإطلاق، المُرسَل، المُسلَّم، المقروء، من ردّ، والإخفاقات — مع رسم بياني لآخر 30 يوماً. وتحت ذلك يظهر استهلاك التواصل الخارجي لهذا الشهر وتكلفته التقديرية (للرسائل التسويقية فقط، بسعر 0.10$ للرسالة). هكذا تعرف في أي لحظة كم أرسلت وكم سيكلّفك.
قبل أن تبدأ
ما الذي تحتاجه
- باقة Pro فأعلى. محفّزات API متاحة على باقة Pro حصراً، لأنها تستهلك بنية تحتية منفصلة (Webhook، تتبّع التسليم، عدّاد فوترة مستقل).
- رقم واتساب أعمال موصول عبر ميتا. التواصل الخارجي يعمل على قنوات ميتا الرسمية، صادراً ووارداً في مكان واحد منظّم.
- قالب واحد معتمد على الأقل. سواء كتبته بنفسك أو استوردته من مكتبة ميتا، يجب أن يُعتمد قبل أول إرسال.
- نظام يستدعي الـ Webhook — أو استخدم زر «اختبار» المدمج للتجربة قبل الربط البرمجي.
جهّز أول محفّز تواصل خارجي خلال دقائق
اعتمد قالباً، أنشئ محفّزاً، وانسخ رابط الـ Webhook إلى نظامك. كل خطوة موثّقة في لوحة Safqat، وفريقنا يساعدك في الإعداد عند الحاجة.