Skip to main content
Webhooks יוצאים מעדכנים את המערכות שלך כשמשהו משתנה בסביבת העבודה. כשמתרחש אירוע, למשל אפליקציה מתפרסמת או שצ’אט ה-AI מסיים תשובה, Base44 שולחת בקשה חתומה לכתובת ה-URL שבחרת. כך המערכות שלך נשארות מעודכנות בלי לבדוק שינויים.
כדי להשתמש ב-webhooks יוצאים צריך מסלול Enterprise (Business או Enterprise), ורק בעלים ומנהלים של סביבת העבודה יכולים לנהל אותם. המפתחים שלך צריכים קודם להקים נקודת קבלה בכתובת ה-URL. כדי ללמוד איך לבנות אחת, ראה את סקירת ה-webhooks היוצאים.
הכרטיסייה Outgoing עם 4 webhooks: 2 פעילים, 1 מושהה ו-1 ממתין

Webhooks יוצאים בדף Webhooks


יצירת webhook

צור webhook לכל כתובת URL שצריכה לקבל אירועים. אפשר ליצור עד 10 בכל סביבת עבודה. webhook חדש נמצא במצב Pending ולא מקבל דבר עד שתפעיל אותו. אחרי היצירה, Base44 מציגה את מפתח החתימה הציבורי של סביבת העבודה. נקודת הקבלה משתמשת בו כדי לוודא שכל בקשה הגיעה מ-Base44. אפשר לשתף את המפתח בבטחה עם המפתחים שלך. ליצירת webhook:
  1. לחץ על שם סביבת העבודה שלך בפינה השמאלית התחתונה, ולחץ על Settings.
  2. לחץ על Webhooks בסרגל הצד, ואז לחץ על הכרטיסייה Outgoing.
  3. לחץ על Create webhook.
  4. הזן את Endpoint URL. הכתובת חייבת להתחיל ב-https://.
  5. תחת Events to send, בחר את האירועים שהכתובת הזו צריכה לקבל. יש 2 סוגים:
    • אירועי אפליקציה: אפליקציה בסביבת העבודה נוצרת, מתפרסמת, מועברת למצב לא מקוון, מועברת לאשפה או משוחזרת מהאשפה.
    • אירועי צ’אט AI: צ’אט ה-AI בעורך האפליקציה מתחיל לעבוד על הודעה (Chat turn started) או מסיים אותה (Chat turn ended).
  6. (אופציונלי) הזן Description כדי שהצוות יידע למה משמש ה-webhook.
  7. לחץ על Create webhook.
הטופס Create webhook עם כתובת endpoint, 3 אירועים נבחרים ותיאור

יצירת webhook


הפעלת webhook

ההפעלה שולחת אירוע בדיקה לכתובת ה-URL שלך. ה-webhook עובר למצב Active כשנקודת הקבלה עונה ומחזירה את הקוד שבאירוע הבדיקה. אם ההפעלה לא מסתיימת, Base44 מסבירה למה. למשל, ה-endpoint לא ענה בזמן או לא החזיר את הקוד. תקן את נקודת הקבלה והפעל שוב. להפעלת webhook:
  1. לחץ על שם סביבת העבודה שלך בפינה השמאלית התחתונה, ולחץ על Settings.
  2. לחץ על Webhooks בסרגל הצד, ואז לחץ על הכרטיסייה Outgoing.
  3. לחץ על הסמל More actions ליד ה-webhook ובחר Activate.
webhook יוצא במצב ממתין, עם התפריט More actions פתוח ו-Activate מסומן

הפעלת webhook ממתין


ניהול webhooks

השהה webhook בזמן שנקודת הקבלה מתעדכנת, שנה את מה שהוא מקבל או הסר אותו. webhook שנכשל כמה ימים ברציפות מושהה אוטומטית על ידי Base44 ועובר למצב Auto-paused. כשנקודת הקבלה עובדת שוב, חדש את ה-webhook. Base44 תריץ שוב את בדיקת ההפעלה לפני שתתחיל לשלוח. לניהול webhook:
  1. לחץ על שם סביבת העבודה שלך בפינה השמאלית התחתונה, ולחץ על Settings.
  2. לחץ על Webhooks בסרגל הצד, ואז לחץ על הכרטיסייה Outgoing.
  3. לחץ על הסמל More actions ליד ה-webhook ובחר אפשרות:
    • Send test event: שולח אירוע בדיקה כדי לבדוק את נקודת הקבלה.
    • Edit endpoint: משנה את כתובת ה-URL, את האירועים או את התיאור. שינוי הכתובת עוצר את השליחות עד שתפעיל את הכתובת החדשה.
    • Pause deliveries או Resume deliveries: עוצר או מחדש את השליחה. אירועים שקורים בזמן שה-webhook מושהה לא נשלחים מאוחר יותר.
    • Delete endpoint: מפסיק מיד לשלוח לכתובת ה-URL.
מינויים לאירועים הישנים builder.turn_started.v1 ו-builder.turn_ended.v1 כבר לא מקבלים אירועים. בחר במקומם Chat turn started ו-Chat turn ended.
התפריט More actions פתוח על webhook פעיל, עם Send test event, Edit endpoint, Pause deliveries ו-Delete endpoint

ניהול webhook


ניהול מפתח החתימה

כל בקשה נחתמת במפתח של סביבת העבודה. סבב מפתח מחליף אותו במפתח חדש. במשך 24 שעות Base44 חותמת גם במפתח הישן וגם בחדש, כך שנקודת הקבלה ממשיכה לעבוד בזמן שהמפתחים מוסיפים את המפתח החדש. כשהם מסיימים, לחץ על Finish rotation כדי להפסיק להשתמש במפתח הישן מוקדם יותר.
Revoke מפסיק מיד את החתימה של Base44 במפתח. נקודות קבלה שיש להן רק את המפתח הזה דוחות כל שליחה עד שיקבלו את המפתח החדש. לשינוי שגרתי, בצע סבב מפתח במקום זאת.
לסבב מפתח החתימה:
  1. לחץ על שם סביבת העבודה שלך בפינה השמאלית התחתונה, ולחץ על Settings.
  2. לחץ על Webhooks בסרגל הצד, ואז לחץ על הכרטיסייה Outgoing.
  3. לחץ על See public keys.
  4. לחץ על Rotate key, ואז לחץ על Rotate key לאישור.
חלון Public signing keys במהלך סבב, עם המפתח הנוכחי, תאריך הפסקת השימוש במפתח הישן ו-Finish rotation

מפתחות החתימה במהלך סבב


שאלות נפוצות

לחץ על שאלה למטה כדי ללמוד עוד על webhooks יוצאים.
לא. webhook מקבל את האירועים שבחרת עבור כל האפליקציות בסביבת העבודה. כל אירוע כולל את האפליקציה שהוא עוסק בה, כך שנקודת הקבלה יכולה להתעלם מאפליקציות שהיא לא צריכה.
Base44 ממשיכה לנסות לשלוח כל אירוע במשך כיום, ומחכה זמן ארוך יותר בין ניסיון לניסיון. אם ה-webhook ממשיך להיכשל כמה ימים, Base44 משהה אותו אוטומטית. כשהשרת עובד שוב, חדש את ה-webhook מהתפריט More actions שלו.
לא. שליחת אירועים ל-webhooks שלך לא צורכת קרדיטים.
דף זה תורגם באמצעות AI. למידע המדויק והעדכני ביותר, עיין בגרסה האנגלית.