Đăng ký bằng Business Messages

Khi đăng ký làm đối tác bằng Business Messages, bạn có thể bật cuộc trò chuyện giữa người dùng và thương hiệu bằng cách tạo nhân viên hỗ trợ (trò chuyện) đại diện cho các chức năng kinh doanh, chẳng hạn như hỗ trợ trang web và vị trí thương hiệu.

Nhân viên hỗ trợ: Người đại diện có thể trò chuyện của một thương hiệu, do đối tác quản lý. Bao gồm mọi giao diện mà người dùng tương tác và bất kỳ mã hoặc cơ sở hạ tầng nào cần thiết để hỗ trợ tương tác.

Khi người dùng tìm thấy một thương hiệu mà bạn quản lý trong Google Tìm kiếm hoặc Google Maps, kết quả tìm kiếm sẽ hiển thị tùy chọn Chat. Khi nhấp vào Chat, người dùng có thể gửi tin nhắn cho nhân viên hỗ trợ của thương hiệu. Nhân viên hỗ trợ này cho phép bạn nhận và trả lời tin nhắn của người dùng.

Đăng ký làm đối tác

Bằng cách đăng ký với tư cách là đối tác của Business Messages, tạo nhân viên hỗ trợ cho thương hiệu và tận dụng các API hỗ trợ nhân viên hỗ trợ, bạn có thể bật trải nghiệm nhắn tin cho các dịch vụ khách hàng, chương trình giảm giá và các ứng dụng khác dành cho doanh nghiệp.

1. Mở Business Communications Developer Console.
2. Trong mục Business Messages, hãy nhấp vào Create account account (Tạo tài khoản đối tác).

3. Nhập giá trị cho thông tin đối tác:

   Trường	Giá trị
   Tên của bạn	Tên đầy đủ của bạn
   Tên đối tác	Tên tổ chức
   Trang web của đối tác	Trang web của tổ chức
   Vùng	Khu vực mà bạn muốn lưu trữ dịch vụ Business Messages

Lưu ý: Để ra mắt nhân viên hỗ trợ sản xuất bằng Business Messages, bạn phải đăng ký bằng email công ty, không phải email cá nhân.

1. Xem và chấp nhận Điều khoản dịch vụ của Business Messages.

2. Nhấp vào Tạo.

Bạn hiện đã đăng ký làm đối tác Business Messages và có quyền truy cập vào Business Messages và API Business Communications. API Business Messages gửi tin nhắn cho người dùng, trong khi API Business Communications quản lý các nhân viên hỗ trợ.

Tạo một tài khoản dịch vụ

Để xác thực an toàn các lệnh gọi API tới API Business Messages và Business Communications, bạn cần có khoá tài khoản dịch vụ và công cụ dòng lệnh OAuth2l.

1. Trên trang chủ Business Communications Developer Console, hãy nhấp vào Cài đặt tài khoản của đối tác.
2. Trong bảng điều hướng bên trái, hãy nhấp vào Tài khoản dịch vụ.

3. Nhấp vào Tạo khoá, rồi nhấp vào Tạo.

   Trình duyệt của bạn tải khoá tài khoản dịch vụ xuống. Lưu trữ khoá tài khoản dịch vụ ở một nơi riêng tư và bảo mật. Đừng chia sẻ công khai khóa của bạn. Bạn sẽ cần khoá này sau để truy cập vào Business Messages và API Business Communications.

Lưu ý: Nếu là đối tác Business Messages bằng tài khoản GCP của riêng mình, bạn có thể truy cập vào khoá tài khoản dịch vụ trong Google Cloud Console.

Thiết lập Webook

Giờ đây, API Business Messages và Business Communications đã được bật, bạn phải chỉ định URL webhook để bắt đầu nhận tin nhắn.

1. Mở phần Settings settings (Cài đặt tài khoản) trong Business Communications Developer Console.
2. Đảm bảo bạn đã chọn đúng tài khoản đối tác.
3. Đối với URL webhook doanh nghiệp, hãy nhấp vào Định cấu hình.
4. Đối với URL điểm cuối webhook, hãy nhập URL của webhook, bắt đầu bằng "https://".
5. Vui lòng lưu ý giá trị clientToken của bạn. Bạn cần mã nhận dạng này để xác minh rằng tin nhắn bạn nhận được là của Google.

6. Định cấu hình webhook của bạn để chấp nhận yêu cầu POST có tham số clientToken được chỉ định và gửi một phản hồi 200 OK kèm theo giá trị văn bản thuần túy của tham số secret làm nội dung phản hồi.

   Ví dụ: nếu webhook của bạn nhận được một yêu cầu POST với nội dung nội dung sau

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

   webhook của bạn phải xác nhận giá trị clientToken và nếu clientToken chính xác, hãy trả về một phản hồi 200 OK với 0123456789 là nội dung phản hồi.

7. Trong bảng điều khiển, hãy nhấp vào Xác minh.

   Khi Business Messages xác minh webhook của bạn, hộp thoại sẽ đóng lại.

Hãy xem phần Ví dụ: Cập nhật URL webhook để xem cách định cấu hình webhook của bạn với API Business Communications.

Hỏi thông tin về đối tác

Để biết thông tin về đối tác hiện tại, bạn có thể truy vấn API Doanh nghiệp liên lạc bằng Mã đối tác.

Chạy lệnh sau. Thay thế PARTNER_ID bằng Mã đối tác của bạn.

# 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

Cập nhật thông tin đối tác

Để cập nhật thông tin đối tác, bạn có thể sử dụng trang Cài đặt tài khoản trong Business Communications Developer Console hoặc chạy các lệnh sau.

Thay thế PARTNER_ID bằng mã đối tác của bạn(có thể tìm thấy mã đối tác trong Business Communications Developer Console) và thay thế UPDATED_FIELDS bằng tên trường mà bạn cập nhật.

# 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

Để biết các tuỳ chọn định dạng và giá trị, hãy xem partners.patch.

Ví dụ: Cập nhật tên hiển thị

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',
}"

Ví dụ: Cập nhật URL webhook

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',
      },
    },
  ],
}"

Các bước tiếp theo

Giờ đây, bạn đã là đối tác đã đăng ký và đã bật các API, nên bạn có thể bắt đầu phát triển bằng Business Messages. Để bắt đầu nhanh, hãy xem phần Tạo nhân viên hỗ trợ đầu tiên.

Nếu không, hãy tìm hiểu cách tạo nhân viên hỗ trợ đại diện cho thương hiệu của bạn trong các cuộc trò chuyện và định cấu hình webhook để nhận tin nhắn từ người dùng.