ตั้งค่าอุปกรณ์ทดสอบ

จนกว่าคุณจะเปิดตัว เอเจนต์ เอเจนต์จะสื่อสารได้เฉพาะกับอุปกรณ์ทดสอบที่กำหนดเท่านั้น ซึ่งจะช่วยให้คุณ ทดสอบเอเจนต์ภายในเพื่อป้องกันไม่ให้ผู้ใช้ปลายทางเข้าถึงก่อนกำหนดโดยไม่ตั้งใจ

หากต้องการสื่อสารกับตัวแทน RBM อุปกรณ์ทดสอบต้องเปิดใช้ RCS โปรดทราบ ว่าอุปกรณ์ Android บางรุ่นไม่ได้เปิดใช้ RCS โดยค่าเริ่มต้น หากต้องการตรวจสอบสถานะ RCS ของอุปกรณ์ โปรดดูตรวจสอบสถานะ RCS ของอุปกรณ์

ตัวแทนจะส่งคำเชิญให้ผู้ทดสอบได้สูงสุด 20 รายต่อวัน โดยมีขีดจำกัดรวมอยู่ที่ 200 คำเชิญ

ตรวจสอบสถานะ RCS ของอุปกรณ์

  1. ในแอปข้อความ ให้ไปที่การตั้งค่าข้อความ
  2. แตะแชท RCS หากไม่พบ "แชท RCS" ให้แตะฟีเจอร์แชท
  3. ค้นหาค่าสถานะ

หากอุปกรณ์ไม่ได้เปิดใช้ RCS ให้เปิดใช้ RCS โดยกำหนดค่าอุปกรณ์ด้วยแอป Messages และแอปบริการของผู้ให้บริการเวอร์ชันก่อนเปิดตัว

หากอุปกรณ์เปิดใช้ RCS คุณจะส่งคำเชิญให้ผู้ทดสอบได้ เมื่ออุปกรณ์ยอมรับคำเชิญ ก็จะเริ่มส่งข้อความกับเอเจนต์ที่ยังไม่ได้เปิดตัวได้

เปิดใช้ RCS ในอุปกรณ์

หากต้องการเปิดใช้ RCS ในอุปกรณ์ Android ให้เปิดใช้แชท RCS ในแอป Messages

เมื่อ RCS ทำงานบนอุปกรณ์แล้ว คุณก็พร้อมที่จะส่งคำเชิญให้ผู้ทดสอบ

ส่งคำเชิญให้ผู้ทดสอบ

หากต้องการเชิญอุปกรณ์ที่เปิดใช้ RCS ให้เป็นผู้ทดสอบ คุณต้องส่งคำเชิญให้เป็นผู้ทดสอบ เมื่ออุปกรณ์ยอมรับคำเชิญ ตัวแทนจะส่งข้อความ เหตุการณ์ และ คำขอไปยังอุปกรณ์ได้

หากอุปกรณ์ไม่ได้เปิดใช้ RCS ไม่ตอบรับคำเชิญของผู้ทดสอบ หรือปฏิเสธคำเชิญ เจ้าหน้าที่ของคุณจะได้รับ403 PERMISSION_DENIEDข้อผิดพลาด เมื่อพยายามสื่อสารกับอุปกรณ์

คอนโซล

วิธีส่งคำเชิญให้ผู้ทดสอบด้วยคอนโซลของนักพัฒนาซอฟต์แวร์ Business Communications

  1. เปิดคอนโซลนักพัฒนาแอป Business Communications ลงชื่อเข้าใช้ด้วยบัญชี Google ของ RBM แล้วคลิกเอเจนต์
  2. เลือกอุปกรณ์ในเมนูด้านซ้าย
  3. เพิ่มอุปกรณ์ทดสอบลงในรายการอุปกรณ์ทดสอบโดยป้อน หมายเลขโทรศัพท์ของอุปกรณ์ รวมถึงรหัสประเทศและรหัสพื้นที่ หากต้องการเพิ่มหมายเลขโทรศัพท์หลายหมายเลข ให้คั่นด้วยคอมมา

เมื่อเพิ่มอุปกรณ์ลงในรายการ ระบบจะส่งคำเชิญ ผู้ใช้จะเห็นข้อความเชิญในอุปกรณ์และมีตัวเลือกในการยอมรับหรือปฏิเสธ

รายการอุปกรณ์ทดสอบจะแสดงรายละเอียดสถานะคำเชิญผู้ทดสอบสำหรับอุปกรณ์แต่ละเครื่อง ที่คุณเชิญให้ทดสอบเอเจนต์

API

วิธีส่งคำเชิญให้ผู้ทดสอบด้วย RBM Management API

  • ใช้โค้ดต่อไปนี้ ดูตัวเลือกการจัดรูปแบบและค่าได้ที่ 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

Java

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

Python

# 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

C#

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

คอนโซล

วิธีดูสถานะคำเชิญของอุปกรณ์ทดสอบด้วย Business Communications Developer Console

  1. เปิดคอนโซลนักพัฒนาแอป Business Communications ลงชื่อเข้าใช้ด้วยบัญชี Google ของ RBM แล้วคลิกเอเจนต์
  2. เลือกอุปกรณ์ในเมนูด้านซ้าย
  3. เพิ่มอุปกรณ์ทดสอบลงในรายการอุปกรณ์ทดสอบโดยป้อน หมายเลขโทรศัพท์ของอุปกรณ์ รวมถึงรหัสประเทศและรหัสพื้นที่ หากต้องการเพิ่มหมายเลขโทรศัพท์หลายหมายเลข ให้คั่นด้วยคอมมา

เมื่อเพิ่มอุปกรณ์ทดสอบลงในรายการแล้ว คุณจะตรวจสอบสถานะของอุปกรณ์ได้ในคอลัมน์สถานะ

API

วิธีดูสถานะคำเชิญของอุปกรณ์ทดสอบด้วย RBM Management API

  • ใช้โค้ดต่อไปนี้ ดูตัวเลือกการจัดรูปแบบและค่าได้ที่ 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 Developer Console

  1. เปิดคอนโซลนักพัฒนาแอป Business Communications ลงชื่อเข้าใช้ด้วยบัญชี Google ของ RBM แล้วคลิกเอเจนต์
  2. เลือกอุปกรณ์ในเมนูด้านซ้าย
  3. เพิ่มอุปกรณ์ทดสอบลงในรายการอุปกรณ์ทดสอบโดยป้อน หมายเลขโทรศัพท์ของอุปกรณ์ รวมถึงรหัสประเทศและรหัสพื้นที่ หากต้องการเพิ่มหมายเลขโทรศัพท์หลายหมายเลข ให้คั่นด้วยคอมมา

เมื่อเพิ่มอุปกรณ์ทดสอบลงในรายการแล้ว คุณจะตรวจสอบสถานะของอุปกรณ์ได้ในคอลัมน์สถานะ

API

วิธีตรวจสอบสถานะคำเชิญของอุปกรณ์ทดสอบทั้งหมดด้วย RBM Management API

  • ใช้โค้ดต่อไปนี้ ดูตัวเลือกการจัดรูปแบบและค่าได้ที่ 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. เลือกอุปกรณ์ในเมนูด้านซ้าย
  3. เลือกอุปกรณ์ในรายการอุปกรณ์ทดสอบ แล้วคลิก เมนู
  4. คลิกนำอุปกรณ์ออก

API

วิธีนำอุปกรณ์ทดสอบออกด้วย RBM Management API

  • ใช้โค้ดต่อไปนี้ ดูตัวเลือกการจัดรูปแบบและค่าได้ที่ 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`"