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

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

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

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

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

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

ניהול מותגים

כשותפים של RCS for Business, אתם יכולים ליצור סוכנים בשם מותגים.

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

הוספת מותג

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

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

עריכת מותג

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

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

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

הסרת מותג

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

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

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

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

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

הוספת משתמש

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

במדריך בנושא Webhooks מוסבר איך להגדיר את ה-webhook של השותף.

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

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

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

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

1. מחפשים את הכותרת X-Goog-Signature של ההודעה. זהו עותק מגובב בקידוד Base64 של מטען הייעודי (payload) של גוף ההודעה.
2. מפענחים את מטען ה-RBM הייעודי בקידוד Base64 ברכיב 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);
  

השלבים הבאים

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