작업 (Dialogflow)에 링크

액션별로 특정 작업에 직접 연결되는 URL을 생성할 수 있습니다. 사용자가 웹브라우저나 모바일 브라우저에서 어시스턴트 링크 (이전 명칭: 작업 링크)를 클릭하면 기기의 어시스턴트로 이동하여 해당 작업과 직접 상호작용하게 됩니다.

유용한 어시스턴트 링크의 예는 다음과 같습니다.

방법 안내 웹사이트의 음성 안내 도움말로 사용자를 연결합니다.
'도움말 보기' 페이지에서 사용자를 고객 지원 환경으로 연결합니다.
사용자가 향후 업데이트에 동의할 수 있도록 사용자를 업데이트 인텐트에 연결합니다.

작업의 URL을 생성하려면 다음 단계를 따르세요.

Actions 콘솔에서 개발 > 작업으로 이동합니다.
링크를 생성하려는 작업을 클릭합니다.
링크 섹션에서 이 작업에 URL을 사용 설정하시겠어요?를 사용 설정합니다.
링크 제목을 입력합니다. 이 제목에는 수행할 작업을 설명하는 동사가 포함되어야 합니다. 예를 들어 작업에서 사용자가 콘서트 티켓을 구매하기 위해 거래 흐름을 중단하는 경우 '콘서트 티켓 구매'와 같은 유용한 링크 제목이 적합합니다.
저장을 클릭합니다.

제공된 URL을 복사하여 사용자를 이 특정 작업으로 안내하고 싶은 위치에서 참조할 수 있습니다.

어시스턴트 링크 매개변수

어시스턴트 링크는 선택적으로 URL에 인텐트와 매개변수를 포함할 수 있습니다. Google은 URL에 지정된 인텐트 유형에 따라 매개변수를 처리합니다.

어시스턴트 링크 URL 사양

어시스턴트 링크 URL의 일반적인 문법은 다음과 같습니다.

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

설정할 수 있는 URL 매개변수는 다음 표에 설명되어 있습니다.

URL 매개변수	설명
`$action_id`	작업의 숫자 식별자입니다.
`$intent`	내장 또는 맞춤 인텐트의 전체 이름입니다.
`$param`	작업 패키지에 지정된 인텐트 매개변수의 전체 이름입니다.
`$value`	작업 패키지의 `$param`에 대해 선언된 유형의 URL 인코딩 값입니다.
`$utm_param`	하나 이상의 UTM 매개변수 유형의 목록입니다. 유효한 값은 `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`입니다.
`$utm_value`	UTM 매개변수의 문자열 값입니다.

내장 인텐트가 있는 어시스턴트 링크 URL

어시스턴트 링크에 내장 인텐트 (인텐트가 actions.intent.*로 시작)가 포함되어 있는 경우 Google은 URL에서 내장 인텐트 매개변수를 추출하여 작업에 전달하려고 합니다. Google이 내장 인텐트 매개변수로 인식하지 못하는 매개변수는 모두 제거됩니다.

대화형 작업의 경우 Google에서 AppRequest 메시지의 일부로 이러한 매개변수를 처리에 전송합니다.

다음 예는 단일 인텐트 매개변수가 있는 내장 인텐트가 포함된 어시스턴트 링크 URL을 지정하는 방법을 보여줍니다.

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

맞춤 인텐트가 있는 어시스턴트 링크 URL

맞춤 인텐트의 경우 Google은 작업에서 인텐트의 일부로 정의한 매개변수만 추출하고 다른 매개변수는 모두 삭제합니다.

다음 예는 맞춤 인텐트가 포함된 어시스턴트 링크 URL을 지정하는 방법을 보여줍니다.

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

위 URL 예의 경우 AppRequest에서 Google은 다음과 같이 JSON 객체를 추가합니다.

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

인텐트가 없는 어시스턴트 링크 URL

어시스턴트 링크에서 인텐트를 지정하지 않으면 Google은 기본적으로 다음 동작으로 작업의 MAIN 인텐트 (actions.intent.MAIN)에 연결합니다.

어시스턴트 링크에서 MAIN 인텐트를 명시적으로 사용 설정하지 않았다면 Google은 'app_name에 연결' 동작과 유사하게 매개변수 없이 기본 인텐트를 트리거합니다.
MAIN 인텐트를 명시적으로 사용 설정한 경우 Google은 매개변수를 작업에 전달합니다.

다음 예는 인텐트 없이 어시스턴트 링크 URL을 지정하는 방법을 보여줍니다.

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

UTM 매개변수가 있는 어시스턴트 링크 URL

UTM 매개변수는 사용자가 어시스턴트 링크를 클릭할 때 Google에서 작업에 전송하는 문자열로, 나중에 분석에 사용할 수 있습니다.

Google에서 작업에 전송하는 UTM 매개변수는 다음과 같습니다.

utm_source
utm_medium
utm_campaign
utm_term
utm_content

다음 예는 UTM 매개변수가 포함된 어시스턴트 링크 URL을 지정하는 방법을 보여줍니다.

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

위의 예시 URL에서 Google은 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’,
}

어시스턴트 링크 테스트

시뮬레이터나 기기를 통해 모든 인텐트 (기본 또는 맞춤, 매개변수 유무와 관계없음)의 어시스턴트 링크를 테스트할 수 있습니다.

어시스턴트 링크를 테스트하려면 다음 단계를 따르세요.

콘솔에서 어시스턴트 링크를 사용 설정합니다.
Actions on Google 프로젝트를 만들 때 사용한 계정으로 어시스턴트에 로그인합니다.
이메일, 채팅, 문서 등에서 클릭 가능한 버전의 어시스턴트 링크를 만듭니다.
어시스턴트 지원 기기에서 이전 단계에서 만든 링크를 클릭합니다.

어시스턴트 링크가 정상적으로 작동하는지 확인한 후 사용자가 링크를 사용할 수 있도록 작업을 다시 배포해야 합니다.

제한사항 및 권장사항

이제 어시스턴트 링크 URL을 디렉터리나 다른 Google 서비스 외부에서 배포 및 참조할 수 있으므로 다음 제한사항 및 권장사항이 적용됩니다.

모든 어시스턴트 링크를 계속 지원해야 합니다. 어시스턴트 링크를 배포하다가 나중에 중단되면 작업 프로젝트가 비정상으로 신고되어 게시 중단될 수 있습니다.
링크를 게시하면 신뢰할 수 없는 소스에서 트리거할 수 있습니다. 연결된 작업의 경우 '실제 작업'을 취하기 전에 사용자에게 명시적으로 확인해야 합니다. 예를 들어 스마트 홈 어플라이언스를 끄는 작업은 사용자에게 '$applianceName을(를) 사용 중지하시겠어요?'라는 메시지를 표시해야 합니다.

이 문맥에서 '실제 작업'은 사용자의 서비스, 데이터, 기기, 네트워크, 컴퓨터 또는 API에 영향을 미치는 모든 작업을 의미합니다. 예를 들어 이메일 전송, 거래 수행, 스마트 홈 어플라이언스 상태 변경, 구독 생성, 콘텐츠 업데이트 등이 있습니다.