حساب شریک خود را تنظیم کنید، حساب شریک خود را تنظیم کنید

هنگامی که به عنوان شریک RCS for Business ثبت نام کردید، یک حساب شریک دارید. برای دسترسی به تنظیمات حساب شریک خود، Business Communications Developer Console را باز کنید و روی تنظیمات حساب شریک کلیک کنید. از اینجا می توانید کارهای زیر را انجام دهید:

اطلاعات حساب شریک را به روز کنید

از صفحه تنظیمات ، می توانید شناسه شریک خود را مشاهده کرده و اطلاعات زیر را به روز کنید:

میدان توضیحات
نام شریک نام حساب شریک شما
نام نمایشی Name will appear in the billing reports that carriers receive (as the owner_name field). شرکت های مخابراتی از این برای شناسایی شما به عنوان یک شریک قابل اعتماد و ایجاد اطلاعات صورتحساب صحیح برای استفاده شما از RCS for Business برای دسترسی به مشترکین خود استفاده می کنند. نامی که در اینجا ارائه می‌دهید باید با نامی که در قراردادهای پیام‌رسانی شرکت مخابراتی شما استفاده می‌شود مطابقت داشته باشد.
نقطه تماس فنی

فردی که Google در صورت وجود هرگونه مشکل فنی با نمایندگان شما با او تماس خواهد گرفت. می توانید آنها را به روز کنید

  • نام
  • آدرس ایمیل شرکت
  • شماره تلفن
وب هوک این URL نقطه پایانی وب هوک شما است. برای به روز رسانی روی Configure کلیک کنید. هنگامی که وب هوک شریک خود را پیکربندی می کنید، برای همه نمایندگان شما اعمال می شود. اگر می خواهید از یک وب هوک متفاوت برای یک نماینده استفاده کنید، می توانید یک وب هوک عامل را پیکربندی کنید که فقط برای آن نماینده اعمال شود.

برندها را مدیریت کنید

به عنوان یک شریک RCS برای کسب و کار، می توانید نمایندگانی از طرف برندها ایجاد کنید.

از صفحه برندها در تنظیمات حساب برای افزودن، ویرایش و حذف مارک های مرتبط با حساب شریک خود استفاده کنید.

یک نام تجاری اضافه کنید

برای افزودن نام تجاری، نام آن را در قسمت ورودی وارد کنید و روی افزودن کلیک کنید.

یک برند را ویرایش کنید

برای ویرایش برند:

  1. روی کادر کنار نام برند کلیک کنید.
  2. روی دکمه کلیک کنید و روی Edit name کلیک کنید.
  3. ویرایش های خود را انجام دهید و روی انجام شد کلیک کنید.

برندی را حذف کنید

اگر نام تجاری با یک نماینده مرتبط باشد، نمی‌توان آن را حذف کرد، حتی اگر آن نماینده راه‌اندازی نشده باشد.

برای حذف یک نام تجاری، روی کادر تأیید کنار نام مارک کلیک کنید و روی حذف کلیک کنید.

مدیریت کاربران

صفحه کاربران در تنظیمات حساب جایی است که شما کاربران حساب شریک خود را مدیریت می کنید. کاربری که حساب شریک را ایجاد کرده است نقش مالک را دارد. کاربران جدید می توانند نقش مدیر یا خواننده را داشته باشند.

  • مدیران می‌توانند به تمام قابلیت‌های Developer Console دسترسی داشته باشند تا همه و همه عوامل متعلق به حساب شریک را مدیریت کنند.
  • خوانندگان به Developer Console دسترسی فقط خواندنی دارند تا همه و همه عوامل متعلق به حساب شریک را مشاهده کنند.

یک کاربر اضافه کنید

برای افزودن کاربر، آدرس ایمیل او را در قسمت ورودی وارد کنید و نقش او را انتخاب کنید.

وقتی کاربر جدیدی اضافه می کنید، ایمیلی دریافت می کند که به آنها اطلاع می دهد که به حساب شریک دسترسی دارند.

حذف یک کاربر

برای حذف یک کاربر:

  1. کاربری را که می خواهید حذف کنید پیدا کنید و روی دکمه در ردیف جدول او کلیک کنید.
  2. حذف کاربر را انتخاب کنید.
  3. حذف را تایید کنید.

کاربری که حذف کردید ایمیلی دریافت می کند که به او اطلاع می دهد که دیگر به حساب شریک دسترسی ندارد.

نمی‌توانید کاربری با نقش مالک را حذف کنید. برای تغییر یا حذف مالک، باید با پشتیبانی تماس بگیرید.

نقش کاربر را تغییر دهید

برای به روز رسانی نقش کاربر:

  1. کاربری را که می خواهید به روز کنید پیدا کنید و روی دکمه در ردیف جدول او کلیک کنید.
  2. ویرایش نقش را انتخاب کنید.
  3. یک نقش جدید را از منوی کشویی انتخاب کنید.
  4. روی ذخیره کلیک کنید.

حساب سرویس را برای احراز هویت تماس‌های API تنظیم کنید

هنگامی که با RBM API تماس می گیرید، تماس ها را با یک کلید حساب سرویس احراز هویت می کنید. این کلید به شما امکان می دهد مارک ها و نمایندگان را ایجاد و مدیریت کنید و به عنوان نماینده پیام ها و درخواست ها را ارسال کنید. یک حساب سرویس می تواند حداکثر 10 کلید داشته باشد.

برای احراز هویت ایمن تماس‌های API، به ابزار خط فرمان oauth2l نیز نیاز دارید.

برای ایجاد یک کلید حساب سرویس، مراحل زیر را دنبال کنید:

  1. در تنظیمات حساب ، به صفحه حساب سرویس بروید.
  2. روی ایجاد کلید کلیک کنید، سپس روی ایجاد کلیک کنید. مرورگر شما کلید حساب سرویس را دانلود می کند.

کلید حساب سرویس خود را در مکانی امن و خصوصی ذخیره کنید. کلید خود را به صورت عمومی به اشتراک نگذارید. You'll need this key later to access the RBM APIs.

وب هوک شریک خود را پیکربندی کنید

A webhook is a partner-created HTTPS callback that specifies how your agent should respond to messages and events. هنگامی که وب هوک خود را پیکربندی کردید، می توانید شروع به دریافت پیام ها و رویدادها کنید.

اگر می‌خواهید برای هر یک از نمایندگان خود از یک وب هوک متفاوت استفاده کنید، می‌توانید یک وب هوک در سطح نماینده راه‌اندازی کنید که وب‌هوک شریک را لغو کند. برای اطلاعات بیشتر، پیکربندی یک عامل وب هوک را ببینید.

برای پیکربندی وب هوک شریک خود، این مراحل را دنبال کنید:

  1. Open the Business Communications Developer Console and sign in with your RCS for Business partner Google Account.

  2. تنظیمات حساب را باز کنید.

  3. برای آدرس اینترنتی وب هوک پیام‌رسانی تجاری RCS ، روی پیکربندی کلیک کنید.

  4. برای URL نقطه پایانی Webhook ، نشانی وب هوک خود را که با "https://" شروع می شود وارد کنید.

  5. به ارزش clientToken خود توجه کنید. You need it to verify that messages you receive are coming from Google .

  6. وب هوک خود را طوری پیکربندی کنید که درخواست POST را با پارامتر clientToken مشخص شده بپذیرد و یک پاسخ 200 OK با مقدار متن ساده پارامتر secret به عنوان بدنه پاسخ ارسال کند.

    به عنوان مثال، اگر وب هوک شما یک درخواست POST با محتوای بدنه زیر دریافت کند

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"1234567890"
}

    سپس وب هوک شما باید مقدار clientToken را تأیید کند و اگر clientToken درست باشد، یک پاسخ 200 OK با 1234567890 به عنوان بدنه پاسخ برگرداند:

    // clientToken from Configure
const myClientToken = "SJENCPGJESMGUFPY";

// Example endpoint
app.post("/rbm-webhook", (req, res) => {
  const msg = req.body;
  if (msg.clientToken === myClientToken) {
      res.status(200).send(msg.secret);
      return;
  }
  res.send(400);
});

  7. در Developer Console، روی تأیید کلیک کنید. When RCS for Business verifies your webhook, the dialog closes.

For guidance on processing webhooks asynchronously to prevent delivery failures, see Message handling .

پیام های دریافتی را تأیید کنید

Because webhooks can receive messages from any senders, you should verify that Google sent incoming messages before processing message content.

برای تأیید اینکه Google پیامی را که دریافت کرده‌اید ارسال کرده است، این مراحل را دنبال کنید:

  1. هدر X-Goog-Signature پیام را استخراج کنید. This is a hashed, base64-encoded copy of the message body payload.
  2. Base-64-بارگذاری RBM را در عنصر message.body درخواست رمزگشایی کنید.
  3. با استفاده از توکن کلاینت وب‌هوک خود (که هنگام راه‌اندازی وب‌هوک خود مشخص کرده‌اید) به‌عنوان یک کلید، یک SHA512 HMAC از بایت‌های بار پیام رمزگشایی شده base-64 ایجاد کنید و نتیجه را در base64 رمزگذاری کنید.
  4. Compare the X-Goog-Signature hash with the hash you created.
    • If the hashes match, you've confirmed that Google sent the message.

    • If the hashes don't match, check your hashing process on a known-good message.

      If your hashing process is working correctly and you receive a message that you believe was fraudulently sent to you, contact us .

Node.js 

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

    if (headerHash === genHash) {
      let userEvent = JSON.parse(userEventString);

      console.log('userEventString: ' + userEventString);
      handleMessage(userEvent);
    } else {
      console.log('hash mismatch - ignoring message');
    }
  }

  res.sendStatus(200);

مراحل بعدی

Now that your partner account is set up, it's time to build your first agent .

،

Once you've registered as an RCS for Business partner, you have a partner account. برای دسترسی به تنظیمات حساب شریک خود، Business Communications Developer Console را باز کنید و روی تنظیمات حساب شریک کلیک کنید. From here, you can do the following:

اطلاعات حساب شریک را به روز کنید

From the Settings page, you can view your partner ID and update the following information:

میدان توضیحات
نام شریک نام حساب شریک شما
نام نمایشی نام در گزارش‌های صورت‌حساب‌هایی که شرکت‌های مخابراتی دریافت می‌کنند ظاهر می‌شود (به عنوان قسمت owner_name ). شرکت های مخابراتی از این برای شناسایی شما به عنوان یک شریک قابل اعتماد و ایجاد اطلاعات صورتحساب صحیح برای استفاده شما از RCS for Business برای دسترسی به مشترکین خود استفاده می کنند. نامی که در اینجا ارائه می‌دهید باید با نامی که در قراردادهای پیام‌رسانی شرکت مخابراتی شما استفاده می‌شود مطابقت داشته باشد.
نقطه تماس فنی

فردی که Google در صورت وجود هرگونه مشکل فنی با نمایندگان شما با او تماس خواهد گرفت. می توانید آنها را به روز کنید

  • نام
  • آدرس ایمیل شرکت
  • شماره تلفن
وب هوک این URL نقطه پایانی وب هوک شما است. برای به روز رسانی روی Configure کلیک کنید. هنگامی که وب هوک شریک خود را پیکربندی می کنید، برای همه نمایندگان شما اعمال می شود. اگر می خواهید از یک وب هوک متفاوت برای یک نماینده استفاده کنید، می توانید یک وب هوک عامل را پیکربندی کنید که فقط برای آن نماینده اعمال شود.

برندها را مدیریت کنید

به عنوان یک شریک RCS برای کسب و کار، می توانید نمایندگانی از طرف برندها ایجاد کنید.

از صفحه برندها در تنظیمات حساب برای افزودن، ویرایش و حذف مارک های مرتبط با حساب شریک خود استفاده کنید.

یک نام تجاری اضافه کنید

برای افزودن نام تجاری، نام آن را در قسمت ورودی وارد کنید و روی افزودن کلیک کنید.

یک برند را ویرایش کنید

برای ویرایش برند:

  1. روی کادر کنار نام برند کلیک کنید.
  2. روی دکمه کلیک کنید و روی Edit name کلیک کنید.
  3. ویرایش های خود را انجام دهید و روی انجام شد کلیک کنید.

برندی را حذف کنید

اگر نام تجاری با یک نماینده مرتبط باشد، نمی‌توان آن را حذف کرد، حتی اگر آن نماینده راه‌اندازی نشده باشد.

برای حذف یک نام تجاری، روی کادر تأیید کنار نام مارک کلیک کنید و روی حذف کلیک کنید.

مدیریت کاربران

صفحه کاربران در تنظیمات حساب جایی است که شما کاربران حساب شریک خود را مدیریت می کنید. کاربری که حساب شریک را ایجاد کرده است نقش مالک را دارد. کاربران جدید می توانند نقش مدیر یا خواننده را داشته باشند.

  • مدیران می‌توانند به تمام قابلیت‌های Developer Console دسترسی داشته باشند تا همه و همه عوامل متعلق به حساب شریک را مدیریت کنند.
  • خوانندگان به Developer Console دسترسی فقط خواندنی دارند تا همه و همه عوامل متعلق به حساب شریک را مشاهده کنند.

یک کاربر اضافه کنید

برای افزودن کاربر، آدرس ایمیل او را در قسمت ورودی وارد کنید و نقش او را انتخاب کنید.

وقتی کاربر جدیدی اضافه می کنید، ایمیلی دریافت می کند که به آنها اطلاع می دهد که به حساب شریک دسترسی دارند.

حذف یک کاربر

برای حذف یک کاربر:

  1. کاربری را که می خواهید حذف کنید پیدا کنید و روی دکمه در ردیف جدول او کلیک کنید.
  2. حذف کاربر را انتخاب کنید.
  3. حذف را تایید کنید.

کاربری که حذف کردید ایمیلی دریافت می کند که به او اطلاع می دهد که دیگر به حساب شریک دسترسی ندارد.

نمی‌توانید کاربری با نقش مالک را حذف کنید. برای تغییر یا حذف مالک، باید با پشتیبانی تماس بگیرید.

نقش کاربر را تغییر دهید

برای به روز رسانی نقش کاربر:

  1. کاربری را که می خواهید به روز کنید پیدا کنید و روی دکمه در ردیف جدول او کلیک کنید.
  2. ویرایش نقش را انتخاب کنید.
  3. یک نقش جدید را از منوی کشویی انتخاب کنید.
  4. روی ذخیره کلیک کنید.

حساب سرویس را برای احراز هویت تماس‌های API تنظیم کنید

هنگامی که با RBM API تماس می گیرید، تماس ها را با یک کلید حساب سرویس احراز هویت می کنید. این کلید به شما امکان می دهد مارک ها و نمایندگان را ایجاد و مدیریت کنید و به عنوان نماینده پیام ها و درخواست ها را ارسال کنید. یک حساب سرویس می تواند حداکثر 10 کلید داشته باشد.

برای احراز هویت ایمن تماس‌های API، به ابزار خط فرمان oauth2l نیز نیاز دارید.

برای ایجاد یک کلید حساب سرویس، مراحل زیر را دنبال کنید:

  1. در تنظیمات حساب ، به صفحه حساب سرویس بروید.
  2. روی ایجاد کلید کلیک کنید، سپس روی ایجاد کلیک کنید. مرورگر شما کلید حساب سرویس را دانلود می کند.

کلید حساب سرویس خود را در مکانی امن و خصوصی ذخیره کنید. کلید خود را به صورت عمومی به اشتراک نگذارید. بعداً برای دسترسی به APIهای RBM به این کلید نیاز خواهید داشت.

وب هوک شریک خود را پیکربندی کنید

وب هوک یک تماس HTTPS ایجاد شده توسط شریک است که مشخص می کند نماینده شما چگونه باید به پیام ها و رویدادها پاسخ دهد. هنگامی که وب هوک خود را پیکربندی کردید، می توانید شروع به دریافت پیام ها و رویدادها کنید.

اگر می‌خواهید برای هر یک از نمایندگان خود از یک وب هوک متفاوت استفاده کنید، می‌توانید یک وب هوک در سطح نماینده راه‌اندازی کنید که وب‌هوک شریک را لغو کند. برای اطلاعات بیشتر، پیکربندی یک عامل وب هوک را ببینید.

برای پیکربندی وب هوک شریک خود، این مراحل را دنبال کنید:

  1. کنسول توسعه‌دهنده Business Communications را باز کنید و با حساب Google شریک تجاری RCS خود وارد شوید.

  2. تنظیمات حساب را باز کنید.

  3. برای آدرس اینترنتی وب هوک پیام‌رسانی تجاری RCS ، روی پیکربندی کلیک کنید.

  4. برای URL نقطه پایانی Webhook ، نشانی وب هوک خود را که با "https://" شروع می شود وارد کنید.

  5. Note your clientToken value. برای تأیید اینکه پیام‌هایی که دریافت می‌کنید از Google ارسال می‌شوند به آن نیاز دارید.

  6. وب هوک خود را طوری پیکربندی کنید که درخواست POST را با پارامتر clientToken مشخص شده بپذیرد و یک پاسخ 200 OK با مقدار متن ساده پارامتر secret به عنوان بدنه پاسخ ارسال کند.

    به عنوان مثال، اگر وب هوک شما یک درخواست POST با محتوای بدنه زیر دریافت کند

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"1234567890"
}

    سپس وب هوک شما باید مقدار clientToken را تأیید کند و اگر clientToken درست باشد، یک پاسخ 200 OK با 1234567890 به عنوان بدنه پاسخ برگرداند:

    // clientToken from Configure
const myClientToken = "SJENCPGJESMGUFPY";

// Example endpoint
app.post("/rbm-webhook", (req, res) => {
  const msg = req.body;
  if (msg.clientToken === myClientToken) {
      res.status(200).send(msg.secret);
      return;
  }
  res.send(400);
});

  7. در Developer Console، روی تأیید کلیک کنید. هنگامی که RCS برای کسب و کار وب هوک شما را تأیید می کند، کادر گفتگو بسته می شود.

برای راهنمایی در مورد پردازش وب‌قلاب‌ها به‌صورت ناهمزمان برای جلوگیری از شکست‌های تحویل، به مدیریت پیام مراجعه کنید.

پیام های دریافتی را تأیید کنید

از آنجایی که وب هوک ها می توانند از هر فرستنده ای پیام دریافت کنند، باید تأیید کنید که Google پیام های دریافتی را قبل از پردازش محتوای پیام ارسال کرده است.

برای تأیید اینکه Google پیامی را که دریافت کرده‌اید ارسال کرده است، این مراحل را دنبال کنید:

  1. Extract the message's X-Goog-Signature header. این یک کپی هش شده و کدگذاری شده با base64 از بار بدنه پیام است.
  2. Base-64-بارگذاری RBM را در عنصر message.body درخواست رمزگشایی کنید.
  3. با استفاده از توکن کلاینت وب‌هوک خود (که هنگام راه‌اندازی وب‌هوک خود مشخص کرده‌اید) به‌عنوان یک کلید، یک SHA512 HMAC از بایت‌های بار پیام رمزگشایی شده base-64 ایجاد کنید و نتیجه را در 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
    let userEventString = Buffer.from(requestBody.message.data, 'base64');
    let hmac = crypto.createHmac('sha512', CLIENT_TOKEN);
    let data = hmac.update(userEventString);
    let genHash = data.digest('base64');
    let headerHash = req.header('X-Goog-Signature');

    if (headerHash === genHash) {
      let userEvent = JSON.parse(userEventString);

      console.log('userEventString: ' + userEventString);
      handleMessage(userEvent);
    } else {
      console.log('hash mismatch - ignoring message');
    }
  }

  res.sendStatus(200);

مراحل بعدی

اکنون که حساب شریک شما راه اندازی شده است، وقت آن رسیده است که اولین نماینده خود را بسازید .

،

هنگامی که به عنوان شریک RCS for Business ثبت نام کردید، یک حساب شریک دارید. برای دسترسی به تنظیمات حساب شریک خود، Business Communications Developer Console را باز کنید و روی تنظیمات حساب شریک کلیک کنید. From here, you can do the following:

Update partner account information

از صفحه تنظیمات ، می توانید شناسه شریک خود را مشاهده کرده و اطلاعات زیر را به روز کنید:

میدان توضیحات
نام شریک Name of your partner account
نام نمایشی نام در گزارش‌های صورت‌حساب‌هایی که شرکت‌های مخابراتی دریافت می‌کنند ظاهر می‌شود (به عنوان قسمت owner_name ). شرکت های مخابراتی از این برای شناسایی شما به عنوان یک شریک قابل اعتماد و ایجاد اطلاعات صورتحساب صحیح برای استفاده شما از RCS for Business برای دسترسی به مشترکین خود استفاده می کنند. نامی که در اینجا ارائه می‌دهید باید با نامی که در قراردادهای پیام‌رسانی شرکت مخابراتی شما استفاده می‌شود مطابقت داشته باشد.
Technical point of contact

فردی که Google در صورت وجود هرگونه مشکل فنی با نمایندگان شما با او تماس خواهد گرفت. می توانید آنها را به روز کنید

  • نام
  • آدرس ایمیل شرکت
  • شماره تلفن
وب هوک This is your webhook endpoint URL. Click Configure to update it. هنگامی که وب هوک شریک خود را پیکربندی می کنید، برای همه نمایندگان شما اعمال می شود. اگر می خواهید از یک وب هوک متفاوت برای یک نماینده استفاده کنید، می توانید یک وب هوک عامل را پیکربندی کنید که فقط برای آن نماینده اعمال شود.

برندها را مدیریت کنید

به عنوان یک شریک RCS برای کسب و کار، می توانید نمایندگانی از طرف برندها ایجاد کنید.

از صفحه برندها در تنظیمات حساب برای افزودن، ویرایش و حذف مارک های مرتبط با حساب شریک خود استفاده کنید.

یک نام تجاری اضافه کنید

برای افزودن نام تجاری، نام آن را در قسمت ورودی وارد کنید و روی افزودن کلیک کنید.

یک برند را ویرایش کنید

برای ویرایش برند:

  1. Click the checkbox next to the brand's name.
  2. روی دکمه کلیک کنید و روی Edit name کلیک کنید.
  3. Make your edits, and click Done .

برندی را حذف کنید

اگر نام تجاری با یک نماینده مرتبط باشد، نمی‌توان آن را حذف کرد، حتی اگر آن نماینده راه‌اندازی نشده باشد.

برای حذف یک نام تجاری، روی کادر تأیید کنار نام مارک کلیک کنید و روی حذف کلیک کنید.

مدیریت کاربران

صفحه کاربران در تنظیمات حساب جایی است که شما کاربران حساب شریک خود را مدیریت می کنید. کاربری که حساب شریک را ایجاد کرده است نقش مالک را دارد. کاربران جدید می توانند نقش مدیر یا خواننده را داشته باشند.

  • مدیران می‌توانند به تمام قابلیت‌های Developer Console دسترسی داشته باشند تا همه و همه عوامل متعلق به حساب شریک را مدیریت کنند.
  • خوانندگان به Developer Console دسترسی فقط خواندنی دارند تا همه و همه عوامل متعلق به حساب شریک را مشاهده کنند.

یک کاربر اضافه کنید

To add a user, enter their email address in the input field and select their Role .

وقتی کاربر جدیدی اضافه می کنید، ایمیلی دریافت می کند که به آنها اطلاع می دهد که به حساب شریک دسترسی دارند.

حذف یک کاربر

برای حذف یک کاربر:

  1. کاربری را که می خواهید حذف کنید پیدا کنید و روی دکمه در ردیف جدول او کلیک کنید.
  2. حذف کاربر را انتخاب کنید.
  3. حذف را تایید کنید.

The user you removed receives an email notifying them that they no longer have access to the partner account.

You can't remove a user with an Owner role. برای تغییر یا حذف مالک، باید با پشتیبانی تماس بگیرید.

نقش کاربر را تغییر دهید

برای به روز رسانی نقش کاربر:

  1. Find the user you want to update, and click the button in their table row.
  2. ویرایش نقش را انتخاب کنید.
  3. یک نقش جدید را از منوی کشویی انتخاب کنید.
  4. روی ذخیره کلیک کنید.

حساب سرویس را برای احراز هویت تماس‌های API تنظیم کنید

When you make calls to the RBM API , you authenticate calls with a service account key. This key lets you create and manage brands and agents, and to send messages and requests as an agent. A service account can have up to 10 keys.

To securely authenticate API calls, you also need the oauth2l command line tool.

برای ایجاد یک کلید حساب سرویس، مراحل زیر را دنبال کنید:

  1. در تنظیمات حساب ، به صفحه حساب سرویس بروید.
  2. روی ایجاد کلید کلیک کنید، سپس روی ایجاد کلیک کنید. مرورگر شما کلید حساب سرویس را دانلود می کند.

کلید حساب سرویس خود را در مکانی امن و خصوصی ذخیره کنید. کلید خود را به صورت عمومی به اشتراک نگذارید. You'll need this key later to access the RBM APIs.

Configure your partner webhook

A webhook is a partner-created HTTPS callback that specifies how your agent should respond to messages and events. Once you configure your webhook, you can start receiving messages and events .

If you want to use a different webhook for any of your agents, you can set up an agent-level webhook that will override the partner webhook. برای اطلاعات بیشتر، پیکربندی یک عامل وب هوک را ببینید.

برای پیکربندی وب هوک شریک خود، این مراحل را دنبال کنید:

  1. Open the Business Communications Developer Console and sign in with your RCS for Business partner Google Account.

  2. تنظیمات حساب را باز کنید.

  3. برای آدرس اینترنتی وب هوک پیام‌رسانی تجاری RCS ، روی پیکربندی کلیک کنید.

  4. برای URL نقطه پایانی Webhook ، نشانی وب هوک خود را که با "https://" شروع می شود وارد کنید.

  5. به ارزش clientToken خود توجه کنید. You need it to verify that messages you receive are coming from Google .

  6. وب هوک خود را طوری پیکربندی کنید که درخواست POST را با پارامتر clientToken مشخص شده بپذیرد و یک پاسخ 200 OK با مقدار متن ساده پارامتر secret به عنوان بدنه پاسخ ارسال کند.

    For example, if your webhook receives a POST request with the following body content

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"1234567890"
}

    سپس وب هوک شما باید مقدار clientToken را تأیید کند و اگر clientToken درست باشد، یک پاسخ 200 OK با 1234567890 به عنوان بدنه پاسخ برگرداند:

    // clientToken from Configure
const myClientToken = "SJENCPGJESMGUFPY";

// Example endpoint
app.post("/rbm-webhook", (req, res) => {
  const msg = req.body;
  if (msg.clientToken === myClientToken) {
      res.status(200).send(msg.secret);
      return;
  }
  res.send(400);
});

  7. در Developer Console، روی تأیید کلیک کنید. هنگامی که RCS برای کسب و کار وب هوک شما را تأیید می کند، کادر گفتگو بسته می شود.

برای راهنمایی در مورد پردازش وب‌قلاب‌ها به‌صورت ناهمزمان برای جلوگیری از شکست‌های تحویل، به مدیریت پیام مراجعه کنید.

پیام های دریافتی را تأیید کنید

از آنجایی که وب هوک ها می توانند از هر فرستنده ای پیام دریافت کنند، باید تأیید کنید که Google پیام های دریافتی را قبل از پردازش محتوای پیام ارسال کرده است.

To verify that Google sent a message you received, follow these steps:

  1. هدر X-Goog-Signature پیام را استخراج کنید. این یک کپی هش شده و کدگذاری شده با base64 از بار بدنه پیام است.
  2. Base-64-بارگذاری RBM را در عنصر message.body درخواست رمزگشایی کنید.
  3. با استفاده از توکن کلاینت وب‌هوک خود (که هنگام راه‌اندازی وب‌هوک خود مشخص کرده‌اید) به‌عنوان یک کلید، یک SHA512 HMAC از بایت‌های بار پیام رمزگشایی شده base-64 ایجاد کنید و نتیجه را در 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
    let userEventString = Buffer.from(requestBody.message.data, 'base64');
    let hmac = crypto.createHmac('sha512', CLIENT_TOKEN);
    let data = hmac.update(userEventString);
    let genHash = data.digest('base64');
    let headerHash = req.header('X-Goog-Signature');

    if (headerHash === genHash) {
      let userEvent = JSON.parse(userEventString);

      console.log('userEventString: ' + userEventString);
      handleMessage(userEvent);
    } else {
      console.log('hash mismatch - ignoring message');
    }
  }

  res.sendStatus(200);

مراحل بعدی

اکنون که حساب شریک شما راه اندازی شده است، وقت آن رسیده است که اولین نماینده خود را بسازید .

،

هنگامی که به عنوان شریک RCS for Business ثبت نام کردید، یک حساب شریک دارید. برای دسترسی به تنظیمات حساب شریک خود، Business Communications Developer Console را باز کنید و روی تنظیمات حساب شریک کلیک کنید. از اینجا می توانید کارهای زیر را انجام دهید:

اطلاعات حساب شریک را به روز کنید

از صفحه تنظیمات ، می توانید شناسه شریک خود را مشاهده کرده و اطلاعات زیر را به روز کنید:

میدان توضیحات
نام شریک نام حساب شریک شما
نام نمایشی نام در گزارش‌های صورت‌حساب‌هایی که شرکت‌های مخابراتی دریافت می‌کنند ظاهر می‌شود (به عنوان قسمت owner_name ). شرکت های مخابراتی از این برای شناسایی شما به عنوان یک شریک قابل اعتماد و ایجاد اطلاعات صورتحساب صحیح برای استفاده شما از RCS for Business برای دسترسی به مشترکین خود استفاده می کنند. نامی که در اینجا ارائه می‌دهید باید با نامی که در قراردادهای پیام‌رسانی شرکت مخابراتی شما استفاده می‌شود مطابقت داشته باشد.
نقطه تماس فنی

فردی که Google در صورت وجود هرگونه مشکل فنی با نمایندگان شما با او تماس خواهد گرفت. می توانید آنها را به روز کنید

  • نام
  • آدرس ایمیل شرکت
  • شماره تلفن
وب هوک این URL نقطه پایانی وب هوک شما است. برای به روز رسانی روی Configure کلیک کنید. هنگامی که وب هوک شریک خود را پیکربندی می کنید، برای همه نمایندگان شما اعمال می شود. اگر می خواهید از یک وب هوک متفاوت برای یک نماینده استفاده کنید، می توانید یک وب هوک عامل را پیکربندی کنید که فقط برای آن نماینده اعمال شود.

برندها را مدیریت کنید

به عنوان یک شریک RCS برای کسب و کار، می توانید نمایندگانی از طرف برندها ایجاد کنید.

از صفحه برندها در تنظیمات حساب برای افزودن، ویرایش و حذف مارک های مرتبط با حساب شریک خود استفاده کنید.

یک نام تجاری اضافه کنید

برای افزودن نام تجاری، نام آن را در قسمت ورودی وارد کنید و روی افزودن کلیک کنید.

یک برند را ویرایش کنید

برای ویرایش برند:

  1. روی کادر کنار نام برند کلیک کنید.
  2. روی دکمه کلیک کنید و روی Edit name کلیک کنید.
  3. ویرایش های خود را انجام دهید و روی انجام شد کلیک کنید.

برندی را حذف کنید

A brand can't be removed if it's associated with an agent, even if the agent is not launched.

برای حذف یک نام تجاری، روی کادر تأیید کنار نام مارک کلیک کنید و روی حذف کلیک کنید.

مدیریت کاربران

The Users page in the Account settings is where you manage the users of your partner account. The user who created the partner account has the role of Owner. کاربران جدید می توانند نقش مدیر یا خواننده را داشته باشند.

  • Managers can access all the capabilities of the Developer Console, to manage any and all agents belonging to the partner account.
  • Readers have read-only access to the Developer Console, to view any and all agents belonging to the partner account.

یک کاربر اضافه کنید

برای افزودن کاربر، آدرس ایمیل او را در قسمت ورودی وارد کنید و نقش او را انتخاب کنید.

When you add a new user, they receive an email notifying them that they have access to the partner account.

حذف یک کاربر

برای حذف یک کاربر:

  1. Find the user you want to remove, and click the button in their table row.
  2. حذف کاربر را انتخاب کنید.
  3. حذف را تایید کنید.

کاربری که حذف کردید ایمیلی دریافت می کند که به او اطلاع می دهد که دیگر به حساب شریک دسترسی ندارد.

نمی‌توانید کاربری با نقش مالک را حذف کنید. To change or remove the Owner, you need to reach out to support .

نقش کاربر را تغییر دهید

برای به روز رسانی نقش کاربر:

  1. Find the user you want to update, and click the button in their table row.
  2. ویرایش نقش را انتخاب کنید.
  3. یک نقش جدید را از منوی کشویی انتخاب کنید.
  4. روی ذخیره کلیک کنید.

حساب سرویس را برای احراز هویت تماس‌های API تنظیم کنید

هنگامی که با RBM API تماس می گیرید، تماس ها را با یک کلید حساب سرویس احراز هویت می کنید. This key lets you create and manage brands and agents, and to send messages and requests as an agent. یک حساب سرویس می تواند حداکثر 10 کلید داشته باشد.

To securely authenticate API calls, you also need the oauth2l command line tool.

Follow these steps to generate a service account key:

  1. در تنظیمات حساب ، به صفحه حساب سرویس بروید.
  2. روی ایجاد کلید کلیک کنید، سپس روی ایجاد کلیک کنید. مرورگر شما کلید حساب سرویس را دانلود می کند.

کلید حساب سرویس خود را در مکانی امن و خصوصی ذخیره کنید. کلید خود را به صورت عمومی به اشتراک نگذارید. You'll need this key later to access the RBM APIs.

وب هوک شریک خود را پیکربندی کنید

A webhook is a partner-created HTTPS callback that specifies how your agent should respond to messages and events. Once you configure your webhook, you can start receiving messages and events .

اگر می‌خواهید برای هر یک از نمایندگان خود از یک وب هوک متفاوت استفاده کنید، می‌توانید یک وب هوک در سطح نماینده راه‌اندازی کنید که وب‌هوک شریک را لغو کند. برای اطلاعات بیشتر، پیکربندی یک عامل وب هوک را ببینید.

برای پیکربندی وب هوک شریک خود، این مراحل را دنبال کنید:

  1. کنسول توسعه‌دهنده Business Communications را باز کنید و با حساب Google شریک تجاری RCS خود وارد شوید.

  2. تنظیمات حساب را باز کنید.

  3. برای آدرس اینترنتی وب هوک پیام‌رسانی تجاری RCS ، روی پیکربندی کلیک کنید.

  4. برای URL نقطه پایانی Webhook ، نشانی وب هوک خود را که با "https://" شروع می شود وارد کنید.

  5. به ارزش clientToken خود توجه کنید. برای تأیید اینکه پیام‌هایی که دریافت می‌کنید از Google ارسال می‌شوند به آن نیاز دارید.

  6. وب هوک خود را طوری پیکربندی کنید که درخواست POST را با پارامتر clientToken مشخص شده بپذیرد و یک پاسخ 200 OK با مقدار متن ساده پارامتر secret به عنوان بدنه پاسخ ارسال کند.

    به عنوان مثال، اگر وب هوک شما یک درخواست POST با محتوای بدنه زیر دریافت کند

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"1234567890"
}

    سپس وب هوک شما باید مقدار clientToken را تأیید کند و اگر clientToken درست باشد، یک پاسخ 200 OK با 1234567890 به عنوان بدنه پاسخ برگرداند:

    // clientToken from Configure
const myClientToken = "SJENCPGJESMGUFPY";

// Example endpoint
app.post("/rbm-webhook", (req, res) => {
  const msg = req.body;
  if (msg.clientToken === myClientToken) {
      res.status(200).send(msg.secret);
      return;
  }
  res.send(400);
});

  7. در Developer Console، روی تأیید کلیک کنید. هنگامی که RCS برای کسب و کار وب هوک شما را تأیید می کند، کادر گفتگو بسته می شود.

برای راهنمایی در مورد پردازش وب‌قلاب‌ها به‌صورت ناهمزمان برای جلوگیری از شکست‌های تحویل، به مدیریت پیام مراجعه کنید.

پیام های دریافتی را تأیید کنید

از آنجایی که وب هوک ها می توانند از هر فرستنده ای پیام دریافت کنند، باید تأیید کنید که Google پیام های دریافتی را قبل از پردازش محتوای پیام ارسال کرده است.

برای تأیید اینکه Google پیامی را که دریافت کرده‌اید ارسال کرده است، این مراحل را دنبال کنید:

  1. هدر X-Goog-Signature پیام را استخراج کنید. این یک کپی هش شده و کدگذاری شده با base64 از بار بدنه پیام است.
  2. Base-64-بارگذاری RBM را در عنصر message.body درخواست رمزگشایی کنید.
  3. با استفاده از توکن کلاینت وب‌هوک خود (که هنگام راه‌اندازی وب‌هوک خود مشخص کرده‌اید) به‌عنوان یک کلید، یک SHA512 HMAC از بایت‌های بار پیام رمزگشایی شده base-64 ایجاد کنید و نتیجه را در 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
    let userEventString = Buffer.from(requestBody.message.data, 'base64');
    let hmac = crypto.createHmac('sha512', CLIENT_TOKEN);
    let data = hmac.update(userEventString);
    let genHash = data.digest('base64');
    let headerHash = req.header('X-Goog-Signature');

    if (headerHash === genHash) {
      let userEvent = JSON.parse(userEventString);

      console.log('userEventString: ' + userEventString);
      handleMessage(userEvent);
    } else {
      console.log('hash mismatch - ignoring message');
    }
  }

  res.sendStatus(200);

مراحل بعدی

اکنون که حساب شریک شما راه اندازی شده است، وقت آن رسیده است که اولین نماینده خود را بسازید .

قبلی
به عنوان شریک ثبت نام کنید
بعدی
اولین نماینده خود را بسازید