אימות באמצעות OAuth

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

‫Business Messages תומך ב-OAuth 2.0 באמצעות ההצעה לשליחת בקשת אימות, שמבקשת מהמשתמשים להיכנס לספק OAuth שהגדרתם עבור הנציג. אחרי שהמשתמש נכנס בהצלחה, Business Messages מעביר קוד הרשאה בחזרה לנציג כהודעה.

אחרי שמקבלים את קוד ההרשאה מספק ה-OAuth, אפשר לבצע אינטגרציה עם ה-API שלו ולתמוך בתהליכי שיחה שנדרש בהם מידע על זהות המשתמש. חשוב לזכור שלכל שירות שאתם משתמשים בו יש תנאי שימוש משלו.

הגדרת OAuth לסוכן

כדי להפעיל את ההצעה לשליחת בקשת אימות לנציג, צריך קודם להגדיר OAuth.

כדי לציין הגדרת OAuth, שולחים בקשת PATCH באמצעות Business Communications API כדי לעדכן את השדה endpointUrl של הסוכן.

אחרי שמציינים את כתובת ה-URL של נקודת הקצה, צריך לשמור את כתובות ה-URI של ההפניה האוטומטית של הנציג ולעדכן את כתובות ה-URI של ההפניה האוטומטית בפרטים של ספק OAuth.

דרישות מוקדמות

תצטרכו את הפריטים הבאים:

  • ספק OAuth שתואם למפרט OAuth 2.0
  • הנתיב למפתח של חשבון השירות בפרויקט GCP במכונת הפיתוח
  • הנציג name (לדוגמה, brands/12345/agents/67890)

    אם אתם לא יודעים את name של הסוכן, תוכלו לעיין במאמר איך מציגים רשימה של כל הסוכנים של מותג.

  • כתובת ה-URL של נקודת הקצה שבה המשתמשים נכנסים לספק OAuth

שליחת הבקשה לעדכון

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