Skill יצירת תוכן שיווקי ל-Claude

היקף

ה-skill הזה מטפל בקמפיין בחמישה שלבים עוקבים, כל אחד מותנה באישור בעל העסק:

בריף → לוח שנה → מלאי נכסים → עיצובי Canva → קופי → קביעה ב-HubSpot

Canva לא משמש לשורות אימייל בשום נסיבה — ללא תבניות, ללא autofill, ללא עותקי עיצוב, ללא העלאת נכסים, ללא ייצוא. בעל העסק הוציא במפורש את Canva מנתיב האימייל כי autofill של תבניות אימייל מייצר גרפיקות placeholder כאשר חריצי תמונה עולים על התמונות הזמינות, ותמונות ממוזערות לא מתרנדרות בתצוגה מקדימה. אם בעל העסק מבקש עיצוב אימייל ב-Canva, ראה reference/gotchas.md לשפת הניתוב.

בדיקה מקדימה

לפני שלב 1, אשר:

1. בריף. המשתמש הפנה או הדביק בריף מאושר. אם לא: "אצטרך את בריף התוכן לפני שאוכל לבנות את הקמפיין. יש לך אחד מ-skill content-strategy, או שתרצה לכתוב אחד עכשיו?"

2. רמת Canva. Pro/Teams דורשות בחירת תבנית ידנית מספריית המשתמש (ללא API autofill). Enterprise יכול autofill מתבניות מותג.

3. רמת HubSpot. קביעת פוסטים סושיאל דורשת Marketing Hub Professional. Starter או Free ← דלג על שלב 5 וייצא CSV במקום (ראה reference/hubspot-staging.md).

4. נכסי מותג. אשר את הנתיב לתמונות מוצר בדיסק או שה-brand kit פעיל ב-Canva.

5. תקציב יצירה. העריך את נפח Canva של הקמפיין והצג אותו לפני שלב 1. ברירת המחדל היא 3 מועמדים לכל שורת Canva; כל עיצוב עולה כ-5 קריאות API (autofill + export + polling).

   תקציב יצירה לקמפיין זה:
     שורות Canva (סושיאל): 8
     מועמדים לשורה:  3   (ברירת מחדל — אמור "מועמד יחיד" לשימוש ב-1)
     סך עיצובים:       24
     קריאות API (בקירוב):  ~120  (autofill + export + polling)
   
   מגבלת Canva: 100 בקשות/דקה. זה ייקח ~2-3 דקות יצירה,
   הרבה מתחת למגבלות הרמה שלך. להמשיך?
   

   אם סך העיצובים הצפוי עולה על 30, המלץ מצב מועמד-יחיד מראש — קמפיינים גדולים מתקצרים מהר. בעל העסק יכול לדרוס את ברירת המחדל ל-1, 2, או 3 מועמדים לשורה לפני שלב 1. נעל את הערך הנבחר לכל ה-session.

תהליך עבודה

שלב 1 — לוח שנה לפרסום

שאב מהבריף: נושאי תוכן, ערוצים, קצב, תאריכים קשיחים (השקות, מבצעים, חגים).

בנה טבלת לוח שנה עם עמודת נתיב שמנתבת כל שורה ל-Canva או טיוטת טקסט-בלבד:

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

נקודת ביקורת 1. הצג את לוח השנה. שאל: "האם זה מתאים לתוכנית? יש תאריכים להזיז, ערוצים להוסיף, או נושאים להחליף?" חזור על כך עד לאישור, לאחר מכן הצג שוב בקול את הפיצול — "N שורות עוברות דרך Canva, M שורות עוברות דרך טיוטת טקסט-בלבד" — לפני המשך. תפיסת סיווג שגוי כאן חינמית; תפיסתו לאחר יצירת עיצובים אינה.

שלב 2 — מלאי נכסים (שורות Canva בלבד)

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

1. מנה כל חריץ תמונה לפי שם. פוסטי Instagram מרובעים בדרך כלל יש להם 1-2 חריצי תמונה; קרוסלות ורשתות מוצרים יכולות להיות 5+. רשום אותם בנפרד (Header_Image, Product1_Image, Product2_Image, …) — לעולם אל תכנס אותם כ"תמונות מוצר."

   • Enterprise: קרא שמות שדות מ-dataset[].label על תבנית המותג (GET /v1/brand-templates/{id}).
   • Pro/Teams: ספור כל מלבן תמונה נפרד בתבנית.

2. מנה נכסים זמינים. תוכן טקסט מהבריף (שמות מוצרים, קופי הצעה, taglines, תמחור), תמונות מוצר שהועלו כבר ל-Canva (GET /v1/assets) או בדיסק של הבעלים, צבעי brand kit וגופנים (Enterprise).

3. בנה את טבלת הפערים חריץ-אחר-חריץ. שורה אחת לחריץ לעיצוב — לא לעיצוב.

   תאריך	שם חריץ	סוג חריץ	נכס זמין	סטטוס
   2 ביוני	Hero_Image	תמונה	bloom_summer.jpg → asset_id ממתין	העלה
   2 ביוני	Headline	טקסט	"פשתן קיץ, סוף סוף"	מוכן
   9 ביוני	Product1_Image	תמונה	—	חסר

4. פתור אי-התאמות חריץ/נכס עם הבעלים. אם לתבנית יש יותר חריצי תמונה מאשר הבריף מספק תמונות, עצור ושאל:

   לתבנית "קרוסלת קיץ" יש 5 חריצי תמונה. הבריף נתן לי
   תמונה 1 (bloom_summer.jpg). איך למלא את ה-4 האחרים?
   
     1. השתמש באותה תמונה בכל 5 החריצים
     2. שלח לי 4 תמונות נוספות (נתיבי קבצים)
     3. בחר תבנית פשוטה יותר עם פחות חריצים
   

   ללא קריאות יצירה עד שהבעלים יבחר. יצירה עם חריצים ריקים מייצרת עיצובים מלאים בתמונות הנוף המוגדרות כברירת מחדל של Canva.

5. העלה תמונות חסרות ולכוד מזהי נכסים מאומתים. העלה דרך POST /v1/asset-uploads, לאחר מכן סקור GET /v1/asset-uploads/{job_id} עד status == "success". רשום asset.id מהתגובה — זהו הערך היחיד שעובד בשדה תמונת autofill. מסירת מחרוזת ריקה, URL, נתיב קובץ, או ID מיושן מרנדר בשקט את גרפיקת הנוף המלאי של Canva במקום התמונה.

6. אשר את המניפסט. הצג לבעלים את טבלת חריץ-אחר-חריץ המלאה עם כל חריץ פתור וכל asset.id תמונה מאושר. זו התחנה האחרונה לפני קריאות Canva API.

שלב 3 — יצירת עיצובי Canva

לפני כל קריאת Canva API, קרא מחדש את לוח השנה וורד כל שורה שה-נתיב שלה אינו Canva (סושיאל). שורות אימייל לא עוברות דרך שלב זה.

צור עיצובים שורת לוח שנה אחת בכל פעם, עם 3 מועמדים לשורה (או הערך שנבחר בבדיקה מקדימה). כל שורה עוקבת אחר אותה לולאה: צור מועמדים ← אמת ← ייצא ← בדוק ויזואלית ← נסה שוב כשלים ← הצג ← המתן לבחירת הבעלים ← שורה הבאה. עצור 30 שניות בין שורות. זה מגביל את הפריצה ל-3 יצירות + 3 ייצואים לכל ~30 שניות — הרבה מתחת למגבלת 100 בקשות/דקה של Canva. אל תבצע מקביל על שורות מרובות; שורה אחת בכל פעם היא ההגנה שמונעת מהבעלים לפגוע במכסה באמצע קמפיין.

קצב Polling. סקור סטטוס עבודה כל 3-5 שניות, לא מהר יותר. מרווחים קצרים יותר שורפים מכסה מבלי להאיץ השלמה.

URLs תצוגה מקדימה — רק סוג אחד בטוח להטמעה. תגובות autofill מחזירות תמונות ממוזערות design.canva.ai שפגות תוך דקות; הטמעתן כתמונות markdown מייצרת placeholders שבורים. URLs ייצוא קבועים (export-download.canva.com או כלי ה-MCP export-design) אינם פגים. קרוסלות Cowork מקוריות מרנדרות את תוצאת autofill ישירות — תן להן לרנדר בעצמן, אל תטמיע מחדש.

לולאת שורה

1. פתור תבנית. (פעם אחת לsession — אותה תבנית בין שורות אלא אם לוח השנה מערבב סוגי נכסים.)

   • Enterprise: GET /v1/brand-templates מסונן לפי סוג נכס.
   • Pro/Teams: GET /v1/designs?ownership=any&query={template name}, הצג 3 עליונים לבעלים, אשר אחד לפני יצירה.

2. צור מועמדי השורה במקביל. שגר את 3 המועמדים של השורה בו-זמנית (או N מהבדיקה המקדימה).

   • Enterprise: POST /v1/autofills לכל מועמד עם מזהה התבנית וערכי השדות. סקור את כל העבודות בו-זמנית.
   • Pro/Teams: POST /v1/designs ליצירת עותקים. תאר את עריכות הטקסט והתמונה שהבעלים מחיל ב-Canva; אסוף מזהי עיצוב חזרה.

3. אמת סטטוס עבודה. לכל מועמד, אשר ש-GET /autofills/{job_id} החזיר status == "success" ו-result.design.id קיים. טפל בשגיאות לפי עיצוב:

   • JOB_FAILED ← קרא job.error.message, תקן ערכי שדות או מזהי נכסים, נסה שוב פעם אחת.

   • RATE_LIMIT_EXCEEDED (פגיעה ראשונה ב-session זה) ← המתן 60 שניות, נסה שוב אותו מועמד פעם אחת. זה מטפל בפסגות חולפות.

   • RATE_LIMIT_EXCEEDED (פגיעה שנייה ב-session זה) או כל שגיאת quota_exceeded / מכסה יומית ← עצור יצירה מיד. אל תנסה שוב. הצג התקדמות ושאל:

     Canva מגביל את הקמפיין. סטטוס עד כה:
       ✓ נוצרו:  פוסטים 1-4 (12 עיצובים)
       ⏸ נותרו:  פוסטים 5-8 (12 עיצובים שטרם נוצרו)
     
     כיצד להמשיך?
       1. עבור ל-1 מועמד לכל שורה נותרת (4 עיצובים בסך הכל) — מסיים עכשיו
       2. עצור את הקמפיין — חדש בעוד 60 דקות כשהמכסה מתחדשת
       3. עצור יצירה — עבוד עם מה שיש, עבור לכיתובים
     

     המתן לבחירת הבעלים. אל תלול על ניסיון חוזר.

4. ייצא כל מועמד מוצלח ל-PNG קבוע. שגר את ייצואי השורה במקביל.

   • REST: POST /v1/exports עם format.type: "png", סקור GET /v1/exports/{job_id} עד הצלחה, לכוד urls[0].
   • Canva MCP: export-design עם מזהה העיצוב.

   ה-URLs הקבועים האלה הם מה שמוטמע בתצוגות מקדימה ומצורף לפוסט HubSpot בהמשך. תמונה ממוזערת מתגובת autofill לא נמשכת לשימוש בהמשך.

5. אמת ויזואלית כל ייצוא. הסתכל על התמונה ודחה כל אחת מהן — כולן מצביעות על חריץ לא ממולא או נכס שגוי:

   • נוף גנרי עם עננים וגבעות ירוקות (placeholder ברירת המחדל של Canva)
   • מלבנים אפורים מוצקים במקום תמונה
   • טקסט Lorem-ipsum או תבנית ברירת מחדל
   • נושא שאינו תואם לבריף (מוצר שגוי, מותג שגוי)

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

6. נסה שוב לפי מועמד בכשל חלקי. אם 1 מתוך N מועמדים בשורה נכשל בשלב 3 או 5, צור מחדש רק אותו — אל תעשה מחדש את כל השורה ואל תציג קרוסלה שבורה חלקית. אם הניסיון השני גם נכשל:

   המועמד השלישי לפוסט 9 ביוני ממשיך להיכשל — Canva החזיר
   [שגיאה / רנדר placeholder]. כיצד להמשיך?
   
     1. דלג עליו — הצג את ה-2 האחרים והמשך
     2. עבור לתבנית פשוטה יותר רק למועמד זה
     3. נסה שוב פעם נוספת עם תמונה שונה
   

7. הצג את מועמדי השורה. תן לקרוסלת Cowork המקורית לרנדר את תוצאת כלי autofill. מתחתיה, הוסף הנחיית טקסט:

   מועמדי 9 ביוני מוכנים — גלול בקרוסלה למעלה.
   איזה אחד להשתמש לפוסט של 9 ביוני?
   

   אם הקרוסלה לא מתרנדרת או מיקום אחד שבור, הטמע את ה-URLs של PNG הייצוא הקבוע משלב 4. גיבוי אחרון: קשר לURL עריכת Canva של העיצוב (https://www.canva.com/d/{design_id}). לעולם אל תטמיע מחדש URLs של design.canva.ai.

8. עצור 30 שניות, לאחר מכן עבור לשורה הבאה.

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

שלב 4 — טיוטת קופי

לכל שורת לוח שנה, צור טיוטת קופי. שורות סושיאל מקבלות כיתוב; שורות אימייל מקבלות אימייל מלא.

כיתובים לסושיאל — Instagram, Facebook, X, LinkedIn:

• אורך: מתאים לערוץ (Instagram ≤ 2,200 תווים; Facebook ≤ 500 מומלץ; X ≤ 280).
• מבנה: hook ← יתרון מוצר אחד ← CTA ← 3-5 hashtags (לא 30).
• קול: התאם לסמנים הטוניים של הבריף. אם הבריף אומר "קזואלי ואנושי," אל תכתוב קופי תאגידי.
• ללא מילוי. ללא "חדשות מרגשות!" או "אנו שמחים להודיע." פתח עם הערך.

תוכן אימייל — Claude כותב את כל האימייל; ללא Canva:

• נושא: ≤ 50 תווים, ספציפי, ללא clickbait. "פרויקטי אביב מלאים" עדיף על "אל תפספסי!"
• Preheader: ≤ 90 תווים, משלים את הנושא מבלי לחזור עליו.
• גוף: פרוזה פשוטה, 100-250 מילים. שורת פתיחה שמרוויחה את הקריאה ← 1-2 פסקאות של תוכן ← CTA יחיד וברור ← חתימה.
• קול: אותם סמנים טוניים כמו בסושיאל. בעלי עסקים רוצים שהאימיילים שלהם ישמעו כמוהם, לא כמו ניוזלטר מתבנית.
• ללא הפניות לתמונה. אל תכתוב "ראה תמונה למעלה." אם הבעלים רוצה ויזואלים, הם מוסיפים אותם בכלי האימייל שלהם.
• CTA אחד לאימייל. בחר את הפעולה החשובה ביותר והוביל איתה.

הצג כיתובים inline מתחת לכל שורת סושיאל. הצג אימיילים מלאים inline מתחת לכל שורת אימייל:

נושא: <שורת נושא>
Preheader: <טקסט preheader>

<טקסט גוף>

לדוגמאות מעובדות, ראה reference/examples/boutique-brief-campaign.md.

נקודת ביקורת 3. "יש כיתובים או אימיילים לשכתב? סמן את התאריך ומה לשנות." חזור על כך עד לאישור.

שלב 5 — קביעה ב-HubSpot + מסירת אימייל

קבע פוסטים סושיאל ב-HubSpot. תוכן אימייל לא נקבע — הוא מוצג inline לבעל העסק להעתיק לכלי האימייל שלו. לעיון בשדות API, ראה reference/hubspot-staging.md.

1. צור את הקמפיין. POST /marketing/v3/campaigns עם שם הקמפיין ותאריכי התחלה/סיום מלוח השנה.

2. קבע כל פוסט סושיאל. POST ל-HubSpot Social API לכל שורת Canva (סושיאל):

   • channel: מפה ערוץ לוח שנה למזהה חשבון HubSpot
   • scheduledAt: datetime ISO 8601 — אשר שהוא בעתיד לפני קריאה
   • content.body: כיתוב מאושר
   • attachments: URL PNG ייצוא קבוע של Canva משלב 3
   • status: SCHEDULED (לעולם לא PUBLISHED)

3. אשר את התור. קרא GET /marketing/v3/social/posts?status=SCHEDULED, הצג את הרשימה, ספק קישור ישיר לתצוגת קמפיין HubSpot.

4. הצג תוכן אימייל למסירה. לכל שורת אימייל, הצג את הנושא + preheader + גוף המאושרים inline, מקובצים לפי תאריך שליחה. הבעלים מעתיק אלה לכלי האימייל שלהם (HubSpot Marketing Email, Mailchimp, Gmail).

נקודת ביקורת סופית.

הפוסטים הסושיאליים שלך קבועים ב-HubSpot: [קישור]
הם ישלחו כמתוזמן — אתה יכול לבטל או לערוך כל פוסט ב-HubSpot.

תוכן האימייל מוצג למטה — העתק כל אחד לכלי האימייל שלך כשתהיה מוכן לשלוח:

  5 ביוני — "פרויקטי אביב מלאים"
  15 ביולי — "חלונות תחזוקת קיץ מתמלאים"

יש שינויים לפני שנסיים?

שערי אישור

• ללא קריאות Canva לשורות אימייל. בדוק מחדש את עמודת הנתיב לפני כל קריאת API.
• ללא פרסום. כל פוסט HubSpot נקבע כ-SCHEDULED; הבעלים שולט על הפעלה.
• הצג תמיד את תקציב היצירה בבדיקה מקדימה. הבעלים רואה את סך העיצובים ומאשר לפני שלב 1.
• שורה אחת בכל פעם בשלב 3. מועמדים בתוך שורה שורפים במקביל, אבל שורות עוקבות עם פרק זמן של 30 שניות — זו ההגנה על המכסה.
• על שגיאת מכסה שנייה, עצור ושאל. לעולם אל תלול על ניסיון חוזר.
• ייצא תמיד ל-PNG קבוע לפני הצגה. הצלחת עבודה לא אומרת שהעיצוב רונדר נכון.
• לעולם אל תטמיע URLs של design.canva.ai בהודעות. הם פגים.
• לעולם אל תצור מחדש את כל השורה כאשר מועמד אחד נכשל. ניסיון חוזר לפי מועמד בלבד.
• לעולם אל תבחר תבנית אוטומטית למשתמשי Pro/Teams. אשר תמיד.
• לעולם אל תדלג על מלאי חריץ-אחר-חריץ. תבניות רב-חריצים מרנדרות נופי placeholder כאשר חריץ כלשהו ריק.
• לעולם אל תדלג על נקודת ביקורת 1. יצירה לפני שלוח השנה מאושר היא המקור הגדול ביותר לעבודה מבוזבזת ב-skill זה.

עזר

• reference/canva-api.md — נקודות קצה Canva Connect API, העלאת נכסים, פורמטי ייצוא, שקילי MCP
• reference/hubspot-staging.md — HubSpot Social API וגיבוי CSV לרמות שאינן Pro
• reference/gotchas.md — דפוסים טובים/רעים לכל מצב כשל שה-skill הזה פגש בפרודקשן
• reference/examples/boutique-brief-campaign.md — דוגמאות מעובדות מלאות (סושיאל חריץ-יחיד, תבנית רב-חריצים)