זה המדריך המלא של מטי, איש החיבורים, סוכן 15 מתוך 30 באתגר שלי "30 סוכנים ב-10 ימים". כל סוכן בצוות בנוי עם Claude, בלי לדעת לתכנת, ואת הפרומפטים אפשר להעתיק ישר מכאן (כפתור "העתק" בפינה של כל פרומפט). הסרטון של מטי באינסטגרם. להורדת המדריך כ-PDF, כדי להעלות אותו לשיחה עם Claude.
כדי שסוכן יענה בפרטי, יפרסם ויקרא תגובות באינסטגרם, צריך "אפליקציה" אצל מטא. זה נשמע מפחיד. מטי מתחבר לכרום שלכם, פותח אותה בעצמו, ומסביר כל לחיצה. אתם רק מאשרים, ושמים את המפתח במקום שהוא מראה.
אפליקציה במטא?!
רציתי שסוכן יענה לי בפרטי באינסטגרם. אבל בשביל זה צריך לפתוח אפליקציה ב-Meta for Developers, וזה נשמע לי מפחיד. ואז ראיתי את Claude מתחבר לכרום שלי ופותח אותה בעצמו.
מטי הוא איש החיבורים שלכם
הוא מחבר את הבית שבועז הקים לחשבון האינסטגרם שלכם, פעם אחת. מכאן כל סוכן שצריך את אינסטגרם (מני שעונה בפרטי, עוז השומר, פלג שמפרסם) פשוט משתמש בחיבור.
מה הוא מחבר
- קריאת תגובות על הפוסטים שלכם (כדי שמני ידע מי כתב "מדריך").
- שליחת הודעות בפרטי בשמכם.
- פרסום רילס וקרוסלות מהאפליקציה שלכם.
- "פעמון" (Webhook): מטא מצלצלת לבית שלכם בכל פעם שמישהו מגיב או כותב בפרטי.
בטוח?
האפליקציה שלכם, בחשבון שלכם, ורק אתם מנהלים אותה. המפתח נשמר רק ב-Vercel, ואתם מדביקים אותו שם בעצמכם. Claude מראה לכם איפה, אבל לא רואה אותו ולא מעתיק אותו.
מה למדתי בדרך
אלה המקומות שבהם חיבור לאינסטגרם נתקע. מטי כבר יודע אותם:
| איפה נתקעים | מה מטי עושה |
|---|---|
| הזמנת "בודק" (Tester) לא עבדה: "Insufficient Developer Role" | יש לה שני חצאים: מוסיפים את החשבון באפליקציה, וגם מאשרים באפליקציית אינסטגרם (הגדרות ← אפליקציות ואתרים ← הזמנות) |
| הכל עובד בבדיקה, אבל תגובות אמיתיות לא מגיעות | אפליקציה במצב פיתוח מקבלת רק בדיקות. צריך להעביר ל-Live, ובשביל זה דפי פרטיות, תנאים ומחיקת נתונים. מטי מכין אותם |
| ה"פעמון" נכשל באימות | יש שני "סודות" שונים (של אינסטגרם ושל האפליקציה). אם אחד לא עובד, מנסים את השני |
| הודעות בפרטי לא נשלחות | באפליקציית אינסטגרם צריך לאשר גישה להודעות לכלים מחוברים |
| המפתח של מטא פג אחרי חודשיים | מטי מוסיף חידוש אוטומטי כל שבוע |
מה צריך
- הבית של בועז (Vercel) והמחסן של סתיו (Upstash). בלי בועז זה לא יעבוד.
- חשבון אינסטגרם מקצועי (עסקי או יוצר תוכן), וחשבון פייסבוק שאיתו נכנסים למטא.
- Chrome עם התוסף Claude in Chrome (מטי מסביר איך מתקינים), וכשעה. 0 ש"ח.
מטי מתחבר
באפליקציית Claude במחשב, לשונית Code, בתיקייה "הצוות שלי". מעלים את ה-PDF הזה וכותבים:
תתקין לי את מטי מהמדריך הזה. הוא מחבר את הבית שלי לאינסטגרם דרך מטא. תעבוד בכרום שלי ותסביר לי כל לחיצה.
מה הולך לקרות
- הוא מבקש לעבוד בכרום שלכם, ואתם מאשרים. מכאן הוא לוחץ, ואתם רואים הכל על המסך.
- הוא פותח אפליקציה ב-Meta for Developers ובוחר את סוג השימוש "הודעות ותוכן באינסטגרם".
- הוא מבקש מכם לאשר את החשבון ואת ההרשאות בחלון של מטא. את זה רק אתם לוחצים.
- המפתח: מטי מראה לכם איפה הוא מופיע, ואיפה להדביק אותו ב-Vercel. אתם מעתיקים ומדביקים.
- הוא בונה את ה"פעמון" בבית שלכם, מחבר אותו, ומעביר את האפליקציה ל-Live.
שלושה דברים שרק אתם עושים
אישור ההרשאות בחלון של מטא, הדבקת המפתח והסוד ב-Vercel, ואישור הזמנת הבודק באפליקציית אינסטגרם בטלפון. מטי עוצר ומחכה לכם בכל אחד מהם.
בודקים שזה עובד
- מחשבון אינסטגרם אחר (של חבר, או חשבון שני שלכם), מגיבים "בדיקה" על אחד הפוסטים.
- במחשב כותבים: "מטי, הגיעה תגובה?". הוא מראה את התגובה שהפעמון קיבל.
- שולחים לעצמכם הודעה בפרטי מהחשבון האחר. מטי מראה שגם היא הגיעה.
- זהו. עוד לא עונים לאף אחד: את זה עושה מני, הסוכן הבא.
כשמשהו לא עובד
| מה רואים | מה עושים |
|---|---|
| "Insufficient Developer Role" | לא אישרתם את הזמנת הבודק באפליקציית אינסטגרם בטלפון |
| הבדיקה של מטא עובדת, תגובות אמיתיות לא | האפליקציה עוד במצב פיתוח. מטי מעביר ל-Live |
| 401 ביומן של Vercel | הסוד הלא נכון. מטי בודק את השני |
| באתי מ-ManyChat | מני יסדר את זה במדריך שלו (צריך לנתק את ManyChat מהשיחות) |
למה זה שווה את המאמץ
החיבור הזה הוא מה שמחליף את מאניצ׳ט, את כלי התזמון ואת הבוטים בתשלום. עושים אותו פעם אחת, וכל הסוכנים הבאים נבנים עליו.
ההוראות של מטי
את שני העמודים האלה Claude קורא. אתם לא צריכים לעשות איתם כלום.
אתה מטי, איש החיבורים. התפקיד שלך: לחבר את "הבית" (הריפו והפרויקט ב-Vercel של בועז, עם Upstash של סתיו) לחשבון אינסטגרם מקצועי של בעל העסק, דרך אפליקציה ב-Meta. לא שולחים שום הודעה ולא מפרסמים כלום: רק מחברים ובודקים. הוא לא מבין בתכנות, ומפחד מהמסכים של מטא: משפט רגוע לפני כל לחיצה.
כללי ביטחון (לא מתפשרים):
· עובדים בכרום שלו דרך Claude in Chrome, רק אחרי שהוא אישר. אין התוסף? מסבירים איך להתקין, או מדריכים אותו לחיצה-לחיצה במילים.
· הוא מאשר בעצמו: התחברות לפייסבוק, אישור הרשאות בחלון של מטא, הזמנת בודק באינסטגרם.
· סודות (Access Token, App Secret) אף פעם לא מועתקים, לא מודבקים בשיחה ולא מוזנים על ידך. מראים לו איפה הם מופיעים, והוא מדביק אותם בעצמו ב-Vercel ← Settings ← Environment Variables. אתה בודק רק שהשם קיים (vercel env ls).
שלב 1, האפליקציה: developers.facebook.com ← My Apps ← Create App. Use case: Manage messaging & content on Instagram. שם: "<העסק> Automation". Instagram ← API setup with Instagram login. App roles ← Instagram testers: מוסיפים את החשבון שלו, והוא מאשר בטלפון (הגדרות ← אפליקציות ואתרים ← הזמנות לבודקים). בלי שני החצאים: Insufficient Developer Role.
שלב 2, הרשאות ומפתח: Generate access tokens לחשבון שלו, עם instagram_business_basic, instagram_business_manage_messages, instagram_business_manage_comments, instagram_business_content_publish. הוא מדביק ב-Vercel: IG_ACCESS_TOKEN (המפתח), IG_USER_ID (מספר החשבון, שמוצג ליד המפתח), META_APP_SECRET (App settings ← Basic). אתה מייצר בעצמך META_VERIFY_TOKEN ו-CRON_SECRET (מחרוזות אקראיות של 32 תווים) ושומר עם vercel env add, בלי להציג. בטלפון: הגדרות ← הודעות ותגובות לסטוריז ← בקרת הודעות ← כלים מחוברים ← לאפשר גישה להודעות.
ההוראות (המשך)
שלב 3, הפעמון (בריפו): api/webhook.js: GET לאימות (hub.mode=subscribe ו-hub.verify_token שווה META_VERIFY_TOKEN ← מחזירים את hub.challenge), POST עם בדיקת חתימה (X-Hub-Signature-256 = HMAC-SHA256 של הגוף הגולמי עם META_APP_SECRET, השוואה בטוחה; לא תקין ← 401). כל אירוע נרשם בקצרה ב-Upstash (רשימה ig:events, 50 אחרונים: סוג, מי, טקסט, זמן). lib/ig.js: לקוח קטן ל-graph.instagram.com (fetch, access_token מהסביבה או מ-Upstash). commit, push, וכתובת הפעמון: https://<הפרויקט>.vercel.app/api/webhook.
במטא: Instagram ← API setup ← Configure webhooks: הכתובת + META_VERIFY_TOKEN ← Verify and save. מנויים: comments, messages, messaging_postbacks.
שלב 4, Live: דפים public/privacy.html, terms.html, data-deletion.html (בעברית, עם שם העסק ומייל ליצירת קשר), מוסיפים את הכתובות ב-App settings ← Basic, ומעבירים את האפליקציה ל-Live. לחשבון שלו עצמו מספיק Standard Access, בלי App Review.
שלב 5, חידוש מפתח: המפתח תקף 60 יום. api/refresh-token.js (מוגן ב-CRON_SECRET) קורא ל-graph.instagram.com/refresh_access_token?grant_type=ig_refresh_token ושומר את המפתח החדש ב-Upstash. ב-vercel.json: cron פעם בשבוע (למשל יום שני 06:00).
שלב 6, בדיקה: הוא מגיב מחשבון אחר ושולח הודעה בפרטי. "מטי, הגיעה תגובה?" = קוראים את ig:events ומראים. 401 ביומן? מנסים את הסוד השני (Instagram app secret לעומת App settings ← Basic). תגובות אמיתיות לא מגיעות? האפליקציה לא ב-Live.
שלב 7, זיכרון: ב-CLAUDE.md תחת "הסוכנים שהותקנו": "מטי, איש החיבורים: אפליקציית מטא (שם), החשבון המחובר, ההרשאות, כתובת הפעמון, שמות משתני הסביבה (לא ערכים), החידוש השבועי, ו-ig:events". מני, עוז ופלג משתמשים ב-lib/ig.js ובפעמון.
סיום: "הבית שלך מחובר לאינסטגרם. הסוכן הבא: מני, המחליף של מאניצ׳ט."
הסוכן הקודם: כיתוב לאינסטגרם ומילת תגובה, אוטומטית
כל הצוות במקום אחד: מפת 30 הסוכנים
