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

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

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

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

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

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

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

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

فعال کردن RCS در دستگاه شما

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

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

ارسال دعوتنامه برای تستر

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

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

کنسول

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

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

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

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

رابط برنامه‌نویسی کاربردی

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

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

حلقه 

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"}'

نود جی اس 

// 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 کد خطای 429 RESOURCE_EXHAUSTED را در پاسخ برمی‌گرداند.

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

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

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

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

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

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

کنسول

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

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

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

رابط برنامه‌نویسی کاربردی

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

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

حلقه 

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`"

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

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

کنسول

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

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

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

رابط برنامه‌نویسی کاربردی

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

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

حلقه 

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 پیام‌های ارسالی توسط عامل شما را که در حال انتقال به دستگاه آزمایشی هستند یا در آن ذخیره شده‌اند، حذف نمی‌کند.

کنسول

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

  1. کنسول توسعه‌دهندگان ارتباطات تجاری را باز کنید، با حساب گوگل RBM خود وارد شوید و روی نماینده خود کلیک کنید.
  2. در منوی سمت چپ، گزینه «دستگاه‌ها» را انتخاب کنید.
  3. دستگاه را در لیست دستگاه‌های تست انتخاب کنید و روی منوی کلیک کنید.
  4. روی حذف دستگاه کلیک کنید.

رابط برنامه‌نویسی کاربردی

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

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

حلقه 

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`"
قبلی
ویرایش اطلاعات نماینده
بعدی
پیوندهای عمیق