قناة API قناة فارغة ذات باب على كل جهة. فتطبيقك يُدخل الرسائل إليها عبر HTTP، ويُرسل لينوميا تشات ردود وكلائك
إلى عنوان webhook تعطيه إياه.

وكل ما عدا ذلك يعمل كالمعتاد: تظهر المحادثة في **المحادثات**، ويمكن إسنادها وتصنيفها وأتمتتها وقياسها
والرد عليها من الشاشة نفسها التي ترد بها على كل قناة أخرى.

## متى تستخدمها

- سطح مراسلة بلا موصّل هنا — دردشة داخل تطبيق كتبته بنفسك، أو كشك، أو منصّة لا يدعمها أحد.
- جسر إلى نظام تشغّله أصلاً، وتريد أن تعيش المحادثة في لينوميا تشات.

و**لا** تستخدمها لقناة لها موصّل جاهز. فالقنوات الجاهزة تحمل ما لا تعرفه قناة API: حالات التسليم، والقوالب،
وقواعد المزوّد نفسه، ومسار إعادة ربط حين ينتهي الإذن.

## الخطوات

1. اذهب إلى **الإعدادات ← قنوات التواصل**، أضف صندوق وارد، واختر **API**.
2. أعطها اسماً، و**عنوان webhook** — حيث سيرسل لينوميا تشات الأحداث، ومنها كل ردّ يرسله وكيل. ويمكنك تركه
   فارغاً وإضافته لاحقاً من إعدادات القناة.
3. أنهِ الإعداد وأضف الوكلاء.
4. افتح تبويب **الإعدادات** في القناة. يعرض **معرّف صندوق الوارد** (Inbox Identifier)، وهو الرمز الذي يصادق
   به تطبيقك.

ومن هناك، ينشئ تطبيقك جهة اتصال، ثم محادثة لها، ثم يُدخل الرسائل في تلك المحادثة. ومرجع الواجهة البرمجية
لتثبيتك هو المرجع المعتمد في أسماء النداءات وأشكالها؛ وهذا المقال عن القناة لا عن النداءات.

## حدود ينبغي معرفتها

- **معرّف صندوق الوارد بيانات اعتماد.** فكل من يحمله يستطيع إنشاء جهات اتصال ومحادثات في هذه القناة. أبقِه
  على خادمك، لا في متصفح ولا في تطبيق جوال.
- **لا إشعارات تسليم** إلا إن أبلغ بها تطبيقك.
- **المرفقات تخضع لحدّ الحجم في التثبيت.**
- **لا شيء يعيد المحاولة نيابة عنك.** فإن كان عنوانك متوقفاً حين يردّ وكيل، فشل ذلك التسليم؛ ومعالجة ذلك
  مهمّة تطبيقك.

## من يستطيع فعل هذا

المديرون ينشئون القناة. ومطوّروك يفعلون الباقي.

## ذات صلة

- [اربط أول قناة](connect-your-first-channel-ar)
- [الـ Webhooks](webhooks-ar)
- [جهّز صندوق وارد](set-up-an-inbox-ar)

## إن لم ينجح الأمر

**نداءات تطبيقك مرفوضة.** تأكّد أنك ترسل معرّف صندوق الوارد من تبويب الإعدادات في هذه القناة، وأنك تنادي
التثبيت الذي تنتمي إليه هذه القناة.

**الوكلاء يردّون ولا يسمع تطبيقك.** عنوان الـ webhook خاطئ، أو غير قابل للوصول، أو بطيء بما يكفي لانتهاء
المهلة. وهو في صفحة إعدادات القناة؛ والعنوان الصحيح خلف جدار حماية يبدو من هنا كالعنوان الخاطئ تماماً.