استدعِ أي API من وسط محادثة
مجانًا لمدة 7 أيام، بدون بطاقة ائتمان
شخص يسأل أين طلبه، أو كم يستغرق وصول البن إلى رمزه البريدي. خطوة «طلب HTTP» (يسميها ManyChat «External Request») تسأل نظامك أو أي API في منتصف المحادثة وتضع الجواب في الرسالة التالية.
- واجهة Meta الرسمية، لا كلمة مرور، لا شيء مثبت
- جهات اتصال بلا حدود في كل خطة
- ردود بالذكاء الاصطناعي بلغة عميلك
- ابتداءً من 29 دولارًا في الشهر
من إجابتهم إلى واجهة API لديك ثم العودة
أربع لحظات داخل محادثة واحدة، تدفق «التحقق من الشحن» من البداية إلى الرد.
- 01
يخبرونك بما تحتاجه
سؤال سابق في التدفق يطلبه: رمز بريدي، رقم طلب، بريد إلكتروني. وتُحفظ الإجابة متغيرًا.
كل ما تعرفه عنهم يمكن إدخاله: إجاباتهم، بريدهم الإلكتروني، حقل محفوظ
- 02
الطلب يخرج
تملأ الخطوة المتغيرات، مرمّزة بأمان بحسب موضعها، وتستدعي العنوان من خادمنا.
الطرق: GET أو POST أو PUT أو PATCH أو DELETE؛ ومهلة 3 أو 5 أو 8 أو 10 ثوانٍ
- 03
الجواب جاهز للاستخدام
سمِّ الاستجابة مرة واحدة فيصير كل حقل تعيده متغيرًا للخطوات اللاحقة؛ و«احفظ في جهة الاتصال» يضع حقلًا على الشخص للتشغيلات القادمة.
حتى 20 قيمة محفوظة؛ ويُقرأ من الجواب حتى 512 KB
- 04
التدفق يسلك مخرجًا
الجواب السليم يسلك «نجاح» فتستطيع الرسالة التالية أن تقول Portland. والخطأ أو انتهاء المهلة يسلك «فشل»، فلا يُترك أحد منتظرًا.
عند الفشل: شخص، أو محاولة جديدة، أو رسالة أخرى
كل إعداد، بكلمات اللوحة الجانبية
التسميات التي ستراها في لوحة الخطوة، وما يفعله كل منها، والحد الذي وراءه.
الطلب
كل ما يطلبه توثيق الـ API، في الحقول التي يستخدمها توثيقه.
- الطريقةخمس طرق
طريقة GET تقرأ شيئًا (طلبًا، حجزًا)، و POST تنشئه (عميلًا محتملًا في نظام CRM لديك)، و PUT تستبدله، و PATCH تغيّر جزءًا منه، و DELETE تحذفه.
طلب GET لا يحمل body؛ أرسل القيم كمعاملات استعلام.
- العنوانأي عنوان https أو http
الصق العنوان من توثيق الـ API وضع متغيرًا في أي موضع منه، مثل رقم الطلب في /orders/{{order_number}}.
حتى 2,000 حرف.
- معاملات الاستعلامقيم في العنوان
يُضاف كل صف إلى العنوان بصيغة key=value ومرمّزًا تلقائيًا؛ وعطّل صفًّا بخيار «أرسل هذا الصف» من دون حذفه.
حتى 20 معاملًا.
- HeadersHeaders
سطور إضافية يطلبها الـ API، مثل أي متجر أو أي لغة. اقفل أي صف يحمل مفتاحًا فيُحفظ مشفّرًا.
حتى 20 header.
- BodyJSON أو نموذج أو خام
JSON تُرسل حقوله نصًّا أو رقمًا أو صح/خطأ أو JSON، والنقطة في المفتاح تجعله متداخلًا: customer.email يُرسل على أنه email داخل customer. نموذج يرسل الحقول كما يرسلها نموذج ويب؛ خام هو JSON أو نص عادي أو XML مكتوب يدويًا.
حتى 40 حقل JSON؛ و body خام حتى 20,000 حرف.
- الصق أمر cURLأنشئه من التوثيق
انسخ المثال من توثيق الـ API والصقه هنا. تُملأ الطريقة والعنوان والـ headers والمصادقة والـ body تلقائيًا.
المتغيرات والمفاتيح
ما يتغير من شخص لآخر يدخل؛ وما يجب أن يبقى سرًّا يبقى مختومًا.
- أدرج متغيرًاأربع مجموعات من المتغيرات
جهة الاتصال (الاسم الأول، اسم المستخدم، البريد الإلكتروني، الهاتف)، هذه المحادثة (آخر ما كتبه، تعليقه، المنشور)، الإجابات والحقول المحفوظة، و من استدعاءات الـ API: الحقول التي أعادها طلب سابق.
كل متغير يُهيَّأ بحسب موضعه: ترميز URL في العنوان، وتهريب JSON في body من نوع JSON.
- المصادقةبلا مصادقة، أو Bearer، أو Basic، أو مفتاح API
رمز Bearer، أو اسم مستخدم وكلمة مرور، أو مفتاح API يُرسل بالاسم الذي يختاره الـ API، في header أو في الـ query string.
- سري: محفوظ مشفّرًا ولن يُعرض مجددًاالأسرار مختومة
قيم المصادقة وأي صف معلَّم بأنه سري تُختم بتشفير AES-256-GCM عند الحفظ، وتُربط بحسابك، ولا تُفتح إلا على خادمنا. لن يراها أحد مجددًا، ولا حتى في سجل التشغيلات.
المفتاح المكتوب في أي مكان، حتى داخل أمر cURL ملصوق، يصير سريًا تلقائيًا.
- محظورالعناوين الخاصة مرفوضة
العنوان الذي يشير إلى داخل شبكة خاصة، أو إلى loopback، أو إلى نطاق بيانات وصفية سحابي، يُرفض عند إنشاء الاتصال، ومعه التحويلات.
3 تحويلات على الأكثر؛ وبيانات اعتمادك لا تُرسل أبدًا إلى موقع آخر.
استخدام الجواب
سمِّه مرة واحدة، واستخدمه بعدها في كل مكان.
- اسم الاستجابةكل حقل، باسمه
سمِّ الاستجابة مرة واحدة فيمكن إدخال كل حقل تعيده في الرسائل والطلبات والشروط اللاحقة بصيغة {{name.path}}، مثل {{order.items[0].name}}، أو {{name.$status}} لرمز الحالة.
لا يمكن لخطوتي HTTP في تدفق واحد أن تحملا الاسم نفسه.
- احفظ في جهة الاتصالعلى الشخص، للتشغيلات القادمة
بجانب كل حقل أعاده: احفظه بريدًا له أو هاتفًا أو اسمًا، أو حقلًا محفوظًا على جهة الاتصال (كما يحفظ تعيين حقل حقلًا). أما الخطوات اللاحقة في هذا التدفق فلديها كل الحقول أصلًا.
حتى 20 قيمة محفوظة لكل خطوة.
- رمز الحالةالحالة، والـ headers، والجواب كله
القيمة المحفوظة يمكن أن تكون رمز الحالة، أو الاستجابة كاملة، أو header واحدًا، أو أي حقل مثل data.items[0].email.
يُقرأ من الجواب حتى 512 KB.
- الحقول التي أعادهاالحقول من آخر تجربة
اضغط «أرسل طلبًا تجريبيًا» فيُدرج كل حقل في الجواب مع قيمته، جاهزًا للإدراج بزر المتغيرات أو للنسخ، مثل {{ship.places[0].place name}}.
عندما يفشل
تحت «خيارات أخرى». أي API يتعثر أحيانًا؛ والشخص في المحادثة لا يلاحظ شيئًا.
- نجاحمخرجان
نجاح هو استجابة 2xx؛ فشل هو خطأ أو انتهاء المهلة أو لا استجابة. اضبط «يُعدّ نجاحًا» على «أي استجابة» فيستطيع شرط أن يفحص رمز الحالة بدلًا من ذلك.
مخرج «فشل» غير الموصول بشيء ينهي التشغيل فاشلًا، والمنشئ يحذّرك أولًا.
- المهلةأنت تختار كم ينتظر
إن كان الـ API أبطأ من المهلة، تكف الخطوة عن الانتظار وتسلك «فشل». الناس في منتصف محادثة، فالأقصر ألطف بهم.
3 أو 5 أو 8 أو 10 ثوانٍ، و8 افتراضيًا.
- أعد المحاولة عند الأخطاءإعادة محاولات لا تخصم مرتين
عند خطأ في الشبكة أو 5xx يحاول من جديد بعد لحظة، مرة أو مرتين، مع احترام Retry-After. ولا تُعاد إلا الطرق الآمنة للإرسال مرتين (GET، PUT، DELETE)، أو الطلب الذي يحمل Idempotency-Key.
محاولتان إضافيتان على الأكثر.
- متوقف بعد الإخفاقاتالعنوان المتعثر يستريح
العنوان الذي فشل 5 مرات متتالية يتوقف دقيقة، ثم يُجرَّب من جديد، فلا يُغرَق API معطّل بالطلبات أبدًا.
5 استدعاءات في وقت واحد على الأكثر لكل حساب.
شاهد الجواب الحقيقي قبل التفعيل
«أرسل طلبًا تجريبيًا» يجري الاستدعاء الحقيقي من خادمنا بقيم تجريبية، ثم يعرض الجواب والـ headers وما أُرسل بالضبط.
- أرسل طلبًا تجريبيًا
- الاستدعاء الحقيقي بقيم تجريبية لمتغيراته، وأي مخرج كان التدفق سيسلكه؛ ثم كل حقل أعاده، في قائمة.
- ما أُرسل
- الطلب كما خرج تمامًا، وكل سر فيه محجوب.
- احفظ في جهة الاتصال
- بجانب أي حقل: بريده أو هاتفه أو اسمه، أو حقل محفوظ، للتشغيلات القادمة.
97205أرسل طلبًا تجريبيًا
20023 msيسلك مسار النجاح
الحقول التي أعادها
{{ship.$status}} 200{{ship.country}} United States احفظ في جهة الاتصال{{ship.post code}} 97205 احفظ في جهة الاتصال{{ship.places[0].place name}} Portland احفظ في جهة الاتصال{{ship.places[0].state}} Oregon احفظ في جهة الاتصال{{ship.places[0].latitude}} 45.5207 احفظ في جهة الاتصال
أدرج أيًا منها لاحقًا بزر المتغيرات. انسخ واحدًا لتلصقه بنفسك.
الاستجابةHeadersما أُرسل
انسخه من التوثيق، فيُبنى وحده
كل API يوثّق نفسه بمثال cURL. الصقه فتُملأ الطريقة والعنوان والـ headers والمصادقة والـ body؛ والمفتاح الذي فيه يُختم في الحال.
- أنشئه
- Ctrl أو ⌘ + Enter لإنشائه؛ وما تعذّرت قراءته يُذكر بالاسم.
- ثم أضف المتغيرات
- بدّل القيمة المكتوبة بـ {{email}} أو {{name}} ليخرج لكل شخص ما يخصه.
الصق أمر cURL
curl -X POST https://crm.northwindcoffee.com/api/leads \ -H "Authorization: Bearer nw_live_8f2k…" \ -H "Content-Type: application/json" \ -d '{"name": "Lucía", "email": "lucia@example.com", "source": "instagram"}'أنشئه
أُنشئ من أمر cURL. راجع الحقول أدناه.
https://crm.northwindcoffee.com/api/leads- المصادقة
- Bearer tokenمحفوظ ومخفي
- Body
- JSON ·
name{{name}} ·email{{email}} ·sourceinstagram
خطوة واحدة في محادثة كاملة
طلب HTTP يقع في أي مكان من التدفق: بعد سؤال يجمع ما يحتاجه، وقبل شرط يقرأ جوابه. واربط مخرج «فشل» أيضًا، إلى تنبيه الفريق و تحويل المحادثة إلى شخص.
الأرقام وراء ذلك
كل سقف للخطوة، في مكان واحد.
| البند | الحد |
|---|---|
| الطرق | GET, POST, PUT, PATCH, DELETE |
| معاملات الاستعلام والـ headers | حتى 20 لكل منهما |
| body من نوع JSON | حتى 40 حقلًا؛ و body خام حتى 20,000 حرف |
| العنوان | حتى 2,000 حرف، ومنها المتغيرات |
| المهلة | 3 أو 5 أو 8 أو 10 ثوانٍ، و8 افتراضيًا |
| إعادة المحاولة | بلا محاولة، أو مرة، أو مرتان، عند خطأ في الشبكة أو 5xx |
| القيم المحفوظة في جهة الاتصال | حتى 20 لكل خطوة |
| ما يُقرأ من الجواب | حتى 512 KB |
| التحويلات المتَّبعة | حتى 3، ويُفحص كل منها من جديد |
| الاستدعاءات في وقت واحد | حتى 5 لكل حساب |
| بعد 5 إخفاقات متتالية | يتوقف ذلك العنوان دقيقة |
| الطلبات التجريبية | حتى 30 في الدقيقة لكل شخص |
| خطوات لكل تدفق | حتى 60 |
| الخطة | Starter وما فوقها، مع منشئ التدفقات؛ وتجربة 7 أيام لأتمتة الرسائل الخاصة في Mini و Lite |
كل الحدود تخص CommentWatchDog، من كود الخطوة؛ وسطر الخطة من صفحة الأسعار.
قل ما تريده، والذكاء الاصطناعي يضبطه
اضغط «اضبطها بالذكاء الاصطناعي» وصف المهمة. يبحث عن API رسمي، ويقرأ توثيقه، ويختبر الطلب، ويملأ الخطوة.
- اضبطها بالذكاء الاصطناعي
- كيف يعمل المنشئ بالذكاء الاصطناعي، وكم يكلّف من أرصدة الذكاء الاصطناعي.
- خدمات جاهزة
- اثنتا عشرة خدمة مجانية يبدأ منها، لأسعار الصرف والطقس والعطل والرموز البريدية وغيرها: الخدمات الجاهزة.
استخدام جواب الـ API، بلا مفاجآت
خطوة External Request في ManyChat مقابل خطوة «طلب HTTP»، في ما يحدد هل الجواب صالح للاستخدام. المزيد في بديل ManyChat.
CommentWatchDogمركز مساعدة ManyChat: «Make External Request» و«Dev Tools: Basics»، قُرئا في أكتوبر 2026. الشعارات ملك لأصحابها.
أسئلة عن خطوة طلب HTTP
ما يسأل عنه الناس قبل أن يربطوا API.
تستدعي API نظام آخر في منتصف المحادثة وتستخدم الجواب في الخطوات التالية. ابحث عن حالة طلب من الرقم الذي يكتبه الشخص، أو تحقق من رمز بريدي، أو أرسل عميلًا محتملًا جديدًا إلى نظام CRM لديك، أو اسأل عن كمية المخزون، ثم اذكر النتيجة في الرسالة التالية أو فرّع بحسبها بشرط. تعمل على إنستغرام وفيسبوك، قبل فتح المحادثة أو بعده.
لا. الصق مثال cURL من توثيق الـ API فتُملأ الطريقة والعنوان والـ headers والمصادقة والـ body تلقائيًا، أو اضغط «اضبطها بالذكاء الاصطناعي» وصف ما تريده بالكلمات: يجد الخدمة، ويقرأ توثيقها، ويختبر الطلب لك. راجع المنشئ بالذكاء الاصطناعي.
نعم. قيم المصادقة وأي صف تعلّمه بأنه سري تُشفَّر بـ AES-256-GCM عند الحفظ، وتُربط بحسابك، ولا تُفتح إلا على خادمنا. تُحجب في ما تعرضه التجربة، وتُزال من الأجوبة المخزّنة، ولا تُعرض مجددًا أبدًا، ولا تُعرض على الذكاء الاصطناعي أبدًا. والمفتاح المكتوب في أي مكان، حتى داخل أمر cURL ملصوق، يصير سريًا تلقائيًا.
أعطِ الاستجابة اسمًا، مثل order، فيمكن إدخال كل حقل تعيده في الرسائل والطلبات والشروط اللاحقة بصيغة {{order.status}} أو {{order.items[0].name}}، أو {{order.$status}} لرمز الحالة. و«احفظ في جهة الاتصال» يضع حقلًا على الشخص للتشغيلات القادمة: بريده أو هاتفه أو اسمه، أو حقلًا محفوظًا، حتى 20 لكل خطوة.
تنتظر الخطوة حتى مهلتك (3 أو 5 أو 8 أو 10 ثوانٍ، و8 افتراضيًا)، ويمكن أن تحاول من جديد مرة أو مرتين عند خطأ في الشبكة أو 5xx، وإلا سلكت مخرج «فشل»، فتستطيع تحويل المحادثة إلى شخص أو إرسال رسالة أخرى. والعنوان الذي يفشل 5 مرات متتالية يتوقف دقيقة.
نعم، إلى أي منها يعطيك عنوان API ومفتاحًا. لا توجد تكاملات مدمجة، فلا شيء يُربط بنقرة واحدة: خطوة «طلب HTTP» تستدعي API الخدمة نفسها. ولنظام CRM، استخدم POST، وضع اسم جهة الاتصال أو بريدها أو إجاباتها في body من نوع JSON كمتغيرات، وأضف مفتاحه تحت «المصادقة»؛ راجع جمع العملاء المحتملين في الرسائل الخاصة. الخطوة تستدعي إلى الخارج فقط، فلا يستطيع أي منها بدء تدفق أو إرسال بيانات إليه.
ترسل طلبًا إلى الخارج، وهو ما تسميه أدوات كثيرة webhook أو External Request. أما الاستدعاءات الداخلة إلى تدفق من نظام آخر فغير مدعومة؛ التدفق يبدأ من تعليق، أو رسالة، أو قصة، أو رابط رسالة خاصة، أو محادثة جديدة، أو منشور تمت مشاركته.
تأتي مع منشئ التدفقات في Starter وما فوقها، وفي Mini و Lite مع تجربة 7 أيام لأتمتة الرسائل الخاصة. لا رسوم إضافية لكل طلب؛ و«اضبطها بالذكاء الاصطناعي» وحدها تستهلك أرصدة الذكاء الاصطناعي.