إضافة خطّاف ويب هي POST على /linkedin/webhooks/endpoints، ضمن عائلة webhooks في MakeHybrid API. كل طلب يحمل مفتاحك أنت في ترويسة X-API-KEY؛ والمفتاح هو ما يحدد أي مؤسسة أنت، وبالتالي أي حسابات LinkedIn يحق لك ذكرها.
الـ webhooks هي الفرق بين أن تُبلَّغ وأن تظل تسأل. تحقق من التوقيع في كل تسليم، وعامل تكرار الحدث نفسه على أنه أمر طبيعي.
الطلب
curl -X POST "https://makehybrid.com/linkedin/webhooks/endpoints" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
ما يعود حين لا تنجح
- 401 — المفتاح ناقص أو خاطئ أو مُلغى.
- 402 — الخطة غير مدفوعة. تجيب خدمة MakeHybrid API بهذا بعد انتهاء التجربة.
- 404 — إما أن الشيء غير موجود، وإما أن معرّف الحساب ليس لك. الجوابان متطابقان عن قصد، حتى لا تُستكشَف المعرّفات.
- 429 — طلبات أكثر من اللازم، أو LinkedIn يكبح الحساب. الانتظار وحده هو الحل؛ وإعادة المحاولة مبكرًا تطيل المدة.
- 503 — LinkedIn، أو القفزة التي قبله، لم يجب. ويحمل الجسم رمز الحالة المجرد كما رآه.
كل خطأ هو JSON بالشكل نفسه: {"type":"errors/<code>","status":<n>,"detail":"..."} — فمعالج واحد يغطيها جميعًا، وحقل detail مكتوب ليُعرض على إنسان.
اطلبها من مساعد بدلًا من ذلك
هذه العملية أداة MCP أيضًا. الصق https://makehybrid.com/linkedin/mcp/<مفتاح الواجهة الخاص بك> في Claude أو ChatGPT أو أي مساعد يتكلم MCP، واطلب ما تريد بلغة عادية — فيختار المساعد الاستدعاء، ويملأ المعرّفات، ويقرأ لك الجواب. لا شيء يُثبَّت.
في غرفة مشروع
في غرفة مشروع، حدِّد MakeHybrid تحت «يمكنه استخدام» لوكيل ذكاء اصطناعي خاص بك، فيستدعي «إضافة خطّاف ويب» أداةً كلما احتاجت المحادثة إلى ذلك، على حسابات LinkedIn التي ربطتها مؤسستك. ويرى كل من في الغرفة ما طلبه وما عاد به. اسأل بكلمات عادية؛ واسم الوكيل هنا @scout:
- @scout ما الويب هوك لدينا، وهل نجحت آخر عمليات تسليمها؟
أسئلة شائعة
هل يستطيع وكيل ذكاء اصطناعي أن يستدعي «إضافة خطّاف ويب» نيابةً عني؟
نعم. يستطيع ذلك أي مساعد يتكلم MCP، عبر العنوان أعلاه، ويستطيعه كذلك وكيل ذكاء اصطناعي خاص بك في غرفة مشروع حُدِّد له MakeHybrid. أما الوكلاء المدمجون في الغرفة فلا يستطيعون: فهم ينصحون ولا يحملون مفتاح LinkedIn الخاص بك.
هل يعمل خارج الغرفة، من كودي أنا؟
نعم. الطلب أعلاه هو العملية نفسها التي تستدعيها أدوات وكيل الذكاء الاصطناعي، بالجواب نفسه وبالأخطاء نفسها. ومفتاحك هو ما يحدد حسابات LinkedIn التي يحق له ذكرها، أيًّا كانت الطريقة التي تدخل بها.
هل يعمل في غرفة بعلامتي التجارية؟
نعم. على عنوان العلامة البيضاء تُدرَج الأداة باسم منتجك، وتصل إلى الحسابات نفسها بالقواعد نفسها.
هل يستطيع شخص أن يوافق قبل أن يفعل وكيل الذكاء الاصطناعي هذا؟
اكتب ذلك في تعليمات وكيل الذكاء الاصطناعي: يقول ما هو على وشك فعله، وينتظر أن يقول شخص في الغرفة «تفضّل». والغرفة تعرض كل ردّ على كل من فيها، فيُرى الطلب قبل أن يتغيّر أي شيء على LinkedIn.
في أي خطة
MakeHybrid API، على /linkedin. تسعة دولارات لكل حساب LinkedIn متصل شهريًا، وسبعة ابتداءً من عشرة حسابات، وخمسة ابتداءً من ألف، مع تجربة 30 يومًا لحساب واحد.