חברו את הכלים שלכם למערכת הפרסום של Influence
השתמשו ב־API ובכלי MCP של Influence לשמירת טיוטות, לבדיקת פוסטים ולתזמון פרסום שאושר. אפשר לקבל את החשבונות המחוברים ולבדוק תוצאות פרסום שתועדו באמצעות אותם כלים.
פרטי גישה, אישור ומצב המסירה
הגבילו גישה באמצעות פרטי גישה בעלי הרשאות מוגדרות
אשרו את פעולת הפרסום המדויקת
בדקו את מצב המסירה
קריאת פרטי החשבונות המחוברים שלכם באמצעות MCP
דוגמת Node.js הזו מתחברת ל-Influence ומציגה את החשבונות החברתיים בסביבת העבודה שלכם. היא קוראת פרטי חשבונות בלי ליצור טיוטה או לפרסם פוסט.
1. צרו מפתח עם הרשאת קריאה
ב״הגדרות״, פתחו את אפליקציות ואוטומציות → כלים למפתחים. בחרו קריאת ערוצים מחוברים (integrations:read), בטלו את כל שאר ההרשאות ואז צרו את מפתח ה-API. שמרו את המפתח במאגר הסודות המקומי שלכם או במשתנה סביבה בשם INFLUENCE_API_TOKEN. המפתח מוצג פעם אחת; אל תשמרו אותו בקובצי מקור ואל תכניסו אותו לשיחות.
פתחו את הגדרות מפתחות ה-API2. הריצו את הדוגמה
כש-Node.js ו-npm מותקנים, התקינו בפרויקט שלכם את ה-SDK של MCP. שמרו את הקוד שלמטה בשם accounts.mjs, ואז הריצו node accounts.mjs בסביבה שבה INFLUENCE_API_TOKEN מוגדר. ה-SDK מטפל בחיבור ה-MCP ובאתחול.
npm install @modelcontextprotocol/client@2.3.1accounts.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עוזר נתמך מגלה כלים ופועל לפי אותו תהליך בדיקה.
1. הכינו טיוטה
קראו ל-campaignDraftSave עם חשבונות ומדיה מסביבת העבודה. שמרו את הגרסה ואת פרטי הזיהוי של הבקשה כדי לשחזר תשובה שנקטעה. פעולות כתיבה של טיוטות מחייבות אישור מהשרת.
2. הכינו את הבדיקה
קראו ל-campaignReview עבור הגרסה השמורה והפעולה. הציגו את החשבונות, התוכן, המדיה, ההגדרות, המועד ומועד פקיעת התוקף לפני שתבקשו אישור.
3. בצעו את הפעולה שאושרה
campaignReviewExecute מחייב אישור של הבדיקה הזו בדיוק. לפוסטים טקסטואליים נדרשת תשובת אישור חדשה לאחר הצגת פרטי הבדיקה המלאים; למדיה נדרש אישור לאחר צפייה בה. השרת מעביר את הפעולה למתזמן עמיד במקום לפנות ישירות לספק.
4. קראו את התוצאה לפני ניסיון חוזר
קראו את המצב של כל חשבון ואת קישור הפרסום, כשהוא זמין. שליחה שתוצאתה אינה ודאית נשארת במצב ״נדרשת בדיקה״ עד שתוצאתה מתבררת. שחזרו את מצב הבקשה הקיימת לפני יצירת פוסט נוסף, אחרת אתם עלולים לשלוח אותו פעמיים.
בחרו את החיבור המתאים לכלי שלכם
| חיבור | למה הוא משמש | גישה |
|---|---|---|
| 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 Direct, מסרו בשיחה את בחירות הפרסום ואת הסכמתכם, ואז אשרו את הבדיקה המעודכנת. כרטיס בדיקה הוא אפשרות, לא חובה. להגדרה ולבדיקת מצב החיבור, פתחו את ״הגדרות״.
פרסמו לחשבונות המחוברים שלכם
בחרו חשבונות שזמינים לסביבת העבודה שלכם. ערכו לכל יעד את הטקסט ואת המדיה הנתמכת, ואז בדקו את הפוסטים לפני הפרסום.
הכינו את הפוסטים הבאים שלכם
הוסיפו את החשבונות שלכם, הכינו את הפוסטים ובחרו את התאריכים שלהם. בדקו את התוכן לפני התזמון.
מתחיליםשאלות נפוצות
- מה אפשר לעשות בתהליך עבודה עם API ו־MCP?
- בהתאם לכלים שהופעלו ולהרשאות שלכם, לקוח API או MCP יכול לעבוד עם חשבונות מחוברים, טיוטות שמורות, מדיה מהסוגים הנתמכים, בדיקות פוסטים, תזמון ומצב המסירה.
- קריאות API או MCP עוקפות את האישור?
- לא. השרת אוכף את דרישות האישור של כל כלי. פרסום מחייב אישור של הבדיקה הנוכחית. לפני תזמון המסירה, הביצוע בודק את סביבת העבודה, ההרשאות, החשבונות והתוכן.
- אילו סוגי מדיה מתקבלים בתהליך העבודה עם העוזר?
- בקשו מהעוזר להעלות תמונות וסרטונים שיש לו גישה אליהם, או להשתמש שוב במדיה מוכנה מ־Influence. אם אין לו גישה לקובץ, העלו אותו קודם ל־Influence. בדקו את החשבונות המדויקים, הטקסט, המדיה, ההגדרות והמועד. לאחר הצגת הבדיקה המלאה, אשרו בכרטיס נתמך בצ׳אט או בתשובה חדשה של ״מאושר״. ב־TikTok Direct ציינו בצ׳אט את אפשרויות הפרסום הרצויות ותנו הסכמה, ואז אשרו את הבדיקה המעודכנת. כרטיס בדיקה הוא אפשרות, לא חובה.
- איך מטפלים בתגובה שאבדה או בשליחה שתוצאתה אינה ודאית?
- שחזרו את תוצאת הבקשה המקורית ובדקו את המצב שתועד. אל תחזרו על שליחה שתוצאתה אינה ברורה. מצב ״נדרשת בדיקה״ נשאר פתוח עד שבירור ואימות התוצאה מוכיחים מה קרה.
- תמיכה ב־MCP מבטיחה שכל יישום מארח לעוזר יעבוד?
- לא. היכנסו לחשבון ופתחו הגדרות ← אפליקציות ואוטומציות ← חיבור העוזר שלכם כדי לבדוק הוראות הגדרה ואת מצב החיבור הנוכחי.
- אינטגרציה יכולה לערוך פוסט מתוזמן או פוסט שפורסם?
- פוסט מתוזמן יכול לחזור לטיוטה לצורך עריכה ובדיקה נוספת, אם המסירה עדיין לא התחילה ואין שליחה שתוצאתה טרם הובהרה. העוזר אינו יכול לערוך או למחוק תוכן שכבר פורסם ברשת.