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

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

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

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

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

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

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

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

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

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

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

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

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

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

  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 شریک RBM خود وارد شوید.

  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، روی تأیید کلیک کنید. هنگامی که RBM وب هوک شما را تأیید می کند، گفتگو بسته می شود.

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

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

از آنجایی که وب هوک ها می توانند از هر فرستنده ای پیام دریافت کنند، باید تأیید کنید که 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);

مراحل بعدی

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

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