Trang doanh nghiệp là một công cụ miễn phí và dễ sử dụng giúp các doanh nghiệp và tổ chức quản lý sự hiện diện trực tuyến của mình trên Google (bao gồm cả Tìm kiếm và Maps).
API Trang doanh nghiệp trên Google cung cấp một giao diện để quản lý thông tin vị trí của doanh nghiệp trên Google. Một doanh nghiệp có thể cấp quyền truy cập thông qua sự đồng ý OAuth cho một doanh nghiệp khác để thay mặt họ quản lý trang doanh nghiệp.
Các doanh nghiệp được quản lý trên Trang doanh nghiệp đã được xác minh thông qua quy trình xác minh Trang doanh nghiệp. Bạn có thể mở rộng luồng đồng ý OAuth của Trang doanh nghiệp để đưa những doanh nghiệp này vào Business Messages và tự động xác minh để triển khai trên Business Messages.
Đây là phương thức linh hoạt và nhanh hơn để ra mắt Business Messages, đồng thời là quy trình được đề xuất để bật tính năng nhắn tin cho một vị trí trên Trang doanh nghiệp.
Điều kiện tiên quyết
Bạn phải là đối tác Trang doanh nghiệp hiện có và có quyền truy cập vào API Trang doanh nghiệp trên Google. Nếu không, hãy làm theo các điều kiện tiên quyết của Trang doanh nghiệp để đăng ký quyền truy cập.
Sau khi bạn được cấp quyền truy cập vào API Trang doanh nghiệp trên Google, hãy làm theo hướng dẫn thiết lập cơ bản và thiết lập OAuth trước khi tiếp tục.
Bật tính năng Tin nhắn cho doanh nghiệp cho một địa điểm đã xác minh trong Trang doanh nghiệp
Sơ đồ sau đây cho thấy cách dịch vụ web của bạn có thể tận dụng quy trình xác minh vị trí trên Trang doanh nghiệp của một thương hiệu cho một nhân viên hỗ trợ trên ứng dụng Tin nhắn cho doanh nghiệp. Hãy xem bên dưới để biết hướng dẫn chi tiết.
Trong quy trình đồng ý OAuth hiện tại, trong đó chủ sở hữu tài khoản Trang doanh nghiệp cấp cho bạn quyền thay mặt họ gọi các API Trang doanh nghiệp trên Google, hãy cập nhật phạm vi API để bao gồm
- https://www.googleapis.com/auth/business.manage
- https://www.googleapis.com/auth/businesscommunications
Bạn cần có cả hai phạm vi này để tự động xác minh thành công nhân viên hỗ trợ và vị trí doanh nghiệp.
Tạo một người đại diện bằng
displayName
khớp với tên của ít nhất một trang thông tin trên Trang doanh nghiệp trên Google thuộc quyền sở hữu của thông tin xác thực OAuth mà bạn đã nhận được ở bước trước. Tra cứu vị trí bằng API Trang doanh nghiệp của Google để tìm tên doanh nghiệp.Đối với việc so khớp tên,
- Không phân biệt chữ hoa chữ thường.
- Họ và tên của người đại diện phải khớp chính xác với từ hoặc cụm từ đầu tiên trong tên địa điểm trên Trang doanh nghiệp. Ví dụ: một đại lý có tên "GBP Bakery" sẽ khớp với "Gbp Bakery Mountain View", "Gbp Bakery" và "gbp bakery sunnyvale", nhưng không khớp với "Bakery San Francisco".
Đối với mỗi vị trí trong Trang doanh nghiệp, hãy tạo một vị trí có cùng
placeId
.placeId
cho vị trí của Trang doanh nghiệp nằm trong đối tượngLocationKey
khi một vị trí được truy xuất từ API Trang doanh nghiệp trên Google.Với tác nhân mà bạn đã tạo và mã thông báo OAuth đã nhận được, hãy yêu cầu xác minh tác nhân.
Yêu cầu xác minh cần có thông tin liên hệ của thương hiệu. Tuy nhiên, quy trình xác minh sẽ không gửi email cho thương hiệu nếu tên người đại diện khớp với tên Trang doanh nghiệp và nếu bạn đã lấy mã thông báo OAuth với các phạm vi chính xác.
Nếu bạn thực hiện đúng cách, kết quả của yêu cầu xác minh sẽ ngay lập tức trả về một
verificationState
củaVERIFICATION_STATE_VERIFIED
. NếuverificationState
trả về một giá trị khác, thì có thể bạn không sử dụng đúng mã thông báo OAuth khi đưa ra yêu cầu hoặc không thể so khớp tác nhân với một địa điểm trên Trang doanh nghiệp.Sử dụng cùng một mã thông báo OAuth, hãy yêu cầu xác minh địa điểm cho tất cả địa điểm mà doanh nghiệp sở hữu trên Trang doanh nghiệp.
Tương tự như việc xác minh đại lý, nếu bạn thực hiện đúng cách, kết quả của yêu cầu xác minh sẽ ngay lập tức trả về một
verificationState
củaVERIFICATION_STATE_VERIFIED
. NếuverificationState
trả về một giá trị khác, thì có thể bạn đã không sử dụng đúng mã thông báo OAuth khi đưa ra yêu cầu hoặc địa điểm trên Trang doanh nghiệp không phải là một doanh nghiệp đã được xác nhận quyền sở hữu và xác minh.Chạy trình đại diện bằng điểm truy cập
LOCATION
.Bật tính năng nhắn tin cho những vị trí cụ thể bằng cách chạy những vị trí mà bạn muốn cung cấp thông tin thông qua Tìm kiếm và Maps. Sau khi quy trình ra mắt bắt đầu, người dùng sẽ nhận được thông báo cho từng vị trí đã ra mắt trong vòng vài giờ.
Sau khi làm theo các bước này, tất cả tin nhắn của người tiêu dùng sẽ được đăng lên webhook Business Messages đã đăng ký và bạn phải gửi phản hồi cho người tiêu dùng bằng API Business Messages.