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

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

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

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

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

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

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

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

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

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

เพิ่มแบรนด์

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

แก้ไขแบรนด์

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

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

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

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

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

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

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

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

เพิ่มผู้ใช้

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

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

นำผู้ใช้ออก

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เปิดคอนโซลของนักพัฒนาซอฟต์แวร์ 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 ของข้อความ นี่คือรูปแบบที่แฮช สำเนาที่เข้ารหัส base64 ของเพย์โหลดเนื้อหาข้อความ
Base-64-ถอดรหัสเพย์โหลด RBM ในองค์ประกอบ message.body ของคำขอ
ใช้โทเค็นไคลเอ็นต์ของเว็บฮุค (ซึ่งคุณระบุไว้เมื่อตั้งค่า ) เป็นคีย์ ให้สร้าง SHA512 HMAC ของไบต์ที่ถอดรหัส base-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);

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

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

ลงทะเบียนให้เสร็จสมบูรณ์

สร้าง Agent แรก