# מדריך הגדרת SosoAPI כתובת URL קנונית: https://sosoapi.ai/he/docs/setup-guide חברו את סוכן ה-AI, קשרו חשבון חברתי והכינו את הפוסט הראשון שלכם. ## בחרו את נקודת ההתחלה שלכם SosoAPI מעניק לסוכן שכבר משמש אתכם חיבור אחד לחשבונות החברתיים. הסוכן עוזר לכתוב ולבדוק תוכן; SosoAPI מטפל בפעולות חשבון נתמכות, תזמון ותוצאות פרסום. אפשר לבדוק את אותם פוסטים באפליקציה או להשתמש ב-API מהקוד שלכם. המדריך מתחיל באדם אחד ובחשבון חברתי אחד. תחברו לקוח MCP מקומי או מתארח, תבחרו גישה, תבדקו חשבון חברתי, תכינו ותאשרו פוסט ותקראו את תוצאתו בפועל. ההדרכה המתקדמת מכסה CLI ו-HTTP API. ההגדרה עצמה אינה דורשת פוסט בדיקה. - [תנו ל-Claude Code או Codex לטפל בהגדרה: שלב 1](#1-give-your-agent-the-setup-request) - [הגדרת לקוח MCP בעצמכם: שלב 3](#3-connect-your-agent-manually-if-needed) - [השתמשו במסוף או בשרת: שלב 9](#9-cli-and-api-walkthrough) - [תיקון חיבור: שלב 10](#10-troubleshooting) ## לפני שמתחילים דרושים לקוח AI תואם MCP, חשבון SosoAPI וחשבון חברתי שאתם רשאים לנהל. אפשר ליצור חשבון SosoAPI כשנפתחת הכניסה. הכינו רעיון לפריט תוכן אמיתי אחד. MCP מקומי דורש Node.js 20 ואילך עם npm/npx ולקוח ה-AI שבחרתם. MCP מתארח דורש לקוח שתומך ב-MCP מרוחק, OAuth ורישום לקוחות אוטומטי; אינו דורש התקנת Node.js מקומית. יכולות הלקוח עשויות להיות תלויות בתוכנית ובהגדרות מנהל. SosoAPI מחבר את Instagram, Threads, Facebook Pages, YouTube ו-X. בחרו חשבון שהסוג, ההרשאות ופורמט הפוסט שלו תואמים למשימה. חשבון Threads מתאים הוא דוגמה ראשונה שימושית לטקסט בלבד. Instagram ו-YouTube דורשים מדיה מתאימה לפורמטי הפרסום הנתמכים. פלטפורמה בתפריט החיבור אינה מבטיחה שכל פעולה זמינה לכל חשבון. בדקו יכולות לפי חשבון בזמן ההגדרה. קראו את התוכנית והמכסה הנוכחיות באפליקציה לפני תזמון אצווה; ל-X מכסת קרדיטים נפרדת ברמת Organization. דוגמה מפלטפורמה אחת אינה מוכיחה תמיכה באחרת. - [פלטפורמות נתמכות](https://sosoapi.ai/he/docs/supported-platforms) - [יכולות פרסום ודרישות החשבון](https://sosoapi.ai/he/docs/publishing-capabilities) ## 1. תנו לסוכן את בקשת ההגדרה הדביקו זאת בשיחה הקיימת שלכם ב-Claude Code או Codex. הסוכן צריך לבדוק תחילה חיבור SosoAPI תקין ולהשתמש בו שוב. אחרת הוא פועל לפי הוראות ההגדרה ואומר מתי דרושים כניסה בדפדפן או הפעלת לקוח מחדש. תוצאה צפויה: כלי SosoAPI שימושיים בשיחה זו. הודעת התקנה לבדה אינה הוכחה. המשיכו בכניסה ובבדיקת חשבון, או השתמשו בשלב 3 לתצורה ידנית. > הגדירו את SosoAPI מתוך https://sosoapi.ai/setup.md. שמרו את התוכן והמשימה הנוכחיים שלי. אכנס ואאשר גישה כשאתבקש. אל תפרסמו דבר בזמן ההגדרה. ## 2. היכנסו ובחרו את הגישה של הסוכן שלכם השתמשו בחשבון המיועד: המשיכו עם Google או הירשמו בדוא״ל והשלימו אימות. השלימו כל הגדרת חשבון או Workspace שמוצגת. אם אתם חברים בכמה Workspaces, בחרו מותג או פרויקט מיועד. בדקו Workspaces ופעולות שהתבקשו לפני אישור, ואז חזרו לאותה שיחה. שמרו את קישור הכניסה שסיפק הסוכן כדי שהדפדפן יוכל לחזור להרשאה הממתינה. אפשר להתחיל קודם באפליקציה ואז לחזור לסוכן. אל תחליפו קישור אישור ממתין בקישור כניסה אחר. תפקידי Workspace והרשאות פלטפורמה עדיין חלים: צופה אינו נעשה עורך כי לסוכן גישת פרסום. גישת הפרסום מתמשכת בתחום שהענקתם; SosoAPI אינו דורש אישור דפדפן חדש לכל פוסט. אמרו לסוכן מתי לעצור לבדיקת תוכן. הגדרת OAuth רגילה אינה דורשת הדבקת סיסמת רשת חברתית או מפתח API לסוכן. תוצאה צפויה: הכניסה מושלמת בזהות המיועדת והסוכן יכול לאחזר את ה-Workspaces שאישרתם. השתמשו בפתרון תקלות אם נפתח פרופיל דפדפן שגוי. בחרו גישה למשימה | בחירת גישה | למה זה מיועד | | --- | --- | | קריאה, יצירה ועריכה | קריאת פרטי חשבון זמינים והכנת עבודה. | | תזמון ופרסום | שלחו ונהלו עבודת פרסום בתחום שנבחר. | | הרשאות נוספות | הפעילו רק לצורך מסוים. פרסום רגיל אינו דורש ניהול מפתחות API. | - [התחילו באפליקציית SosoAPI](https://app.sosoapi.ai/start?lang=en) ## 3. חברו את הסוכן ידנית, לפי הצורך בחרו שיטת חיבור אחת. דלגו על סעיף זה אם הסוכן כבר הגדיר חיבור תקין. ל-MCP מקומי, בדקו תחילה Node.js ו-npx. נדרשת Node.js בגרסה 20 ואילך. ``` node --version npx --version ``` ## MCP מקומי: Claude Code או Codex הפעילו רק את פקודת הלקוח שלכם: הראשונה ל-Claude Code והשנייה ל-Codex. פרופיל core מכסה פרסום יומיומי. פרופילים משנים אילו כלים מוצגים; הם אינם מעניקים הרשאות. שמרו חיבור full-profile תקין אם כבר יש לכם כזה. התחברו מחדש או הפעילו מחדש לפי בקשת הלקוח, ואז בדקו שכלי SosoAPI זמינים בשיחה הנוכחית. הקריאה המאומתת הראשונה מתחילה כניסה בדפדפן לפי הצורך. ``` claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` ``` codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` ## לקוחות MCP מקומיים אחרים ללקוחות שמשתמשים ב-mcpServers JSON, הוסיפו רשומה זו לתצורה הקיימת ושמרו על שרתים אחרים. בפורמטים אחרים יש להזין אותה פקודה, ארגומנטים ומשתנה סביבה דרך הגדרות MCP של הלקוח. ``` { "mcpServers": { "sosoapi": { "command": "npx", "args": [ "-y", "sosoapi" ], "env": { "SOSOAPI_TOOL_PROFILE": "core" } } } } ``` - [מדריך התקנה ואפשרויות חבילה](https://sosoapi.ai/he/docs/installation) ## MCP מתארח: לקוחות דפדפן או לקוחות מרוחקים תואמים בהגדרות מחבר מותאם או MCP מרוחק של הלקוח, הוסיפו חיבור בשם SosoAPI באמצעות כתובת השרת שלהלן. בחרו OAuth עם רישום לקוח אוטומטי כשהאפשרות מוצעת. היכנסו ל-SosoAPI, בחרו Workspaces ופעולות מותרות, חזרו לשיחה והפעילו את החיבור לפי הצורך. בקשו מהסוכן לבדוק חשבונות מורשים. השתמשו ב- https://sosoapi.ai לחיבור מתארח חדש. נקודת הקצה הישנה https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp נשאר נתמך. שמרו על חיבור מקומי או מתארח שעובד; אין צורך להחליפו רק כדי לשנות את כתובת ה-URL שלו. אין צורך להדביק מפתח API, מזהה לקוח או סוד לקוח. אפליקציות MCP מותאמות ב-ChatGPT תלויות בתוכנית הלקוח, מצב המפתחים והגדרות המנהל. ההוראות מתארות חיבור מותאם, לא רישום בספריית אפליקציות. MCP מתארח אינו קורא קבצים מקומיים; השתמשו בייבוא URL ציבורי או ב-MCP מקומי להעלאות מקומיות. ``` https://sosoapi.ai ``` - [רישום לקוח OAuth מותאם ומתכון לאסימון](https://sosoapi.ai/auth.md) ## בדיקת כניסה אופציונלית במסוף לחיבור מקומי, הפעילו קודם auth status. הפעילו auth login רק אם דווח שאינכם מחוברים. השלימו את התהליך בדפדפן ובדקו שוב מצב. אסימונים אינם מודפסים. זה בודק אימות CLI מקומי, לא כניסה למחבר מתארח נפרד. ``` npx -y sosoapi auth status ``` ``` npx -y sosoapi auth login ``` ## 4. חברו את החשבון החברתי שלכם פתחו חיבור חשבונות או השתמשו בפקודה המקומית שלהלן. החליפו threads ב-instagram, facebook, youtube או x לפי העניין. זה פותח את תהליך החיבור; לא מפרסם תוכן. בדקו את ה-Organization וה-Workspace המוצגות. בחרו פלטפורמה, היכנסו בדף ההרשאה שלה ובחרו את החשבון, ה-Page או הערוץ המדויק. השלימו הסכמה וכל אישור בחירת חשבון עם החזרה. אז בקשו מהסוכן לרענן את החשבונות המחוברים ל-Workspace המיועדת. השתמשו בחיבור קיים ותקין. אם הוא שייך ל-Organization או ל-Workspace אחרת, הסדירו את הבחירה באפליקציה; הגדרה שגרתית לא אמורה לנתק או להעביר אותו. התוצאה הצפויה: החשבון הנכון מופיע ב-Workspace המיועדת עם מידע עדכני על תקינות ויכולות. callback מוצלח לבדו אינו הוכחה להרשאת פרסום. בדקו את היעד המיועד | יעד | מה לבדוק | | --- | --- | | Threads | הפרופיל המיועד וההרשאה לפורמט הטקסט או המדיה המבוקש. | | Instagram | הגדרת חשבון מקצועי נתמכת והרשאת פרסום לפורמט המבוקש. | | Facebook | ה-Page שאתם מנהלים וההרשאות הנדרשות לאותו Page. | | YouTube | הערוץ המיועד, במיוחד כשחשבון Google אחד מנהל כמה ערוצים. | | X | יכולות הטקסט או הווידאו של החשבון וקרדיטי ה-X הנותרים של ה-Organization. | ``` npx -y sosoapi connect threads ``` - [חיבור חשבונות](https://app.sosoapi.ai/connect?lang=en) ## 5. אמתו גישה ללא פרסום הדביקו את הבא בשיחת הסוכן המחובר. הסוכן יכול להשתמש ב-sosoapi_get_workspace_context וב-sosoapi_list_connected_accounts, להשתמש שוב בהקשר ידוע ולהעביר במפורש את workspace_id שנבחר. אתחול החשבון עשוי ליצור את ה-Workspace הראשונה שלכם; בדיקת ההגדרה אינה יוצרת פוסט חברתי. לפני ההמשך, אשרו Workspace ויעד, תפקיד וגישת סוכן, ותמיכת היעד בפורמט המוצע. השתמשו בפתרון תקלות אם בדיקה נכשלת. התקנת חבילה מחדש אינה מתקנת הרשאת פלטפורמה חסרה. > בדקו את הגדרת SosoAPI שלי בלי לפרסם או לתזמן דבר. > הציגו את ה-Workspaces שבהם אוכל להשתמש ואת החשבונות החברתיים ב-Workspace שאבחר. > לחשבון שאבחר, הציגו את הפלטפורמה, תווית החשבון, תקינות החיבור ויכולות הפרסום לפורמט שאציע. > אם כמה Workspaces או חשבונות עשויים להתאים, שאלו אותי באיזה להשתמש. > שמרו מזהים פנימיים לקריאות כלים; אל תבקשו ממני למצוא או להמציא אותם. ## 6. הכינו ואשרו את הפוסט הראשון שלכם התחילו בפוסט אמיתי אחד וביעד אחד. החליפו את השדות שבסוגריים בהנחיית טיוטה זו. הסוכן כותב; SosoAPI מספק חיבור ופעולות פרסום. בדקו בעצמכם טענות, איות, קישורים ומדיה. השתמשו בתאריך, שעה מקומית ואזור זמן IANA מפורשים לפוסט עתידי. אם שעון קיץ יוצר שעה מקומית דו-משמעית, בחרו את המופע הרצוי לפני השליחה. התוצאה הצפויה בשלב זה: טיוטה מדויקת לבדיקה, ללא בקשת פרסום שנשלחה. > עזרו לי להכין הודעת מוצר אחת באמצעות SosoAPI. > > מוצר: [שם מוצר ציבורי] > עובדות מאומתות: [מה זמין כיום] > קהל: [למי זה עוזר] > יעד: [תווית חשבון ופלטפורמה] > שפה: [שפה] > תאריך ושעה מקומיים מועדפים: [YYYY-MM-DD HH:mm] > אזור זמן: [אזור IANA, למשל Asia/Hong_Kong] > מדיה: [ללא, קובץ מקומי או URL ציבורי למדיה] > > השתמשו רק בעובדות שסיפקתי. בדקו את דרישות הפורמט של היעד. > הציגו לבדיקה את הטיוטה, המדיה, היעד, התאריך, השעה ואזור הזמן המדויקים. > עדיין אל תתזמנו ואל תפרסמו. ## אשרו את הפוסט המדויק לפני תזמון כשכל הפרטים נכונים, תנו הוראה מסוימת באמצעות ההנחיה שלהלן. היא יוצרת תזמון אמיתי שיכול להתפרסם בפומבי. השתמשו בתוכן ובחשבון שברצונכם לפרסם אליו. גם פרסום מיידי דורש הוראה מפורשת לאחר בדיקת אותם פרטים. תוצאה צפויה: מזהה Scheduled Post, יעד מיועד, מועד שהתקבל ומצב נוכחי. תזמון שהתקבל אינו אומר שהפלטפורמה פרסמה אותו. > תזמנו את הפוסט המדויק שאושר להלן לחשבון הנקוב בתאריך, בשעה ובאזור הזמן המצוינים. > > [הדביקו את התוכן הסופי, המדיה, היעד, התאריך, השעה ואזור הזמן.] > > בדקו תחילה אם קיים תזמון תואם. שלחו את הפוסט פעם אחת וקראו את התוצאה השמורה. החזירו את המזהה, היעד, המועד שהתקבל והמצב הנוכחי. אם התוצאה אינה ודאית, בדקו את הבקשה הקיימת לפני פעולה נוספת. ## 7. בדקו תוצאה, תזמנו מחדש או בטלו בקשו מהסוכן לקרוא את אותו Scheduled Post באמצעות sosoapi_get_scheduled_post. אפשר גם לפתוח https://app.sosoapi.ai/scheduled-posts/ לאחר כניסה בחשבון מורשה. בדקו כל יעד בנפרד כשהבקשה פונה לכמה חשבונות; חלקם יכולים להצליח ואחרים לדרוש טיפול. > קראו את התוצאה הנוכחית של Scheduled Post [המזהה שהוחזר]. > הציגו את היעד, מועד התזמון, המצב הנוכחי ותוצאת הפרסום. > אם הפרסום אושר, הוסיפו את הקישור החי כשזמין. > אל תנסו שוב, אל תתזמנו מחדש ואל תיצרו פוסט נוסף. הבינו את התוצאה השמורה | תוצאה | משמעות | השלב הבא | | --- | --- | --- | | מתוזמן | התקבל למועד עתידי. | שמרו את המזהה ובדקו לאחר המועד. | | בהכנה, בפרסום או בבירור מצב | העבודה מתבצעת או שתוצאת הפלטפורמה הסופית אינה ידועה. | קראו את אותו פוסט בהמשך; הימנעו משליחה נוספת. | | פורסם | ראיות מהפלטפורמה מאשרות את הפרסום. | פתחו את ה-permalink שהוחזר כשזמין. | | נכשל או דורש טיפול | נדרש תיקון מסוים או פעולה מותרת. | קראו את הסיבה ואת הפעולות הזמינות. | | נדרש תזמון מחדש או שפג התוקף | התזמון המקורי אינו יכול להתקדם כבקשתכם. | קראו את ההסבר ובחרו פעולה זמינה. | | בוטל | הביטול מאושר. | אל תצפו שתזמון זה יתפרסם. | ## נהלו פוסט ממתין וחזרו בהמשך לשינוי פוסט ממתין, ספקו את המזהה שלו ואת הפרטים החדשים. הסוכן חייב לקרוא את הגרסה הנוכחית והפעולות הזמינות לפני עדכון או ביטול נתמכים. הביטול תלוי בשלב המסירה ועלול לא להיות זמין לאחר תחילתה. ביטול תזמון אינו מסיר פוסט שכבר פורסם אצל הפלטפורמה. לאחר קבלת הפרטים השמורים לתזמון עתידי, אפשר לעזוב את השיחה ולחזור לאותו פוסט בהמשך. שיחת סוכן סגורה אינה מבטיחה להתעורר או להודיע לכם אלא אם הדבר הוגדר בנפרד. ## 8. הוסיפו תמונות או וידאו, ואז השתמשו שוב בתהליך הפעילו בהצלחה את תהליך הפוסט היחיד לפני הכנת אצווה גדולה. אמרו לסוכן אם המדיה היא קובץ מקומי, URL ציבורי או נכס קיים ב-SosoAPI. קבצים מקומיים: MCP מקומי יכול להשתמש ב-sosoapi_upload_asset. הקובץ חייב להיות בתיקיית העלאה מותרת; הכלי מסביר אילו מיקומים מותרים כשנתיב חורג מהתחום. MCP מתארח אינו יכול לקרוא קבצים במחשב שלכם. כתובות URL ציבוריות: השתמשו ב-sosoapi_import_asset_url, ואז ב-sosoapi_get_asset_import_status עם include_asset=true. המתינו עד שהנכס מוכן. לנכס קיים, ודאו שהוא שייך ל-Workspace המיועדת ומוכן לפורמט שנבחר. בקשת התזמון הרגילה משתמשת יחד במזהה הנכס הרשום ובכתובת URL הקנונית שלו. כתובת תצוגה מקדימה זמנית או כתובת המקור החיצוני אינן תחליף. בתהליך הנתמך של כתובת תמונה אחת, sosoapi_post_image_url משלב ייבוא ושליחה. זו פעולת פרסום: אשרו קודם את הפוסט המלא. שמרו את מזהה הפוסט שהתקבל בזמן העיבוד; אל תתחילו ייבוא נוסף כדי להמשיך אותו. X תומך בפוסט TEXT מקורי ללא מדיה, או VIDEO עם נכס וידאו MP4 רשום ומוכן אחד בדיוק, באורך של לפחות 0.5 שניות ובמגבלת העלאה של 500 MiB. וידאו דורש can_publish_video מאומת לחשבון המדויק; גישה לטקסט בלבד אינה מספיקה. חיבור ישן עשוי לדרוש את אישורכם לחיבור מחדש עם הרשאת העלאת וידאו. טקסט, תגיות וקישור חייבים לעמוד במגבלת הטקסט המשוקלל של X. תמונות, תשובות, ציטוטים, שיתופים מחדש ושרשורים אינם נתמכים. קבלת העלאה או עיבוד וידאו אינה תוצאת פרסום. לפני שליחה ל-X, קראו sosoapi_get_x_usage עבור workspace_id המיועדת והטקסט הסופי. המכסה והעלות שלו נפרדות ממכסת התוכנית הכללית. אל תעקפו מגבלת קרדיטים בשליחות חוזרות; בררו פרסום לא ודאי לפני שליחה נוספת. ## הכינו אצווה שנבדקה וקראו ביצועים בכנות אחרי הפוסט המוצלח הראשון, נסו את הנחיית השקת המוצר שלהלן. לאחר אישור הטבלה המדויקת, בדקו את האצווה מול מגבלות התוכנית. דווחו בנפרד על יעדים שהתקבלו ושנדחו ושמרו את הזהות של כל פוסט שהתקבל. גישה לפרסום וגישה לניתוח נתונים עשויות להיות שונות. אם תבקשו בהמשך סקירת ביצועים, יש לדווח שמדדים לא זמינים אינם זמינים. אל תמציאו אפסים ואל תניחו שכל מדד ניתן לקריאה כי פוסט פורסם. > באמצעות אותה הגדרה מאומתת, הכינו שבע טיוטות הודעת מוצר, אחת ליום, מהעובדות הציבוריות שאספק. הציגו טבלת בדיקה עם טיוטה, יעד, מדיה, תאריך מקומי, שעה ואזור זמן בכל שורה. השאירו את כל השבע כטיוטות עד שאאשר את הטבלה המדויקת. ## 9. הדרכת CLI ו-API השתמשו במסלול אופציונלי זה לקובצי בקשות מפורשים או לאינטגרציית שרת. משתמשי סוכן יכולים לדלג עליו. הדוגמאות משתמשות באותם חשבון, Workspace והרשאות פרסום כמו MCP. בדקו תחילה את עזרת החבילה המותקנת ואת החוזה המוטמע; בדיקת חוזה אינה דורשת כניסה. הוא מציג פעולות וסכימות שנשלחו עם החבילה. השתמשו בשמות שדות אלה במקום בפורמט בקשה של ספק אחר. ``` npx -y sosoapi --help npx -y sosoapi api contract --summary npx -y sosoapi api contract --route /studio-api/scheduled-posts/ ``` ## CLI: בצעו בקשת הקשר מאומתת ראשונה השלימו auth login. בעורך טקסט שמרו workspaces.json המכיל את ה-JSON שלהלן, ואז הפעילו את הפקודה. השתמשו בקבצים לגופי בקשות במקום לשלב תוכן בפקודות מעטפת. CLI מחזיר schema_version, http_status ו-body. תשובה מוצלחת כוללת body.active_workspace_id ו-body.workspaces. בחרו את ה-Workspace המיועדת מהתשובה; ה-Workspace הפעילה אינה קובעת בשקט את יעדה של משימה חדשה. קריאה ראשונה בחשבון חדש עשויה לאתחל את ה-Workspace הראשונה שלו. בדקו http_status ו-body, לא רק את קוד היציאה מהמעטפת. פקודה יכולה להחזיר מעטפת שגיאת HTTP בלי שפעולת API הצליחה. ``` {} ``` ``` npx -y sosoapi api post /identity-api/workspace/list < workspaces.json ``` ## CLI: בחרו את החשבון החברתי המחובר שמרו את accounts.json עם מזהה ה-Workspace שהוחזר לחשבון שלכם, ואז הפעילו את הפקודה. בחרו את החשבון המיועד מתוך body.accounts. מזהה החשבון שלו ב-SosoAPI הוא social_account_id המשמש לתזמון; שם משתמש או מזהה Page של הפלטפורמה אינם תחליף. ``` { "workspace_id": "" } ``` ``` npx -y sosoapi api post /identity-api/user/social-accounts/list < accounts.json ``` ## CLI: צרו תזמון טקסט מאושר אחד ב-Threads זו תבנית בקשה, לא פוסט מוכן להרצה. שמרו post.json בעורך קבצים והחליפו כל ערך בסוגריים בערכים מורשים משלכם. בחרו חותמת זמן ISO עתידית עם היסט UTC מפורש, או Z עבור UTC. display_timezone הוא אזור זמן IANA לתצוגה; הוא אינו משלים חותמת זמן מקומית דו-משמעית. צרו idempotency_key ייחודי, למשל UUID, ושמרו אותו עם גוף הבקשה המדויק. נסו שוב בקשה זהה עם אותו מפתח; תשובה שמתעכבת אינה סיבה ליצור מפתח נוסף. פוסט ששונה הוא בקשה אחרת: בדקו את התוצאה המקורית לפני בחירת זהות חדשה. לאחר אישור התוכן, החשבון, המועד, ההרשאות והמכסה הנוכחית, הפעילו את פקודת היצירה. היא מתזמנת פוסט אמיתי. עם קבלת הבקשה, שמרו את body.post.id וקראו את body.post.status, body.post.scheduled_at ו-body.post.destination. השדה body.deduped מציין אם נעשה שימוש חוזר בבקשה קיימת. קבלה אינה אישור פרסום מהפלטפורמה. ``` { "workspace_id": "", "social_account_id": "", "caption": "", "hashtags": [], "media": [], "provider_payload": { "platform": "threads", "publish_options": { "post_type": "TEXT" } }, "scheduled_at": "", "display_timezone": "Asia/Hong_Kong", "idempotency_key": "" } ``` ``` npx -y sosoapi api post /studio-api/scheduled-posts/create < post.json ``` ## CLI: קראו את הפוסט השמור ואת תוצאתו שמרו post-status.json עם המזהה שהוחזר. קראו body.post, body.delivery, body.actions ו-body.outcomes. אשרו תוצאת פרסום לפני דיווח הצלחה. אם תשובת היצירה אבדה, שחזרו את הבקשה המקורית בזהותה השמורה; אל תיצרו תזמון נוסף במפתח חדש. ``` { "id": "" } ``` ``` npx -y sosoapi api post /studio-api/scheduled-posts/get < post-status.json ``` ## CLI: בטלו רק כשהתוצאה הנוכחית מתירה זאת אם הקריאה האחרונה מתירה ביטול וברצונכם לבטל, שמרו cancel.json עם המזהה שהוחזר וערך body.post.version המספרי הנוכחי. הדוגמה 1 להמחשה: החליפו אותה בגרסה שקראתם כעת. הפעילו אז את הפקודה ואשרו תוצאה. אם הגרסה השתנתה או שהביטול אינו זמין, קראו שוב את אותו פוסט והשתמשו בפעולות הזמינות בפועל. אל תעקפו התנגשות גרסאות ואל תבלבלו בין ביטול למחיקת פוסט שכבר פורסם. ``` { "id": "", "expected_version": 1 } ``` ``` npx -y sosoapi api post /studio-api/scheduled-posts/cancel < cancel.json ``` ## HTTP: קראו מהשרת שלכם לאינטגרציה בצד השרת, צרו מפתח API תחת Connection → API ושמרו את הסוד בתצורת הסודות בשרת. המסך הנוכחי מבקש שם; אין בו בחירת Workspace או יכולות. מפתח שיצר משתמש מקבל כברירת מחדל operate, publish ו-engage בכל ה-Workspaces שהמשתמש יכול לגשת אליהן. בדקו אם סמכות זו מתאימה לאינטגרציה. חוזה ה-API תומך ביכולות מוגבלות במפורש וב-workspace_ids למפתח בעל תחום מוגבל. הגדרת סוכן רגילה משתמשת ב-OAuth ואינה דורשת שלב מפתח API זה. בדוגמה, SOSOAPI_ACCESS_TOKEN הוא משתנה דוגמה בצד השרת שמכיל את המפתח; זו אינה הגדרת SosoAPI CLI. משתנה אסימון הגישה האישי האופציונלי של CLI הוא VICKY_API_KEY. השתמשו בקובץ workspaces.json שלעיל. HTTP ישיר מחזיר את גוף נקודת הקצה בלי מעטפת http_status/body של CLI; קראו את סטטוס HTTP וה-JSON בפועל. שמרו אישורי גישה בשרת ולא בקוד דפדפן, הנחיות, צילומי מסך או קובצי בקשות משותפים. הטמעת חיבור חברתי במוצר ללקוחות שלכם היא משימת אינטגרציה נפרדת. הדרכה לחשבון יחיד זו אינה מוכיחה שתהליך קליטת הלקוחות מוכן. ``` curl --fail-with-body --silent --show-error \ -H "Authorization: Bearer ${SOSOAPI_ACCESS_TOKEN}" \ -H 'Content-Type: application/json' \ --data-binary @workspaces.json \ 'https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/workspace/list' ``` - [ניהול מפתחות API: Connection → API](https://app.sosoapi.ai/connection/api?lang=en) - [תיעוד API](https://sosoapi.ai/he/docs/api) - [יצירת מפתח API וסמכות מפורשת](https://sosoapi.ai/he/docs/api/identity-api-api-keys-create) - [אימות והרשאות](https://sosoapi.ai/he/docs/authentication) - [תיעוד CLI](https://sosoapi.ai/he/docs/cli-reference) ## 10. פתרון תקלות השתמשו בשגיאה בפועל ובחיבור שאתם מאבחנים. הרחבת הרשאות או שליחה חוזרת אינן מתקנות כל כישלון. שחזור בלי לאבד את הבקשה המקורית | תסמין | מה לבדוק או לעשות | | --- | --- | | node או npx אינם זמינים | התקינו סביבת Node.js נתמכת ל-MCP מקומי, או השתמשו ב-MCP מתארח תואם. | | נראה ש-npx sosoapi ממתין לנצח | ללא פקודה, זהו שרת stdio MCP שממתין ללקוח שלו. השתמשו באפשרות --help להוראות במסוף. | | מותקן, אך אין כלים בשיחה | חברו מחדש או הפעילו מחדש את הלקוח בפועל והפעילו SosoAPI בשיחה הנוכחית. | | הכניסה פותחת פרופיל דפדפן שגוי | עצרו את הכניסה המקומית הממתינה שלכם. ודאו שקיים --no-open באמצעות --help, ואז הפעילו npx -y sosoapi auth login --no-open. פתחו את הקישור החדש בפרופיל המיועד ואמתו זהות לפני הסכמה. אל תפעילו שני פרופילים במקביל על קישור אחד. | | יציאה 8789 תפוסה | בדקו באמצעות lsof -nP -iTCP:8789 -sTCP:LISTEN. עצרו מאזין רק אם הוא תהליך הכניסה הממתין שלכם. | | אימות דוא״ל או כניסה נכשלים | קראו את השגיאה בפועל והשתמשו בניסיון החוזר המוצע. כניסה בדוא״ל משתמשת באימות ברקע, ללא תיבת CAPTCHA שצריך למצוא. המשך באמצעות Google הוא אפשרות נוספת. | | תגובת 401 | בדקו כניסה ותוקף אישורי גישה לחיבור זה. auth status מקומי אינו בודק מחבר מתארח. | | 403 או פעולת פרסום חסרה | בדקו את ה-Workspace הנבחרת, התפקיד והיכולת שהוענקה. בקשו מהבעלים גישה נחוצה לפי העניין. | | החשבון החברתי הצפוי חסר | בדקו זהות, Workspace ובחירת חשבון הפלטפורמה. השלימו כל אישור חיבור ממתין. | | מחובר, אך פרסום אינו זמין | קראו את יכולות החשבון המדויק ואת דרישות הפלטפורמה. התחברו מחדש רק כשנדרשת באמת הסכמה חדשה לפלטפורמה; גישה לווידאו עשויה להיות שונה מגישה לטקסט. | | נתיב ההעלאה מחוץ לתיקיות המותרות | השתמשו בתיקייה מותרת או הגדירו במכוון SOSOAPI_UPLOAD_ROOTS בסביבת MCP המקומית. | | ייבוא המדיה עדיין ממתין | בדקו את הייבוא הקיים ואת מזהה המשימה. דווחו על שגיאת הביצוע או התצורה במקום ליצור ייבואים כפולים. | | המכסה או קרדיטי X אזלו | קראו את המכסה הרלוונטית ובחרו פעולת תזמון או תוכנית מותרת. שליחות חוזרות אינן מסירות את המגבלה. | | בקשת יצירה חורגת מהזמן | שמרו את מפתח הבקשה ואת מזהה הפוסט שהתקבל, אם ידוע. קראו או שחזרו את הבקשה המקורית לפני ניסיון חוזר; ניסיון זהה שומר על אותו מפתח. | | התנגשות גרסאות בעדכון או בביטול | קראו שוב את אותו פוסט, בדקו פעולות זמינות והשתמשו בגרסה הנוכחית רק לפעולה המיועדת. | | שגיאת סכימה או אי-התאמה בין גרסאות | עדכנו את החבילה שלקוח MCP מריץ בפועל, התחברו מחדש ובדקו את החוזה. הרשאות נוספות אינן מתקנות חוסר התאמה בסכימה. | ## עדכנו, בטלו גישה או בקשו עזרה הפקודה הראשונה להלן בודקת את עזרת החבילה העדכנית בלי להפעיל את שרת MCP. אם הלקוח מצמיד גרסה בפקודה השמורה שלו, עדכנו את אותה פקודה במכוון. עדכון התקנה גלובלית נפרדת אינו מעדכן את העותק המוצמד של הלקוח. לביטול מכשיר מקומי, השתמשו ב-Connection → Agent או בפקודת auth logout להלן. למחבר מתארח, בטלו את ההרשאה המתארחת המתאימה תחת Connection → Agent. מפתחות API מנוהלים בנפרד תחת Connection → API. ביטול גישת סוכן אינו מבטל תזמונים שכבר התקבלו; נהלו פוסטים אלה בנפרד. לעזרה, ספקו לקוח וגרסת חבילה, שלב שנכשל, השגיאה שהוצגה ושעה/אזור זמן. שתפו מזהי בקשות או פוסטים רלוונטיים באופן פרטי עם התמיכה לפי הצורך. אל תשלחו אישורי גישה, קישורי הרשאה או יומנים גולמיים שעלולים להכיל אסימונים. ``` npx -y sosoapi@latest --help ``` ``` npx -y sosoapi auth logout ``` - [ניהול לקוחות סוכן: Connection → Agent](https://app.sosoapi.ai/connection/agent?lang=en) - [ניהול מפתחות API: Connection → API](https://app.sosoapi.ai/connection/api?lang=en) - [מדריך פתרון תקלות](https://sosoapi.ai/he/docs/troubleshooting) - [פנייה לתמיכת SosoAPI](mailto:vickyai.tech@gmail.com) ## רשימת השלמת ההגדרה אפשר להשלים הגדרת חיבור בלי לשלוח פוסט. אם תפרסמו, השתמשו בבדיקת התוצאה הנפרדת לאישור תהליך הפרסום הראשון. - הלקוח שלי יכול להשתמש בכלי SosoAPI, או ה-CLI/API שלי יכול לבצע בקשה מורשית. - נכנסתי עם החשבון המיועד ובחרתי את ה-Workspace הנכונה. - החשבון החברתי שלי מופיע עם היכולות הנדרשות למשימה. - אני מבין אם הסוכן יכול להכין עבודה או גם לתזמן ולפרסם. - אני יכול להכין טיוטה ולבדוק את היעד, התוכן והמועד המדויקים. - אם שלחתי פוסט, שמרתי את המזהה שלו ואני יכול להבחין בין קבלה לפרסום מאושר. - אני יודע כיצד לבדוק כישלון, לנהל תזמון ממתין ולבטל גישה.