> For the complete documentation index, see [llms.txt](https://happytalk.gitbook.io/happybot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://happytalk.gitbook.io/happybot/setting/channel/kakao/i.md).

# 카카오 i 오픈 빌더 연동하기

***

## 1. 봇 ID 연동하기

{% hint style="success" %}
\[챗봇 관리자센터] - \[설정]에서 \[봇 ID]를 확인 후 복사하여,\
\[해피봇new] - \[설정] - \[메신저 연동] - \[카카오 i 오픈빌더]에 봇 ID를 입력하여 설정하는 순서로 진행합니다.
{% endhint %}

### 1) 카카오톡 챗봇 ID 복사하기

> \[챗봇 관리자센터] - \[설정]에서 \[봇 ID]를 확인 후 복사합니다.

<figure><img src="/files/ehHygKGEJdw24IgMCIpX" alt=""><figcaption></figcaption></figure>

### 2) 해피봇 new  > 설정하기로 이동

> 해피봇 new 화면에서 나의 봇 우측 상단 \[ ··· ] 아이콘에서 <mark style="color:orange;">**설정하기**</mark>를 클릭합니다.

<figure><img src="/files/rAm3dapCQSbIk41gspvR" alt=""><figcaption></figcaption></figure>

### 3) 연동기능 활성화하기

> **\[해피봇 new] - \[설정] - \[메신저 연동] - \[카카오 i 오픈빌더]** 우측의 슬라이드 바를 클릭하여 연동 기능을 활성화하고, 앞에서 복사한 봇 ID를 붙여넣은 뒤 저장합니다.\
> \
> &#x20;<mark style="color:orange;">\* 해피톡 홈페이지를 통해 로그인한 경우,</mark> \
> &#x20;   해피톡에서 카카오 상담톡 채널 연동을 해야 해당 필드가 표시됩니다. \
> &#x20;   이 경우 추가로 노출되는 '카카오 채널 연동'란에서 아이디를 함께 선택합니다.

<figure><img src="/files/MVhkQ1WR8sEkwAWfGvSO" alt=""><figcaption></figcaption></figure>

***

## 2. 스킬 생성 및 연동 <a href="#id-2." id="id-2."></a>

{% hint style="success" %}
Fallback 스킬 및 시작 스킬을 생성하여 연동합니다.
{% endhint %}

### **1) Fallback 스킬**

> \[해피봇New] - \[설정] - \[메신저 연동] - \[카카오 i 오픈빌더]에서 **Webhook URL**을 복사합니다.

<figure><img src="/files/z0UDqxCyZHtjZ3Bti5Oh" alt=""><figcaption></figcaption></figure>

> \[챗봇 관리자센터] - \[스킬] 메뉴에서 생성 버튼을 클릭하여 스킬을 생성합니다.&#x20;

<figure><img src="/files/WtfrhELmAbP7e05yrS65" alt=""><figcaption></figcaption></figure>

> 스킬명을 <mark style="color:blue;">**Fallback**</mark>으로 입력한 후 앞에서 복사한 Webhook URL을 붙여넣은 뒤 저장합니다. 이 스킬은 유저가 챗봇 경로를 이타할 경우 **시나리오로 리턴**시키는 역할을 합니다.

<figure><img src="/files/pvyDBvoLmyQjrdZHGwcx" alt=""><figcaption></figcaption></figure>

> \[챗봇 관리자센터] - \[시나리오] - \[폴백 블록]으로 이동합니다.&#x20;
>
> \[파라미터 설정]에서 드롭박스를 클릭하여 방금 만든 **Fallback** 스킬을 선택한 후, 하단의 \[봇 응답] - \[응답 추가]에서 봇 응답 설정을 **스킬 데이터**로 지정하고 저장합니다.&#x20;

<figure><img src="/files/FjZ1i28cupTxWk4EyyB3" alt=""><figcaption><p>폴백 블록에 Fallback 스킬 적용하기</p></figcaption></figure>

<figure><img src="/files/UQfAuHLIR52VDCgMaArb" alt=""><figcaption><p>[봇 응답] - [응답 추가]에서 <strong>스킬데이터</strong> 설정 한 후 화면</p></figcaption></figure>

### 2) **챗봇 시작 스킬**

> 같은 방법으로 스킬을 하나 더 생성하겠습니다. \
> \
> \[챗봇 관리자센터] - \[스킬] 메뉴에서 생성 버튼을 클릭하여 스킬을 생성합니다. \
> 스킬 목록에서 위에서 만든 Fallback 스킬도 확인 가능합니다.

<figure><img src="/files/DQhD3mETebKqZgu1Vj9o" alt=""><figcaption></figcaption></figure>

> 스킬명을 <mark style="color:orange;">**챗봇 시작**</mark>으로 입력한 후 처음에 복사한 Webhook URL 뒤에 **/home**을 추가로 붙여줍니다. \
> 이 스킬은 **챗봇을 실행**시키는 역할을 합니다.&#x20;

<figure><img src="/files/ctUVAaZNUyVTl8tIKg3o" alt=""><figcaption></figcaption></figure>

> \[챗봇 관리자센터] - \[시나리오]로 이동하여, \[+ 시나리오]를 클릭합니다.

<figure><img src="/files/0s4tsnH9iMgi6F6qFTph" alt=""><figcaption></figcaption></figure>

> 블록 이름을 **챗봇 시작**으로 지정하고, \
> \[파라미터 설정]에서 드롭박스를 클릭하여 방금 만든 **챗봇 시작** 스킬을 선택한 후, \
> 하단의 \[봇 응답] - \[응답 추가]에서 봇 응답 설정을 **스킬 데이터**로 지정하고 저장합니다. &#x20;

<figure><img src="/files/3qFYxS8JbUELmwdJKVi7" alt=""><figcaption><p><strong>챗봇 시작</strong> 블록에 <strong>챗봇 시작</strong> 스킬 적용하기</p></figcaption></figure>

<figure><img src="/files/OzBagahP8Kwqitd50Njx" alt=""><figcaption><p>[봇 응답] - [응답 추가]에서 <strong>스킬데이터</strong> 설정 한 후 화면</p></figcaption></figure>

***

## 3. 챗봇 시작 버튼 생성

{% hint style="success" %}
카카오 챗봇 시나리오를 생성 및 챗봇 시작 버튼을 생성합니다.
{% endhint %}

### 1) 카카오 챗봇 시나리오 설정

> \[챗봇 관리자센터] - \[시나리오] - \[시나리오 설정]을 클릭합니다.

<figure><img src="/files/C13A0LFp2644SbZjskpI" alt=""><figcaption></figcaption></figure>

### 2) 봇 제네릭 메뉴 설정

> \[봇 제네릭 메뉴 설정] 기능을 활성화합니다.

<figure><img src="/files/1uNmj0INPL2ooWgU2bMp" alt=""><figcaption></figcaption></figure>

> \[봇 제네릭 메뉴 설정]에서 \[+버튼 추가]를 클릭합니다.

<figure><img src="/files/kV4uH0ioJcpz8oT8h128" alt=""><figcaption></figcaption></figure>

> \[버튼 설정]에서 버튼명을 **챗봇 시작하기**로 입력하고, \
> 버튼 기능은 앞에서 생성한 **챗봇 시작** 블록을 연결하고 확인을 누릅니다.

<figure><img src="/files/RKoVdlBfIxSDuyEfaqKI" alt=""><figcaption></figcaption></figure>

***

## 4. 배포하기

{% hint style="success" %}
설정 내용을 적용하기 위해서 \
\[챗봇 관리자센터] - \[배포]에서 배포 버튼을 클릭해 배포를 진행합니다.
{% endhint %}

<figure><img src="/files/vd16ZuzzUPiDTootxoVS" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://happytalk.gitbook.io/happybot/setting/channel/kakao/i.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.