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

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

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

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

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

บุคคลที่ Google จะติดต่อหากพบปัญหาด้านเทคนิคเกี่ยวกับ ตัวแทนของคุณ คุณสามารถอัปเดต

  • ชื่อ
  • อีเมลของบริษัท
  • หมายเลขโทรศัพท์
เว็บฮุค นี่คือ URL ปลายทางของเว็บฮุค คลิกกำหนดค่าเพื่ออัปเดต เมื่อ กำหนดค่าเว็บฮุกของพาร์ทเนอร์ การตั้งค่านี้จะมีผลกับตัวแทนทั้งหมด หากต้องการใช้ Webhook อื่นสำหรับตัวแทนแต่ละราย คุณสามารถกำหนดค่า Webhook ของตัวแทนที่จะมีผลกับตัวแทนรายนั้นเท่านั้นได้

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

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

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

เพิ่มแบรนด์

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

แก้ไขแบรนด์

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

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

นำแบรนด์ออก

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

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

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

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

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

เพิ่มผู้ใช้

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

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

นำผู้ใช้ออก

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ดูวิธีกำหนดค่าเว็บฮุคของพาร์ทเนอร์ได้ที่คำแนะนำเกี่ยวกับเว็บฮุค

ดูคำแนะนำในการประมวลผล Webhook แบบไม่พร้อมกันเพื่อป้องกันไม่ให้การนำส่งล้มเหลวได้ที่การจัดการข้อความ

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

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

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

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

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

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