Chúng tôi sẽ ngừng cung cấp ứng dụng Google Business Messages từ ngày 31 tháng 7 năm 2024. Đọc thêm tại đây.

Trang này được dịch bởi Cloud Translation API.

Đăng ký bằng Business Messages

Khi đăng ký làm đối tác bằng Business Messages, bạn có thể bật các 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 pháp nhân đại diện cho chức năng kinh doanh (chẳng hạn như dịch vụ hỗ trợ trang web) và thương hiệu vị trí.

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

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

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

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

Nhập các giá trị cho thông tin về đối tác của bạn:

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 đối tác	Trang web của tổ chức
Khu vực	Khu vực mà bạn muốn lưu trữ dịch vụ Business Messages

Đọc kỹ và chấp nhận Điều khoản dịch vụ của Business Messages.
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à Business Communications API. Business Messages API gửi thông báo cho người dùng, còn Business Communications API quản lý nhân viên hỗ trợ.

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

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

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

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

Thiết lập sổ sách trực tuyến

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

Mở phần Cài đặt tài khoản trong Business Communications Developer Console.
Nhớ chọn đúng tài khoản đối tác.
Đối với URL webhook của Business Messages, hãy nhấp vào Định cấu hình.
Đối với URL điểm cuối webhook, hãy nhập URL của webhook, bắt đầu bằng "https://".
Ghi lại giá trị clientToken của bạn. Bạn cần mã này để xác minh rằng tin nhắn bạn nhận được đến từ Google.
Định cấu hình webhook của bạn để chấp nhận yêu cầu POST bằng thông tin được chỉ định tham số clientToken và gửi phản hồi 200 OK có văn bản thuần tuý giá trị 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 yêu cầu POST với thông tin sau nội dung
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
webhook của bạn phải xác nhận giá trị clientToken và nếu clientToken là chính xác, hãy trả về phản hồi 200 OK, trong đó 0123456789 làm nội dung phản hồi.
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.

Xem Ví dụ: Cập nhật URL webhook để xem cách định cấu hình webhook bằng API Business Communication.

Nhận thông tin đối tác

Để xem thông tin về đối tác hiện tại, bạn có thể truy vấn doanh nghiệp API Truyền thông với Mã đối tác của bạn.

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 có 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 với các 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 lựa chọn về đị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

Vì bạn là một đối tác đã đăng ký và đã kích hoạt các API, bạn có thể bắt đầu đang phát triển bằng Business Messages. Để bắt đầu nhanh, hãy xem 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 của bạn để nhận tin nhắn từ người dùng.