جلب دردشة الموقع وشيفرتها هي GET على /webchat/v1/widgets/{id}، ضمن MakeHybrid Website chat API: دردشة مؤسستك الخاصة على مواقعها، يجيب عنها فريقك أو وكلاء الذكاء الاصطناعي لديك. كل طلب يحمل مفتاحك أنت في ترويسة X-API-KEY — وهو المفتاح نفسه الذي تستخدمه مع LinkedIn API — ولا يصل إلا إلى دردشاتك أنت.
الدردشة ملكك أنت، نحتفظ بها نحن لا خدمة صندوق وارد أخرى: لا يُوصل إلى محادثة الزائر إلا بمفتاحك، ووكيل الذكاء الاصطناعي الذي يجيب الزوار يفعل ذلك دون أي أدوات.
الطلب
curl -X GET "https://makehybrid.com/webchat/v1/widgets/$ID" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
ما يوضع في المسار
- id — معرّف أعاده استدعاء سابق من هذه العائلة.
ما يعود حين لا تنجح
- 401 — المفتاح ناقص أو خاطئ أو مُلغى.
- 402 — الخطة غير مدفوعة. تجيب خدمة MakeHybrid API بهذا بعد انتهاء التجربة.
- 404 — إما أن الشيء غير موجود، وإما أنه ليس لمؤسستك. الجوابان متطابقان عن قصد، حتى لا تُستكشَف المعرّفات.
- 429 — طلبات أكثر من اللازم، أو أن المنصة تطلب منا التمهّل. انتظر قليلًا قبل أن تحاول مجددًا.
- 502 أو 503 — لم تجب المنصة الآن. حاول مجددًا بعد قليل.
كل خطأ هو JSON بالشكل نفسه: {"type":"errors/<code>","status":<n>,"detail":"..."} — فمعالج واحد يغطيها جميعًا، وحقل detail مكتوب ليُعرض على إنسان.
اطلبها من مساعد بدلًا من ذلك
هذه العملية أداة MCP أيضًا. الصق https://makehybrid.com/webchat/mcp/<your API key> في Claude أو ChatGPT أو أي مساعد يتكلم MCP، واطلب ما تريد بلغة عادية — فيختار المساعد الاستدعاء، ويملأ المعرّفات، ويقرأ لك الجواب. والوكيل الشامل على https://makehybrid.com/mcp/<your API key> يملكها أيضًا، إلى جانب LinkedIn API وكل قناة أخرى.
في غرفة مشروع
في غرفة مشروع، حدِّد وكيل هذه الواجهة تحت «يمكنه استخدام» لوكيل ذكاء اصطناعي خاص بك، فيستدعي «جلب دردشة الموقع وشيفرتها» أداةً كلما احتاجت المحادثة إلى ذلك. ويرى كل من في الغرفة ما طلبه وما عاد به. اسأل بكلمات عادية؛ واسم الوكيل هنا @scout:
- @scout اسرد محادثات دردشة الموقع التي لم يجب عنها أحد بعد، واكتب مسودة ردّ على كل واحدة لأراجعها.
أسئلة شائعة
هل يستطيع وكيل ذكاء اصطناعي أن يستدعي «جلب دردشة الموقع وشيفرتها» نيابةً عني؟
نعم. يستطيع ذلك أي مساعد يتكلم MCP، عبر العنوان أعلاه، ويستطيعه كذلك وكيل ذكاء اصطناعي خاص بك في غرفة مشروع حُدِّد له وكيل هذه الواجهة. أما الوكلاء المدمجون في الغرفة فلا يستطيعون: فهم ينصحون ولا يحملون مفتاحك.
هل يعمل خارج الغرفة، من كودي أنا؟
نعم. الطلب أعلاه هو العملية نفسها التي تستدعيها أدوات وكيل الذكاء الاصطناعي، بالجواب نفسه وبالأخطاء نفسها. ومفتاحك يصل إلى القنوات نفسها أيًّا كانت الطريقة التي تدخل بها.
هل يعمل في غرفة بعلامتي التجارية؟
نعم. على عنوان العلامة البيضاء تحمل الواجهة ومرجعها ووكيل الذكاء الاصطناعي فيها اسم منتجك، وتصل إلى القنوات نفسها بالقواعد نفسها.
في أي خطة
مشمولة في خطة MakeHybrid API، وبالمفتاح نفسه الذي تستخدمه مع LinkedIn API: تسعة دولارات لكل مقعد شهريًا، وسبعة ابتداءً من عشرة مقاعد، وخمسة ابتداءً من ألف. وتحتاج إلى عدد من المقاعد يساوي عدد النوع الذي لديك منه أكثر من غيره — حسابات LinkedIn أو أرقام WhatsApp أو حسابات X أو حسابات صندوق الوارد — وتغطي تجربة الثلاثين يومًا مقعدًا واحدًا.