Thiết lập webhook

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ải phản hồi các tin nhắn và sự kiện. Trừ phi bạn đang sử dụng 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à cấp nhân viên hỗ trợ

Bạn có thể thiết lập 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ì, còn ở cấp nhân viên hỗ trợ Mỗi webhook áp dụng cho một 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 có thể cần thiết lập một webhook khác nhau 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 nhân viên hỗ trợ có hành vi tương tự, hoặc nếu bạn chỉ có một nhân viên hỗ trợ, có thể sử dụng webhook ở cấp đối tác.

Nếu bạn đã thiết lập cả webhook ở cấp đối tác và webhook ở cấp nhân viên hỗ trợ, webhook ở cấp nhân viên hỗ trợ sẽ được ưu tiên so với 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ó cấp nhân viên hỗ trợ webhook.

Đặt webhook ở 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 của bạn trong Business Messages.
  2. Mở phần Cài đặt tài khoản.
  3. Nhớ chọn đúng tài khoản đối tác.
  4. Đối với URL webhook của Business Messages, 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ụ: "https://PROJECT_ID.appspot.com/callback/".
  6. Ghi lại giá trị clientToken của bạn. Bạn cần mã xác minh này để xác minh rằng các tin nhắn bạn nhận được đến từ Google.

  7. Định cấu hình webhook của bạn để chấp nhận yêu cầu POST bằng yêu cầu đượ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ố bí mật làm nội dung phản hồi. Ví dụ: giả sử webhook nhận được một yêu cầu POST với nội dung nội dung sau đây:

    {
"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ề phản hồi 200 OK với 0123456789 là giá trị 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 đóng lại.

Thiết lập webhook ở cấp nhân viên hỗ trợ

Bạn nhận tin nhắn gửi đến nhân viên hỗ trợ tại webhook ở cấp đối tác. Nếu bạn muốn tin nhắn cho một đại lý cụ thể sẽ chuyển đến một webhook khác, bạn có thể thiết lập 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 của bạn trong Business Messages.
  2. Nhấp vào nhân viên hỗ trợ.
  3. Nhấp vào 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. 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.

  7. Định cấu hình webhook của bạn để chấp nhận yêu cầu POST bằng yêu cầu được chỉ định tham số clientToken và gửi một phản hồi 200 OK bằng giá trị của tham 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 như 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ề phản hồi 200 OK có URL bí mật tham số đượ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 đóng lại.