הגדרת ה-webhook

תגובה לפעולה מאתר אחר (webhook) היא קריאה חוזרת (callback) שנוצרה על ידי שותף, שמציינת איך הנציג צריך להגיב להודעות ולאירועים. אלא אם משתמשים בפתרון אוטומטי שנוצר מראש כמו Dialogflow, צריך להגדיר webhook בהתאמה אישית כדי להגדיר את ההתנהגות של הנציג.

תגובות לפעולה מאתר אחר (webhook) ברמת השותף וברמת הנציג

אפשר להגדיר את התגובה לפעולה מאתר אחר (webhook) ברמת השותף או ברמת הנציג. כשמוסיפים webhook לכל משתמש ברמה של כל נציג, כל תגובה חלה על כל נציג.

אם אתם מפעילים כמה נציגים עם התנהגות שונה, מומלץ להגדיר webhook שונה לכל סוכן באמצעות ההגדרה ברמת הנציג. מצד שני, אם לנציגים שלכם יש התנהגות דומה או אם יש לכם רק נציג אחד, תוכלו להשתמש ב-webhook ברמת השותף.

אם הגדרתם תגובה לפעולה מאתר אחר (webhook) ברמת השותף וגם תגובה לפעולה מאתר אחר (webhook) ברמת הנציג, התגובה לפעולה מאתר אחר (webhook) ברמת הנציג תקבל עדיפות על ידי הנציג הספציפי, ואילו התגובה לפעולה מאתר אחר (webhook) ברמת השותף תחול על סוכנים שלא מוגדר להם webhook ברמת הנציג.

הגדרת webhook ברמת השותף

כדי להגדיר webhook ברמת השותף, צריך לפעול לפי השלבים הבאים:

  1. פותחים את Business Communications Developer Console ופותחים את חשבון Google Messages של העסק.
  2. פותחים את הגדרות החשבון.
  3. מוודאים שנבחר חשבון השותף הנכון.
  4. ליד כתובת ה-URL של ה-webhook של Business, לוחצים על Configure (הגדרה).
  5. בכתובת URL של נקודת קצה (webhook), מזינים את כתובת ה-URL של האפליקציה + "/callback/ ". לדוגמה: https://PROJECT_ID.appspot.com/callback/ .
  6. שימו לב לערך של clientToken. צריך לוודא שכל ההודעות שמתקבלות מ-Google.

  7. צריך להגדיר את התגובה לפעולה מאתר אחר (webhook) כדי לקבל בקשת POST עם הפרמטר clientToken שצוין, ולשלוח תגובת 200 OK עם הטקסט הפשוט של הפרמטר הסודי כגוף התגובה. לדוגמה, נניח שהתגובה לפעולה מאתר אחר (webhook) מקבלת בקשת POST עם תוכן הגוף הבא:

    {
"clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}

    במקרה כזה, התגובה לפעולה מאתר אחר (webhook) צריכה לאשר את הערך clientToken. אם התגובה הנכונה היא clientToken, יש להחזיר תגובה 200 OK שגוף התגובה הוא 0123456789.

  8. במסוף, לוחצים על אימות. כשמערכת Business Messages מאמתת את ה-webhook, הדו-שיח נסגר.

הגדרת webhook ברמת הנציג

אתם יכולים לשלוח לנציג נציגים ברמת התגובה לפעולה מאתר אחר (webhook) ברמת השותף. אם אתם רוצים שההודעות לנציג ספציפי יגיעו ל-webhook אחר, תוכלו להגדיר webhook ברמת הנציג.

  1. פותחים את Business Communications Developer Console ופותחים את חשבון Google Messages של העסק.
  2. לוחצים על הנציג.
  3. לוחצים על שילובים.
  4. עבור webhook, לוחצים על Configure.
  5. בשדה webhook URL של נקודת הקצה מזינים את ה-webhook URL שמתחילים ב-https:// .
  6. שימו לב לערך של clientToken. יהיה עליכם לוודא שהודעות שאתם מקבלים מגיעות מ-Google.

  7. מגדירים את התגובה לפעולה מאתר אחר (webhook) כך שתקבל בקשת POST עם הפרמטר clientToken שצוין, וישלח תגובה של 200 OK עם הערך של הפרמטר הסודי. לדוגמה, נניח שה-webhook שלכם מקבל בקשת POST עם התוכן הבא:

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}

    במקרה כזה, התגובה לפעולה מאתר אחר (webhook) צריכה לאמת את הערך clientToken. אם התשובה הנכונה היא clientToken, יש להחזיר תגובה 200 OK שבה הפרמטר הסודי של כתובת ה-URL מוגדר ל-0123456789.

  8. במסוף, לוחצים על אימות. כשמערכת Business Messages מאמתת את ה-webhook, הדו-שיח נסגר.