---
title: "액션 메소드 V2 활용법"
slug: "chatbot-chatbot-3-10"
updated: 2026-09-17T09:07:06Z
published: 2026-09-17T09:07:06Z
canonical: "guide.ncloud-docs.com/chatbot-chatbot-3-10"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 액션 메소드 V2 활용법

Classic/VPC 환경에서 이용 가능합니다.

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

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

참고

- 액션 메소드 V2.0에 대한 자세한 내용은 [액션 메소드 V2.0](/docs/chatbot-chatbot-3-4)을 참조해 주십시오.

### 답변에서 활용법

참고

- 백엔드에서 응답 형식을 참고하여 응답해 주어야 합니다.
- 답변에서 이용 시 응답 형식의 variableName 값을 이용해 주십시오.

**답변 설정**

![chatbot-chatbot-3-10-1_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/chatbot-chatbot-3-10-1_ko.png?sv=2026-02-06&spr=https&st=2026-11-13T15%3A07%3A41Z&se=2026-11-13T16%3A07%3A41Z&sr=c&sp=r&sig=08WnmWj7G29ZLAk0gllIK6SDnZreXTlsluIazB7anfE%3D)

**응답 형식**

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

**대화 테스트**

![chatbot-chatbot-3-10-2_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/chatbot-chatbot-3-10-2_ko.png?sv=2026-02-06&spr=https&st=2026-11-13T15%3A07%3A41Z&se=2026-11-13T16%3A07%3A41Z&sr=c&sp=r&sig=08WnmWj7G29ZLAk0gllIK6SDnZreXTlsluIazB7anfE%3D)

### 사용자 변수 활용법

- 액션 메소드 호출하여 세션 내 이용할 사용자 변수에 값 설정이 가능합니다.
- 사용자 변수를 설정하기 위한 Type, Action, valueType에 대한 자세한 내용은 [액션 메소드 V2.0](/docs/chatbot-chatbot-3-4)을 참조해 주십시오.
- 사용자 변수에 대한 자세한 내용은 [사용자 변수](/docs/chatbot-chatbot-2-6)를 참조해 주십시오.

**사용자 변수 설정**

![chatbot-chatbot-3-10-3_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/chatbot-chatbot-3-10-3_ko.png?sv=2026-02-06&spr=https&st=2026-11-13T15%3A07%3A41Z&se=2026-11-13T16%3A07%3A41Z&sr=c&sp=r&sig=08WnmWj7G29ZLAk0gllIK6SDnZreXTlsluIazB7anfE%3D)

**응답 형식**

```
{
    "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](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/chatbot-chatbot-3-10-4_ko.png?sv=2026-02-06&spr=https&st=2026-11-13T15%3A07%3A41Z&se=2026-11-13T16%3A07%3A41Z&sr=c&sp=r&sig=08WnmWj7G29ZLAk0gllIK6SDnZreXTlsluIazB7anfE%3D)

### 아규먼트 활용법

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

**답변 설정**

![chatbot-chatbot-3-10-5_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/chatbot-chatbot-3-10-5_ko.png?sv=2026-02-06&spr=https&st=2026-11-13T15%3A07%3A41Z&se=2026-11-13T16%3A07%3A41Z&sr=c&sp=r&sig=08WnmWj7G29ZLAk0gllIK6SDnZreXTlsluIazB7anfE%3D)

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

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

![chatbot-chatbot-3-10-6_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/chatbot-chatbot-3-10-6_ko.png?sv=2026-02-06&spr=https&st=2026-11-13T15%3A07%3A41Z&se=2026-11-13T16%3A07%3A41Z&sr=c&sp=r&sig=08WnmWj7G29ZLAk0gllIK6SDnZreXTlsluIazB7anfE%3D)

참고

- 액션메소드 관련 에러는 [CLOVA Chatbot 오류 코드](/docs/clovachatbot-troubleshoot-errorcode)를 참조해 주십시오.