طريقة تفعيل البوابة وإنشاء مفتاح
تم التحديث
في SyBox، يتم ذلك في الإعدادات > التكاملات > مفاتيح API.
- انتقل إلى الإعدادات > التكاملات > مفاتيح API.
- فعّل مفتاح "بوابة API".
- انقر على "مفتاح جديد".
- اختر "نوع المفتاح":
- "الإرسال عبر واتساب": يرسل البرنامج رسائل إلى عملائك.
- "تسجيل شكوى": يفتح البرنامج شكاوى في SyBox. ولا يمكنه إرسال رسائل.
- "استيراد SMS من هاتف": يعيد هاتف توجيه رسائل SMS الخاصة به إلى صندوق الوارد.
- "تشغيل أتمتة": يقوم البرنامج بتشغيل قواعد الأتمتة التي يكون خيار "تبدأ عندما" فيها هو "يقوم برنامج آخر باستدعاء SyBox" (عبر POST /v1/automation مع "phone" الخاص بالعميل، و"event" و"data" اختياريين). ولا يمكنه إرسال رسائل. راجع الإعدادات > الذكاء الاصطناعي والأتمتة > الأتمتة.
- "قراءة جهات الاتصال وتحديثها": يبحث البرنامج عن جهات الاتصال، ويقرأ بيانات جهة اتصال، ويعدّل اسمها وبريدها الإلكتروني وحقولها وتصنيفاتها (عبر POST /v1/contacts/search و /get و /update و /labels). ولا يمكنه إرسال رسائل. ويعمل المفتاح بصلاحيات المستخدم الذي أنشأه: فهو لا يرى إلا جهات الاتصال المسموح لذلك المستخدم برؤيتها، ولا يعمل إلا إذا كان مسموحًا لذلك المستخدم بفتح قائمة جهات الاتصال ورؤية الأرقام، ولا يمكنه تعديل جهات الاتصال إلا إذا كان مسموحًا لذلك المستخدم بتعديلها. وإذا تم تعطيل حساب ذلك المستخدم، يتوقف المفتاح عن العمل.
- املأ "اسم الجهاز أو البرنامج"، على سبيل المثال "كمبيوتر المكتب" أو "نظام المحاسبة". وامنح كل جهاز أو برنامج مفتاحًا خاصًا به.
- بالنسبة لمفتاح "الإرسال عبر واتساب"، اضبط أيضًا ما يلي:
- "يرسل من": رقم WhatsApp الذي يرسل هذا المفتاح منه (مطلوب).
- "السماح بالرسائل الحرة": تشغيل أو إيقاف.
- "السماح بالقوالب المعتمدة": تشغيل أو إيقاف. ويجب تفعيل واحد على الأقل من هذين الخيارين، وإلا فستظهر لك رسالة "اسمح بواحد على الأقل من النص الحر أو القوالب — وإلا فلن يتمكن المفتاح من إرسال أي شيء."
- "السماح بإرسال الوسائط": تشغيل أو إيقاف.
- "القوالب" (اختياري): أسماء القوالب، مفصولة بفواصل. اتركه فارغًا للسماح بأي قالب.
- "دول المستلمين المسموح بها" (اختياري): رموز الدول المكونة من حرفين، على سبيل المثال MA,FR,EG. اتركه فارغًا للسماح بأي دولة.
- "الإرسال مسموح من" ... "إلى": الساعات المسموح للمفتاح بالإرسال خلالها. يمكنك ترك الوقتين متماثلين إذا كنت لا تريد تحديد حد زمني. وتكون الأوقات بالساعات المحلية لمساحة العمل.
- "الحد اليومي للرسائل (0 = بلا حد)".
- بالنسبة لمفتاح "استيراد SMS من هاتف"، اضبط "جهات الاتصال والعملاء فقط". وعند تفعيله، تظل رسائل SMS من أي رقم آخر على الهاتف ولا تصل أبدًا إلى صندوق الوارد. ولا توقفه إلا إذا كان الهاتف مخصصًا للعمل فقط.
- انقر على حفظ.
- تعرض نافذة "الرابط الأساسي" و"مفتاح API". انسخهما الآن. "انسخ هذا المفتاح الآن — يظهر مرة واحدة فقط." وضعهما في إعدادات برنامجك.
الأسئلة
فقدت مفتاح API الخاص بي. هل يمكنني رؤيته مرة أخرى؟
لا. فهو يظهر مرة واحدة فقط. أنشئ مفتاحًا جديدًا وضعه في برنامجك، ثم احذف المفتاح القديم.
أعتقد أن مفتاحًا قد تسرّب. ماذا أفعل؟
احذف ذلك المفتاح، أو عطّله فورًا. سيتوقف هذا المفتاح وحده عن العمل، ولن يتأثر رقم WhatsApp الخاص بك ولا مفاتيحك الأخرى.
قائمة "يرسل من" فارغة.
لا تعرض القائمة سوى أرقام WhatsApp المتصلة والمفعلة. اربط رقمًا أولاً، تحت الإعدادات > المراسلة > القنوات.
يتم رفض برنامجي عند الإرسال.
تأكّد من تفعيل مفتاح "بوابة API" ومن أن المفتاح نشط. وتحقق أيضًا من قيود المفتاح: النص الحر مقابل القوالب، والوسائط، والقوالب المسموح بها، والدول المسموح بها، وساعات الإرسال، والحد اليومي. كما تظل قواعد WhatsApp نفسها سارية أيضًا. فعلى سبيل المثال، لا يعمل النص الحر إلا خلال 24 ساعة من آخر رسالة للعميل.
هل يمكن لمفتاح "تسجيل شكوى" إرسال رسائل أيضًا؟
لا، وذلك عن قصد. فالمفتاح الذي يسجل شكاوى لا يمكنه مراسلة العملاء، ومفتاح الإرسال لا يمكنه تسجيل شكاوى. استخدم مفتاحًا منفصلاً لكل مهمة.
لديّ مفتاح قديم من نوع "استقبال من برنامج". هل لا يزال يعمل؟
نعم، تستمر المفاتيح الحالية من ذلك النوع في العمل. ولا يمكن إنشاء مفاتيح جديدة من ذلك النوع بعد الآن. استخدم "تسجيل شكوى" لهذا النوع من المهام بدلاً منه.
المزيد عن مفاتيح API.