Kể từ ngày 13 tháng 6 năm 2023, Hành động trò chuyện không còn được dùng nữa. Để biết thêm thông tin, hãy xem phần Hành động trò chuyện ngừng hoạt động.

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

Liên kết tới Hành động của bạn (Dialogflow)

Bạn có thể tạo một URL liên kết trực tiếp đến Hành động cụ thể theo từng Hành động. Người dùng nhấp vào đường liên kết Trợ lý (trước đây gọi là đường liên kết Hành động) trong trình duyệt web hoặc thiết bị di động sẽ được chuyển đến Trợ lý trên thiết bị của họ để tương tác trực tiếp với Hành động tương ứng.

Một số ví dụ về các đường liên kết hữu ích đến Trợ lý bao gồm:

Liên kết người dùng với hướng dẫn bằng giọng nói trên trang web hướng dẫn.
Liên kết người dùng với trải nghiệm hỗ trợ khách hàng từ trang "yêu cầu trợ giúp".
Liên kết người dùng với một ý định cập nhật để họ có thể chọn nhận các bản cập nhật trong tương lai của bạn.

Để tạo URL cho một Hành động, hãy làm như sau:

Trong Bảng điều khiển Actions, hãy chuyển đến phần Phát triển > Hành động.
Nhấp vào Hành động mà bạn muốn tạo liên kết.
Trong phần Liên kết, hãy bật tuỳ chọn Bạn có muốn kích hoạt một URL cho Hành động này không.
Nhập Tiêu đề liên kết. Tiêu đề này phải bao gồm một động từ mô tả hành động sẽ làm. Ví dụ: nếu Hành động của bạn đưa người dùng vào một quy trình giao dịch để mua vé xem một buổi hoà nhạc, thì tiêu đề liên kết hữu ích sẽ là "mua vé xem chương trình âm nhạc".
Nhấp vào Lưu.

Bạn có thể sao chép URL đã cung cấp và tham chiếu đến URL đó ở bất cứ nơi nào bạn muốn hướng người dùng đến Hành động cụ thể này.

Các tham số liên kết của Trợ lý

Đường liên kết đến Trợ lý có thể tuỳ ý chứa ý định và tham số trong URL. Google xử lý các tham số theo loại ý định được chỉ định trong URL.

Quy cách URL đường liên kết của Trợ lý

Cú pháp chung cho URL của một đường liên kết đến Trợ lý như sau:

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$param=$value][&$utm_param=$utm_value]

Các tham số URL mà bạn có thể đặt được mô tả trong bảng sau:

Tham số URL	Nội dung mô tả
`$action_id`	Giá trị nhận dạng dạng số của Hành động.
`$intent`	Tên đầy đủ của một ý định tích hợp hoặc đối tượng có ý định tuỳ chỉnh.
`$param`	Tên đầy đủ của tham số ý định được chỉ định trong Gói Hành động.
`$value`	Giá trị URL mã hoá của kiểu được khai báo cho `$param` trong Gói Hành động.
`$utm_param`	Danh sách một hoặc nhiều loại thông số UTM. Các giá trị hợp lệ bao gồm: `utm_source`, `utm_medium`, `utm_campaign`, `utm_term` và `utm_content`.
`$utm_value`	Giá trị chuỗi của thông số UTM.

Các URL liên kết của Trợ lý với ý định tích hợp

Nếu đường liên kết đến Trợ lý có chứa một ý định tích hợp (ý định bắt đầu bằng actions.intent.*), thì Google sẽ cố gắng trích xuất mọi tham số ý định tích hợp trong URL và truyền các tham số đó vào Hành động của bạn. Mọi tham số mà Google không hiểu là tham số ý định tích hợp đều sẽ bị xoá.

Đối với Hành động trò chuyện, Google sẽ gửi các tham số này đến phương thức thực hiện của bạn như một phần của thông báo AppRequest.

Ví dụ sau đây cho thấy cách bạn có thể chỉ định URL liên kết Trợ lý chứa ý định tích hợp bằng một tham số ý định duy nhất:

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.GET_HOROSCOPE&param.astrologySign=%22cancer%22

Trợ lý liên kết các URL với đối tượng có ý định tuỳ chỉnh

Đối với ý định tuỳ chỉnh, Google chỉ trích xuất những tham số mà Hành động của bạn xác định dưới dạng một phần của ý định và loại bỏ mọi tham số khác.

Ví dụ sau cho thấy cách bạn có thể chỉ định URL liên kết Trợ lý có chứa một ý định tuỳ chỉnh:

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.topic=sports

Đối với URL ví dụ trên, trong AppRequest, Google thêm đối tượng JSON như sau:

argument {
  name: ‘topic’,
  raw_text: ‘sports’,
  text_value: ‘sports’,
}

URL liên kết của Trợ lý không có ý định

Nếu bạn không chỉ định ý định trong đường liên kết đến Trợ lý, thì theo mặc định, Google sẽ liên kết với ý định MAIN (actions.intent.MAIN) của Hành động của bạn bằng hành vi sau đây:

Nếu bạn không bật ý định MAIN một cách rõ ràng trong đường liên kết đến Trợ lý, thì Google sẽ kích hoạt ý định chính mà không có tham số nào, tương tự như hành vi đối với "Trò chuyện với app_name".
Nếu bạn bật ý định MAIN một cách rõ ràng, Google sẽ chuyển các tham số này đến Hành động của bạn.

Ví dụ sau cho thấy cách bạn có thể chỉ định URL liên kết Trợ lý mà không có ý định:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4

URL liên kết của Trợ lý với thông số UTM

Tham số UTM là các chuỗi mà Google gửi tới Hành động của bạn khi người dùng nhấp vào một đường liên kết đến Trợ lý mà sau này bạn có thể dùng cho mục đích phân tích.

Thông số UTM mà Google gửi đến Hành động của bạn bao gồm:

utm_source
utm_medium
utm_campaign
utm_term
utm_content

Ví dụ sau cho thấy cách bạn có thể chỉ định URL liên kết Trợ lý có chứa các tham số UTM:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale

Đối với URL ví dụ ở trên, Google thêm các đối số sau vào thông báo AppRequest:

argument {
  name: ‘utm_source’,
  raw_text: ‘Google’,
  text_value: ‘Google’,
}
argument {
  name: ‘utm_medium’,
  raw_text: ‘email’,
  text_value: ‘email’,
}
argument {
  name: ‘utm_campaign’,
  raw_text: ‘holiday sale’,
  text_value: ‘holiday sale’,
}

Kiểm tra các đường liên kết của Trợ lý

Bạn có thể thử nghiệm các đường liên kết đến Trợ lý cho bất kỳ ý định nào (chính hay tuỳ chỉnh, có hoặc không có tham số) thông qua trình mô phỏng hoặc thiết bị.

Cách kiểm tra đường liên kết đến Trợ lý:

Bật đường liên kết đến Trợ lý trong bảng điều khiển.
Đăng nhập vào Trợ lý bằng chính tài khoản bạn đã dùng để tạo dự án Actions on Google.
Tạo một phiên bản có thể nhấp của đường liên kết đến Trợ lý (trong email, cuộc trò chuyện, tài liệu, v.v.).
Trên một thiết bị có Trợ lý, hãy nhấp vào đường liên kết đã tạo ở bước trước.

Sau khi xác nhận đường liên kết đến Trợ lý hoạt động như dự kiến, bạn sẽ cần triển khai lại Hành động của mình để cung cấp đường liên kết cho người dùng.

Các hạn chế và phương pháp hay nhất

Vì URL liên kết đến Trợ lý hiện có thể được phân phối và giới thiệu ra bên ngoài danh bạ hoặc các dịch vụ khác của Google, nên xin lưu ý rằng các phương pháp hay nhất và quy định hạn chế sau đây sẽ được áp dụng:

Đảm bảo bạn sẽ tiếp tục hỗ trợ tất cả các đường liên kết đến Trợ lý. Nếu bạn phân phối một đường liên kết đến Trợ lý nhưng sau đó bị hỏng, thì dự án Actions của bạn có thể bị gắn cờ là không lành mạnh và bị gỡ bỏ.
Việc xuất bản đường liên kết có nghĩa là bạn hỗ trợ việc kích hoạt từ các nguồn không đáng tin cậy. Đối với bất kỳ Hành động được liên kết nào, bạn phải xác nhận rõ ràng với người dùng trước khi thực hiện bất kỳ "hành động trong thế giới thực". Ví dụ: Hành động tắt thiết bị nhà thông minh sẽ nhắc người dùng nói "Bạn có chắc chắn muốn tắt $applianceName không?"

Trong ngữ cảnh này, "hành động trong thế giới thực" là bất kỳ hành động nào ảnh hưởng đến dịch vụ, dữ liệu, thiết bị, mạng, máy tính hoặc API của người dùng. Ví dụ: gửi email, thực hiện giao dịch, thay đổi trạng thái của thiết bị Nhà thông minh, tạo gói thuê bao hoặc cập nhật một nội dung.