@mentions ב-Instagram דרך ה-API: איתור ומענה להם
ה-API של Instagram מדווח על @mentions של חשבון מקצועי בתגובות ובכיתובים במדיה ציבורית, ומאפשר לחשבון להשיב במקום. עם Instagram Login, התיוגים מגיעים בוובהוק (Webhook) התגובות, והתשובה עוברת דרך POST /<IG_ID>/mentions עם מזהה המדיה, ולתגובה גם מזהה התגובה, והיא מתפרסמת כתגובה באותו מקום.
easyCoexistence מעביר את התגובות, התיוגים וההודעות הישירות של חשבון Instagram לנקודת הקצה שלכם כשהם מגיעים, חתומות בסוד ייעודי לאותו חשבון, אחרי שמגדירים אותו עם set_social_webhook_destination.
הודעת וובהוק הכוללת @mentions, לאפליקציות שעובדות עם Instagram Login.
נקודת הקצה שמשיבה לתגובה או לכיתוב שבהם משתמש אחר ב-Instagram תייג את החשבון.
מדיה של חשבון פרטי לא מפעילה וובהוק על תגובה או @mention בה.
ההרשאות instagram_business_basic ואת instagram_business_manage_comments נדרשות לתיוגים עם Instagram Login.
איך מגיעים התיוגים?
בוובהוק, ברגע שהם קורים. עם Instagram Login, Meta כוללת את התיוגים בהודעת התגובות ולא שולחת שדה mentions נפרד, כך שהמטפל קורא אותם מאותם אירועים של תגובות חדשות. Meta אינה שומרת היסטוריה של הודעות קודמות, ולכן שמרו את מה שאתם צריכים מכל הודעה ברגע שהיא מגיעה.
אילו תיוגים ה-API מכסה?
ממשק ה-mentions של Meta מזהה כיתובים, תגובות ומדיה שבהם חשבון עסקי או יוצר הוזכר או תויג:
- @mentions בתגובות.
- @mentions בכיתוב של פוסט.
- מדיה שבה החשבון מתויג, שמופיעה ב-GET /<
IG_ID>/tags; אין תמיכה בתגובה לתמונות שבהן החשבון רק מתויג. - לא ב-Stories: ממשק ה-mentions אינו תומך בהן, והזכרה בסטורי מגיעה לחשבון כהודעה ישירה, שסוג הקובץ המצורף שלה הוא
story_mention, ולא כתיוג. - לא חשבונות פרטיים: מדיה שבבעלותם אינה שולחת וובהוקים על תיוגים.
איך משיבים לתיוג?
עם POST /<IG_ID>/mentions. לתיוג בתגובה שולחים את media_id ואת comment_id יחד עם ההודעה, והתשובה מופיעה בשרשור של אותה תגובה. לתיוג בכיתוב שולחים את media_id וההודעה, והיא מתפרסמת כתגובה על המדיה. שני המזהים מגיעים מהודעת הוובהוק.
POST https://graph.instagram.com/<IG_ID>/mentions
?media_id=<MEDIA_ID>
&comment_id=<COMMENT_ID>
&message=<REPLY_TEXT>מה התיוגים צריכים?
עם Instagram Login, ההרשאות instagram_business_basic ואת instagram_business_manage_comments, אותו זוג שבו משתמש ניהול התגובות, והקריאות עוברות אל graph.instagram.com. כדי לשרת חשבונות מקצועיים שהמפתח לא בבעלותו ולא מנהל אותם, נדרשת גם Advanced Access לאפליקציה.
טעויות נפוצות
- המתנה לאירוע נפרד של @mentions תחת Instagram Login. Meta שולחת את התיוגים בתוך הודעת התגובות.
- השבה לתיוג בפוסט של חשבון אחר כמו לתגובה בפוסט שלכם. הדרך של Meta לכך היא POST /<IG_ID>/mentions, עם מזהה המדיה ולתגובה גם מזהה התגובה.
- הצפייה לתיוגים בסטורי דרך ממשק ה-mentions. Meta לא תומכת בהם שם; הם מגיעים לחשבון כהודעות ישירות.
- ההנחה שהוובהוק ישלח מחדש תיוגים ישנים. Meta לא שומרת היסטוריה של הודעות, ולכן שמרו כל אחת מהן ברגע שהיא מגיעה.
הכלים שלו משיבים לתגובות בפוסטים שלכם עם reply_to_comment; מענה לתיוג בפוסט של מישהו אחר, שמשתמש בנקודת הקצה של התיוגים של Meta, אינו ביניהם. מ-US$ 9 לחיבור בחודש, יורד עד US$ 0.75 ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
אפשר להגיב לתמונה שהחשבון שלי מתויג בה?
לא. GET /<IG_ID>/tags מציג את המדיה שבה החשבון מתויג, אבל Meta לא תומכת בתגובה לתמונות שבהן החשבון רק מתויג.
אפשר להשיב לתיוג בפוסט של מישהו אחר?
כן. POST /<IG_ID>/mentions עם מזהה המדיה, ועם מזהה התגובה כשהתיוג הוא בתגובה, מפרסם את התשובה שם בשם החשבון.
האם תיוגים בסטורי זמינים דרך ממשק ה-mentions?
לא. הזכרה בסטורי מגיעה לחשבון כהודעה ישירה שסוג הקובץ המצורף שלה הוא story_mention, ואפשר לקבל עליה תשובה באותה שיחה.
למה תיוג מעולם לא הגיע?
המדיה עשויה להיות של חשבון פרטי, שאינו שולח הודעות תיוג, או שהתיוג נמצא בסטורי, שממשק ה-mentions אינו מכסה.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-