הגדרת התגובה לפעולה מאתר אחר (webhook)

עליך לבחור אם להגדיר את ה-webhook באמצעות התקשורת העסקית מפתח Console או API.

מסוף למפתחים API

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

webhooks ברמת השותף וברמת הנציג

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

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

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

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

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

1. פותחים את Business Communications Console Console ונכנסים באמצעות חשבון Google ב-Business Messages.
2. פותחים את הגדרות החשבון.
3. מוודאים שבחרתם בחשבון השותף הנכון.
4. לוחצים על הגדרה ליד Business Messages webhook URL.
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. לוחצים על Verify במסוף. כשמערכת Business Messages מאמתת את ה-webhook שלכם, תיבת הדו-שיח תיסגר.

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

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

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

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

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

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

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