เมื่อลงทะเบียนเป็นพาร์ทเนอร์กับ Business Messages คุณจะเปิดใช้ การสนทนาระหว่างผู้ใช้กับแบรนด์ด้วยการสร้างตัวแทน - การสนทนา สิ่งที่แสดงถึงหน้าที่ทางธุรกิจ เช่น การสนับสนุนทางเว็บไซต์ และแบรนด์ สถานที่ตั้ง
เมื่อผู้ใช้พบแบรนด์ที่คุณจัดการใน Google Search หรือ Google Maps ผลการค้นหาจะแสดงตัวเลือกแชท เมื่อผู้ใช้คลิกแชท ระบบจะเลือกใช้ สามารถส่งข้อความถึงตัวแทนของแบรนด์ ตัวแทนจะช่วยให้คุณรับและตอบกลับได้ กับข้อความของผู้ใช้
ลงทะเบียนเป็นพาร์ทเนอร์
การลงทะเบียนเป็นพาร์ทเนอร์กับ Business Messages ซึ่งเป็นการสร้างตัวแทนให้กับแบรนด์ และใช้ประโยชน์จาก API ที่ขับเคลื่อนตัวแทนของคุณ คุณจะสามารถเปิดใช้การรับส่งข้อความ สำหรับการบริการลูกค้า การขาย และแอปพลิเคชันทางธุรกิจอื่นๆ
- เปิดคอนโซลของนักพัฒนาซอฟต์แวร์ Business Communications
- ในส่วน Business Messages ให้คลิกสร้างบัญชีพาร์ทเนอร์
ป้อนค่าสำหรับข้อมูลพาร์ทเนอร์ ดังนี้
ช่อง ค่า ชื่อของคุณ ชื่อและนามสกุลของคุณ ชื่อพาร์ทเนอร์ ชื่อองค์กร เว็บไซต์พาร์ทเนอร์ เว็บไซต์องค์กร ภูมิภาค ภูมิภาคที่ต้องการโฮสต์บริการ Business Messages
อ่านและยอมรับ ข้อกำหนดในการให้บริการของ Business Messages
คลิกสร้าง
ตอนนี้คุณลงทะเบียนเป็นพาร์ทเนอร์ของ Business Messages และมีสิทธิ์เข้าถึง Business Messages และ Business Communications API แล้ว Business Messages API จะส่งข้อความให้ผู้ใช้ ส่วน Business Communications API จะจัดการตัวแทน
สร้างบัญชีบริการ
หากต้องการตรวจสอบสิทธิ์การเรียก API ไปยัง Business Messages และ Business Communications API อย่างปลอดภัย คุณจะต้องมีคีย์บัญชีบริการและ oauth2l ได้ด้วย
- คลิกการตั้งค่าบัญชีพาร์ทเนอร์ในหน้าแรกของ Business Communications Developer Console
- ในการนำทางด้านซ้าย ให้คลิก บัญชีบริการ
คลิกสร้างคีย์ แล้วคลิกสร้าง
เบราว์เซอร์จะดาวน์โหลดคีย์บัญชีบริการ เก็บคีย์บัญชีบริการไว้ในที่ปลอดภัยและเป็นส่วนตัว สิ่งที่ไม่ควรทำ แชร์คีย์แบบสาธารณะ คุณจะต้องใช้คีย์นี้ในภายหลังเพื่อเข้าถึง Business Message and Business Communication API
ตั้งค่า eBook ของคุณ
เมื่อเปิดใช้ Business Messages และ Business Communications API แล้ว คุณจะ ต้องระบุ URL ของเว็บฮุคเพื่อเริ่มต้น การรับข้อความ
- เปิดการตั้งค่าบัญชีใน Business Communications Developer Console
- ตรวจสอบว่าได้เลือกบัญชีพาร์ทเนอร์ที่ถูกต้องแล้ว
- สำหรับ URL ของเว็บฮุคของ Business Messages ให้คลิกกำหนดค่า
- สำหรับ URL ปลายทางของเว็บฮุค ให้ป้อน URL ของเว็บฮุคโดยขึ้นต้นด้วย "https://"
- จดค่า
clientToken
ไว้ คุณต้องใช้รหัสเพื่อยืนยันว่า ที่ได้รับมาจาก Google กำหนดค่าเว็บฮุคให้ยอมรับคำขอ
POST
ที่มีข้อมูล พารามิเตอร์clientToken
และส่งการตอบกลับ200 OK
ด้วยข้อความธรรมดา ของพารามิเตอร์secret
เป็นส่วนเนื้อหาการตอบกลับตัวอย่างเช่น หากเว็บฮุคได้รับคำขอ
POST
ที่มีข้อมูลต่อไปนี้ เนื้อหาเกี่ยวกับเนื้อความ{ "clientToken":"SJENCPGJESMGUFPY", "secret":"0123456789" }
เว็บฮุคควรยืนยันค่า
clientToken
และหากclientToken
คือ ถูกต้อง แสดงผลคำตอบ200 OK
ที่มี0123456789
เป็นส่วนเนื้อหาคำตอบคลิกยืนยันในคอนโซล
เมื่อ Business Messages ยืนยันเว็บฮุค กล่องโต้ตอบจะปิดลง
โปรดดู ตัวอย่าง: อัปเดต URL ของเว็บฮุค เพื่อดูวิธีกำหนดค่าเว็บฮุคด้วย Business Communication API
รับข้อมูลพาร์ทเนอร์
หากต้องการรับข้อมูลปัจจุบันของพาร์ทเนอร์ ให้ค้นหาธุรกิจ 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)"
อัปเดตข้อมูลพาร์ทเนอร์
หากต้องการอัปเดตข้อมูลพาร์ทเนอร์ คุณสามารถใช้หน้าการตั้งค่าบัญชีใน Business Communications Developer Console หรือเรียกใช้คำสั่งต่อไปนี้
แทนที่ PARTNER_ID ด้วยรหัสพาร์ทเนอร์ของคุณ(สามารถดูรหัสพาร์ทเนอร์ได้ในคอนโซลของนักพัฒนาซอฟต์แวร์ Business Communications) และแทนที่ 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__" }'
สำหรับตัวเลือกการจัดรูปแบบและค่า โปรดดู
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 หากต้องการเริ่มต้นใช้งานอย่างรวดเร็ว โปรดดู สร้างตัวแทนแรก
หรือดูวิธีการ สร้าง Agent เพื่อนำเสนอแบรนด์ในการสนทนาและกำหนดค่าเว็บฮุคให้ รับข้อความ จากผู้ใช้