רוצה ליצור את הנציג הראשון שלך?

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

יצירת הסוכן

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

במדריך למתחילים הזה תבצעו את הפעולות הבאות:

  • הרשמה כשותף
  • יצירת מותג וסוכן
  • אפשר גם לבדוק את הפיצ'רים בשיחה עם בוט העזרה של Business Messages
  • הגדרת הסוכן לשליחה ולקבלה של הודעות

כדי ליצור סוכן בלי להשתמש בדוגמה, אפשר לעיין במאמר יצירת סוכן.

הרשמה כשותף

  1. פותחים את מסוף המפתחים של Business Communications.
  2. בקטע Business Messages, לוחצים על יצירת חשבון שותף.

  3. מזינים את פרטי השותף:

    שדה ערך
    השם שלך שמך המלא
    שם השותף שם הארגון
    האתר של השותף האתר של הארגון
    אזור האזור שבו רוצים לארח את שירות הצ'אט עם עסקים

  4. קוראים את התנאים וההגבלות של 'הודעות לעסקים' ומאשרים אותם.

  5. לוחצים על יצירה.

ההרשמה שלכם כשותפים של Business Messages הושלמה. נוצר בשבילכם פרויקט בענן חדש ב-Google Cloud עם ממשקי Business Messages ו-Business Communications APIs מופעלים. אין לכם גישה לפרויקט הזה, והוא לא יפריע לאף אחד מהפרויקטים הקיימים שלכם ב-Google Cloud.

עכשיו יש לכם גישה ל-API של Business Messages ול-API של Business Communications.

יצירה של חשבון שירות

  1. בדף הבית של Business Communications Developer Console, לוחצים על Partner account settings (הגדרות חשבון שותף).
  2. בחלונית הניווט הימנית, לוחצים על חשבון שירות.

  3. לוחצים על Create key ואז על Create.

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

יצירת מותג וסוכן

נציג הוא נציג שיחה מטעם המותג – ישות שיחה שהמשתמשים מתקשרים איתה. אתם יוצרים מותג שמייצג את העסק וסוכן כדי שהצרכנים יוכלו לתקשר איתו בשיחה.

  1. פותחים את Business Communications Developer Console ונכנסים באמצעות חשבון Google של Business Messages.
  2. לוחצים על יצירת סוכן.
  3. בקטע Agent type (סוג הסוכן), בוחרים באפשרות Business Messages (הודעות לעסק).
  4. מזינים ערכים לפרמטרים שם המותג ושם הסוכן.
  5. מבצעים אחת מהפעולות הבאות:
    • כדי לנהל שיחה עם הנציג ולבדוק את הפיצ'רים הזמינים, בוחרים באפשרות הפעלת בוט העזרה של Business Messages.
    • כדי להתאים אישית את הנציג ולהכין אותו לטיפול בהודעות, מבטלים את הסימון של האפשרות הפעלת בוט העזרה של Business Messages.
  6. לוחצים על יצירת סוכן.

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

בדיקת התכונות באמצעות בוט העזרה של Business Messages

באמצעות בוט העזרה של Business Messages אפשר להתחיל בקלות שיחה עם הנציג, כדי לבדוק את האפשרויות השונות שהפלטפורמה מציעה. הפעלת ה-Helper Bot היא אופציונלית, אבל מומלצת מאוד כשיוצרים את הסוכן הראשון.

בוט העזרה מאפשר לכם

  • תכונות מתקדמות
  • איך מטמיעים תכונות
  • חיפוש משאבים להגדרת סוכנים

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

איך מתחילים שיחה עם בוט העזרה

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

כדי ליצור אינטראקציה עם צ'אטבוט העזרה, פועלים לפי השלבים הבאים בתיבת הדו-שיח הזו:

  1. אפשר לגשת לכתובות ה-URL לבדיקה של הסוכן בכמה דרכים:

    • לוחצים על הלחצן Android או על הלחצן iOS. לאחר מכן סורקים את קוד ה-QR באמצעות המכשיר הנייד המתאים ולוחצים על הפעלה. לחלופין, לוחצים על העתקת כתובת URL ל-Android או על העתקת כתובת URL ל-iOS כדי להעתיק את כתובת ה-URL לבדיקה של הסוכן.
    • לוחצים על שליחה כדי לשלוח את כתובות ה-URL לכתובת האימייל שלכם.

  2. פותחים את כתובת ה-URL במכשיר הנייד. (במכשירי iOS צריך להשתמש באפליקציית מפות Google).

השבתת בוט העזרה

כדי להתאים אישית את הנציג ולהכין אותו להפעלה, צריך להשבית את בוט העזרה של Business Messages.

כדי להשבית את בוט העזרה,

  1. פותחים את מסוף Business Communications Developer.
  2. בוחרים את הסוכן.
  3. בתפריט הניווט הימני, לוחצים על שילובים.
  4. בקטע בוט העזרה, לוחצים על השבתה.

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

הגדרת הסוכן לטיפול בהודעות

במדריך הזה נסביר איך לפרוס את Echo Bot ב-Google Cloud Platform ‏ (GCP) באמצעות webhook שנועד לעבד הודעות של משתמשים.

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

תבצעו את השלבים הבאים:

  • פריסת דוגמת הבוט Echo ב-GCP
  • הגדרת webhook URL לחשבון שותף ב-Business Messages
  • לספק מידע בסיסי על הסוכן

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

פריסת אפליקציית האינטרנט ב-GCP

פלטפורמת Business Messages מעבירה הודעות ממשתמשים ל-webhook בתשתית שלכם. במדריך הזה נסביר איך לפרוס את קוד המקור לדוגמה של Echo Bot ל-Webhook שהוגדר מראש. אם כבר יש לכם תשתית אינטרנט שאפשר להשתמש בה כדי לקבל הודעות, אתם יכולים ליצור webhook חדש בשירות האינטרנט הזה, אבל תצטרכו להגדיר את הלוגיקה בעצמכם. פרטים נוספים זמינים במאמר בנושא הגדרת webhook ברמת השותף.

יצירת סביבת ענן

כדי לפרוס את דוגמת ה-Echo Bot, צריך סביבת ענן.

כדי ליצור פרויקט ב-GCP כסביבת ענן:

  1. פותחים את הכלי לבחירת פרויקט במסוף Google Cloud.

    אם מעולם לא יצרתם פרויקט ב-Google Cloud, תצטרכו לאשר את התנאים וההגבלות.

  2. לוחצים על Create Project.

  3. מזינים שם ומיקום לפרויקט החדש.

    • מזהה הפרויקט נוצר באופן אוטומטי ומופיע מתחת לשם הפרויקט.
    • בשדה Location, לוחצים על Browse כדי להציג מיקומים אפשריים לפרויקט. אם אתם לא מוצאים את הארגון שלכם ב-Google Workspace, סימן שלא נכנסתם לחשבון Google Workspace. אפשר ליצור פרויקט בלי ארגון, אבל חלק מהתכונות מוגבלות. מידע נוסף זמין במאמר היתרונות של משאב הארגון.

  4. לוחצים על יצירה.

  5. לוחצים על תפריט.

  6. לוחצים על חיוב.

  7. לוחצים על קישור חשבון לחיוב.

  8. יוצרים חשבון חיוב חדש או מוסיפים לחשבון קיים את הפרויקט. ראו תכונות של תוכנית Google Cloud לתקופת ניסיון בחינם כדי להבין את אפשרויות התשלום.

פריסת הדוגמה של בוט האקו

  1. מתקינים את ה-CLI של gcloud. תשתמשו בזה כדי לפרוס את הקוד לדוגמה ב-Google Cloud.

  2. מורידים את הדוגמה של Echo Bot ופותחים אותה לתיקייה לא מכווצת (Node.js‏, Java‏, Python).

  3. מעתיקים את קובץ פרטי הכניסה בפורמט JSON שהורדתם בקטע יצירת חשבון שירות לתיקיית המשאבים של הדוגמה, ומשנים את שם פרטי הכניסה ל-bm-agent-service-account-credentials.json. הנתיב לקובץ פרטי הכניסה הזה תלוי בדוגמה שהורדתם.

    Node.js

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    Java

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    Python

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. במסוף, עוברים לספרייה full_sample של הדוגמה.

  5. מריצים את הפקודות הבאות במסוף כדי לפרוס את הדוגמה:

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    ‫PROJECT_ID הוא מזהה הפרויקט שיצרתם בקטע יצירת סביבת Cloud. מזהה הפרויקט מופיע בלוח הבקרה של הפרויקט ב-Google Cloud.

    Java

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    ‫PROJECT_ID הוא מזהה הפרויקט שיצרתם בקטע יצירת סביבת Cloud. מזהה הפרויקט מופיע בלוח הבקרה של הפרויקט ב-Google Cloud.

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    ‫PROJECT_ID הוא מזהה הפרויקט שיצרתם בקטע יצירת סביבת Cloud. מזהה הפרויקט מופיע בלוח הבקרה של הפרויקט ב-Google Cloud.

  6. שימו לב לכתובת ה-URL של האפליקציה שפרסתם בפלט של הפקודה האחרונה. זו כתובת הבסיס של ה-Webhook URL:

    Deployed service [default] to [https://PROJECT_ID.appspot.com]

הגדרת ה-webhook

עכשיו, אחרי שהבוט Echo נפרס, צריך לציין webhook URL (שמופעל על ידכם) כדי להתחיל לקבל הודעות.

  1. פותחים את הגדרות החשבון במסוף למפתחים של תקשורת עסקית.
  2. מוודאים שבחרתם בחשבון השותף הנכון.
  3. בקטע Business Messages webhook URL (כתובת ה-URL של ה-webhook של 'הודעות לעסקים'), לוחצים על Configure (הגדרה).

  4. בקטע כתובת URL של נקודת קצה ל-webhook, מזינים את כתובת ה-URL של האפליקציה + ‎/callback.

    נקודת הקצה תהיה בפורמט: ‎"https://PROJECT_ID.appspot.com/callback".

    נקודת הקצה הזו מוגדרת מראש בלוגיקה של האפליקציה בדוגמה שפרסתם ב-GCP.

  5. ב-Developer Console, לוחצים על אימות.

    כשפלטפורמת Business Messages מאמתת את ה-webhook, תיבת הדו-שיח נסגרת.

כדי להגדיר את ה-webhook באמצעות Business Communications API, אפשר לעיין בדוגמה: עדכון של webhook URL.

אתם יכולים להשתמש במסגרת הבדיקה של Business Messages כדי לבדוק אם ה-webhook שלכם מגיב בהצלחה למטענים ייעודיים (payloads) של Business Messages.

הזנת פרטי הנציג

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

  1. פותחים את מסוף Business Communications Developer.
  2. בחלונית הניווט הימנית, לוחצים על פרטי הנציג.

  3. אפשר לעדכן את הערכים איך שרוצים, או להשתמש בהצעות הבאות:

    שדה ערך
    הודעת פתיחה ברוכים הבאים לשיחה עם בוט האקו!
    מדיניות הפרטיות https://policies.google.com/privacy

  4. לוחצים על שמירה.

התחלת השיחה

כדי ליצור אינטראקציה עם ה-Echo Bot, פועלים לפי השלבים הבאים:

  1. פותחים את מסוף Business Communications Developer.
  2. בחלונית הניווט הימנית, לוחצים על פרטי הנציג.
  3. בקטע כתובות URL לבדיקת סוכן, לוחצים על הלחצן Android או על הלחצן iOS.

  4. סורקים את קוד ה-QR באמצעות המכשיר הנייד המתאים, או לוחצים על העתקת כתובת ה-URL ל-Android או על העתקת כתובת ה-URL ל-iOS כדי להעתיק את כתובת ה-URL לבדיקה של הסוכן.

    אפשר גם ללחוץ על שליחה כדי לשלוח את כתובות ה-URL לכתובת האימייל שלכם.

  5. פותחים את כתובת ה-URL במכשיר הנייד. (במכשירי iOS צריך להשתמש באפליקציית מפות Google).

מוצגת לכם הודעת הפתיחה של הנציג. בשלב הזה, אפשר לקיים אינטראקציה עם בוט Echo. הוא מחזיר לכם את ההודעות שאתם שולחים. בנוסף, אתם יכולים להפעיל תכונות מתקדמות על ידי שליחת מחרוזות ספציפיות: carousel,‏ card,‏ chips.

השלבים הבאים

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