الغرض منه
يتيح قسم المطوّرين لأنظمتك الخاصة أن تعمل مع مساحة عملك: نظام ERP، أو نظام CRM، أو تقاريرك، أو أداة أتمتة مثل Make أو n8n.
- بواسطة واجهة API، يقرأ النظام مساحة عملك ويغيّرها: يضيف جهات اتصال ووسومًا، ويقرأ المحادثات، ويُعدّ حملة، وغير ذلك. ويستخدم مفتاح API تنشئه هنا.
- بواسطة الويب هوك، تُخبر مساحة عملك النظام لحظة حدوث شيء: وصول رسالة من عميل، أو طلب جهة اتصال التوقف، أو انتهاء حملة. تعطي العنوان الذي يُخبَر، وتختار ما يسمعه.
لا تحتاج إلى بناء أي شيء لتستخدم xconversions. قسم المطوّرين لنشاط تجاري لديه من يبني الربط، أو أداة توفّره.
أين يوجد
افتح التكاملات، ثم فتح في بطاقة المطوّرين، أو انتقل إليه مباشرة. والزر الدائري بجانب العنوان يعيدك إلى التكاملات.
في قائمة على الجانب أربعة تبويبات ورابط:
| على الشاشة | ما وظيفته |
|---|---|
| مفاتيح API | المفاتيح التي تستدعي بها أنظمتك واجهة API. راجع مفاتيح API. |
| الويب هوك | العناوين التي تُخبرها مساحة عملك عندما يحدث شيء. راجع الويب هوك. |
| عناوين IP المسموح بها | عناوين الإنترنت التي يُسمح لها باستدعاء واجهة API. راجع قائمة عناوين IP المسموح بها. |
| MCP | تطبيقات الذكاء الاصطناعي المربوطة بمساحة عملك، وما تطلب هي ومفاتيحك أن يوافق عليه مسؤول. راجع نظرة عامة على MCP. |
| دليل المطوّر | كيف تستدعي واجهة API، وتُبقي نظامًا متزامنًا معها، وتتحقق من أن الويب هوك صادر منا فعلًا. بالإنجليزية، كما هي واجهة API. |
ويرتبط دليل المطوّر أيضًا بوصف واجهة API في ملف OpenAPI، وصف واجهة API (OpenAPI)، الذي تقرؤه الأدوات لتعرف كل استدعاء.
من يستطيع إعداده، وفي أي خطة
- قسم المطوّرين من شأن مسؤول المؤسسة. ومن يفتحه غيرُه يُقال له إن المسؤولين هم من يُعدّونه.
- تأتي واجهة API والويب هوك مع بعض الخطط. ومن دونها لا يمكن إنشاء مفتاح، وتعرض الشاشة غير متاح في خطتك. أما تبويب MCP فيتوقف على ميزة خاصة به في الخطة.
- كل مفتاح يُنشأ أو تُعاد تسميته أو يُحذف، وكل عنوان يُنشأ أو يُغيَّر، يُسجَّل في سجل النشاط.
ما ينتظر مسؤولًا
يستطيع النظام أن يُعدّ أمورًا، لكن لا شيء يصل إلى عملائك أو يصبح مباشرًا يحدث دون شخص. فإطلاق حملة، ونشر وكيل، وتغيير ما يعرفه وكيل مباشر، وتفعيل مسار، لا تكون أبدًا إلا طلبًا: كل استدعاء يقدّم طلبًا، ولا يحدث شيء إلى أن يوافق عليه مسؤول في تبويب MCP. وينتظر الطلب 24 ساعة.
راجع الموافقة على ما يطلبه التطبيق: يُوافَق هناك على الطلبات الواردة من مفتاح بالطريقة نفسها.
أسئلة
هل تُحتسب تكلفة على واجهة API؟
استدعاء واجهة API جزء من الخطة التي تشملها. أما ما يترتب عليه فيُحتسب كالمعتاد: الرد الذي يرسله وكيلك يستخدم وحدات الذكاء الاصطناعي، والرسالة المرسلة تدخل في فاتورة ميتا.
هل يستطيع نظام أن يرسل رسائل واتساب عبر واجهة API؟
يستطيع النظام أن يُعدّ حملة ويطلب إطلاقها. ويوافق عليها مسؤول قبل أن يُرسل أي شيء.
لمن أعطي دليل المطوّر؟
لمن يبني لك الربط. ويُفتح في التطبيق، من دليل المطوّر في قائمة المطوّرين.