ลงทะเบียนกับ Business Messages

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

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

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

การลงทะเบียนเป็นพาร์ทเนอร์กับ Business Messages, การสร้างตัวแทนสําหรับแบรนด์ต่างๆ และการใช้ประโยชน์จาก API ที่ขับเคลื่อนตัวแทนของคุณ ทําให้คุณสามารถเปิดใช้การรับส่งข้อความ สําหรับฝ่ายบริการลูกค้า ฝ่ายขาย และแอปพลิเคชันทางธุรกิจอื่นๆ

  1. เปิดคอนโซลนักพัฒนาซอฟต์แวร์การสื่อสารทางธุรกิจ
  2. ในส่วน Business Messages ให้คลิกสร้างบัญชีพาร์ทเนอร์

  3. ป้อนค่าสําหรับข้อมูลของพาร์ทเนอร์

    ช่อง ค่า
    ชื่อ ชื่อและนามสกุลของคุณ
    ชื่อพาร์ทเนอร์ ชื่อองค์กร
    เว็บไซต์พาร์ทเนอร์ เว็บไซต์องค์กร
    ภูมิภาค ภูมิภาคที่คุณต้องการโฮสต์บริการ Business Messages

  1. อ่านและยอมรับข้อกําหนดในการให้บริการของ Business Messages

  2. คลิกสร้าง

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

สร้างบัญชีบริการ

คุณต้องมีคีย์บัญชีบริการและเครื่องมือบรรทัดคําสั่ง oauth2l เพื่อตรวจสอบสิทธิ์การเรียก API ไปยัง Business Messages และ Business Communications API อย่างปลอดภัย

  1. คลิกการตั้งค่าบัญชีพาร์ทเนอร์ในหน้าแรกของคอนโซลการสื่อสารทางธุรกิจ
  2. คลิกบัญชีบริการในการนําทางด้านซ้าย

  3. คลิกสร้างคีย์ แล้วคลิกสร้าง

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

ตั้งค่า eBook ของคุณ

เมื่อเปิดใช้ Business Messages และ Business Communications API แล้ว คุณต้องระบุ URL ของเว็บฮุคเพื่อเริ่มรับข้อความ

  1. เปิดการตั้งค่าบัญชีใน Business Communications Developer Console
  2. ตรวจสอบว่าได้เลือกบัญชีพาร์ทเนอร์ที่ถูกต้องแล้ว
  3. สําหรับ URL ของเว็บฮุคของ Business Messages ให้คลิกกําหนดค่า
  4. สําหรับ URL ของเว็บฮุค ให้ป้อน URL ของเว็บฮุคโดยขึ้นต้นด้วย "https://"
  5. จดบันทึกมูลค่า clientToken ของคุณ คุณต้องยืนยันว่าข้อความที่คุณได้รับมาจาก Google

  6. กําหนดค่าเว็บฮุคให้ยอมรับคําขอ POST ที่มีพารามิเตอร์ clientToken ที่ระบุ และส่งการตอบกลับ 200 OK ด้วยค่าข้อความธรรมดาของพารามิเตอร์ secret เป็นเนื้อหาการตอบกลับ

    ตัวอย่างเช่น หากเว็บฮุคได้รับคําขอ POST พร้อมด้วยเนื้อหาเนื้อหาต่อไปนี้

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}

    เว็บฮุคควรยืนยันค่า clientToken และหาก clientToken ถูกต้อง ให้แสดงการตอบกลับ 200 OK ด้วย 0123456789 เป็นเนื้อหาตอบกลับ

  7. คลิกยืนยันในคอนโซล

    เมื่อ Business Messages ยืนยันเว็บฮุคของคุณ กล่องโต้ตอบจะปิด

ดูตัวอย่าง: อัปเดต URL ของเว็บฮุคเพื่อดูวิธีกําหนดค่าเว็บฮุคด้วย Business Communication API

รับข้อมูลพาร์ทเนอร์

หากต้องการค้นหาข้อมูลพาร์ทเนอร์ปัจจุบัน ให้ค้นหา Business Communications API ด้วยรหัสพาร์ทเนอร์

เรียกใช้คําสั่งต่อไปนี้ แทนที่ PARTNER_ID ด้วยรหัสพาร์ทเนอร์


# This code gets the partner.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get

# Replace the __PARTNER_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"
get-partner.sh

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

หากต้องการอัปเดตข้อมูลพาร์ทเนอร์ ให้ใช้หน้าการตั้งค่าบัญชีใน Business Communications Developer Console หรือเรียกใช้คําสั่งต่อไปนี้

แทนที่ PARTNER_ID ด้วยรหัสพาร์ทเนอร์(สามารถพบรหัสพาร์ทเนอร์ได้ใน Business Communications Developer Console) และแทนที่ UPDATED_FIELDS ด้วยชื่อช่องที่คุณอัปเดต


# This code updates the partner entity.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/patch

# Replace the __PARTNER_ID__, __UPDATED_FIELDS__, __FIELD_NAME__, __FIELD_VALUE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__?updateMask=__UPDATED_FIELDS__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "__FIELD_NAME__": "__FIELD_VALUE__"
}'
update-partner.sh

ดูตัวเลือกการจัดรูปแบบและค่าได้ที่ partners.patch

ตัวอย่าง: อัปเดตชื่อที่แสดง

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/12345/partners/67890?updateMask=displayName" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
    'displayName': 'XYZ Messaging',
}"

ตัวอย่าง: อัปเดต URL ของเว็บฮุค

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/12345?updateMask=productCapabilities" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
  'productCapabilities': [
    {
      'product': 'BUSINESS_MESSAGES',
      'businessMessagesCapability': {
        'webhookUrl': 'https://xyz.messaging.com/webhook',
      },
    },
  ],
}"

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

ตอนนี้คุณเป็นพาร์ทเนอร์ที่ลงทะเบียนและเปิดใช้ API แล้ว คุณจะเริ่มพัฒนาด้วย Business Messages ได้ หากต้องการเริ่มต้นใช้งานอย่างรวดเร็ว โปรดดูหัวข้อสร้างตัวแทนแรกของคุณ

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