액션메소드 V2 활용

액션 메소드 V2.0 이용 가이드

  • 액션 메소드 V2.0을 활용하는 방법에 대해 설명합니다.
  • 액션 메소드 V2.0은 POST 방식으로 요청이 되어야 하며, Body를 통해 분석된 엔티티 값, 사용자 변수 값을 전송합니다.
참고

답변에서 활용법

참고
  • 백엔드에서 응답 형식을 참고하여 응답해야 합니다.
  • 답변에서 이용 시 응답 형식의 variableName 값을 이용하시면 됩니다.


답변 설정

chatbot-chatbot-3-10-1_ko.png


응답 형식

{
    "data": [
        {
            "variableName": "var1",
            "value": "VAR1"
        },
        {
            "variableName": "var2",
            "value": "VAR2"
        }
    ]
}


대화 테스트

chatbot-chatbot-3-10-2_ko.png


사용자 변수 활용법

  • 액션 메소드 호출하여 세션 내 이용할 사용자 변수에 값 설정이 가능합니다.
  • 사용자 변수를 설정하기 위한 Type, Action, valueType에 대한 자세한 내용은 액션 메소드 V2.0을 참고해 주십시오.
  • 사용자 변수에 대한 자세한 내용은 사용자변수를 참고해 주십시오.

사용자 변수 설정

chatbot-chatbot-3-10-3_ko.png


응답 형식

{
    "data": [
        {
            "variableName": "var1",
            "value": "VAR1"
        },
        {
            "variableName": "var2",
            "value": "VAR2"
        }
    ],
    "userVariable": [
        {
            "name": "userVarString",
            "value": "USERVAR1",
            "type": "TEXT",
            "action": "EQ",
            "valueType": "TEXT"
        },
        {
            "name": "userVarNumber",
            "value": 100,
            "type": "NUMBER",
            "action": "EQ",
            "valueType": "NUMBER"
        },
        {
            "name": "date.year",
            "value": "2022",
            "type": "JSON",
            "action": "EQ",
            "valueType": "TEXT"
        },
        {
            "name": "date.month",
            "value": 10,
            "type": "JSON",
            "action": "EQ",
            "valueType": "NUMBER"
        },
        {
            "name": "date.day",
            "value": 24,
            "type": "JSON",
            "action": "ADD",
            "valueType": "NUMBER"
        }
    ]
}


사용자 변수 테스트

chatbot-chatbot-3-10-4_ko.png


아규먼트 활용법

  • 액션 메소드 호출 시 임의의 아규먼트를 넣어 요청할 수 있으며 백엔드에서 활용 가능한 데이터입니다.
  • 답변에서 $2{액션메소드명(arg1, arg2).variableName}와 같이 활용합니다.

답변 설정

chatbot-chatbot-3-10-5_ko.png

  • 답변에서 설정한 아규먼트를 백엔드에서 확인이 가능합니다.


백엔드에서 아규먼트 정보 확인

chatbot-chatbot-3-10-6_ko.png

참고
  • 액션메소드 관련 에러는 에러코드를 참고해 주십시오.