התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

וובהוקים לרשתות חברתיות (Webhooks): תגובות, אזכורים והודעות לנקודת קצה אחת

easyCoexistence מעבירה אירועי רשתות חברתיות לנקודת קצה ב-HTTPS שלכם ברגע שהם קורים: תגובות, אזכורים והודעות ישירות מ-Instagram ומ-Facebook, ותגובות מ-TikTok. כל אירוע מגיע בעטיפה אחת, עם אירוע הרשת בתוכה ללא שינוי, וחתום לפי חשבון באמצעות X-EC-Signature. מפעילים זאת לכל חשבון עם set_social_webhook_destination מ-Claude או מ-ChatGPT, או דרך ה-Partner API. הודעות של מספר WhatsApp מגיעות גם הן לשרת שלכם.

  • תגובות, אזכורים והודעות ברגע שהם קורים
  • עטיפה אחת, חתומה לכל חשבון
  • הגדרה מ-Claude, מ-ChatGPT או דרך ה-Partner API
התחילו תקופת ניסיון בחינם

לא תחויבו במשך 3 ימים. בטלו בכל זמן.

ממשקי API רשמיים בלבדMCP עבור Claude ו-ChatGPTכל חיבור במעקב 24/73 ימי ניסיון חינם
1 attempt

כמה פעמים easyCoexistence שולחת כל אירוע מועבר; היא אינה שומרת עותק, ולכן אין שליחה חוזרת מאוחר יותר.

Within 5 minutes

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

In comments

היכן אפליקציות ב-Instagram Login מקבלות @mentions: בתוך התראת הוובהוק של התגובות, ולא כשדה נפרד משלהן.

3 events

מה מדווחות התראות הדחיפה של YouTube על ערוץ: העלאה חדשה, כותרת חדשה או תיאור חדש.

7 days

כמה זמן Meta ממשיכה לנסות שוב וובהוק של WhatsApp שהשרת שלכם לא קיבל, מה שעלול לגרום לכפילויות.

אילו אירועים כל רשת שולחת?

Instagram, Facebook ו-TikTok דוחפים אירועים ל-easyCoexistence, והיא מעבירה כל אחד לכתובת ה-URL שהגדרתם לאותו חשבון. Instagram שולח תגובות חדשות, כאשר @mentions מגיעים בתוך התראת התגובות, ו-DM. דף Facebook שולח פעילות פיד, הכוללת תגובות חדשות, וכן הודעות Messenger ואזכורים של הדף. TikTok שולח comment.update, שמופעל כשתגובה נוצרת, נמחקת או משנה נראות.

YouTube ו-LinkedIn אינם שולחים ל-easyCoexistence אירועי תגובות או הודעות, ולכן סוכן קורא את התגובות שלהם לפי בקשה. מספר WhatsApp פועל במסלול משלו: Meta מעבירה את ההודעות ישירות לשרת שלכם, או ש-easyCoexistence מעבירה אותן חתומות כשהמספר פועל במצב מנוהל.

What arrivesSent by
InstagramComments, mentions and DMseasyCoexistence, signed per account
FacebookFeed activity, Messenger and mentionseasyCoexistence, signed per account
TikTokcomment.update eventseasyCoexistence, signed per account
WhatsAppMessages and echoes from the appMeta directly, or easyCoexistence in managed mode
YouTubeNo comment eventsRead with list_youtube_comments
LinkedInNo comment eventsRead with list_linkedin_comments

איך נראה אירוע שהועבר?

אותה מעטפת JSON בכל רשת, שנשלחת עם Content-Type application/json: platform: הרשת; account_id: המזהה שכלי ה-MCP וה-Partner API משתמשים בו; external_id: מזהה החשבון ברשת; entry: אירוע הרשת עצמו כפי שהגיע. ב-Instagram ו-Facebook, entry הוא ה-entry של וובהוק Meta, עם changes לתגובות ואזכורים ו-messaging להודעות ישירות. ב-TikTok הוא מכיל את אירוע comment.update, עם comment_id, video_id ו-parent_comment_id כמחרוזות, כך שמזהים של 64 ביט לא יעוגלו. הודעת Messenger מגיעה כך:

A forwarded Messenger message, trimmed
{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793318400512,
    "messaging": [
      {
        "sender": { "id": "<PAGE_SCOPED_ID>" },
        "recipient": { "id": "<PAGE_ID>" },
        "timestamp": 1793318399870,
        "message": { "mid": "<MESSAGE_ID>", "text": "Are you open on Sunday?" }
      }
    ]
  }
}

איך מאמתים את X-EC-Signature?

בעזרת סוד החתימה שמוחזר כשמגדירים את היעד, ייחודי לאותו חשבון ומוצג פעם אחת. הכותרת נראית כך t=<unix>,v1=<hex>, והערך v1 הוא HMAC-SHA256 של חותמת הזמן, נקודה והגוף הגולמי של הבקשה, עם הסוד הזה כמפתח. קראו את הגוף כבייטים לפני הפענוח, דחו חותמת זמן שרחוקה מהשעון שלכם ביותר מ-5 דקות, חפשו את הסוד לפי account_id של האירוע והשוו את שני הערכים בהשוואה בזמן קבוע. ואז החזירו תשובה 2xx והכניסו את העבודה לתור. ב-PHP זה לוקח כמה שורות:

PHP: verifying a forwarded event
<?php
// POST /hooks/social: one endpoint for the events of each account
$raw = file_get_contents('php://input');          // the exact bytes that were signed
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_EC_SIGNATURE'] ?? ''), $sig);
$event = json_decode($raw, true);                  // platform, account_id, external_id, entry
$secret = secret_for($event['account_id'] ?? '');  // the signing_secret stored for that account

$fresh = ctype_digit($sig['t'] ?? '') && abs(time() - (int) $sig['t']) <= 300;
$expected = hash_hmac('sha256', ($sig['t'] ?? '') . '.' . $raw, (string) $secret);
if (!$secret || !$fresh || !hash_equals($expected, $sig['v1'] ?? '')) {
    http_response_code(401);
    exit;
}

http_response_code(204);
enqueue($event); // keep this quick: the forward waits 8 seconds and is never resent

איך מפעילים העברה לחשבון?

מהעוזר או מהשרת הפנימי שלכם. בקשו מ-Claude או מ-ChatGPT להריץ set_social_webhook_destination עם החשבון וכתובת ה-HTTPS שלכם, או קראו ל-PUT /api/v1/channels/:id/webhook ב-Partner API עם המפתח ec_live_ שלכם וגוף שמכיל את השדה url. שתי הפעולות מחזירות את signing_secret של החשבון פעם אחת, לכן שמרו אותו מול account_id באותו רגע. קריאה חוזרת מנפיקה סוד חדש, וערך null בשדה url מכבה את ההעברה.

הכתובת חייבת להיות HTTPS על שרת ציבורי: כתובת פרטית נדחית כשמגדירים אותה ושוב בזמן המסירה. נקודת קצה אחת יכולה לשרת חשבונות רבים, כי כל אירוע מציין את account_id שלו. למספר WhatsApp, set_webhook_destination מנתב את המסירות של Meta אליכם, ו-set_inbound_mode עם forward_url מעביר אותן חתומות במקום.

מה קורה כשנקודת הקצה איטית או לא זמינה?

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

WhatsApp שונה. במצב ישיר, Meta ממשיכה לנסות למסור מחדש מסירה שהשרת שלכם לא קיבל, עד 7 ימים. במצב מנוהל, easyCoexistence מכניסה הודעות לתור לכתובת ההעברה שלכם ומנסה שוב עם השהיות הולכות וגדלות. אירועי סטטוס של Partner, כמו ניתוק חיבור, נשלחים שוב במשך כ-33 שעות.

איך תגובות YouTube ו-LinkedIn מגיעות לסוכן?

בקריאה לפי לוח זמנים. ההתראות בדחיפה של YouTube מדווחות על העלאה חדשה, כותרת חדשה או תיאור חדש, לא על תגובות, ו-easyCoexistence לא מקבלת אירועי תגובות מ-LinkedIn, ולכן אף אחד מהם לא מעביר דבר. לכן הסוכן בודק בעצמו: list_youtube_comments מחזיר את שרשורי הסרטון או של כל הערוץ, כולל אלה שממתינים לאישור, ואילו list_linkedin_comments מחזיר את התגובות על פוסט או את התשובות תחת תגובה אחת. ב-n8n, Make או Zapier, טריגר מתוזמן מפעיל את הבדיקה. בקוד שלכם, משימת cron שולפת את אישורי הערוץ וקוראת ישירות לנקודת הקצה commentThreads של YouTube או לנקודת הקצה של התגובות ב-LinkedIn.

איך מגדירים

  1. Set the destinationRun set_social_webhook_destination with the account and an HTTPS URL, or call PUT /api/v1/channels/:id/webhook with your ec_live_ key.
  2. Store the secretSave the signing_secret from the response against that account_id, since it is shown only once.
  3. Verify each deliveryCheck that the timestamp is fresh and that v1 matches an HMAC-SHA256 of the timestamp, a dot and the raw body.
  4. Acknowledge, then workAnswer 2xx straight away and hand the event to a queue, because easyCoexistence sends it only once.

טעויות נפוצות

  • בדיקת ה-HMAC על ה-JSON אחרי הפענוח. החתימה מכסה את הגוף הגולמי בייט אחרי בייט, וסידור מחדש של האובייקט המפוענח משנה את הבייטים האלה, ולכן יש לאמת לפני הפענוח.
  • שימוש בסוד אחד לכל החשבונות. כל חשבון חותם עם הסוד שלו, ולכן יש לחפש אותו לפי account_id של האירוע לפני השוואת הערך v1.
  • הגדרת היעד שוב בלי לעדכן את נקודת הקצה. כל קריאה מנפיקה סוד חדש, והישן מפסיק לחתום מיד, ולכן שמרו את החדש מיד.
  • מתן כתובת שמפנה לכתובת אחרת. העברות לא עוקבות אחרי הפניות, ולכן מעבר לנתיב או למארח חדש מאבד את האירוע; הגדירו את הכתובת הסופית.
עושים את זה עם EasyCoexistence

easyCoexistence שולחת תגובות, אזכורים והודעות מ-Instagram ומ-Facebook, וכן תגובות מ-TikTok, לנקודת הקצה שלכם ברגע שהן קורות, חתומות לפי חשבון, ומנתבת הודעות WhatsApp לשרת שלכם, כך שסוכני ה-AI שלכם שומעים מהלקוחות דרך ה-API הרשמי של כל רשת, עם ניטור של כל חיבור 24/7. מ-US$ 9 עד US$ 0.75 לחיבור לחודש, יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים בחינם.

שאלות נפוצות

איך ההודעות של מספר WhatsApp מגיעות לנקודת הקצה שלי?

בשתי דרכים. set_webhook_destination גורם ל-Meta למסור אותן ישירות לשרת שלכם, בעוד set_inbound_mode עם forward_url גורם ל-easyCoexistence להעביר אותן חתומות עם X-EC-Signature, ולנסות שוב עם השהיות הולכות וגדלות.

האם אותו אירוע יכול להגיע פעמיים?

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

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

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

כמה עולה easyCoexistence לוובהוקים מרשתות חברתיות?

מ-US$ 9 עד US$ 0.75 לחיבור לחודש, יורד ככל שמוסיפים חיבורים, והמחיר זהה בכל רשת. ההעברה, שרת ה-MCP וה-Partner API כלולים, עם תקופת ניסיון של 3 ימים בחינם.

המשיכו לקרוא

ממשק API לתגובות ברשתות החברתיות: Instagram, Facebook, TikTok, YouTube ו-LinkedInקראו, השיבו ונהלו תגובות ב-Instagram, Facebook, TikTok, YouTube ו-LinkedIn מ-Claude, ChatGPT או מהקוד שלכם, דרך ממשקי API רשמיים.ממשק API להודעות DM ברשתות חברתיות: Instagram, Messenger ו-WhatsApp בממשק אחדהשיבו להודעות DM ב-Instagram, Messenger ו-WhatsApp מ-Claude, מ-ChatGPT או מהקוד שלכם, עם תבניות, אוטומציות ותשובות AI, דרך ה-API של Meta.איך מקבלים בוובהוק (Webhook) את הודעות WhatsApp ואת התגובות ברשתות החברתיות של הלקוחות שלכםוובהוק לכל חיבור: הודעות WhatsApp ישירות מ-Meta, מאומתות בסוד בכתובת, ותגובות ו-DM מהרשתות החברתיות חתומות בכותרת X-EC-Signature.אוטומציה לרשתות חברתיות ב-n8n: Instagram, TikTok, Facebook ועודאוטומציה ב-n8n ל-Instagram, TikTok, Facebook ו-YouTube: אירועי Instagram, Facebook ו-TikTok חתומים לצומת Webhook וסוכן AI עם 35+ כלי MCPפרסום ל-Instagram, TikTok ו-Facebook מ-Node.js באמצעות ממשק API אחדפרסום, תזמון ומענה ב-Instagram, Facebook, TikTok, YouTube ו-LinkedIn מ-Node.js וגם TypeScript עם fetch, וכלי MCP לסוכן שלכם.פרסום ב-Instagram, ב-TikTok וב-Facebook מ-Python דרך ממשק API אחדפרסום פוסטים, קריאת תגובות ומענה להודעות DM ב-Instagram, Facebook, TikTok, YouTube ו-LinkedIn מ-Python, דרך ה-API הרשמי של כל רשת.

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-