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

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

• אם נרשמתם לחשבון שותף לפני 7 במרץ 2022, צריך להפעיל את Business Messages API. מידע נוסף מופיע בקטע הפעלת Business Communications API ו-Business Messages API.

יצירת הנציג

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

במדריך למתחילים:

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

כדי ליצור נציג בלי להשתמש בדוגמה, עיינו בקטע יצירת הנציג.

הרשמה כשותפים

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

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

   שדה	ערך
   איך קוראים לך?	שמך המלא
   שם השותף	שם הארגון שלך
   האתר של השותף	האתר של הארגון שלך
   אזור	האזור שבו רוצים לארח את השירות Business Messages

4. קוראים ומאשרים את התנאים וההגבלות של Business Messages.

5. לוחצים על Create.

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

עכשיו יש לך גישה ל-Business Messages ול-Business Communications APIs.

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

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

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

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

יצירת מותג ונציג

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

1. פותחים את מסוף התקשורת העסקית ונכנסים עם חשבון Google Messages של העסק.
2. לוחצים על יצירת נציג.
3. בהגדרה סוג הנציג, בוחרים באפשרות הודעות עסקיות.
4. מזינים את הערכים של שם המותג ושל שם הנציג.
5. מבצעים אחת מהפעולות האלה:
   • כדי להשתתף בשיחה עם הנציג, תוכלו לנסות את בוט העזרה של Business Messages.
   • כדי להתאים אישית את הנציג ואיך להכין אותו לטיפול בהודעות, מבטלים את הסימון של הפעלת בוט העזרה של Business Messages.
6. לוחצים על יצירת נציג.

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

בוט התכונות של Business Messages עם בוט העזרה

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

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

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

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

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

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

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

1. אפשר לגשת לכתובות ה-URL לבדיקה של הנציג. כך עושים זאת:

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

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

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

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

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

1. פותחים את Console Communications Developer Console.
2. בוחרים את הנציג.
3. בתפריט הניווט הימני, לוחצים על שילובים.
4. לבוט העזרה, לוחצים על השבתה.

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

הגדרת הנציג לטיפול בהודעות

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

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

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

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

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

הערה: אם הפעלתם את בוט העזרה של Business Messages, אתם צריכים להשבית את הנציג כדי לקבל התראות ב-webhook.

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

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

הערה: כשיוצרים אפליקציה משלכם, אפשר להשתמש בלוגיקה שהוגדרה מראש בבוט של Echo כמודל. יש לכלול לוגיקה של clientToken כדי לוודא שההודעות שנשלחות אליך מגיעות מ-Google.

יצירה של סביבת Cloud

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

הערה: כשיוצרים סביבת Cloud צריך להוסיף לפרויקט חשבון לחיוב ב-Cloud. אפשר לבחור בחשבון בחינם או בתשלום. אפשר גם לפרוס את בוט ההד בשרת שלכם.

כדי ליצור פרויקט GCP כסביבת ענן, פועלים לפי השלבים הבאים:

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

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

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

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

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

4. לוחצים על Create.

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

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

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

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

פריסת דגי הבוט של Echo

1. להתקין את gcloud CLI. כך תוכלו לפרוס את הקוד לדוגמה ב-Google Cloud.

2. מורידים את הדגימת הבוט של Echo וחילוץ אותה (Node.js, Java, Python).

3. מעתיקים את קובץ פרטי הכניסה שהורדתם ביצירת חשבון שירות לתיקיית המשאבים לדוגמה, ומשנים את השם ל-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

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

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

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

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

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

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

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

במאמר דוגמה לעדכון webhook URL מוסבר איך להגדיר את ה-webhook עם Business Communications API.

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

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

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

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

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

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

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

התחלת השיחה

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

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

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

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

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

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

השלבים הבאים

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

• הסבר על Business Messages

• בודקים את הדרישות וההנחיות של Business Messages.

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

• אימות התשתית.

• הפעלת סוכנים ומיקומים נוספים.