สร้าง Agent แรก

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

ผู้ใช้โต้ตอบกับตัวแทนผ่านแอปรับส่งข้อความที่เปิดใช้ RCS เช่น Google Messages ในอุปกรณ์ ในการเริ่มต้นใช้งานอย่างรวดเร็วนี้ คุณจะได้สร้างตัวแทน RBM พื้นฐานที่สามารถส่งข้อความง่ายๆ ไปยังอุปกรณ์ทดสอบและรับการตอบกลับ

ข้อกำหนดเบื้องต้น

คุณจะต้องมีสิ่งต่อไปนี้ก่อนเริ่มต้นใช้งานตัวแทน

• ชื่อแบรนด์ที่ตัวแทนจะเป็นผู้แทน
• ตัวแทนของคุณ
  • ชื่อ
  • ภูมิภาคที่ตัวแทนจะดําเนินการ
  • หมวดหมู่การเรียกเก็บเงิน
  • Use Case
• อุปกรณ์ Android ที่มีหมายเลขโทรศัพท์ที่ใช้งานอยู่
• คอมพิวเตอร์สำหรับการพัฒนาซอฟต์แวร์ที่สามารถเรียกใช้โค้ดตัวอย่าง

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

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

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

1. ในแอป Messages ให้แตะปุ่ม แล้วแตะการตั้งค่า

2. แตะฟีเจอร์แชท แล้วหาค่าสถานะ

   หากสถานะเป็นเชื่อมต่อแล้ว แสดงว่า RCS ทำงานอยู่ในอุปกรณ์

ขั้นตอนถัดไป

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

ตั้งค่าตัวแทน

ตัวแทน RBM ใช้ RBM API เพื่อส่งข้อความ กิจกรรม และคำขออื่นๆ ไปยังผู้ใช้ เมื่อสร้างตัวแทน จะเป็นการเปิดใช้การเข้าถึง RBM API และกำหนดข้อมูลพื้นฐานของตัวแทน

ระบุภูมิภาคของตัวแทน

RBM API รองรับปลายทางระดับภูมิภาค 3 แห่งเพื่อช่วยธุรกิจให้ปฏิบัติตามข้อกําหนดระดับภูมิภาคและข้อกําหนดทางธุรกิจ ตัวแทน RBM มีอยู่ได้ 3 ภูมิภาค ได้แก่

• อเมริกาเหนือ
• ยุโรป
• เอเชียแปซิฟิก

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

หมายเหตุ: คุณไม่สามารถเปลี่ยนภูมิภาคของตัวแทนหลังจากที่สร้างตัวแทนแล้ว

กำหนดหมวดหมู่การเรียกเก็บเงินของตัวแทน

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

• การสนทนา - การเรียกเก็บเงินสำหรับการสนทนาที่มีข้อความ A2P และ P2A หลายรายการภายในระยะเวลาหนึ่งๆ
• ข้อความเดียว - การเรียกเก็บเงินสำหรับข้อความเดียวที่มีเนื้อหา RBM แบบริชมีเดีย (เช่น ข้อความที่มีริชการ์ดหรือภาพสไลด์)
• ข้อความพื้นฐาน - ระบบจะเรียกเก็บเงินสำหรับข้อความธรรมดาที่มีอักขระไม่เกิน 160 ตัว

เมื่อสร้างตัวแทน ให้เลือกหมวดหมู่การเรียกเก็บเงินที่ตรงกับลักษณะการทํางานของตรรกะตัวแทนมากที่สุด ดังนี้

• การสนทนา - ตัวแทนนี้จะโต้ตอบกับผู้ใช้อย่างซับซ้อนโดยมีการแลกเปลี่ยนข้อความทั้ง 2 ทาง

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

• ข้อความเดียว - โดยปกติแล้วตัวแทนนี้จะส่งข้อความแบบริชมีเดียและไม่ค่อยคาดหวังที่จะได้รับคำตอบ
• ข้อความพื้นฐาน - ตัวแทนนี้จะอัปเกรด SMS เป็น RBM และไม่ค่อยคาดหวังที่จะได้รับคำตอบ โดยทั่วไป ตัวแทนควรส่งข้อความธรรมดาที่มีความยาวไม่เกิน 160 อักขระ แต่ตัวแทนจะไม่ถูกจํากัด สามารถส่งเนื้อหาที่สมบูรณ์ยิ่งขึ้นได้หากมีการตั้งโปรแกรมไว้ และจะมีการเรียกเก็บเงินตามนั้น

คุณเปลี่ยนหมวดหมู่การเรียกเก็บเงินของตัวแทนได้ก่อนที่จะเปิดตัวตัวแทน ติดต่อเราเพื่อพูดคุยเกี่ยวกับการเปลี่ยนเป็นหมวดหมู่การเรียกเก็บเงินอื่น

ระบุกรณีการใช้งานของตัวแทน

ตัวแทน RBM แต่ละรายต้องมีกรณีการใช้งานที่กําหนดไว้ล่วงหน้าซึ่งแสดงถึงลักษณะการสนทนาที่มีไว้สําหรับผู้ใช้ปลายทาง และเพื่อช่วยธุรกิจให้ปฏิบัติตามกฎทางธุรกิจ RBM รองรับกรณีการใช้งาน 4 กรณี ดังนี้

• OTP: รหัสผ่านที่สามารถใช้งานได้เพียงครั้งเดียวที่จําเป็นสําหรับตรวจสอบสิทธิ์บัญชีหรือยืนยันธุรกรรมอย่างปลอดภัย
• ธุรกรรม: การแจ้งเตือน การอัปเดต หรือการแจ้งเตือนเพื่อแชร์ข้อมูลที่เกี่ยวข้องกับบริการหรือผลิตภัณฑ์ที่มีอยู่ของลูกค้าโดยตรง เช่น การแจ้งเตือนกิจกรรมที่น่าสงสัยในบัญชี การยืนยันการซื้อ และการแจ้งเตือนการจัดส่ง
• การโปรโมต: ข้อความเกี่ยวกับการขาย การตลาด และการโปรโมตไปยังลูกค้าใหม่หรือลูกค้าเดิม โดยมีวัตถุประสงค์เพื่อเพิ่มการรับรู้ การมีส่วนร่วม และยอดขาย
• ใช้ได้หลายครั้ง: ขั้นตอนการสนทนาที่รวมกรณีการใช้งานด้านการซื้อขายและโปรโมชันเข้าด้วยกัน เช่น การส่งการแจ้งเตือนบัญชี แล้วเสนอส่วนลดหรือการอัปเกรดสำหรับผลิตภัณฑ์และบริการใหม่

ดูคำอธิบายโดยละเอียดเกี่ยวกับกรณีที่ควรใช้แต่ละกรณีได้ที่เลือก Use Case ที่ถูกต้อง

คุณจะเปลี่ยน Use Case ไม่ได้หลังจากที่ตัวแทนส่งข้อมูลเพื่อเปิดตัวแล้ว โปรดอ่านกรณีการใช้งานและกฎทางธุรกิจสำหรับประเทศของคุณก่อนที่จะส่งตัวแทน

สร้างตัวแทน

ทำตามวิธีการเหล่านี้เพื่อสร้างตัวแทนใน Business Communications Developer Console

หมายเหตุ: หากต้องการสร้างตัวแทนโดยใช้ RBM Management API โปรดดูเอกสารประกอบจัดการตัวแทน

1. เปิดคอนโซลของนักพัฒนาซอฟต์แวร์สำหรับการสื่อสารทางธุรกิจ แล้วลงชื่อเข้าใช้ด้วยบัญชี Google ของพาร์ทเนอร์ RBM
2. คลิกสร้างตัวแทน
3. เลือกประเภทตัวแทนเป็นการรับส่งข้อความทางธุรกิจ RCS
4. สำหรับแบรนด์ ให้เลือกแบรนด์ที่ตัวแทนจะแสดง หรือคลิกเพิ่มแบรนด์ใหม่ แล้วป้อนชื่อแบรนด์
5. ป้อนชื่อตัวแทน แล้วเลือกภูมิภาค หมวดหมู่การเรียกเก็บเงิน และกรณีการใช้งานของตัวแทน จากนั้นคลิกสร้างตัวแทน
6. เมื่อตัวแทนพร้อมให้บริการ ให้คลิกชื่อตัวแทน

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

เชิญอุปกรณ์ทดสอบ

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

1. คลิกอุปกรณ์ในการนําทางด้านซ้าย
2. ในส่วนเพิ่มอุปกรณ์ทดสอบ ให้ป้อนหมายเลขโทรศัพท์ของอุปกรณ์แล้วคลิกเพิ่ม
3. ยอมรับคําขอตัวแทนทดสอบในอุปกรณ์ทดสอบ

หากไม่ได้รับการเชิญในอุปกรณ์ทดสอบ ให้ตรวจสอบว่าได้เปิดใช้ RCS ในอุปกรณ์แล้ว

ส่งข้อความ

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

คุณต้องมีคีย์บัญชีบริการเพื่อตรวจสอบสิทธิ์การเรียก API อย่างปลอดภัย หากคุณยังไม่ได้สร้างคีย์บัญชีบริการสำหรับบัญชีพาร์ทเนอร์ คุณควรสร้างตอนนี้

ในเทอร์มินัลบนเครื่องที่ใช้พัฒนา ให้เรียกใช้คําสั่งต่อไปนี้

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!'
  }
}"

• แทนที่ REGION ด้วย asia, europe หรือ us โดยขึ้นอยู่กับภูมิภาคของตัวแทน
• แทนที่ PHONE_NUMBER ด้วยหมายเลขโทรศัพท์ของอุปกรณ์ทดสอบ ใส่รหัสประเทศ รหัสพื้นที่ และ+นำหน้า แต่ไม่ต้องใส่ตัวคั่น เช่น [phone]
• แทนที่ AGENT ID ด้วยรหัสตัวแทนของคุณ ซึ่งอยู่ในหน้าข้อมูลตัวแทนในคอนโซลของนักพัฒนาซอฟต์แวร์ Business Communications
• แทนที่ PATH_TO_SERVICE_ACCOUNT_KEY ด้วยเส้นทางไปยังคีย์ที่สร้างขึ้นก่อนหน้านี้

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

หากต้องการส่งข้อความประเภทต่างๆ เช่น การตอบกลับที่แนะนำและการ์ดริชมีเดีย โปรดดูหัวข้อส่งข้อความ

ขั้นตอนถัดไป

เมื่อตัวแทนสามารถส่งข้อความไปยังอุปกรณ์ทดสอบได้แล้ว ก็ถึงเวลาสร้างสิ่งที่เหมาะกับความต้องการทางธุรกิจของคุณ รับตัวอย่าง Agent ในภาษาที่ต้องการ แล้วทําตามวิธีการใน README ของตัวอย่าง

เมื่อกําหนดค่าตัวแทนตัวอย่างแล้ว ให้อ่านแนวทางปฏิบัติแนะนําของ RBM และดูวิธีที่ตัวแทนส่งและรับข้อความ