> 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="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2FfZWB2yZjeLKCnrr2Beri%2Fimage.png?alt=media&amp;token=ec7a4bdd-5d69-41c9-98b2-d8599f6f2f77" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2FLVshwRTpZLgrqaKoq8xB%2Fimage.png?alt=media&amp;token=27a3d957-3bae-49c8-a31d-b2e1dd6154ae" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2Fgv2Snc9iGhkeNigpxm04%2Fimage.png?alt=media&amp;token=6160cfd5-b078-4c4d-b695-2e80a9754345" 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="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2FxI8lLsf9Vdl2LQUISP7q%2Fimage.png?alt=media&amp;token=e6059b2c-6afc-4c56-a654-f3664628ba85" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2FzsPV8szX35fWDLOvWhUf%2Fimage.png?alt=media&amp;token=cb9067bf-645b-4467-87c7-a49925db31a3" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2Fez7w66WP5hLVXeHxYbUu%2Fimage.png?alt=media&amp;token=d88c95db-d7c1-4480-b47a-bb0dc36a6abb" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2FoelCKtoNtTYoYvtQPOvb%2Fimage.png?alt=media&amp;token=90750fdb-4692-4c00-8493-8860cf3a96ab" alt=""><figcaption><p>폴백 블록에 Fallback 스킬 적용하기</p></figcaption></figure>

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2FLgJ2iFU4aSsOLPPHUMFE%2Fimage.png?alt=media&amp;token=e42c276c-a1a0-4884-a4b6-31f4d091cc01" alt=""><figcaption><p>[봇 응답] - [응답 추가]에서 <strong>스킬데이터</strong> 설정 한 후 화면</p></figcaption></figure>

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

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2F9pVVPqqtPgwePb48FZPn%2Fimage.png?alt=media&amp;token=29cd6648-e632-4a1f-aedf-85b051538141" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2FzOEcNEPXILQjqeC8OBAr%2Fimage.png?alt=media&amp;token=f86d6569-9d8e-42ba-a980-79b0156cae9a" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2FgiRPbXcMwNOwz5DEdtIS%2Fimage.png?alt=media&amp;token=3d5549b1-8188-476f-87bd-c8a89a24278c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2FBTbNnVDwK7RwGJaZXVpy%2Fimage.png?alt=media&amp;token=36d61553-826e-4ed1-8066-d61e5e9c52b8" alt=""><figcaption><p><strong>챗봇 시작</strong> 블록에 <strong>챗봇 시작</strong> 스킬 적용하기</p></figcaption></figure>

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2F7eEEzOzNlIlj3ObyiQdT%2Fimage.png?alt=media&amp;token=a064f23d-2764-4850-8dab-0b840ebeaaa0" alt=""><figcaption><p>[봇 응답] - [응답 추가]에서 <strong>스킬데이터</strong> 설정 한 후 화면</p></figcaption></figure>

***

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

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

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

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2F3dbXUZKDPJgrz9awkdIU%2Fimage.png?alt=media&amp;token=2f46de75-b783-420b-831d-1e216c50fde0" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2F9sTiGR6bn1uVQsyiBngX%2Fimage.png?alt=media&amp;token=eeedbd93-95e9-4a0d-8cd9-b1d3ce22eecb" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2F9JIsxp9KWSCsFO1Ts5OA%2Fimage.png?alt=media&amp;token=42e5bf0a-787b-43e4-8352-2344014f07ca" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2FzaI1MoIitwgXRmAi7lq4%2Fimage.png?alt=media&amp;token=953f4058-c2d7-434e-89e6-247d8b3f0e73" alt=""><figcaption></figcaption></figure>

***

## 4. 배포하기

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

<figure><img src="https://3240612988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pepGQKkozVFbob9lhxe%2Fuploads%2FJqLKC2OjQMheZedmqV08%2Fimage.png?alt=media&amp;token=35099e40-747a-42c7-b558-4241461f94f9" alt=""><figcaption></figcaption></figure>
