เมื่อลงทะเบียนเป็นพาร์ทเนอร์ RCS for Business แล้ว คุณจะมีบัญชีพาร์ทเนอร์ หากต้องการเข้าถึงการตั้งค่าบัญชีพาร์ทเนอร์ ให้เปิดคอนโซลของนักพัฒนาซอฟต์แวร์ RCS สำหรับธุรกิจ แล้วคลิกการตั้งค่าบัญชีพาร์ทเนอร์ จากที่นี่ คุณจะทำสิ่งต่อไปนี้ได้
- อัปเดตข้อมูลบัญชีพาร์ทเนอร์
- เพิ่ม แก้ไข และนำแบรนด์ที่ลิงก์กับบัญชีออก
- จัดการผู้ใช้บัญชี
- สร้างบัญชีบริการและคีย์เพื่อตรวจสอบสิทธิ์การเรียก API
อัปเดตข้อมูลบัญชีพาร์ทเนอร์
จากหน้าการตั้งค่า คุณจะดูรหัสพาร์ทเนอร์และอัปเดตข้อมูลต่อไปนี้ได้
| ช่อง | คำอธิบาย |
|---|---|
| ชื่อพาร์ทเนอร์ | ชื่อบัญชีพาร์ทเนอร์ |
| ชื่อที่แสดง | ชื่อจะปรากฏใน
รายงานการเรียกเก็บเงินที่ผู้ให้บริการได้รับ (เป็นowner_name
ฟิลด์) ผู้ให้บริการจะใช้ข้อมูลนี้เพื่อระบุว่าคุณเป็นพาร์ทเนอร์ที่เชื่อถือได้
และสร้างข้อมูลการแจ้งหนี้ที่ถูกต้องสำหรับการใช้ RCS สำหรับ
Business เพื่อเข้าถึงผู้ติดตาม ชื่อที่คุณระบุที่นี่ควรสอดคล้องกับชื่อที่ใช้ในสัญญาการรับส่งข้อความกับผู้ให้บริการ |
| ผู้ติดต่อด้านเทคนิค | บุคคลที่ Google จะติดต่อหากพบปัญหาด้านเทคนิคเกี่ยวกับ ตัวแทนของคุณ คุณสามารถอัปเดต
|
| เว็บฮุค | นี่คือ URL ปลายทางของเว็บฮุค คลิกกำหนดค่าเพื่ออัปเดต เมื่อ กำหนดค่าเว็บฮุกของพาร์ทเนอร์ การตั้งค่านี้จะมีผลกับตัวแทนทั้งหมด หากต้องการใช้ Webhook อื่นสำหรับตัวแทนแต่ละราย คุณสามารถกำหนดค่า Webhook ของตัวแทนที่จะมีผลกับตัวแทนรายนั้นเท่านั้นได้ |
จัดการแบรนด์
ในฐานะพาร์ทเนอร์ RCS for Business คุณสามารถสร้างตัวแทนในนามของแบรนด์ได้
ใช้หน้าแบรนด์ในการตั้งค่าบัญชี เพื่อเพิ่ม แก้ไข และนำแบรนด์ที่เชื่อมโยง กับบัญชีพาร์ทเนอร์ออก
เพิ่มแบรนด์
หากต้องการเพิ่มแบรนด์ ให้ป้อนชื่อในช่องป้อนข้อมูล แล้วคลิกเพิ่ม
แก้ไขแบรนด์
วิธีแก้ไขแบรนด์
- คลิกช่องทำเครื่องหมายข้างชื่อแบรนด์
- คลิกปุ่ม แล้วคลิกแก้ไขชื่อ
- แก้ไขตามต้องการ แล้วคลิกเสร็จสิ้น
นำแบรนด์ออก
คุณจะนำแบรนด์ออกไม่ได้หากเชื่อมโยงอยู่กับตัวแทน แม้ว่าตัวแทนจะยังไม่ได้เปิดตัวก็ตาม
หากต้องการนำแบรนด์ออก ให้คลิกช่องทำเครื่องหมายข้างชื่อแบรนด์ แล้วคลิกลบ
จัดการผู้ใช้
หน้าผู้ใช้ในการตั้งค่าบัญชี คือที่ที่คุณจัดการผู้ใช้บัญชีพาร์ทเนอร์ ผู้ใช้ที่สร้างบัญชีพาร์ทเนอร์จะมีบทบาทเป็นเจ้าของ ผู้ใช้ใหม่จะมีบทบาทเป็นผู้จัดการหรือ ผู้อ่านได้
- ผู้จัดการสามารถเข้าถึงความสามารถทั้งหมดของ Developer Console เพื่อ จัดการเอเจนต์ทั้งหมดที่อยู่ในบัญชีพาร์ทเนอร์
- ผู้อ่านมีสิทธิ์เข้าถึง Play Console แบบอ่านอย่างเดียวเพื่อดูเอเจนต์ทั้งหมดที่อยู่ในบัญชีพาร์ทเนอร์
เพิ่มผู้ใช้
หากต้องการเพิ่มผู้ใช้ ให้ป้อนอีเมลของผู้ใช้ในช่องป้อนข้อมูล แล้วเลือกบทบาท
เมื่อคุณเพิ่มผู้ใช้ใหม่ ผู้ใช้ดังกล่าวจะได้รับอีเมลแจ้งเตือนว่ามีสิทธิ์เข้าถึงบัญชีพาร์ทเนอร์
นำผู้ใช้ออก
หากต้องการนำผู้ใช้ออก ให้ทำดังนี้
- ค้นหาผู้ใช้ที่คุณต้องการยกเลิกสิทธิ์ แล้วคลิกปุ่ม ในแถวตารางของผู้ใช้
- เลือกนำผู้ใช้ออก
- ยืนยันการนำออก
ผู้ใช้ที่คุณนำออกจะได้รับอีเมลแจ้งให้ทราบว่าไม่มีสิทธิ์เข้าถึงบัญชีพาร์ทเนอร์อีกต่อไป
คุณนำผู้ใช้ที่มีบทบาทเจ้าของออกไม่ได้ หากต้องการเปลี่ยนหรือนำเจ้าของออก คุณต้องติดต่อทีมสนับสนุน
เปลี่ยนบทบาทของผู้ใช้
วิธีอัปเดตบทบาทของผู้ใช้
- ค้นหาผู้ใช้ที่ต้องการอัปเดต แล้วคลิกปุ่ม ในแถวตารางของผู้ใช้
- เลือกแก้ไขบทบาท
- เลือกบทบาทใหม่จากเมนูแบบเลื่อนลง
- คลิกบันทึก
ตั้งค่าบัญชีบริการเพื่อตรวจสอบสิทธิ์การเรียก API
เมื่อเรียกใช้ RBM API คุณจะตรวจสอบสิทธิ์การเรียกใช้ด้วยคีย์บัญชีบริการ คีย์นี้ช่วยให้คุณสร้าง และจัดการแบรนด์และตัวแทน รวมถึงส่งข้อความและคำขอในฐานะตัวแทนได้ บัญชีบริการมีคีย์ได้สูงสุด 10 คีย์
หากต้องการตรวจสอบสิทธิ์การเรียก API อย่างปลอดภัย คุณจะต้องมีเครื่องมือบรรทัดคำสั่ง oauth2l ด้วย
ทำตามขั้นตอนต่อไปนี้เพื่อสร้างคีย์บัญชีบริการ
- ในการตั้งค่าบัญชี ให้ไปที่หน้าบัญชีบริการ
- คลิกสร้างคีย์ แล้วคลิกสร้าง เบราว์เซอร์จะดาวน์โหลดคีย์บัญชีบริการ
จัดเก็บคีย์บัญชีบริการไว้ในตำแหน่งที่ปลอดภัยและเป็นส่วนตัว อย่าแชร์คีย์แบบสาธารณะ คุณจะต้องใช้คีย์นี้ในภายหลังเพื่อเข้าถึง RBM API
กำหนดค่าเว็บฮุคของพาร์ทเนอร์
ดูวิธีกำหนดค่าเว็บฮุคของพาร์ทเนอร์ได้ที่คำแนะนำเกี่ยวกับเว็บฮุค
ดูคำแนะนำในการประมวลผล Webhook แบบไม่พร้อมกันเพื่อป้องกันไม่ให้การนำส่งล้มเหลวได้ที่การจัดการข้อความ
ยืนยันข้อความขาเข้า
เนื่องจาก Webhook รับข้อความจากผู้ส่งได้ทุกราย คุณจึงควรยืนยันว่า Google เป็นผู้ส่งข้อความขาเข้าก่อนประมวลผลเนื้อหาข้อความ
หากต้องการยืนยันว่า Google ส่งข้อความที่คุณได้รับ ให้ทำตามขั้นตอนต่อไปนี้
- ดึงข้อมูล
X-Goog-Signatureส่วนหัวของข้อความ นี่คือสำเนาของเพย์โหลดเนื้อความของข้อความที่แฮชและเข้ารหัส Base64 - ถอดรหัส Base64 ของเพย์โหลด RBM ในองค์ประกอบ
message.bodyของคำขอ - ใช้โทเค็นไคลเอ็นต์ของ Webhook (ซึ่งคุณระบุเมื่อตั้งค่า Webhook) เป็นคีย์ จากนั้นสร้าง SHA512 HMAC ของไบต์ของเพย์โหลดข้อความที่ถอดรหัส base64 แล้ว และเข้ารหัส base64 ผลลัพธ์
- เปรียบเทียบแฮช
X-Goog-Signatureกับแฮชที่คุณสร้าง- หากแฮชตรงกัน แสดงว่าคุณยืนยันแล้วว่า Google เป็นผู้ส่งข้อความ
หากแฮชไม่ตรงกัน ให้ตรวจสอบกระบวนการแฮชในข้อความที่ทราบว่าดี
หากกระบวนการแฮชทำงานอย่างถูกต้องและคุณได้รับข้อความที่เชื่อว่ามีการส่งถึงคุณอย่างไม่สุจริต โปรดติดต่อเรา
Node.js
if ((requestBody.hasOwnProperty('message')) && (requestBody.message.hasOwnProperty('data'))) { // Validate the received hash to ensure the message came from Google RBM const headerHash = req.header('X-Goog-Signature'); const userEventString = Buffer.from(requestBody.message.data, 'base64'); const hmac = crypto.createHmac('sha512', myClientToken); const genHash = hmac.update(userEventString).digest('base64'); if (headerHash === genHash) { const userEvent = JSON.parse(userEventString); const webhookType = req.header('X-Goog-Webhook-Type'); // Route based on the header type if (webhookType === 'message_callback') { handleMessage(userEvent); } else if (webhookType === 'agent_callback') { handleAgentEvent(userEvent); } } else { console.log('Hash mismatch - ignoring message'); res.sendStatus(401); return; } } res.sendStatus(200);
ขั้นตอนถัดไป
เมื่อตั้งค่าบัญชีพาร์ทเนอร์แล้ว ก็ถึงเวลาสร้างเอเจนต์แรก