איך מגדירים חשבון שותף/ה

אחרי שנרשמים כשותפים ב-RCS for Business, מקבלים חשבון שותף. כדי לגשת להגדרות חשבון השותף, פותחים את RCS for Business Developer Console ולוחצים על Partner account settings (הגדרות חשבון השותף). מכאן אפשר:

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

עדכון פרטי חשבון השותף

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

שדה	תיאור
שם השותף	השם של חשבון השותף
השם המוצג	השם יופיע ב דוחות החיוב שהספקים מקבלים (בשדה owner_name). הספקים ישתמשו במידע הזה כדי לזהות אתכם כשותפים מהימנים, וכדי ליצור את פרטי החשבונית הנכונים לשימוש שלכם ב-RCS for Business כדי להגיע למנויים שלהם. השם שאתם מציינים כאן צריך להיות זהה לשם שמופיע בחוזי ההודעות שלכם עם הספק.
איש הקשר לנושאים טכניים	זה מי ש-Google יכולה לפנות אליו אם יש בעיות טכניות שקשורות לנציגים שלך. אפשר לעדכן את שם כתובת האימייל של החברה מספר טלפון
Webhook	זו כתובת ה-URL של נקודת הקצה של ה-Webhook. כדי לעדכן את ההגדרה, לוחצים על Configure (הגדרה). כש מגדירים את ה-webhook של השותף, הוא חל על כל הסוכנים. אם רוצים להשתמש ב-Webhook אחר לסוכן ספציפי, אפשר להגדיר webhook לסוכן שיחול רק על הסוכן הזה.

ניהול מותגים

שותפים ב-RCS לעסקים יכולים ליצור נציגים בשם מותגים.

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

בדף מותגים בהגדרות החשבון אפשר להוסיף, לערוך ולהסיר את המותגים שמשויכים לחשבון השותף.

הוספת מותג

הערה: כדי להוסיף מותג באמצעות RBM Management API, אפשר לעיין במסמכי התיעוד בנושא יצירת מותג.

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

עריכת מותג

הערה: כדי לערוך מותג באמצעות RBM Management API, אפשר לעיין במסמכי התיעוד בנושא שינוי השם של מותג.

כדי לערוך מותג:

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

הסרת מותג

אי אפשר להסיר מותג אם הוא משויך לנציג, גם אם הנציג לא הושק.

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

ניהול משתמשים

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

• מנהלים יכולים לגשת לכל היכולות של מסוף הפיתוח, כדי לנהל את כל הסוכנים ששייכים לחשבון השותף.
• לקוראים יש גישת קריאה בלבד ל-Developer Console, כדי לראות את כל הסוכנים ששייכים לחשבון השותף.

הוספת משתמש

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

כשמוסיפים משתמש חדש, הוא מקבל אימייל שמודיע לו שיש לו גישה לחשבון השותף.

להסיר משתמשים

כדי להסיר משתמש:

1. מחפשים את המשתמש שרוצים להסיר ולוחצים על הלחצן בשורה שלו בטבלה.
2. בוחרים באפשרות הסרת משתמש.
3. מאשרים את ההסרה.

המשתמש שהסרתם יקבל אימייל שמודיע לו שאין לו יותר גישה לחשבון השותף.

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

שינוי תפקיד של משתמש

כדי לעדכן את התפקיד של משתמש:

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

הגדרת חשבון שירות לאימות קריאות ל-API

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

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

כדי ליצור מפתח לחשבון שירות:

1. בדף הגדרות חשבון, עוברים לדף חשבון שירות.
2. לוחצים על Create key ואז על Create. הדפדפן מוריד את המפתח של חשבון השירות.

שומרים את המפתח של חשבון השירות במיקום פרטי ומאובטח. אל תשתפו את המפתח שלכם באופן גלוי לכולם. תצטרכו את המפתח הזה בהמשך כדי לגשת ל-RBM API.

הגדרת ה-webhook של השותף

במדריך בנושא תגובות לפעולות מאתר אחר (webhook) מוסבר איך להגדיר תגובה לפעולה מאתר אחר (webhook) של שותף.

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

אימות של הודעות נכנסות

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

כדי לוודא ש-Google שלחה את ההודעה שקיבלתם, פועלים לפי השלבים הבאים:

1. מחפשים את הכותרת X-Goog-Signature של ההודעה. זהו עותק של המטען הייעודי (payload) של גוף ההודעה, שעבר גיבוב (hashing) וקידוד Base64.
2. מפענחים את מטען ה-RBM הייעודי (payload) בקידוד Base-64 ברכיב message.body של הבקשה.
3. משתמשים בטוקן הלקוח של ה-webhook (שציינתם כשאתם מגדירים את ה-webhook) כמפתח, יוצרים HMAC של SHA512 של הבייטים של מטען ההודעה שפוענח ב-base64 ומקודדים את התוצאה ב-base64.
4. משווים את הגיבוב X-Goog-Signature לגיבוב שיצרתם.
   • אם הגיבובים תואמים, סימן ש-Google שלחה את ההודעה.

   • אם הגיבובים לא זהים, צריך לבדוק את תהליך הגיבוב בהודעה תקינה.

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

Node.js

  if ((requestBody.hasOwnProperty('message')) && (requestBody.message.hasOwnProperty('data'))) {
    // Validate the received hash to ensure the message came from Google RBM
    const headerHash = req.header('X-Goog-Signature');
    const userEventString = Buffer.from(requestBody.message.data, 'base64');
    const hmac = crypto.createHmac('sha512', myClientToken);
    const genHash = hmac.update(userEventString).digest('base64');

    if (headerHash === genHash) {
      const userEvent = JSON.parse(userEventString);
      const webhookType = req.header('X-Goog-Webhook-Type');

      // Route based on the header type
      if (webhookType === 'message_callback') {
        handleMessage(userEvent);
      } else if (webhookType === 'agent_callback') {
        handleAgentEvent(userEvent);
      }
    } else {
      console.log('Hash mismatch - ignoring message');
      res.sendStatus(401);
      return;
    }
  }

  res.sendStatus(200);
  

השלבים הבאים

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