หน้านี้ได้รับการแปลโดย Cloud Translation API

ตั้งค่าบัญชีพาร์ทเนอร์

เมื่อลงทะเบียนเป็นพาร์ทเนอร์ RCS สำหรับธุรกิจแล้ว คุณจะมีบัญชีพาร์ทเนอร์ หากต้องการเข้าถึงการตั้งค่าบัญชีพาร์ทเนอร์ ให้เปิด Business Communications Developer Console แล้วคลิกการตั้งค่าบัญชีพาร์ทเนอร์ จากที่นี่ คุณจะทำสิ่งต่อไปนี้ได้

อัปเดตข้อมูลบัญชีพาร์ทเนอร์

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

ช่อง	คำอธิบาย
ชื่อพาร์ทเนอร์	ชื่อบัญชีพาร์ทเนอร์
ชื่อที่แสดง	ชื่อจะปรากฏใน รายงานการเรียกเก็บเงินที่ผู้ให้บริการได้รับ (เป็นฟิลด์ `owner_name` ) ผู้ให้บริการจะใช้ข้อมูลนี้เพื่อระบุว่าคุณเป็นพาร์ทเนอร์ที่เชื่อถือได้ และสร้างข้อมูลการแจ้งหนี้ที่ถูกต้องสำหรับการใช้ RCS สำหรับ Business เพื่อเข้าถึงผู้ติดตาม ชื่อที่คุณระบุที่นี่ควรสอดคล้องกับชื่อที่ใช้ในสัญญาการรับส่งข้อความกับผู้ให้บริการ
ผู้ติดต่อด้านเทคนิค	บุคคลที่ Google จะติดต่อหากพบปัญหาด้านเทคนิคเกี่ยวกับ ตัวแทนของคุณ คุณอัปเดต ชื่อ อีเมลของบริษัท หมายเลขโทรศัพท์
เว็บฮุค	นี่คือ URL ปลายทางของเว็บฮุค คลิกกำหนดค่าเพื่ออัปเดต เมื่อคุณ กำหนดค่าเว็บฮุก ของพาร์ทเนอร์ การตั้งค่านี้จะมีผลกับตัวแทนทั้งหมด หากต้องการใช้ Webhook อื่นสำหรับตัวแทนแต่ละราย คุณสามารถกำหนดค่า Webhook ของตัวแทนที่จะมีผลกับตัวแทนรายนั้นเท่านั้น

จัดการแบรนด์

ในฐานะพาร์ทเนอร์ RCS สำหรับธุรกิจ คุณสามารถสร้างตัวแทนในนามของแบรนด์ได้

ใช้หน้าแบรนด์ในการตั้งค่าบัญชี เพื่อเพิ่ม แก้ไข และนำแบรนด์ที่เชื่อมโยง กับบัญชีพาร์ทเนอร์ออก

เพิ่มแบรนด์

หากต้องการเพิ่มแบรนด์ ให้ป้อนชื่อในช่องป้อนข้อมูล แล้วคลิกเพิ่ม

แก้ไขแบรนด์

วิธีแก้ไขแบรนด์

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

นำแบรนด์ออก

คุณจะนำแบรนด์ออกไม่ได้หากเชื่อมโยงอยู่กับตัวแทน แม้ว่าตัวแทนจะยังไม่ได้เปิดตัวก็ตาม

หากต้องการนำแบรนด์ออก ให้คลิกช่องทำเครื่องหมายข้างชื่อแบรนด์ แล้วคลิกลบ

จัดการผู้ใช้

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

ผู้จัดการสามารถเข้าถึงความสามารถทั้งหมดของ Developer Console เพื่อ จัดการเอเจนต์ทั้งหมดที่อยู่ในบัญชีพาร์ทเนอร์
ผู้อ่านมีสิทธิ์เข้าถึง Play Console แบบอ่านอย่างเดียวเพื่อดูเอเจนต์ทั้งหมดที่อยู่ในบัญชีพาร์ทเนอร์

เพิ่มผู้ใช้

หากต้องการเพิ่มผู้ใช้ ให้ป้อนอีเมลของผู้ใช้ในช่องป้อนข้อมูล แล้วเลือกบทบาท

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

นำผู้ใช้ออก

หากต้องการนำผู้ใช้ออก ให้ทำดังนี้

ค้นหาผู้ใช้ที่คุณต้องการนำออก แล้วคลิกปุ่ม ในแถวตารางของผู้ใช้
เลือกนำผู้ใช้ออก
ยืนยันการนำออก

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

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

เปลี่ยนบทบาทของผู้ใช้

วิธีอัปเดตบทบาทของผู้ใช้

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

ตั้งค่าบัญชีบริการเพื่อตรวจสอบสิทธิ์การเรียก API

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

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

ทำตามขั้นตอนต่อไปนี้เพื่อสร้างคีย์บัญชีบริการ

ในการตั้งค่าบัญชี ให้ไปที่หน้าบัญชีบริการ
คลิกสร้างคีย์ แล้วคลิกสร้าง เบราว์เซอร์จะดาวน์โหลด คีย์บัญชีบริการ

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

กำหนดค่าเว็บฮุคของพาร์ทเนอร์

Webhook คือการเรียกกลับผ่าน HTTPS ที่พาร์ทเนอร์สร้างขึ้น ซึ่งระบุวิธีที่ตัวแทนควรตอบกลับข้อความและเหตุการณ์ เมื่อกำหนดค่า Webhook แล้ว คุณจะเริ่มรับข้อความและเหตุการณ์ได้

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

หากต้องการกำหนดค่า Webhook ของพาร์ทเนอร์ ให้ทำตามขั้นตอนต่อไปนี้

เปิดคอนโซลของนักพัฒนาซอฟต์แวร์สำหรับการสื่อสารทางธุรกิจ แล้วลงชื่อเข้าใช้ด้วยบัญชี Google ของพาร์ทเนอร์ RCS สำหรับธุรกิจ
เปิดการตั้งค่าบัญชี
สำหรับ URL ของเว็บฮุคการรับส่งข้อความทางธุรกิจ RCS ให้คลิกกำหนดค่า
สำหรับ URL ปลายทางของเว็บฮุค ให้ป้อน URL ของเว็บฮุคโดยขึ้นต้นด้วย "https://"
จดค่า clientToken คุณต้องใช้เพื่อ ยืนยันว่าข้อความที่คุณได้รับมาจาก Google
กำหนดค่าเว็บฮุคให้ยอมรับคำขอ POST ที่มีพารามิเตอร์ clientToken ที่ระบุ และส่งการตอบกลับ 200 OK ที่มีค่าข้อความธรรมดาของพารามิเตอร์ secret เป็นเนื้อหาการตอบกลับ

ตัวอย่างเช่น หากเว็บบุ๊กได้รับคำขอ POST ที่มีเนื้อหาใน ส่วนเนื้อหาดังนี้
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"1234567890"
}
```
จากนั้นเว็บฮุคควรยืนยันค่า clientToken และหาก clientToken ถูกต้อง ให้แสดงผลการตอบกลับ 200 OK โดยมี 1234567890 เป็นเนื้อหาการตอบกลับ
```
// clientToken from Configure
const myClientToken = "SJENCPGJESMGUFPY";

// Example endpoint
app.post("/rbm-webhook", (req, res) => {
  const msg = req.body;
  if (msg.clientToken === myClientToken) {
      res.status(200).send(msg.secret);
      return;
  }
  res.send(400);
});
```
ใน Developer Console ให้คลิกยืนยัน เมื่อ RCS สำหรับธุรกิจยืนยันเว็บฮุกแล้ว กล่องโต้ตอบจะปิดลง

ดูคำแนะนำในการประมวลผล 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
    let userEventString = Buffer.from(requestBody.message.data, 'base64');
    let hmac = crypto.createHmac('sha512', CLIENT_TOKEN);
    let data = hmac.update(userEventString);
    let genHash = data.digest('base64');
    let headerHash = req.header('X-Goog-Signature');

    if (headerHash === genHash) {
      let userEvent = JSON.parse(userEventString);

      console.log('userEventString: ' + userEventString);
      handleMessage(userEvent);
    } else {
      console.log('hash mismatch - ignoring message');
    }
  }

  res.sendStatus(200);

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

เมื่อตั้งค่าบัญชีพาร์ทเนอร์แล้ว ก็ถึงเวลาสร้างเอเจนต์แรก

ลงทะเบียนเป็นพาร์ทเนอร์

สร้าง Agent แรก