Các vị trí tham gia từ Trang doanh nghiệp

Trang doanh nghiệp là một công cụ miễn phí và dễ sử dụng. Công cụ này có thể 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 họ trên Google (bao gồm cả Google Tìm kiếm và Maps).

API Trang doanh nghiệp trên Google cung cấp giao diện để quản lý thông tin địa điểm doanh nghiệp trên Google. Một doanh nghiệp có thể cấp quyền truy cập thông qua OAuth cho một doanh nghiệp khác để họ thay mặt họ quản lý trang doanh nghiệp của họ.

Những 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 quy trình đồ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 chúng để ra mắt trên Business Messages.

Đây là một phương thức dễ mở rộng và nhanh hơn để khởi chạy Business Messages và là quy trình được đề xuất để bật tính năng nhắn tin cho một vị trí trong Trang doanh nghiệp.

Điều kiện tiên quyết

Bạn phải là một đối tác Trang doanh nghiệp hiện có và có quyền truy cập vào các API Trang doanh nghiệp trên Google. Nếu không, hãy làm theo điều kiện tiên quyết về 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 Business Messages cho vị trí Trang doanh nghiệp đã xác minh

Sơ đồ sau cho thấy cách dịch vụ web của bạn có thể tận dụng tính năng xác minh vị trí trong Trang doanh nghiệp của một thương hiệu cho nhân viên hỗ trợ Business Messages. Hãy xem hướng dẫn chi tiết bên dưới.

Sơ đồ quy trình xác minh nhân viên hỗ trợ tự động bằng cách sử dụng Trang doanh nghiệp

  1. Trong quy trình đồng ý OAuth hiện tại, khi chủ sở hữu tài khoản Trang doanh nghiệp cấp cho bạn quyền truy cập để gọi API Trang doanh nghiệp trên Google thay mặt họ, 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 phải bật cả hai phạm vi để tự động xác minh nhân viên hỗ trợ và vị trí doanh nghiệp.

  2. Tạo một nhân viên hỗ trợ bằng displayName khớp với tên của ít nhất một trong các trang thông tin trên Trang doanh nghiệp trên Google do thông tin xác thực OAuth mà bạn nhận được ở bước trước sở hữu. Tra cứu địa điểm bằng API Trang doanh nghiệp trên Google để tìm tên của các doanh nghiệp.

    Đối với việc so khớp tên,

    • Cách viết hoa của ký tự không nhạy cảm.
    • Tên đầy đủ của nhân viên hỗ trợ phải khớp chính xác với từ đầu tiên hoặc các từ trong tên vị trí trong Trang doanh nghiệp. Ví dụ: một đại lý có tên là "Tiệm bánh GBP" khớp với "Cửa hàng bánh ngọt Gbp Mountain View", "Tiệm bánh Gbp" và "tiệm bánh gbp Sunvale", nhưng không khớp với "Bakery San Francisco".

  3. Đối với mỗi vị trí trong Trang doanh nghiệp, hãy tạo một vị trí với cùng một placeId. placeId cho một vị trí trong Trang doanh nghiệp nằm trong đối tượng LocationKey khi một vị trí được truy xuất từ API Trang doanh nghiệp trên Google.

  4. Với tác nhân bạn đã tạo và mã thông báo OAuth thu đượ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 đến thương hiệu nếu tên nhân viên hỗ trợ khớp với tên trên Trang doanh nghiệp và nếu bạn có được mã thông báo OAuth với phạm vi chính xác.

    Nếu bạn thực hiện việc này đúng cách, kết quả từ yêu cầu xác minh sẽ trả về ngay verificationState của VERIFICATION_STATE_VERIFIED. Nếu verificationState trả về một giá trị khác, thì có thể bạn đã sử dụng không đúng mã thông báo OAuth khi gửi yêu cầu hoặc không thể so khớp nhân viên hỗ trợ với một vị trí trong Trang doanh nghiệp.

  5. Sử dụng cùng một mã thông báo OAuth, yêu cầu xác minh vị trí đối với tất cả vị trí do doanh nghiệp sở hữu trên Trang doanh nghiệp.

    Tương tự như cách xác minh nhân viên hỗ trợ, nếu bạn thực hiện đúng cách, kết quả từ yêu cầu xác minh sẽ ngay lập tức trả về một verificationState với VERIFICATION_STATE_VERIFIED. Nếu verificationState trả về một giá trị khác, thì có thể bạn đã sử dụng mã thông báo OAuth không chính xác khi đưa ra yêu cầu hoặc vị trí Trang doanh nghiệp không phải là doanh nghiệp đã được xác nhận quyền sở hữu và xác minh.

  6. Khởi chạy tác nhân với điểm truy cập LOCATION.

  7. Bật tính năng nhắn tin cho các vị trí cụ thể bằng cách chạy các vị trí bạn muốn cung cấp qua Tìm kiếm và Maps. Sau khi bắt đầu quá trình ra mắt, thông báo cho từng vị trí đã ra mắt sẽ được cung cấp cho người dùng 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 của Business Messages, và bạn phải gửi phản hồi cho người tiêu dùng bằng API Business Messages.