ربط أدواتك بخدمة النشر في Influence

استخدم API وأدوات MCP من Influence لحفظ المسودات ومراجعة المنشورات وجدولة النشر الذي وافقت عليه. استرجع الحسابات المرتبطة وتحقق من نتائج النشر المسجلة عبر الأدوات نفسها.

بيانات الاعتماد والموافقة وحالة التسليم

تقييد الوصول ببيانات اعتماد محددة الصلاحيات

اختر الصلاحيات التي يحتاجها التطبيق العميل. يتحقق Influence من ملكية مساحة العمل وصلاحية الوصول في كل عملية. توضح كل أداة ما إذا كان التأكيد مطلوبا، ويفرض الخادم هذا الشرط.

الموافقة على إجراء النشر المحدد

راجع الحسابات والمحتوى والوسائط والموعد قبل التنفيذ. يحتاج أي تغيير جوهري إلى مراجعة جديدة وموافقة متجددة؛ ويدخل العمل المعتمد إلى نظام الجدولة في Influence.

قراءة حالة التسليم

استخدم المعرفات المعادة للتحقق من كل منشور. تعني «مجدول» أنه ينتظر التسليم، وتؤكد «تم النشر» أنه أرسل. أما «بحاجة إلى مراجعة» فتعني أن النتيجة غير مؤكدة ويجب حسمها قبل أي إرسال آخر.

قراءة حساباتك المرتبطة عبر MCP

يتصل مثال Node.js هذا بخدمة Influence ويعرض الحسابات الاجتماعية في مساحة عملك. يقرأ تفاصيل الحسابات دون إنشاء مسودة أو نشر منشور.

1. إنشاء مفتاح بصلاحية القراءة

في «الإعدادات»، افتح التطبيقات والأتمتة ثم أدوات المطور. اختر قراءة القنوات المرتبطة (integrations:read)، وأزل تحديد كل صلاحية أخرى، ثم أنشئ مفتاح API. احفظ المفتاح في مخزن الأسرار المحلي أو في البيئة باسم INFLUENCE_API_TOKEN. يظهر المفتاح مرة واحدة؛ لا تضعه في ملفات المصدر أو المحادثات.

فتح إعدادات مفاتيح API

2. تشغيل المثال

بعد تثبيت Node.js وnpm، ثبت حزمة MCP SDK في مشروعك. احفظ الشيفرة أدناه باسم accounts.mjs، ثم شغل node accounts.mjs في بيئة يكون فيها INFLUENCE_API_TOKEN مضبوطا. تتولى حزمة SDK الاتصال عبر MCP وتهيئته.

npm install @modelcontextprotocol/client@2.3.1

accounts.mjs

import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";

const token = process.env.INFLUENCE_API_TOKEN;
if (!token) throw new Error("Set INFLUENCE_API_TOKEN first.");

const client = new Client({ name: "influence-quickstart", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
  new URL("https://influence.so/api/mcp"),
  { requestInit: { headers: { Authorization: `Bearer ${token}` } } }
);

try {
  await client.connect(transport);
  const result = await client.callTool({
    name: "accountList",
    arguments: { limit: 20 }
  });
  console.log(JSON.stringify(result.structuredContent, null, 2));
  if (result.isError) process.exitCode = 1;
} finally {
  await client.close();
}

3. قراءة الاستجابة

استجابة توضيحية بأسماء حسابات ومعرفات خيالية. تحدد استجابتك مساحة عملك وحساباتها الاجتماعية المرتبطة.

{
  "ok": true,
  "output": {
    "cursor": null,
    "done": true,
    "items": [
      {
        "connectionId": "account_example_01",
        "eligible": true,
        "name": "Example studio",
        "platform": "bluesky",
        "supportsImage": true,
        "supportsText": true,
        "supportsVideo": true
      }
    ],
    "workspaceId": "workspace_example_01",
    "workspaceName": "Example workspace"
  },
  "toolName": "accountList"
}

ما تعنيه النتيجة

وردت حسابات في الاستجابة

استخدم connectionId لتعريف كل حساب. توضح الحقول eligible وsupportsText وsupportsImage وsupportsVideo إمكانات النشر الحالية؛ تحقق منها مجددا قبل إعداد منشور.

لم ترد أي حسابات في الاستجابة

تعني الاستجابة ok: true مع items: [] وdone: true أن القراءة نجحت. اربط حسابا اجتماعيا في مساحة العمل التي يحددها workspaceName، ثم شغل المثال مجددا.

نتائج موزعة على عدة صفحات

عندما تكون done بالقيمة false، استدع accountList مجددا مع cursor المعاد وقيمة limit نفسها. واصل حتى تصبح done بالقيمة true؛ فقد تحتوي الصفحة الأولى على أقل من 20 حسابا.

الوصول مرفوض

عند تلقي استجابة 401، تحقق من أن المفتاح ساري المفعول ويمنح صلاحية integrations:read. قد يؤدي غياب نطاق الصلاحيات أيضا إلى استجابة 401 عند استخدام مفتاح API. وقد يعيد اتصال OAuth الاستجابة 403 insufficient_scope؛ أعد الاتصال ووافق على صلاحية قراءة الحسابات.

يمكن ربط ChatGPT وClaude عبر التفويض في المتصفح بدلا من المفتاح. اتبع دليل إعداد المساعد، ثم اطلب منه عرض حساباتك المرتبطة. يستخدم المثال أعلاه عنوان MCP الكامل، https://influence.so/api/mcp؛ وللموصل الأساسي في Claude إعداد خاص به.

اكتشاف الأدوات والصلاحيات التي تتطلبها

يعرض GET /api/v1/tools الأدوات المتاحة لمفتاحك. ينتقي الطلب الموضح حقول الصلاحيات ومتطلبات التأكيد للأداة accountList. يتطلب إنشاء المسودات صلاحيات كتابة إضافية.

HTTP API

GET /api/v1/tools

يقرأ تطبيقك كتالوج الأدوات ويستدعي الأدوات المتاحة.

MCP

tools/list

يكتشف مساعد مدعوم الأدوات ويتبع سير عمل المراجعة نفسه.

Influence
  1. 1. إعداد مسودة

    استدع campaignDraftSave بالحسابات والوسائط من مساحة العمل. احتفظ برقم النسخة وهوية الطلب لاسترداد الاستجابة إذا انقطعت. تتطلب عمليات كتابة المسودات تأكيدا من الخادم.

  2. 2. إعداد المراجعة

    استدع campaignReview للنسخة المحفوظة والإجراء المطلوب. اعرض الحسابات والمحتوى والوسائط والإعدادات والوقت وموعد انتهاء الصلاحية قبل طلب الموافقة.

  3. 3. تنفيذ الإجراء الموافق عليه

    تتطلب campaignReviewExecute الموافقة على تلك المراجعة بعينها. تحتاج المنشورات النصية إلى رد جديد على المراجعة كاملة، وتتطلب الوسائط موافقة بعد معاينتها بصريا. يرسل الخادم الإجراء إلى مجدول المهام ذي التخزين الدائم، بدلا من استدعاء مزود الخدمة مباشرة.

  4. 4. قراءة النتيجة قبل إعادة المحاولة

    اقرأ حالة كل حساب ورابط المنشور عند توفره. يظل الإرسال غير المؤكد بحالة «بحاجة إلى مراجعة» حتى تتضح نتيجته. استرجع نتيجة الطلب القائم قبل إنشاء منشور آخر؛ وإلا فقد ترسل نسخة مكررة.

اختيار الاتصال المناسب لأداتك

Influence: اختيار الاتصال المناسب لأداتك
الاتصالالاستخدامالوصول
HTTP APIيقرأ تطبيقك كتالوج الأدوات ويستدعي الأدوات المتاحة.استخدم بيانات اعتماد محددة الصلاحيات من نوع Bearer، مخزنة في متغير بيئة.
MCPيكتشف مساعد مدعوم الأدوات ويتبع سير عمل المراجعة نفسه.اتبع إعداد المساعد في «الإعدادات» في Influence. يعتمد التوافر على التطبيق المضيف والصلاحيات الممنوحة.

طلب كتالوج الأدوات

curl --fail-with-body 'https://influence.so/api/v1/tools' \
  --header "Authorization: Bearer $INFLUENCE_API_TOKEN" \
  | jq '{tools: [.tools[] | select(.name == "accountList") | {name, scopes, confirmation, mutability}]}'

أمثلة على حقول الكتالوج

{
  "tools": [
    {
      "confirmation": "none",
      "mutability": "read",
      "name": "accountList",
      "scopes": [
        "integrations:read"
      ]
    }
  ]
}

هذه الحقول التوضيحية مأخوذة من تعريفات الأدوات. ويحدد الكتالوج الفعلي ونطاقات صلاحيات بيانات الاعتماد والحسابات المرتبطة العمليات المتاحة.

كابلات زرقاء تصل صينية بطاقات صور وقطعا وختما وتقويما ومظروفا مغلقا.

مسارات نشر يمكنك بناؤها

منشورات من مسار إعداد محتواك

جهز في أدواتك مسودات من مقال أو سجل تغييرات أو إشعار للمجتمع. اعرض الحسابات المحددة والمحتوى والموعد للمراجعة قبل أن تطلب من Influence جدولة النشر.

استرجاع نتيجة طلب بعد فقدان الرد

احتفظ بالطلب الأصلي ومفتاح منع التكرار، ثم ابحث عن نتيجته. يبقى الإرسال ذو النتيجة غير المؤكدة في حالة «بحاجة إلى مراجعة» حتى تتأكد مما حدث. قد يؤدي إنشاء طلب بديل إلى نشر المنشور نفسه مرتين.

إعداد مسودة أولى باستخدام Influence IQ

قدم إلى Influence IQ مقالا أو ملاحظات مشروع أو تحديثا للمجتمع مع «إرشادات العلامة التجارية» المحفوظة للحصول على مسودات قابلة للتعديل. تستهلك أدوات الذكاء الاصطناعي المتاحة والمصرح بها أرصدة IQ وتظل خاضعة لمتطلبات التأكيد الخاصة بها.

زود Influence IQ بملاحظاتك وإرشادات العلامة التجارية المحفوظة ليقترح منشورات قابلة للتعديل ومواعيد للنشر. يستهلك إعداد المسودات وتوليد الصور أرصدة IQ. راجع عرض تكلفة توليد الصور قبل البدء، ثم راجع المحتوى النهائي قبل النشر.

استكشاف Influence IQ

البدء بمساعد يعمل بالذكاء الاصطناعي

عند استخدام ربط مدعوم مع Influence، يمكنك تخطيط الحملات وتعديل المسودات في ChatGPT أو Claude. اطلب من مساعدك رفع الصور والفيديوهات التي يمكنه الوصول إليها، أو إعادة استخدام الوسائط الجاهزة في Influence. إذا لم يتمكن من الوصول إلى الملف، فارفعه أولا في Influence. راجع الحسابات المحددة والنص والوسائط والإعدادات والوقت. بعد الاطلاع على المراجعة الكاملة، وافق عبر بطاقة مدعومة داخل المحادثة أو برد جديد بعبارة «أوافق». مع النشر المباشر على TikTok، حدد خيارات النشر وقدم الموافقة المطلوبة داخل المحادثة، ثم وافق على المراجعة المحدثة. بطاقة المراجعة اختيارية. راجع «الإعدادات» للاطلاع على خطوات الإعداد وحالة الربط.

النشر إلى حساباتك المرتبطة

اختر الحسابات المتاحة لمساحة عملك. عدل النص والوسائط المدعومة لكل وجهة، ثم راجع المنشورات قبل النشر.

تجهيز منشوراتك القادمة

أضف حساباتك وجهز المنشورات واختر تواريخها. راجع المحتوى قبل الجدولة.

ابدأ

الأسئلة الشائعة

ما الذي يمكن أن يفعله مسار عمل API وMCP؟
بحسب الأدوات المفعلة وصلاحياتك، يمكن لتطبيق عميل يستخدم API أو MCP التعامل مع الحسابات المرتبطة والمسودات المحفوظة والوسائط المدعومة ومراجعات المنشورات والجداول وحالة التسليم.
هل تتجاوز استدعاءات API أو MCP الموافقة؟
لا. يفرض الخادم متطلبات التأكيد الخاصة بكل أداة. يتطلب النشر الموافقة على المراجعة الحالية. ويتحقق التنفيذ من مساحة العمل والصلاحيات والحسابات والمحتوى قبل جدولة التسليم.
ما الوسائط التي يقبلها مسار عمل المساعد؟
اطلب من مساعدك رفع صور وفيديوهات يمكنه الوصول إليها، أو إعادة استخدام وسائط جاهزة من Influence. إذا تعذر عليه الوصول إلى الملف، فارفعه أولا في Influence. راجع الحسابات المحددة والنص والوسائط والإعدادات والموعد. ثم وافق عبر بطاقة مدعومة داخل المحادثة أو برد جديد يقول «أوافق» بعد الاطلاع على المراجعة كاملة. للنشر المباشر على TikTok، قدم خيارات النشر وموافقتك اللازمة في المحادثة، ثم وافق على المراجعة المحدثة. بطاقة المراجعة اختيارية.
كيف تتعامل مع رد مفقود أو إرسال غير مؤكد؟
استرجع نتيجة الطلب الأصلي وتحقق من الحالة المسجلة. لا تكرر إرسالا غير محسوم. تبقى حالة «بحاجة إلى مراجعة» بلا حسم حتى تثبت عملية التحقق النتيجة.
هل يضمن دعم MCP عمل كل بيئات استضافة المساعد؟
لا. سجل الدخول وافتح «الإعدادات»، ثم «التطبيقات والأتمتة»، ثم «ربط مساعدك» للاطلاع على تعليمات الإعداد وحالة الربط الحالية.
هل يمكن للتكامل تعديل منشور مجدول أو منشور سبق نشره؟
يمكن إعادة المنشور المجدول إلى المسودة لتعديله ومراجعته مجددا إذا لم يبدأ التسليم ولم يبق أي إرسال غير محسوم. لا يستطيع المساعد تعديل محتوى نشر بالفعل على شبكة أو حذفه.