דוח לקוח שבועי שהסוכן כותב לבד: לחיצות לכל חשבון, תקלות ומה עושים הלאה

סוכן יכול להכין דוח שבועי ללקוח בתוך כמה דקות, משלוש קריאות לְשַׁגֵּר: get_analytics ללחיצות לכל חשבון ולכל פוסט, list_posts כדי לדעת מה יצא, וget_post כדי להבין מה נכשל. מה שהסוכן לא יכול לעשות לבד הוא להמציא לידים. לחיצות הן לא פניות, והדוח צריך להגיד את זה במפורש.

בסוכנויות שאני מכיר, הדוח השבועי הוא המשימה שכולם דוחים ליום חמישי בערב. זו גם המשימה שהכי קל להעביר לסוכן, כי היא חוזרת על עצמה, הנתונים מובנים, והתבנית קבועה.

אילו נתונים שַׁגֵּר נותן לסוכן?

get_analytics מקבל workspace_id ושני מועדים, from וto, בפורמט ISO 8601. בלי from ברירת המחדל היא שלושים ימים אחורה. התשובה כוללת את סך הלחיצות בתקופה, פירוק לפי חשבון (מזהה, שם החשבון, רשת ומספר לחיצות), ופירוק לפי פוסט. הלחיצות נספרות על הקישורים המקוצרים של שַׁגֵּר, וכל חשבון מקבל קישור משלו, כך שהפירוק לפי חשבון הוא מדויק ולא הערכה. לחיצות שזוהו כבוטים לא נספרות.

get_analytics {
  "workspace_id": "ws_hotel_chain",
  "from": "2026-09-13T00:00:00+03:00",
  "to": "2026-09-19T23:59:59+03:00"
}

ובגרסת REST:

curl "https://app.shager.ai/api/v1/workspaces/ws_hotel_chain/analytics?from=2026-09-13T00:00:00%2B03:00&to=2026-09-19T23:59:59%2B03:00" \
  -H "Authorization: Bearer $SHAGER_API_KEY"

שימו לב לקידוד של הסימן + בכתובת. בלי %2B השרת יקבל רווח, והמועד לא יעבור בדיקה. זו טעות שסוכנים עושים לעיתים קרובות כשהם בונים כתובות בעצמם.

list_posts מחזיר את הפוסטים בסביבת העבודה, החדשים קודם, ואפשר לסנן לפי status. לדוח שבועי מעניינים שלושה מצבים: PUBLISHED, PARTIALLY_PUBLISHED וFAILED. לכל פוסט הוא מחזיר תחילת כיתוב, מועד מתוזמן ומספר חשבונות. get_post מחזיר את המצב של כל חשבון, כולל קישור חי או הודעת שגיאה.

כל הקריאות האלה דורשות רק הרשאת read. לכן לסוכן דוחות כדאי לתת מפתח נפרד עם read בלבד. הוא לא צריך יותר, ואם המפתח ידלוף, אף אחד לא יפרסם איתו כלום. איך עושים את זה מוסבר במאמר על מפתחות והרשאות.

רצף הקריאות של הדוח

1. list_workspaces כדי לקבל את מזהה סביבת העבודה של הלקוח.
2. get_analytics לשבוע הנוכחי.
3. get_analytics לשבוע הקודם, כדי שתהיה נקודת השוואה.
4. list_posts עם status של PUBLISHED, ואז עם PARTIALLY_PUBLISHED וFAILED.
5. get_post לכל פוסט חלקי או כושל, כדי להבין איזה חשבון נכשל ולמה.
6. list_channels כדי לזהות חשבונות שדורשים חיבור מחדש.

שש קריאות לסביבת עבודה אחת, פלוס קריאה לכל פוסט כושל. גם סוכנות עם עשרים לקוחות רחוקה מאוד ממגבלת 120 הבקשות לדקה למפתח.

מה הופך לחיצות ללידים?

כאן רוב הדוחות האוטומטיים נשברים. שַׁגֵּר יודע כמה אנשים לחצו על הקישור של כל חשבון. הוא לא יודע מי מילא טופס, כי זה קורה באתר של הלקוח. החיבור נעשה דרך utm_content: כל קישור מקוצר של שַׁגֵּר מוביל ליעד עם תגיות UTM, ובutm_content יש מזהה של החשבון. אם בטופס של הלקוח יש שדות נסתרים שקולטים את התגיות ושומרים אותן במערכת CRM, אפשר לספור לידים לכל חשבון.

אם יש לסוכן גישה לייצוא ממערכת CRM, למשל קובץ CSV שבועי, הוא יכול לחבר את שני המקורות לפי utm_content ולהוסיף עמודת לידים לדוח. אם אין, הדוח מציג לחיצות ואומר בבירור שהלידים לא נמדדו. ההסבר המלא על השכבות האלה נמצא במאמר על שיוך לידים לכל חשבון, וההרחבה לעבודה עם סוכן במדידת לידים מתוכן של סוכנים.

תבנית הדוח

זו התבנית שאני נותן לסוכן. היא קצרה בכוונה. לקוח קורא את החצי הראשון ואת השורה האחרונה.

דוח שבועי: {שם הלקוח}, {תאריך התחלה} עד {תאריך סיום}

בשורה אחת:
{משפט אחד: מה יצא השבוע ומה בלט, עם מספר אחד}

מה פורסם:
{מספר פוסטים} פוסטים ל{מספר חשבונות} חשבונות. {מספר} פורסמו במלואם, {מספר} חלקית.

איפה לחצו:
| חשבון | רשת | לחיצות השבוע | לחיצות שבוע שעבר |
{חמש השורות הגבוהות}

חשבונות בלי לחיצות:
{רשימה, או "אין"}

תקלות:
{חשבון, מה קרה, מה נעשה. אם צריך פעולה מהלקוח, כתוב בדיוק מה}

לשבוע הבא:
{המלצה אחת או שתיים, רק אם יש להן בסיס בנתונים}

הפרומפט שמפעיל את הדוח

אתה מכין דוח שבועי ללקוח "מלונות הים" מנתוני שגר.
סביבת עבודה: "מלונות הים". השבוע: 2026-09-13 עד 2026-09-19, אזור זמן Asia/Jerusalem.

1. הרץ get_analytics לשבוע הזה ולשבוע שלפניו.
2. הרץ list_posts לפי הסטטוסים PUBLISHED, PARTIALLY_PUBLISHED ו FAILED.
3. לכל פוסט שאינו PUBLISHED הרץ get_post ורשום את החשבונות שנכשלו ואת הודעת השגיאה.
4. הרץ list_channels וסמן חשבונות שדורשים חיבור מחדש.
5. מלא את התבנית המצורפת. עד 250 מילים.

כללים:
לחיצות אינן לידים. אל תכתוב "לידים" אם אין לך קובץ CRM.
אל תסביר ירידה או עלייה בלי נתון שתומך בהסבר. "לא ברור מהנתונים" היא תשובה לגיטימית.
שמות חשבונות כפי שהם מופיעים בשגר.
אם חשבון דורש חיבור מחדש, הצע לשלוח ללקוח קישור חיבור, אבל אל תיצור אותו בלי אישור.

הכלל השני חשוב יותר ממה שנראה. מודלים נוטים לספק הסברים משכנעים לכל תנודה ("הירידה נובעת מהחג"). לפעמים זה נכון, ולפעמים זו המצאה. לקוח שתפס את הסוכנות פעם אחת על הסבר מומצא יפסיק להאמין לדוחות.

איך מטפלים בתקלות בדוח?

סעיף התקלות הוא הסיבה שלקוחות קוראים דוחות שבועיים. פוסט שלא עלה בשלושה עמודים, כי ההרשאה של הלקוח בפייסבוק פגה, הוא מידע שהלקוח צריך לדעת, עם פעולה ברורה. בְּשַׁגֵּר הפתרון הוא קישור חיבור שהלקוח פותח, מתחבר לחשבון שלו ובוחר את העמודים, בלי חשבון בְּשַׁגֵּר ובלי לשתף סיסמאות. הסוכן יכול ליצור את הקישור עם create_connect_link, אבל זו פעולה שדורשת הרשאת write ותביעה של הסנדבוקס, ולכן בסוכן דוחות עם read בלבד הוא רק ממליץ. על קישורי החיבור יש מאמר נפרד.

להפוך את זה לשגרה

ברגע שהדוח עובד פעם אחת, הוא צריך לרוץ כל שבוע בלי שמישהו יזכור. שתי דרכים מקובלות: סקיל בסוכן שאדם מפעיל ביום קבוע, או סקריפט שקורא לממשק REST ושולח את הנתונים למודל. הדרך הראשונה פשוטה יותר להתחלה. המדריך לשגרת הפצה שבועית בסקיל מראה את המבנה, והדוח הוא פשוט עוד שלב בסופה. כל הפרמטרים של get_analytics מופיעים במפרט OpenAPI.

שאלות נפוצות

האם שַׁגֵּר מודד חשיפות ותגובות ברשתות?

הכלי get_analytics מחזיר לחיצות על הקישורים המקוצרים של שַׁגֵּר, לכל חשבון ולכל פוסט. מדדי מעורבות של הרשת עצמה לא נכללים בתשובה שלו, ולכן אם הלקוח רוצה אותם בדוח, צריך להביא אותם ממקור נוסף.

למה לחיצות בְּשַׁגֵּר לא תואמות לביקורים בכלי כמו Google Analytics?

כי כל אחד סופר דבר אחר. שַׁגֵּר סופר לחיצה בשרת לפני ההפניה, וכלי האנליטיקס סופר ביקור רק אם הדף נטען והגולש לא חסם את הסקריפט. פער מסוים צפוי, ופער גדול מרמז על בעיה בדף הנחיתה או בהגדרות האנליטיקס.

האם הסוכן יכול לשלוח את הדוח ללקוח בעצמו?

שַׁגֵּר לא שולח דוחות. אם לסוכן יש גישה לכלי מייל או לוואטסאפ עסקי, הוא יכול, אבל אני ממליץ שאדם בסוכנות יקרא כל דוח לפני שהוא יוצא, לפחות בחודשים הראשונים.