สร้าง Agent แรก

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

สร้างเอเจนต์

ทำตามวิธีการต่อไปนี้เพื่อสร้างเอเจนต์ใน Business Communications Developer Console

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

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

1. ไปที่ Business Communications Developer Console แล้วลงชื่อเข้าใช้ด้วยบัญชี Google ของพาร์ทเนอร์ RCS สำหรับธุรกิจ
2. คลิก + สร้างเอเจนต์ในหน้าแรก
3. ในหน้าต่างการรับส่งข้อความทางธุรกิจ RCS ใหม่ ให้ระบุข้อมูลต่อไปนี้
   • แบรนด์ที่ตัวแทนของคุณเป็นตัวแทน
   • ชื่อตัวแทน
   • ภูมิภาคที่โฮสต์
   • หมวดหมู่การเรียกเก็บเงิน
   • กรณีการใช้งาน
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!"
  },
  "messageTrafficType": "PROMOTION"
}'

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

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

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

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

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

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