--- title: "CLOVA Chatbot overview" slug: "ai-application-service-chatbot" tags: ["CLOVA Chatbot", "overview"] updated: 2026-09-17T09:35:51Z published: 2026-09-17T09:35:51Z canonical: "api.ncloud-docs.com/ai-application-service-chatbot" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # CLOVA Chatbot overview Available in Classic and VPC CLOVA Chatbot is a NAVER Cloud Platform service that identifies the intent of the user's question and provides appropriate answers in various formats. The CLOVA Chatbot Custom API provides an API for the question and answer feature in RESTful form based on the training results of the domain set in CLOVA Chatbot Builder, and is suitable if you want to implement a chatbot on the general web or app instead of the messenger channel. This guide describes how to send a request to CLOVA Chatbot from a Custom channel. ## CLOVA Chatbot integration and development process This section describes the process for Custom integration and development of CLOVA Chatbot. ### Integration process The integration process is as follows: 1. Create a conversation scenario using the CLOVA Chatbot Builder. 2. Build and deploy the conversation model. 3. Set up CLOVA Chatbot Custom integration. 4. Create an API Gateway call URL and issue a secret key. 5. Call the API from the application with the API Gateway invoke URL. ### Development process The development process is as follows: 1. Check the API Gateway invoke URL. 2. Create a signature to generate the authentication key to pass in the request header. - Use the secret key generated in CLOVA Chatbot Custom. 3. Create a response body value for the conversation query. 4. Request using the API Gateway invoke URL. - See [CLOVA Chatbot Custom API examples](/docs/en/ai-application-service-chatbot-chatbotexample). ## Common CLOVA Chatbot settings The following describes commonly used request and response formats in CLOVA Chatbot Custom APIs. ### Request The following describes the common request format. #### API URL The request API URL is as follows: ``` API Gateway's unique invoke URL created in CLOVA Chatbot Builder ``` #### Request headers The following describes the headers. | Field | Required | Description | | --- | --- | --- | | `X-NCP-CHATBOT_SIGNATURE` | Required | Base64-encoded signature that encrypts the request information with a secret key and request body created on NAVER Cloud Platform's CLOVA Chatbot Custom, using the HMAC encryption algorithm (HmacSHA256) - Issue and check secret key: See [How to issue and check secret key](/docs/en/ai-application-service-chatbot#SecretKey%EB%B0%9C%EA%B8%89%EB%B0%8F%ED%99%95%EC%9D%B8%EB%B0%A9%EB%B2%95). - Create signature: See [X-NCP-CHATBOT_SIGNATURE creation examples](/docs/en/ai-application-service-chatbot#XNCPCHATBOTSIGNATURE%EC%83%9D%EC%84%B1%EC%98%88%EC%A0%9C). | | `Content-Type` | Required | Request data type | **How to issue and check secret key** To issue or check the secret key in CLOVA Chatbot: 1. From the NAVER Cloud Platform console, go to **Menu** > **All Services** > **CLOVA Chatbot** > **Domain**. 2. Click **[Run builder]** of the domain you want to run the chatbot builder. 3. From the chatbot builder, click **[Chatbot settings]**. 4. From the chatbot settings, click the **Integrate messenger** tab. 5. Under the **Custom** item, click **[Integrate]**. 6. Issue or check the secret key in the Integrate Custom pop-up. **X-NCP-CHATBOT_SIGNATURE creation examples** The following are examples of language-specific `X-NCP-CHATBOT_SIGNATURE` settings. - JavaScript ``` const HmacSHA256 = require('crypto-js/hmac-sha256'); const EncBase64 = require('crypto-js/enc-base64'); signatureHeader = HmacSHA256(requestBodyString, secretKey).toString(EncBase64); ``` - Java ``` byte[] secretKeyBytes = secretKey.getBytes(StandardCharsets.UTF_8); SecretKeySpec secretKeySpec = new SecretKeySpec(secretKeyBytes, "HmacSHA256"); Mac mac = Mac.getInstance("HmacSHA256"); mac.init(secretKeySpec); byte[] signature = mac.doFinal(body.getBytes(StandardCharsets.UTF_8)); String signatureHeader = Base64.getEncoder().encodeToString(signature); ``` ### Response The following describes the common response format. #### Response status codes The following describes the response status codes. Note For information about the HTTP status codes common to NAVER Cloud Platform, see [Ncloud API response status codes](/docs/en/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C). | HTTP status code | Code | Message | Description | | --- | --- | --- | --- | | 500 | - | Internal server error | Internal server error | | - | 1000 | version not support | Unsupported version | | - | 1001 | Not found domain code | Domain code not found | | - | 1002 | check url param is invalid | Invalid URL parameter | | - | 4000 | request param invalid | Invalid request parameter | | - | 4010 | Unauthorized | Not authenticated | | - | 4030 | Forbidden to access | Access unauthorized | | - | 4031 | Signature validate failed | Signature validation failed | | - | 4032 | timestamp exceeded time window(10000ms) | Allowed time range (10000 ms) exceeded | | - | 5000 | Unknown service error | Unknown service error | | - | 5010 | Current protocol version not support this reply structure | Current protocol version does not support this response structure. | | - | 5020 | Calls to this api have exceeded the rate limit | API call count limit exceeded | ## CLOVA Chatbot Custom API The following describes the APIs provided by the CLOVA Chatbot Custom service. | API | Description | | --- | --- | | [Open](/docs/en/ai-application-service-chatbot-open) | Open the welcome message of CLOVA Chatbot. | | [Send](/docs/en/ai-application-service-chatbot-send) | Send questions to CLOVA Chatbot. | | [getPersistentMenu](/docs/en/ai-application-service-chatbot-getpersistentmenu) | Get the list of persistent menus. | ## CLOVA Chatbot related resources NAVER Cloud Platform provides a variety of related resources to help users better understand CLOVA Chatbot Custom APIs. - CLOVA Chatbot Custom API guides - [Common Ncloud response status codes](/docs/en/common-ncpapi#3-%EC%9D%91%EB%8B%B5-%EC%83%81%ED%83%9C-%EC%BD%94%EB%93%9C): Information on common response status codes of NAVER Cloud Platform used by the CLOVA Chatbot service - [API Gateway user guide](https://guide.ncloud-docs.com/docs/en/apigw-apigw-1): Subscription to the API Gateway service to integrate the domain's InvokeURL with API Gateway - [Basic guide to integrating CLOVA Chatbot with API Gateway](https://guide.ncloud-docs.com/docs/en/chatbot-chatbot-5-1): Introduction to the basic integration of CLOVA Chatbot with API Gateway - [Sub Account User Guides](https://guide.ncloud-docs.com/docs/en/subaccount-overview): Introduction to how to use Sub Account that helps the management of CLOVA Chatbot's administration permissions - How to use the CLOVA Chatbot service - [CLOVA Chatbot user guide](https://guide.ncloud-docs.com/docs/en/chatbot-chatbot-overview): Chatbot creation process, conversation component management, advanced utilization of chatbots, integration with messengers and extension services, and how to manage and troubleshoot chatbots in the NAVER Cloud Platform console - [CLOVA Chatbot prerequisites](https://guide.ncloud-docs.com/docs/en/chatbot-chatbot-spec): View supported environments, cautions for use, and pricing information. - [Ncloud user environment guide](https://guide.ncloud-docs.com/docs/en/environment-environment-1-1): Explore VPC and Classic environments and supported services. - [Pricing and features](https://www.ncloud.com/product/aiService/chatbot): View pricing details and key capabilities. - [Latest announcements](https://www.ncloud.com/intro/news): Stay informed about CLOVA Chatbot updates and news. - [FAQs](https://www.ncloud.com/support/faq/prod?categoryCode2=AI&categoryCode3=SV_0059&page=1): Get answers to common CLOVA Chatbot questions. - [Contact Support](https://www.ncloud.com/support/question/service): Get help if you can't find what you need in the API guide.