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 sẽ 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) trên trình duyệt web hoặc trình duyệt dành cho thiết bị di động sẽ được chuyển đến Trợ lý trên thiết bị của họ. Tại đây, họ sẽ tương tác trực tiếp với Hành động tương ứng của bạn.

Dưới đây là một số ví dụ về các đường liên kết hữu ích của Trợ lý:

Liên kết người dùng với hướng dẫn bằng giọng nói từ một 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ừ mục "nhận 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 đường liên kết.
Trong phần Đường liên kết, hãy bật tuỳ chọn Bạn có muốn bậ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ẽ thực hiện. Ví dụ: nếu Hành động của bạn đưa người dùng đến một quy trình giao dịch để mua vé xem một buổi biểu diễn, thì tiêu đề của một đường liên kết hữu ích sẽ là "mua vé xem ca nhạc".
Nhấp vào Lưu.

Bạn có thể sao chép URL được 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.

Thông số liên kết Trợ lý

Đường liên kết đến Trợ lý có thể chứa ý định và tham số trong URL (không bắt buộc). 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 đến Trợ lý

Dưới đây là cú pháp chung cho URL của đường liên kết đến Trợ lý:

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

Tham số URL mà bạn có thể thiết lập được mô tả trong bảng sau:

Tham số URL	Mô tả
`$action_id`	Giá trị nhận dạng dạng số của thao tác.
`$intent`	Tên đầy đủ của đối tượng có ý định tích hợp sẵn hoặc đối tượng có ý định tuỳ chỉnh.
`$param`	Tên đầy đủ của một tham số ý định được chỉ định trong Gói Hành động.
`$value`	Giá trị URL mã hoá của loại đượ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.

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

Nếu đường liên kết đến Trợ lý chứa ý định tích hợp (ý định bắt đầu bằng actions.intent.*), Google sẽ cố gắng trích xuất mọi tham số ý định tích hợp trong URL và chuyển các tham số đó đến 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 trong thông báo AppRequest.

Ví dụ sau cho thấy cách bạn có thể chỉ định một URL liên kết đến Trợ lý chứa ý định tích hợp với 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

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

Đối với ý định tuỳ chỉnh, Google chỉ trích xuất những tham số được xác định theo Hành động của bạn trong ý đị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 một URL liên kết đến Trợ lý bao gồm một đối tượng có ý đị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 làm sau:

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

URL liên kết với Trợ lý không có ý định

Nếu bạn không chỉ định một ý định trong đường liên kết đến Trợ lý, thì theo mặc định, Google sẽ liên kết đến ý đị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ần tham số nào, tương tự như hành vi của "Trò chuyện với app_name".
Nếu bạn đã bật ý định MAIN một cách rõ ràng, thì Google sẽ truyền các tham số đó đến Hành động của bạn.

Ví dụ sau cho thấy cách bạn có thể chỉ định một URL liên kết đến 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 tham số UTM

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

Sau đây là các thông số UTM mà Google gửi tới Hành động của bạn:

utm_source
utm_medium
utm_campaign
utm_term
utm_content

Ví dụ sau đây cho thấy cách bạn có thể chỉ định một URL đường liên kết đến Trợ lý bao gồm các thông 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’,
}

Đường liên kết đến Trợ lý thử nghiệm

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

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

Bật đường liên kết 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 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 rằng đườ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 quy định hạn chế và các phương pháp hay nhất

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

Đảm bảo bạn tiếp tục hỗ trợ tất 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 này lại bị hỏng, dự án Hành động của bạn có thể bị gắn cờ là không tốt và bị gỡ bỏ.
Nếu xuất bản một đường liên kết, bạn có hỗ trợ việc kích hoạt từ các nguồn không đáng tin cậy. Đối với mọi Hành động được liên kết, 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 thực tế nào". Ví dụ: Hành động tắt thiết bị nhà thông minh phải nhắc người dùng nói "Bạn có chắc chắn muốn tắt $applianceName không?"

Trong bối 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 phần nội dung.