สร้าง 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 มีอยู่ 3 ภูมิภาค ได้แก่ อเมริกาเหนือ ยุโรป และเอเชียแปซิฟิก RBM API รองรับปลายทางระดับภูมิภาค 3 แห่งเพื่อช่วยธุรกิจต่างๆ ปฏิบัติตามข้อกําหนดระดับภูมิภาคและข้อกําหนดทางธุรกิจ

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

หากคุณหรือผู้ใช้เป้าหมายไม่ได้อยู่ในภูมิภาคดังกล่าว ให้เลือกภูมิภาคที่ใกล้กับคุณมากที่สุดเพื่อลดเวลาในการตอบสนอง เช่น

• หากอยู่ในลาตินอเมริกา ให้เลือกภูมิภาคอเมริกาเหนือ
• หากคุณอยู่ในแอฟริกา ให้เลือกภูมิภาคยุโรป
• หากคุณอยู่ในออสเตรเลีย ให้เลือกภูมิภาคเอเชียแปซิฟิก

อย่าเลือกภูมิภาคของตัวแทนตามผู้ให้บริการขนส่งเป้าหมาย ภูมิภาคทั้งหมดมีสิทธิ์เข้าถึงผู้ให้บริการทั่วโลกอย่างเท่าเทียม

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

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

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

• การสนทนา: สําหรับตัวแทนที่มีส่วนร่วมในการสนทนาแบบหลายรอบกับผู้ใช้
• ข้อความพื้นฐานหรือข้อความเดียว: สำหรับตัวแทนที่ส่งข้อความโดยไม่คาดหวังการตอบกลับบ่อยครั้ง

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

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบการเรียกเก็บเงิน RBM ได้ที่คําถามที่พบบ่อยเกี่ยวกับการเรียกเก็บเงิน RBM

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

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

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

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

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

สร้างตัวแทน

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

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

วิธีสร้างตัวแทน

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

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

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

เมื่อคุณมีตัวแทนและอุปกรณ์ทดสอบเปิดใช้ 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 และดูวิธีที่ตัวแทนส่งและรับข้อความ