مفاتيح API
تم التحديث
المكان: الإعدادات > التكاملات > مفاتيح API
الفائدة منه:
"منح برنامج خارجي مفتاحه الخاص للإرسال عبر SyBox — دون خروج رمز واتساب المميز من الخادم مطلقًا، مع إمكانية إلغاء المفتاح المسرب بمفرده." يستخدم نظام إدارة الموارد (ERP) أو نقاط البيع أو برنامج الكمبيوتر مفتاحًا من SyBox، دون الحاجة أبدًا لبيانات اعتماد واتساب الحقيقية.
ما يمكن للبرنامج فعله بالمفتاح (كما هو موضح في صفحة وثائق المطورين العامة):
- إرسال رسائل واتساب من رقمك المتصل نفسه. ويستخدم نفس صيغة طلبات Meta's WhatsApp Cloud API، لذا فإن أي برنامج مبرمج لها مسبقًا يحتاج فقط إلى عنوان جديد ومفتاح SyBox. وتعمل النصوص والقوالب والصور والمستندات والرسائل التفاعلية كافة. كما تصل الردود والأخطاء مطابقة تمامًا لما ترسله Meta.
- تسجيل شكوى من نظامك الخاص، مثل شكوى مقيدة في نظام ERP لديك. ويجب أن يكون العميل موجودًا مسبقًا في SyBox.
- استيراد SMS من هاتف إلى صندوق الوارد.
من يمكنه فتحه: المسؤول الرئيسي، وأعضاء الفريق ممن لديهم إذن "إدارة أرقام واتساب".
مفتاح تبديل "بوابة API":
في أعلى شاشة مفاتيح API يوجد مفتاح تبديل باسم "بوابة API"، ويكون معطلاً افتراضيًا. وطالما أنه معطل، لن يعمل أي مفتاح ولن تتمكن من إنشاء مفاتيح جديدة. وإذا حاولت، ستظهر رسالة: "بوابة API معطلة. فعّلها من المفتاح بأعلى هذه الشاشة قبل إنشاء المفاتيح." ويُحفظ وضع المفتاح بمجرد الضغط عليه.
- اذهب إلى الإعدادات > التكاملات > مفاتيح API.
- فعّل مفتاح التبديل "بوابة API".
- اضغط على "مفتاح جديد".
- اختر "نوع المفتاح":
- "الإرسال عبر واتساب": يرسل البرنامج الرسائل إلى عملائك.
- "تسجيل شكوى": يفتح البرنامج شكاوى في SyBox، ولا يمكنه إرسال رسائل.
- "استيراد SMS من هاتف": يعيد هاتف توجيه رسائل SMS الخاصة به إلى صندوق الوارد.
- املأ "اسم الجهاز أو البرنامج"، على سبيل المثال "كمبيوتر المكتب" أو "نظام المحاسبة". وخصص لكل جهاز أو برنامج مفتاحًا خاصًا به.
- لمفتاح من نوع "الإرسال عبر واتساب"، حدد أيضًا:
- "يرسل من": رقم واتساب الذي يرسل هذا المفتاح منه (مطلوب).
- "السماح بالرسائل الحرة": تشغيل أو إيقاف.
- "السماح بالقوالب المعتمدة": تشغيل أو إيقاف. يجب تفعيل خيار واحد على الأقل منهما، وإلا ستظهر رسالة "اسمح بواحد على الأقل من الرسائل الحرة أو القوالب — وإلا لن يتمكن المفتاح من إرسال أي شيء."
- "السماح بإرسال الوسائط": تشغيل أو إيقاف.
- "القوالب" (اختياري): أسماء القوالب مفصولة بفواصل. اتركه فارغًا للسماح بأي قالب.
- "دول المستلمين المسموح بها" (اختياري): رموز الدول المكونة من حرفين، مثل MA,FR,EG. اتركه فارغًا للسماح بأي دولة.
- "الإرسال مسموح من" ... "إلى": الساعات المسموح للمفتاح بالإرسال خلالها. اتركهما متطابقين لعدم وضع حد زمني. وتعتمد الأوقات على الساعات المحلية لمؤسستك.
- "الحد اليومي للرسائل (0 = بلا حد)".
- لمفتاح من نوع "استيراد SMS من هاتف"، حدد "جهات الاتصال والعملاء فقط". عند تفعيله، ستبقى رسائل SMS من أي رقم آخر على الهاتف ولن تصل أبدًا إلى صندوق الوارد. عطّله فقط إذا كان الهاتف مخصصًا للعمل وحده.
- اضغط على حفظ.
- ستعرض نافذة "الرابط الأساسي" و"مفتاح API". انسخهما الآن: "انسخ هذا المفتاح الآن — يظهر مرة واحدة فقط." وضعهما في إعدادات برنامجك.
ما تعرضه بطاقة المفتاح:
- اسم المفتاح، والرقم الذي يرسل منه (أو شارة نوعه للمفتاح الذي لا يرسل).
- الحروف الأخيرة من المفتاح للتمييز بين المفاتيح.
- "آخر استخدام"، مع التاريخ والوقت، أو "أبدًا".
- أي قيود مفعلة: "نص حر فقط"، "قوالب فقط"، "بدون وسائط"، "القوالب"، الدول المسموح بها، ساعات الإرسال، والحد اليومي معروضًا بصيغة: المرسل اليوم / الحد / اليوم. ويظهر لمفتاح SMS الذي يقبل كل الأرقام "كل الأرقام".
- اضغط على تعديل في بطاقة المفتاح. يمكنك تغيير اسمه ورقمه وقيوده. لا يمكن تغيير نوع المفتاح بعد إنشائه، ولا يُعرض المفتاح نفسه مرة أخرى أبدًا.
- اضغط على تمكين / تعطيل لإيقاف المفتاح مؤقتًا.
- اضغط على حذف، ثم أكّد: "حذف مفتاح API هذا؟ أي برنامج ما زال يستخدمه سيتوقف فورًا."
فقدت مفتاح API الخاص بي، فهل يمكنني رؤيته مرة أخرى؟
لا، فهو يظهر مرة واحدة فقط. أنشئ مفتاحًا جديدًا وضعه في برنامجك، ثم احذف المفتاح القديم.
أعتقد أن مفتاحًا قد تسرب، فماذا أفعل؟
احذف ذلك المفتاح أو عطّله فورًا. سيتوقف ذلك المفتاح وحده عن العمل، ولن يتأثر رقم واتساب الخاص بك ولا مفاتيحك الأخرى.
قائمة "يرسل من" فارغة.
تعرض القائمة فقط أرقام واتساب المتصلة والمفعلة. اربط رقمًا أولاً من الإعدادات > المراسلة > القنوات.
يواجه برنامجي الرفض عند الإرسال.
تأكد من تشغيل مفتاح تبديل "بوابة API" ونشاط المفتاح. تحقق أيضًا من قيود المفتاح: النص الحر مقابل القوالب، الوسائط، القوالب المسموح بها، الدول المسموح بها، ساعات الإرسال، والحد اليومي. كما تظل قواعد واتساب نفسها سارية؛ فعلى سبيل المثال، لا يعمل النص الحر إلا خلال 24 ساعة من آخر رسالة للعميل.
هل يمكن لمفتاح من نوع "تسجيل شكوى" إرسال رسائل أيضًا؟
لا، وذلك مقصود؛ فالمفتاح الذي يسجل الشكاوى لا يمكنه مراسلة العملاء، ومفتاح الإرسال لا يمكنه تسجيل الشكاوى. استخدم مفتاحًا منفصلاً لكل مهمة.
لدي مفتاح قديم من نوع "استقبال من برنامج"، فهل ما زال يعمل؟
نعم، تستمر المفاتيح الحالية من هذا النوع في العمل، ولكن لا يمكن إنشاء مفاتيح جديدة منه بعد الآن. استخدم "تسجيل شكوى" لهذا النوع من المهام بدلاً منه.