מה זה Webhook: כתובת פרטית ברשת שמקבלת הודעה כשמשהו קורה. Webhook נכנס ב-Discord וב-Slack, Webhook יוצא לאירועים, ואיך שומרים עליהם.
Webhook היא כתובת ברשת שמחכה להודעות. במקום שאפליקציה אחת תשאל שוב ושוב אפליקציה אחרת "קרה משהו?", האפליקציה השנייה שולחת הודעה קצרה לכתובת ה-Webhook ברגע שמשהו קורה. הכתובת בדרך כלל ארוכה ואקראית, וכל מי שמכיר אותה יכול לשלוח אליה. לכן מתייחסים לכתובת Webhook כמו לסיסמה.
ל-Webhook יש שני כיוונים, וכדאי להפריד ביניהם:
Webhook פועל בשקט מאחורי הרבה דברים שאתם כבר משתמשים בהם. לדוגמה:
בכל המקרים האלה אף אחד לא לוחץ על כפתור כדי להעביר את הידיעה הלאה. המערכת הראשונה יודעת שמשהו קרה, ומודיעה לשנייה מיד.
| גישה | איך זה עובד | מתאים ל |
|---|---|---|
| Webhook | השירות שולח הודעה לכתובת שלכם כשמשהו קורה | תגובה מיידית, מעט תעבורה |
| בדיקה חוזרת (polling) | המערכת שלכם שואלת את השירות כל כמה דקות | מערכות פשוטות שבהן עיכוב לא מפריע |
| קריאת API | המערכת שלכם מבקשת משהו מסוים כשהיא צריכה | קריאת נתונים, ביצוע פעולות |
| חיבור OAuth | אפליקציה פועלת בחשבון שלכם באישורכם | חיבורים מלאים, כמו פרסום ב-YouTube. ראו מה זה OAuth? חיבור חשבון בלי למסור סיסמה |
הודעת Webhook היא בקשת רשת רגילה, בדרך כלל עם קטע טקסט קטן בפורמט JSON:
POST https://example.com/hooks/streamlive
Content-Type: application/json
{"event": "stream.started", "data": {"stream_id": "...", "title": "Weekly class"}}
הצד המקבל קורא את שם האירוע, עושה את העבודה שלו (שולח הודעה, מעדכן גיליון, מתחיל הקלטה) ועונה מהר שההודעה התקבלה.
1. פרסום ל-Discord ול-Slack (Webhook נכנס). שתי הרשתות האלה מתחברות דרך Webhook ולא דרך התחברות. יוצרים Webhook לערוץ אחד ב-Discord או ב-Slack, מדביקים את הכתובת שלו בעמוד חיבורים, והערוץ הופך ליעד בעמוד פרסום לכל הרשתות. כשמחברים Discord, הכתובת נבדקת קודם מול Discord. חיבור Slack לא שולח שום דבר לערוץ. Discord מקבל טקסט וקובץ אחד. Slack מקבל טקסט וקישורים, אבל לא קבצים. צעד אחר צעד: פרסום לערוץ Discord או Slack דרך Webhook.

2. Webhook לאירועים (יוצא), במסלול Studio. בהגדרות, בחלק "API ו-Webhooks", יש כרטיס Webhooks: מקלידים כתובת https, מסמנים את האירועים הרצויים ולוחצים "הוסף webhook". מאותו רגע StreamLive Pro שולחת POST לכתובת בכל אירוע שסימנתם, חתום ב-HMAC-SHA256. סוד החתימה מוצג פעם אחת בלבד, מיד אחרי ההוספה, אז מעתיקים אותו מיד. באותו כרטיס רואים את רשימת ה-Webhooks ואפשר למחוק אותם. במסלולים אחרים החלק מסביר ש-Webhooks כלולים ב-Studio: /pricing.
| אירוע | נשלח כש |
|---|---|
| stream.started | שידור מתחיל |
| stream.ended | שידור מסתיים, עם האורך שלו |
| payment.succeeded | תשלום של החשבון עובר |
| subscription.canceled | המנוי מבוטל |
| destination.disconnected | באמצע שידור, בדיקת התקינות שלנו (בערך פעם בדקה) מגלה שהשידור לאחד הערוצים נכשל, ומתחילה לחבר אותו מחדש. לא מסומן מראש |
שלושת הראשונים מסומנים כברירת מחדל. כל אירוע נשלח פעם אחת, בלי ניסיון חוזר, ו-Webhook שנכשל 20 פעמים ברצף נכבה. כללים שמגינים עליכם: הכתובת חייבת להיות https ולהצביע לשרת ציבורי, לא לשרת פנימי; עד 10 לחשבון; הפניות (redirects) לא נעקבות. מפתחות API נמצאים באותו חלק: מפתחות API למפתחים: יצירה, שימוש וביטול.
Webhook דוחף אליכם הודעה ברגע שמשהו קורה. בדיקה חוזרת היא הכיוון ההפוך: המערכת שלכם שואלת את השירות כל כמה דקות אם משהו השתנה. בדיקה חוזרת פשוטה יותר להקמה, לא דורשת כתובת ציבורית אצלכם, ושום דבר לא הולך לאיבוד אם השרת שלכם היה למטה לזמן מה, כי פשוט שואלים שוב. המחיר הוא עיכוב ויותר בקשות. Webhook מיידי ושקט, אבל השרת שלכם חייב להיות זמין, לענות מהר ולהתמודד עם הודעה שמגיעה פעמיים או לא מגיעה בכלל, ולכן מערכות זהירות בודקות גם מדי פעם כדי לתפוס מה שפוספס. עם StreamLive Pro אפשר את שניהם: Webhooks לאירועים במסלול Studio, וה-API לכל מה שרוצים לשאול בקצב שלכם.
| בעיה | סיבה סבירה | פתרון |
|---|---|---|
| פוסטים הפסיקו להגיע לערוץ ב-Discord או ב-Slack | ה-Webhook נמחק או שהערוץ הוסר | יוצרים Webhook חדש ומדביקים אותו שוב |
| Discord דוחה את הכתובת | זו לא כתובת Webhook מלאה של Discord | מעתיקים את כל הכתובת. היא מתחילה ב-https://discord.com/api/webhooks/ |
| קובץ לא הגיע ל-Slack | Webhook של Slack לא מקבל קבצים | מפרסמים קישור לסרטון במקום |
| השרת שלכם לא מקבל כלום | הכתובת לא https, לא ציבורית, או מפנה הלאה | משתמשים בכתובת https ציבורית שעונה ישירות |
כתובת פרטית ברשת שמקבלת הודעה באופן אוטומטי כשמשהו קורה, כך שאף אחד לא צריך לבדוק כל הזמן.
כן. כל מי שיש לו כתובת של Webhook נכנס יכול לפרסם בערוץ. שומרים עליה ומוחקים אותה אם היא דלפה.
יוצרים Webhook בהגדרות הערוץ ב-Discord, מדביקים את הכתובת בעמוד חיבורים, ובוחרים את הערוץ כשמפרסמים.
כן, במסלול Studio: בהגדרות, בחלק "API ו-Webhooks", מוסיפים כתובת https עם האירוע stream.started. ההודעות חתומות בסוד שמוצג פעם אחת, כך שהשרת שלכם יכול לבדוק שהן הגיעו מ-StreamLive Pro.
מה זה OAuth: הדרך שבה אפליקציה אחת מקבלת גישה מוגבלת לחשבון שלכם בשירות אחר, בלי הסיסמה. מה זה טוקן ומה זו הרשאה, למה חיבורים פגים ואיך מבטלים.
קריאה ל-API של StreamLive Pro נכשלת: קודי שגיאה ופתרונותשגיאות ה-API של StreamLive Pro בהסבר פשוט: מפתח לא תקין או שפג, הרשאה חסרה, מגבלת מסלול, 409, 429 ו-5xx, וגם קודי המפתחות הישנים באותיות גדולות.
מגבלות קצב ב-API, ניסיונות חוזרים ו-Idempotency-Keyמגבלות הקצב של ה-API של StreamLive Pro לכל מפתח, לכל חשבון, לכתיבה ולפרסום; כותרות RateLimit, מה עושים ב-429, וניסיון חוזר בטוח עם Idempotency-Key.
מה ChatGPT ו-Claude לא יכולים לעשות ב-StreamLive Proהגבולות של ChatGPT ו-Claude ב-StreamLive Pro, עם הסיבה לכל אחד ומה עושים במקום: חיבור רשתות, פוסטים לטיקטוק, העלאות, אישורים ועוד.
רוצים לנסות? 7 ימי ניסיון, בלי כרטיס אשראי.
להתחיל בחינם