อัปเดต: ดูบันทึกประจํารุ่นสําหรับฟีเจอร์ใหม่ๆ และการอัปเดตผลิตภัณฑ์

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

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

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

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

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

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

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

ในฐานะพาร์ทเนอร์ RBM คุณสามารถสร้างตัวแทนในนามของแบรนด์ได้

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

เพิ่มแบรนด์

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

แก้ไขแบรนด์

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

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

นําแบรนด์ออก

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

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

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

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

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

เพิ่มผู้ใช้

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

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

นำผู้ใช้ออก

วิธีนำผู้ใช้ออก

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เปิดคอนโซลของนักพัฒนาซอฟต์แวร์ Business Communications แล้วลงชื่อเข้าใช้ด้วยบัญชี Google ของพาร์ทเนอร์ RBM
เปิดการตั้งค่าบัญชี
สำหรับ 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 ให้คลิกยืนยัน เมื่อ RBM ยืนยันเว็บฮุคเรียบร้อยแล้ว กล่องโต้ตอบจะปิดลง

ยืนยันข้อความขาเข้า

เนื่องจากเว็บฮุคสามารถรับข้อความจากผู้ส่งทุกคน คุณควรตรวจสอบว่า Google ได้ส่งข้อความขาเข้าก่อนประมวลผลเนื้อหาข้อความ

หากต้องการยืนยันว่า Google ได้ส่งข้อความที่คุณได้รับแล้ว ให้ทำตามขั้นตอนต่อไปนี้

ดึงข้อมูลส่วนหัว X-Goog-Signature ของข้อความ นี่คือสำเนาเพย์โหลดเนื้อหาข้อความที่เข้ารหัสฐาน 64
Base-64-ถอดรหัสของเพย์โหลด RBM ในองค์ประกอบ message.body ของคำขอ
สร้าง SHA512 HMAC ของไบต์ของเพย์โหลดข้อความที่ถอดรหัสฐาน 64 และเข้ารหัส 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);

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

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