קישור לפעולות (Dialogflow)

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

כמה דוגמאות לקישורים שימושיים ל-Assistant:

• קישור משתמשים להנחיות קוליות מאתר הדרכה.
• קישור של משתמשים לחוויה של תמיכת לקוחות מדף 'קבלת עזרה'.
• קישור משתמשים אל כוונת עדכון כדי שיוכלו להביע הסכמה לעדכונים העתידיים שלכם.

הערה: קישורים ל-Assistant שונים מקישורי אינטרנט של ספרייה, שמפנים את המשתמשים לדף שלכם בספרייה.

כדי ליצור כתובת אתר עבור פעולה, בצע את הפעולות הבאות:

1. ב-Actions Console, עוברים אל פיתוח > פעולות.
2. לוחצים על הפעולה שרוצים ליצור עבורה קישור.
3. בקטע קישורים, מפעילים את האפשרות רוצה להפעיל כתובת URL לפעולה הזו?
4. מזינים את שם הקישור. הכותרת הזו צריכה לכלול פועל שמתאר את הפעולה שתעשו. לדוגמה, אם הפעולה מעבירה את המשתמש לתהליך עסקה כדי לקנות כרטיסים להופעה, כותרת קישור שימושית תהיה 'רכישת כרטיסים להופעות'.
5. לוחצים על שמירה.

אפשר להעתיק את כתובת ה-URL שצוינה ולהפנות אליה בכל מקום שבו רוצים להפנות משתמשים לפעולה הספציפית הזו.

הערה: אם מפעילים קישור ל-Assistant לאחר פריסת הפעולה, צריך לפרוס מחדש את הפעולה כדי שהקישור ייכנס לתוקף.

פרמטרים של קישור ל-Assistant

קישורים ל-Assistant יכולים לכלול Intent ופרמטרים בכתובת ה-URL. Google מטפלת בפרמטרים בהתאם לסוג Intent שמצוין בכתובת ה-URL.

מפרט כתובת ה-URL של קישור ל-Assistant

התחביר הכללי של כתובת URL של קישור ל-Assistant הוא:

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$param=$value][&$utm_param=$utm_value]

הפרמטרים של כתובת האתר שאפשר להגדיר מתוארים בטבלה הבאה:

פרמטר של כתובת URL	התיאור
$action_id	המזהה המספרי של הפעולה.
$intent	השם המלא של קהל מובנה או מותאם אישית עם כוונת רכישה.
$param	השם המלא של פרמטר ה-Intent שצוין בחבילת הפעולות.
$value	ערך מקודד של כתובת URL מהסוג שהוצהר עבור $param בחבילת הפעולות.
$utm_param	רשימה של סוג פרמטרים אחד או יותר של מנטר התנועה של Urchin. הערכים החוקיים כוללים: utm_source, utm_medium, utm_campaign, utm_term ו-utm_content.
$utm_value	ערך המחרוזת של הפרמטר 'מנטר התנועה של Urchin'.

כתובות URL של קישורים ל-Assistant עם כוונות מובנות

אם הקישור ל-Assistant מכיל אובייקט אובייקט מובנה (Intent מתחיל ב-actions.intent.*), Google תנסה לחלץ את כל הפרמטרים המובנים של ה-Intent מכתובת ה-URL ולהעביר אותם אל הפעולה. המערכת מסירה פרמטרים ש-Google לא מבינה כפרמטרים מובנים של Intent.

עבור פעולות שיחה, Google שולחת את הפרמטרים האלה למילוי הבקשה שלכם כחלק מההודעה AppRequest.

בדוגמה הבאה אפשר לראות איך לציין כתובת URL של קישור ל-Assistant שכוללת Intent מובנה עם פרמטר Intent אחד:

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.GET_HOROSCOPE&param.astrologySign=%22cancer%22

כתובות URL של קישורים ל-Assistant עם כוונות Intent בהתאמה אישית

עבור אובייקטי Intent בהתאמה אישית, Google שולפת רק את הפרמטרים שהוגדרו על ידי הפעולה כחלק מה-Intent, ומתעלמת כל הפרמטרים האחרים.

בדוגמה הבאה אפשר לראות איך לציין כתובת URL של קישור ל-Assistant שכוללת Intent בהתאמה אישית:

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.topic=sports

לכתובת ה-URL לדוגמה שלמעלה, ב-AppRequest, Google מוסיפה אובייקט JSON באופן הבא:

argument {
  name: ‘topic’,
  raw_text: ‘sports’,
  text_value: ‘sports’,
}

כתובות URL של קישורים ל-Assistant ללא כוונות Intent

אם לא מציינים Intent בקישור של Assistant, כברירת מחדל, Google מקשרת ל-Intent MAIN (actions.intent.MAIN) של הפעולה באופן הבא:

• אם לא הפעלת באופן מפורש את Intent MAIN בקישור של Assistant, Google תפעיל את ה-Intent הראשי ללא פרמטרים, בדומה לאופן הפעולה של "Talk to app_name".
• אם הפעלתם באופן מפורש את ה-Intent MAIN, Google תעביר את הפרמטרים אל Actions.

בדוגמה הבאה אפשר לראות איך לציין כתובת URL של קישור ל-Assistant ללא כוונה:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4

כתובות URL של קישורים ל-Assistant עם פרמטרים של מנטר התנועה של Urchin

פרמטרים של מנטר התנועה של Urchin הם מחרוזות ש-Google שולחת ל-Action שלכם כשמשתמשים לוחצים על קישור ל-Assistant. תוכלו להשתמש בהם מאוחר יותר לניתוח נתונים.

הפרמטרים של מנטר התנועה של Urchin ש-Google שולחת לפעולה שלכם כוללים את הפרטים הבאים:

• utm_source
• utm_medium
• utm_campaign
• utm_term
• utm_content

הדוגמה הבאה מראה איך לציין כתובת URL של קישור ל-Assistant שכוללת פרמטרים של מנטר התנועה של Urchin:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale

לכתובת ה-URL לדוגמה שלמעלה, Google מוסיפה את הארגומנטים הבאים להודעה AppRequest:

argument {
  name: ‘utm_source’,
  raw_text: ‘Google’,
  text_value: ‘Google’,
}
argument {
  name: ‘utm_medium’,
  raw_text: ‘email’,
  text_value: ‘email’,
}
argument {
  name: ‘utm_campaign’,
  raw_text: ‘holiday sale’,
  text_value: ‘holiday sale’,
}

קישורים ל-Assistant לבדיקה

אפשר לבדוק קישורים ל-Assistant לכל Intent (ראשי או בהתאמה אישית, עם או בלי פרמטרים) באמצעות הסימולטור או מכשיר.

כדי לבדוק את הקישור ל-Assistant:

1. מפעילים את הקישור ל-Assistant במסוף.
2. נכנסים ל-Assistant עם אותו חשבון שבו השתמשתם כדי ליצור את פרויקט Actions on Google.
3. יוצרים גרסה ניתנת ללחיצה של הקישור ל-Assistant (באימייל, בצ'אט, במסמך וכו').
4. במכשיר עם Assistant מובנית, לוחצים על הקישור שנוצר בשלב הקודם.

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

הערה: הקישורים ל-Assistant זמינים בכל ערוצי הפריסה (אלפא, בטא וייצור). לדוגמה, אם הקישור ל-Assistant מופעל בגרסת האלפא של הפעולה, הקישור יהיה זמין לבודקי אלפא.

הגבלות ושיטות מומלצות

עכשיו אפשר להפיץ את כתובת ה-URL של הקישור ל-Assistant ולהפנות אליה מחוץ למאגר או לשירותים אחרים של Google, לכן חשוב לשים לב להגבלות ולשיטות המומלצות הבאות:

• עליך לוודא שיש לך תמיכה בכל הקישורים ל-Assistant. אם תפיץ קישור ל-Assistant שמתקלקל מאוחר יותר, ייתכן שפרויקט הפעולות שלך יסומן כלא תקין ויוסר.

• פרסום קישור פירושו שיש תמיכה בטריגרים ממקורות לא מהימנים. עבור כל פעולה מקושרת, עליכם לאשר במפורש מול המשתמש לפני ביצוע "פעולה בעולם האמיתי". לדוגמה, פעולה שמכבה מכשיר לבית חכם צריכה להציג למשתמש את השאלה "האם אתה בטוח שברצונך לכבות את $applianceName?"

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