یک دستگاه تست راه اندازی کنید

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

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

نمایندگان می توانند حداکثر 20 دعوت نامه آزمایش کننده در روز ارسال کنند که در مجموع حداکثر 200 دعوت نامه است.

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

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

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

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

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

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

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

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

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

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

کنسول

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

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

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

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

API

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

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

CURL 

curl -X POST "https://businesscommunications.googleapis.com/v1/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`" \
-d '{"phone_number": "PHONE_NUMBER", "agentId": "AGENT_ID"}'

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 است.

اگر بیش از 200 دعوت نامه ارسال کنید، پلت فرم RBM در پاسخ کد خطای 429 RESOURCE_EXHAUSTED را برمی گرداند.

مجدداً دعوتنامه آزمایشگر را ارسال کنید

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

وضعیت دستگاه نتیجه
PENDING دعوت آزمایش کننده به دستگاه ارسال می شود.
ACCEPTED دعوت آزمایشگر به دستگاهی که وضعیت ACCEPTED خود را حفظ می کند، ارسال نمی شود.
DECLINED دعوت آزمایشگر رد شد. قبل از ارسال مجدد دعوت، ابتدا باید دستگاه آزمایشی را حذف کنید . در غیر این صورت، درخواست با شکست مواجه می شود.

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

وضعیت دعوت یک دستگاه آزمایشی را دریافت کنید

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

کنسول

برای دریافت وضعیت دعوت یک دستگاه آزمایشی با کنسول برنامه‌نویس ارتباطات تجاری:

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

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

API

برای دریافت وضعیت دعوت یک دستگاه آزمایشی با API مدیریت RBM:

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

CURL 

curl -X GET "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

وضعیت همه دستگاه های تست را دریافت کنید

می‌توانید وضعیت دعوت همه دستگاه‌هایی را که برای آزمایش‌کننده دعوت کرده‌اید پرس و جو کنید.

کنسول

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

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

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

API

برای بررسی وضعیت دعوت همه دستگاه‌های آزمایشی با API مدیریت RBM:

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

CURL 

curl -X GET "https://businesscommunications.googleapis.com/v1/testers?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

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

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

کنسول

برای حذف یک دستگاه آزمایشی با کنسول برنامه‌نویس Business Communications:

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

API

برای حذف یک دستگاه آزمایشی با API مدیریت RBM:

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

CURL 

curl -X DELETE "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"
قبلی
ویرایش اطلاعات نماینده
بعدی
پیوندهای عمیق