Đặt webhook của bạn

Webhook là một lệnh gọi lại HTTPS do đối tác tạo, chỉ định cách nhân viên hỗ trợ của bạn phản hồi tin nhắn và sự kiện. Trừ khi đang sử dụng giải pháp tự động tạo sẵn như Dialogflow, bạn cần đặt một webhook tuỳ chỉnh để xác định hành vi cho nhân viên hỗ trợ của mình.

Webhook ở cấp độ đối tác và nhân viên hỗ trợ

Bạn có thể đặt webhook ở cấp đối tác hoặc ở cấp nhân viên hỗ trợ. Webhook ở cấp độ đối tác áp dụng cho mọi nhân viên hỗ trợ mà bạn duy trì, trong khi webhook trên web dành cho nhân viên hỗ trợ áp dụng cho từng nhân viên hỗ trợ.

Nếu điều hành nhiều nhân viên hỗ trợ có hành vi riêng biệt, bạn nên đặt một webhook khác cho từng nhân viên hỗ trợ bằng cách sử dụng chế độ cài đặt ở cấp nhân viên hỗ trợ. Mặt khác, nếu các nhân viên hỗ trợ của bạn có hành vi tương tự hoặc nếu bạn chỉ có một nhân viên hỗ trợ, thì bạn có thể sử dụng webhook ở cấp đối tác.

Nếu bạn đã định cấu hình cả webhook ở cấp độ đối tác và webhook ở cấp nhân viên hỗ trợ, thì webhook ở cấp độ nhân viên hỗ trợ sẽ được ưu tiên áp dụng cho nhân viên hỗ trợ cụ thể, trong khi webhook ở cấp độ đối tác áp dụng cho những nhân viên hỗ trợ không có webhook ở cấp nhân viên.

Đặt webhook của bạn ở cấp đối tác

Để đặt webhook ở cấp đối tác, hãy làm theo các bước sau:

  1. Mở Business Communications Developer Console rồi đăng nhập bằng Tài khoản Google Business Messages của bạn.
  2. Mở phần Cài đặt tài khoản.
  3. Đảm bảo bạn đã chọn đúng tài khoản đối tác.
  4. Đối với URL webhook doanh nghiệp, hãy nhấp vào Định cấu hình.
  5. Đối với URL điểm cuối webhook, hãy nhập URL của ứng dụng + "/callback/". Ví dụ: URL có thể có dạng như "https://PROJECT_ID.appspot.com/callback/".
  6. Vui lòng lưu ý giá trị clientToken của bạn. Bạn cần gửi mã này để xác minh rằng tin nhắn bạn nhận được là của Google.

  7. Định cấu hình webhook để chấp nhận yêu cầu POST có thông số clientToken được chỉ định và gửi một phản hồi 200 OK cùng với giá trị văn bản thuần túy của thông số bí mật làm nội dung phản hồi. Ví dụ: giả sử webhook của bạn nhận được yêu cầu POST có nội dung nội dung sau:

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

    Trong trường hợp đó, 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.

  8. 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.

Đặt webhook ở cấp nhân viên hỗ trợ

Bạn sẽ nhận được tin nhắn gửi cho nhân viên hỗ trợ tại webhook ở cấp đối tác. Nếu muốn gửi tin nhắn cho một nhân viên hỗ trợ cụ thể đến một webhook khác, thì bạn có thể đặt webhook ở cấp nhân viên hỗ trợ.

  1. Mở Business Communications Developer Console rồi đăng nhập bằng Tài khoản Google Business Messages của bạn.
  2. Nhấp vào nhân viên hỗ trợ của bạn.
  3. Nhấp vào mục Tích hợp.
  4. Đối với Webhook, hãy nhấp vào Định cấu hình.
  5. Đối với URL điểm cuối webhook, hãy nhập URL của webhook, bắt đầu bằng "https://".
  6. Vui lòng lưu ý giá trị clientToken của bạn. Bạn cần xác minh nó để xác minh rằng thư bạn nhận được là từ Google.

  7. Định cấu hình webhook của bạn để chấp nhận yêu cầu POST có thông số clientToken được chỉ định và gửi một phản hồi 200 OK với giá trị của thông số bí mật. Ví dụ: giả sử webhook của bạn nhận được yêu cầu POST có nội dung nội dung sau:

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

    Trong trường hợp đó, 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 có thông số URL bí mật được đặt thành 0123456789.

  8. 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.