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

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

יצירת נציג

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

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

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

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

הרשמה כשותף

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. פותחים את מפתח התקשורת העסקית מסוף ונכנסים באמצעות חשבון Google ב-Business Messages.
  2. לוחצים על יצירת נציג.
  3. בהגדרה סוג הנציג, בוחרים באפשרות Business Messages.
  4. מזינים ערכים בשדות Brand name (שם המותג) ו-Agent name (שם הסוכן).
  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 app.)

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

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

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

  1. פותחים את מפתח התקשורת העסקית מסוף.
  2. בוחרים את הנציג.
  3. בחלונית הניווט הימנית, לוחצים על Integrations (שילובים).
  4. בשביל Helper Bot, לוחצים על Disable.

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

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

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

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

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

  • פריסת דוגמת ה-Echo Bot ב-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. לוחצים על Link a Billing Account (קישור חשבון לחיוב).

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

פריסת הדוגמה של ה-Echo Bot

  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 הוא מזהה הפרויקט שבו יצרתם אותו יצירת סביבת ענן. מזהה הפרויקט מופיע במרכז הבקרה של הפרויקט ב-Google Cloud.

    Java

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

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

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

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

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

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

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

עכשיו, כשה-Echo Bot נפרס, צריך לציין webhook URL פעולה) כדי להתחיל קבלת הודעות.

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

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

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

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

  5. ב-Developer Console, לוחצים על Verify.

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

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

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

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

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

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

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

    שדה ערך
    הודעת פתיחה טוב שהצטרפת לשיחה של Echo Bot!
    מדיניות הפרטיות https://policies.google.com/privacy

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

התחלת השיחה

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

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

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

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

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

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

השלבים הבאים

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