משימת שילוב שיחות

המשימה Call Integration מאפשרת להפעיל או לקרוא לשילובים אחרים שנוצרו בפרויקט Google Cloud.

המשימה Call Integration (הפעלת שילוב) שימושית בתרחישים שבהם צריך להגדיר כמה שילובים קטנים (שילובי משנה) שמנוהלים באמצעות שילוב ראשי (שילוב אב). אחרי שמריצים שילוב משני, אפשר גם לקרוא את התגובה של השילוב המשני בשילוב הראשי.

לפני שמתחילים

  • המשימה Call Integration (הפעלת שילוב) משתמשת בטריגר ה-API כדי לזהות ולהפעיל שילובים ותתי-שילובים אחרים. לכן, אתם צריכים לוודא שהשילובים שאתם רוצים להפעיל מוגדרים באמצעות טריגר ה-API. מידע על הגדרת טריגר API זמין במאמר טריגר API.
  • מוודאים שחיברתם חשבון שירות שמנוהל על ידי משתמש לשילוב. אם לא הגדרתם חשבון שירות בניהול המשתמשים בשילוב, המערכת תשתמש כברירת מחדל בחשבון השירות שמוגדר כברירת מחדל (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) לצורך אימות.
  • מוודאים שלחשבון השירות שלכם יש את תפקיד ה-IAM‏ Application Integration Invoker (הפעלת שילוב אפליקציות). במאמר ניהול הגישה לחשבונות שירות מוסבר איך נותנים לחשבון שירות תפקיד.

הגדרת המשימה Call Integration (שילוב שיחות)

כדי להגדיר את המשימה Call Integration:

  1. נכנסים לדף Application Integration במסוף Google Cloud .

    מעבר אל Application Integration

  2. בתפריט הניווט, לוחצים על Integrations (שילובים).

    מוצג הדף Integrations (שילובים) עם רשימה של כל השילובים שזמינים בפרויקט בענן של Google.

  3. בוחרים שילוב קיים או לוחצים על יצירת שילוב כדי ליצור שילוב חדש.

    אם יוצרים שילוב חדש:

    1. מזינים שם ותיאור בחלונית יצירת שילוב.
    2. בוחרים אזור לשילוב.
    3. בוחרים חשבון שירות לאינטגרציה. אפשר לשנות או לעדכן את פרטי חשבון השירות של שילוב בכל שלב מחלונית סיכום השילוב בסרגל הכלים של השילוב.
    4. לוחצים על יצירה. השילוב החדש שנוצר ייפתח בכלי השילובים.

  4. בסרגל הניווט של כלי העריכה של השילוב, לוחצים על משימות כדי לראות את רשימת המשימות והמחברים הזמינים.
  5. לוחצים על הרכיב Call Integration (שילוב שיחות) וגוררים אותו למיקום הרצוי בכלי לעריכת השילובים.
  6. לוחצים על רכיב המשימה Call Integration (שילוב שיחות) בכלי העיצוב כדי להציג את חלונית ההגדרות של המשימה Call Integration (שילוב שיחות).
  7. מגדירים את פרטי השילוב המשני הבאים:
    1. API Trigger ID: מזינים את מזהה הטריגר של ה-API של האינטגרציה שרוצים להפעיל. אפשר להפעיל אינטגרציה אחת או כמה אינטגרציות עם אותו מזהה טריגר.
    2. הפעלת כל השילובים עם מזהה הטריגר הזה של ה-API: בוחרים באפשרות הזו כדי להפעיל את כל השילובים שיש להם אותו מזהה טריגר של ה-API.

      לדוגמה, אם לשילוב A ולשילוב B יש אותו מזהה טריגר של API, שני השילובים, A ו-B, יופעלו.

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

    4. אסטרטגיית ביצוע: בוחרים את מצבי הביצוע של שילובי המשנה שרוצים להפעיל.
      • ‫SYNC: מפעיל את שילוב המשנה במצב סינכרוני. במצב הזה, האינטגרציה הראשית ממתינה לסיום האינטגרציות המשניות לפני שהיא ממשיכה במשימות הבאות.

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

        אם בוחרים באפשרות הזו, צריך להגדיר את השהיית הביצוע (באלפיות השנייה). אם ההגדרה הזו מוגדרת, היא מציינת את משך ההשהיה עד להפעלת השילוב.

      כל השינויים במאפיינים נשמרים אוטומטית.

מיפוי משתני תגובה של שילוב משנה

בטבלה הבאה מפורטות מאפייני ההגדרה למיפוי משתנים בין השילוב הראשי לבין שילובי המשנה:
נכס תיאור
Map to sub-integration input(s)

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

לדוגמה, אם רוצים למפות את המשתנה productID של האינטגרציה הראשית למשתנה subIntProductID של אינטגרציית המשנה, בוחרים באפשרות productID בשדה Integration variable to map from (משתנה האינטגרציה למיפוי) ומזינים subIntProductID בשדה Subintegration input to map to (קלט של אינטגרציית המשנה למיפוי).
Map values to sub-integration output(s) מיפוי של משתני הפלט של שילוב המשנה למשתני השילוב הראשי.

לוחצים על Subintegration output to map from (פלט של שילוב משנה למיפוי) ובוחרים את שילוב המשנה. לוחצים על Integration variable to map to (משתנה שילוב למיפוי) ובוחרים את משתנה השילוב הראשי המתאים.

שיטות מומלצות

מידע על מכסות השימוש שחלות על המשימה Call Integration זמין במאמר מכסות שימוש.

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

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

מכסות ומגבלות

מידע על מכסות ומגבלות זמין במאמר מכסות ומגבלות.

המאמרים הבאים