플랫폼 이벤트

플랫폼 이벤트는 Google 어시스턴트, Slack, Facebook Messenger와 같은 Dialogflow가 상호작용하는 플랫폼에서 사용자가 수행하는 작업에 의해 트리거되는 이벤트입니다. 이러한 이벤트는 Dialogflow 에이전트 및 처리에서 사용자의 작업에 응답할 수 있는 방법을 제공합니다.

시작 이벤트

시작 이벤트는 사용자가 작업, 봇, 스킬, 인터페이스와의 대화를 시작할 때 트리거됩니다. 새 에이전트를 만들 때 Default 시작 인텐트가 자동으로 추가됩니다. 이러한 인텐트에는 사전 정의된 WELCOME 이벤트 및 텍스트 응답이 있습니다. WELCOME 이벤트는 지원되는 원클릭 통합을 위한 일반 이벤트입니다. 모든 시작 이벤트를 설정하기 위한 간단한 방법입니다.

최종 사용자가 지원되는 메시징 플랫폼에서 시작 인텐트를 트리거하면 관련 이벤트가 Dialogflow로 전송됩니다. 특정 메시징 플랫폼에 대한 정의된 이벤트가 있는 다른 인텐트가 없는 경우 Default 시작 인텐트가 트리거됩니다.

예를 들어 사용자가 Facebook Messenger 봇과 채팅할 의사를 표현하기 위해 '시작' 버튼을 클릭하는 경우 Facebook 시작 이벤트가 트리거됩니다. 먼저 Dialogflow는 FACEBOOK_WELCOME 이벤트가 포함된 인텐트를 확인합니다. 그러한 인텐트가 없는 경우 기본 시작 인텐트가 트리거됩니다.

플랫폼 이벤트 설명
다중 WELCOME 모든 플랫폼에 적용되는 일반 시작 이벤트. 시작 이벤트가 트리거될 때 트리거됩니다.
전화 TELEPHONY_WELCOME 누군가 Dialogflow 에이전트와 연결된 전화번호로 전화를 걸 때 트리거됩니다.
Actions on Google GOOGLE_ASSISTANT_WELCOME 사용자가 작업과 대화를 시작할 때 트리거됩니다.
Alexa ALEXA_WELCOME 사용자가 스킬과 대화를 시작할 때 트리거됩니다.
Facebook FACEBOOK_WELCOME 사용자가 Facebook Messenger 봇과 대화를 시작할 때 트리거됩니다.
Kik KIK_WELCOME 사용자가 Kik 봇과 대화를 시작할 때 트리거됩니다.
Skype SKYPE_WELCOME 사용자가 Skype 봇과 대화를 시작할 때 트리거됩니다.
Slack SLACK_WELCOME 사용자가 Slack 봇과 대화를 시작할 때 트리거됩니다.
Telegram TELEGRAM_WELCOME 사용자가 Telegram 봇과 대화를 시작하거나 /start를 시작할 때 트리거됩니다.
Viber VIBER_WELCOME 사용자가 Viber 봇과 대화를 시작할 때 트리거됩니다.

Actions on Google 이벤트

사용자가 음성 또는 텍스트 이외의 방법으로 작업과 통신하는 경우 이러한 상호작용은 이벤트를 통해 Dialogflow로 전송됩니다. 이러한 이벤트는 사용자의 입력(예를 들어 사용자가 선택한 목록 항목, 확인, 배송 주소 받기 등)을 나타내고 사용자 정보를 위한 허락을 받거나(예를 들어 사용자의 위치 이름) 트랜잭션을 수행(일정 예약이나 상품 구매 등)할 수 있습니다.

Actions on Google에서는 이러한 이벤트를 'Actions on Google 인텐트'라고 합니다. Action on Google의 인텐트에 대한 문서는 여기서 찾을 수 있습니다.

사용자 입력

Dialogflow는 이벤트를 사용하여 Actions on Google의 비텍스트 및 비음성 사용자 입력을 전달합니다.

이벤트 이름 설명
actions_intent_CANCEL 사용자가 작업과의 대화를 중단하려는 의사를 나타낼 때 트리거되어 최종 응답을 보낼 수 있도록 합니다.
actions_intent_NO_INPUT 사용자가 입력을 제공하지 않을 때 트리거됩니다(사용자 응답을 기다리는 동안 시간 초과됨).
actions_intent_MEDIA_STATUS 작업이 재생 중인 미디어의 재생이 완료될 때 트리거됩니다.
actions_intent_CONFIRMATION 사용자가 요청을 확인할 때(예를 들어 예 또는 아니요 질문에 대한 답) 트리거됩니다.
actions_intent_DATETIME 사용자가 날짜 및 시간 요청에 응답할 때 트리거됩니다.
actions_intent_DELIVERY_ADDRESS 사용자가 배송 주소 요청에 응답할 때 트리거됩니다.
actions_intent_PLACE 사용자가 주소 또는 저장된 위치를 확인하기 위한 요청에 응답할 때 트리거됩니다.
actions_intent_OPTION 사용자가 목록 또는 캐러셀에서 항목을 선택할 때 트리거됩니다. (참고: 목록 또는 캐러셀이 사용자에게 전송된 직후에만 발생합니다. 대화가 계속 진행된 이후에 항목이 선택되는 경우 입력은 항목의 제목을 기반으로 대화로 해석됩니다.)

내장 인텐트

Dialogflow는 이벤트를 통해 Actions on Google의 내장 인텐트를 지원합니다. 자세한 내용은 Actions on Google의 내장 인텐트 페이지를 참조하세요.

Actions on Google 내장 인텐트를 위한 Dialogflow 이벤트
actions_intent_PLAY_GAME
actions_intent_RESERVE_TAXI
actions_intent_HEAR_JOKE
actions_intent_HEAR_QUOTE
actions_intent_HEAR_FACT
actions_intent_TAKE_QUIZ
actions_intent_GET_FORTUNE
actions_intent_GET_HOROSCOPE
actions_intent_GET_JOKE
actions_intent_GET_QUOTATION
actions_intent_GET_CREDIT_SCORE
actions_intent_GET_CRYPTOCURRENCY_PRICE
actions_intent_CHECK_WATERSPORTS_CONDITIONS
actions_intent_CHECK_AIR_QUALITY
actions_intent_CHECK_WATER_CONDITIONS
actions_intent_START_CALMING_ACTIVITY

권한 요청

Dialogflow는 이벤트를 통해 사용자 위치, 딥 링크, 계정 연결, 업데이트 구성 요청과 같은 Action on Google 권한 이벤트를 전달하여 사용자에게 사전에 알립니다.

이벤트 설명
actions_intent_PERMISSION 사용자의 전체 이름, 대략적인 위치, 정확한 위치 또는 이 세 가지 모두에 액세스하기 위한 작업 요청에 사용자가 응답할 때 트리거됩니다.
actions_intent_LINK Android 앱으로의 딥 링크 요청을 사용자가 거부할 때 트리거됩니다.
actions_intent_SIGN_IN 계정 연결 흐름 중 사용자의 계정을 서비스에 연결하기 위해 트리거됩니다.
actions_intent_REGISTER_UPDATE 사용자가 알림 요청을 확인 또는 거부한 후 트리거됩니다.
actions_intent_CONFIGURE_UPDATES 사용자가 알림 설정 의사를 표시할 때 트리거됩니다.
actions_intent_NEW_SURFACE 동일한 사용자 계정의 다른 어시스턴트 서피스/기기로의 전달 요청에 사용자가 응답할 때 트리거됩니다.

트랜잭션

Dialogflow는 이벤트를 사용하여 트랜잭션 요구사항 충족 확인, 사용자의 특정 트랜잭션 확인 또는 거부 결정과 같은 Actions on Google 트랜잭션 단계를 전달합니다. 자세한 내용은 Actions on Google의 트랜잭션 문서를 참조하세요.

이벤트 설명
actions_intent_TRANSACTION_REQUIREMENTS_CHECK 사용자가 트랜잭션 수행에 필요한 요구사항을 충족하는지 여부에 대한 정보를 얻기 위한 요청 이후 트리거됩니다.
actions_intent_TRANSACTION_DECISION 사용자가 트랜잭션 요청을 확인 또는 거부할 때 트리거됩니다.

다른 플랫폼 이벤트

Dialogflow는 Facebook 위치 요청, Telegram 슬래시 명령어, Twilio MMS 메시지 수신 알림과 같은 다른 플랫폼의 이벤트도 지원합니다.

플랫폼 이벤트 설명
Facebook FACEBOOK_LOCATION 사용자가 사용자 위치 요청을 수락/거부할 때 트리거됩니다.
Telegram TELEGRAM_HELP 사용자가 Telegram 봇과 대화 중 /help를 입력할 때 트리거됩니다.
Telegram TELEGRAM_SETTINGS 사용자가 Telegram 봇과 대화 중 /settings를 입력할 때 트리거됩니다.
Twilio TWILIO_MMS_RECEIVED Dialogflow의 Twilio 통합에서 에이전트에 대한 MMS 메시지가 수신될 때 트리거됩니다.

Facebook 위치

FACEBOOK_LOCATION 이벤트를 사용하여 Facebook Messenger에서 위치를 가져올 수 있습니다. 인텐트를 만들어 커스텀 페이로드를 사용해 위치를 요청합니다.

{
  "facebook": {
    "text": "give me your location please",
    "quick_replies": [
      {
        "content_type": "location"
      }
    ]
  }
}

또 다른 이벤트를 만들어 위치를 처리하고 이벤트를 FACEBOOK_LOCATION으로 설정합니다. 웹훅에서 originalRequest 필드에 위도 및 경도를 수신하게 됩니다.

{
  "originalDetectIntentRequest": {
    "source": "facebook",
    "payload": {
      "postback": {
        "data": {
          "lat": 14.556761479425,
          "long": 121.05444780425
        },
        "payload": "FACEBOOK_LOCATION"
      },
      "sender": {
        "id": "1588949991188331"
      }
    }
  }
}

자세한 내용은 Facebook Messenger의 위치 전송을 위한 API 문서를 참조하세요.

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

Dialogflow 문서
도움이 필요하시나요? 지원 페이지를 방문하세요.