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

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

• اطلاعات حساب شریک خود را به‌روزرسانی کنید
• برندهای مرتبط با حساب کاربری خود را اضافه، ویرایش و حذف کنید
• مدیریت کاربران حساب
• یک حساب کاربری سرویس و کلید برای تأیید اعتبار فراخوانی‌های API ایجاد کنید

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

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

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

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

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

برند، سازمان یا گروهی که توسط یک یا چند نماینده نمایندگی می‌شود. برای مثال، شرکت خدمات مالی Growing Tree ممکن است یک برند به نام Growing Tree و یک نماینده به نام Growing Tree Bank ایجاد کند تا با مشتریان در مورد خدمات بانکی صحبت کند.

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

افزودن برند

توجه: برای افزودن برند با استفاده از RBM Management API، به مستندات ایجاد برند مراجعه کنید.

برای افزودن یک برند، نام آن را در فیلد ورودی وارد کرده و روی افزودن کلیک کنید.

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

توجه: برای ویرایش یک برند با استفاده از RBM Management API، به مستندات تغییر نام برند مراجعه کنید.

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

1. روی کادر کنار نام برند کلیک کنید.
2. روی دکمه‌ی کلیک کنید و سپس روی ویرایش نام کلیک کنید.
3. ویرایش‌های خود را انجام دهید و روی «انجام شد» کلیک کنید.

حذف یک برند

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

برای حذف یک برند، روی کادر کنار نام برند کلیک کنید و روی «حذف» کلیک کنید.

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

صفحه کاربران در تنظیمات حساب کاربری، جایی است که شما کاربران حساب کاربری همکار خود را مدیریت می‌کنید. کاربری که حساب کاربری همکار را ایجاد کرده است، نقش مالک (Owner) را دارد. کاربران جدید می‌توانند نقش مدیر (Manager) یا خواننده (Reader) را داشته باشند.

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

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

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

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

حذف یک کاربر

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

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

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

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

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

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

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

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

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

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

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

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

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

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

برای یادگیری نحوه پیکربندی وب‌هوک شریک خود، به راهنمای وب‌هوک‌ها مراجعه کنید.

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

تأیید پیام‌های دریافتی

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

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

1. هدر X-Goog-Signature پیام را استخراج کنید. این یک کپی هش شده و کدگذاری شده با base64 از محتوای بدنه پیام است.
2. کد RBM موجود در عنصر message.body درخواست را با استفاده از Base-64 رمزگشایی کنید.
3. با استفاده از توکن کلاینت وب‌هوک خود (که هنگام تنظیم وب‌هوک مشخص کرده‌اید) به عنوان کلید، یک SHA512 HMAC از بایت‌های پیام رمزگشایی‌شده‌ی base-64 ایجاد کنید و نتیجه را base64-encode کنید.
4. هش X-Goog-Signature را با هشی که ایجاد کرده‌اید مقایسه کنید.
   • اگر هش‌ها مطابقت داشته باشند، شما تأیید کرده‌اید که گوگل پیام را ارسال کرده است.

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

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

نود جی اس

  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);
  

مراحل بعدی

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