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

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

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

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

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

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

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

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

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

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

เพิ่มแบรนด์

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

แก้ไขแบรนด์

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

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

นำแบรนด์ออก

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

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

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

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

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

เพิ่มผู้ใช้

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

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

นำผู้ใช้ออก

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ตัวอย่างเช่น หาก Webhook ได้รับคําขอ 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);
});
```
ในคอนโซลนักพัฒนาแอป ให้คลิกยืนยัน เมื่อ RBM ยืนยันเว็บฮุกแล้ว กล่องโต้ตอบจะปิดลง

หากต้องการจัดการกับการจัดส่ง Webhook ที่ล้มเหลวและตรวจสอบการประมวลผลข้อความที่เชื่อถือได้ โปรดดูการจัดการข้อความ

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

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

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

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