دستگاه های تست

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

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

وقتی دستگاه شما RCS فعال است، می‌توانید یک درخواست آزمایش‌کننده برای دعوت از دستگاه برای آزمایش نماینده‌تان ارسال کنید. هنگامی که دستگاه درخواست را پذیرفت، می‌تواند پیام‌های نماینده شما را دریافت کند و به آنها پاسخ دهد.

یک نماینده می تواند هر روز 20 درخواست آزمایش کننده با حداکثر 200 درخواست آزمایش کننده ارسال کند. اگر آزمایش‌کنندگان را از طریق RBM API اضافه کنید و بیش از 200 درخواست ارسال کنید، پلتفرم RBM یک پاسخ 429 RESOURCE_EXHAUSTED را برمی‌گرداند.

وضعیت RCS دستگاه خود را بررسی کنید

  1. در برنامه پیام‌ها، به تنظیمات پیام‌ها بروید.
  2. روی چت های RCS ضربه بزنید. اگر نمی‌توانید «گپ‌های RCS» را پیدا کنید، روی ویژگی‌های گپ ضربه بزنید.
  3. مقدار Status را پیدا کنید.

    اگر وضعیت متصل است، RCS در دستگاه شما فعال است.

مراحل بعدی

اگر RCS در دستگاه شما فعال است، آماده ارسال درخواست آزمایش‌کننده هستید. اگر RCS در دستگاه شما غیرفعال است، قبل از اینکه بتوانید عامل RBM خود را با آن آزمایش کنید، باید RCS را در دستگاه خود فعال کنید .

RCS را در دستگاه خود فعال کنید

برای فعال کردن RCS در دستگاه Android، چت‌های RCS را در برنامه پیام‌ها روشن کنید .

مراحل بعدی

پس از فعال شدن RCS در دستگاه شما، آماده ارسال درخواست آزمایشگر هستید.

یک درخواست آزمایش کننده ارسال کنید

برای دعوت از یک دستگاه دارای RCS برای تبدیل شدن به یک آزمایش‌کننده، یک درخواست آزمایش‌کننده ارسال می‌کنید. اگر دستگاه درخواست را بپذیرد، نماینده شما می‌تواند پیام‌ها، رویدادها و درخواست‌ها را به دستگاه ارسال کند.

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

گزینه 1: درخواست آزمایش‌کننده را با کنسول توسعه‌دهنده Business Communications ارسال کنید

  1. کنسول توسعه‌دهنده Business Communications را باز کنید، با حساب Google RBM خود وارد شوید و روی نماینده خود کلیک کنید.
  2. در پیمایش سمت چپ، روی دستگاه‌ها کلیک کنید.
  3. برای افزودن دستگاه‌های آزمایشی ، شماره تلفن دستگاه خود را وارد کرده و روی افزودن کلیک کنید.

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

گزینه 2: درخواست آزمایشگر را با RBM API ارسال کنید

کد زیر یک درخواست تستر ارسال می کند. برای گزینه‌های قالب‌بندی و مقدار، به phones.testers مراجعه کنید.

CURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', function(response) {
   console.log(response);
});
این کد گزیده ای از یک عامل نمونه RBM است.

جاوا

import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Register the device as a tester
   rbmApiHelper.registerTester("+12223334444");
} catch(Exception e) {
   e.printStackTrace();
}
این کد گزیده ای از یک عامل نمونه RBM است.

پایتون

# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service

# Send the tester invite to a device
rbm_service.invite_tester('+12223334444')
این کد گزیده ای از یک عامل نمونه RBM است.

سی شارپ

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

// Register the device as a tester
rbmApiHelper.RegisterTester("+12223334444");
این کد گزیده ای از یک عامل نمونه RBM است.

مراحل بعدی

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

یک دستگاه آزمایشی را بردارید

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

  1. کنسول توسعه‌دهنده Business Communications را باز کنید، با حساب Google RBM خود وارد شوید و روی نماینده خود کلیک کنید.
  2. در پیمایش سمت چپ، روی دستگاه‌ها کلیک کنید.
  3. دستگاه را در لیست دستگاه تست قرار دهید و روی منوی برای آن مورد لیست کلیک کنید.
  4. روی حذف دستگاه کلیک کنید.