> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/ko/messenger-channels/kakaotalk.md).

# KakaoTalk

카카오톡에서 Crew AI 어시스턴트와 바로 대화할 수 있습니다.

## 설정 가이드

### 1단계: 페어링 코드 받기

1. Crew 웹 앱에서 **메신저**로 이동
2. 카카오톡 옆의 **연결** 클릭
3. **페어링 코드** (8자리)가 표시됩니다 — 복사하세요

### 2단계: 카카오톡에서 Crew 채널 찾기

1. 카카오톡을 열어주세요 (휴대폰 또는 PC)
2. Crew 공식 채널을 검색하거나, 웹 페이지에 표시된 QR 코드를 스캔하세요
3. 채널을 친구 추가하세요

### 3단계: 페어링 코드 전송

1. Crew 채널과의 채팅을 열어주세요
2. 페어링 코드를 메시지로 보내세요
3. Crew가 연결을 확인합니다: "계정이 성공적으로 연결되었습니다!"

이제 카카오톡에서 Crew와 바로 대화할 수 있습니다.

## 활용 팁

### 대화 시작하기

카카오톡 채팅에서 웹 앱과 동일하게 메시지를 보내면 됩니다:

> "내일 서울 날씨 어때?"

> "내일 오전에 미팅 있는지 확인해 줘."

> "강남역 근처 이탈리안 맛집 찾아 줘."

### 파일 보내기

카카오톡을 통해 **이미지**를 Crew에게 보낼 수 있습니다. 웹에서 업로드한 것과 동일하게 분석해 줍니다:

> \[사진 전송] "이 사진에 뭐가 있어?"

> \[스크린샷 전송] "이 에러가 무슨 뜻이야?"

{% hint style="info" %}
카카오톡에서 Crew로 보낼 수 있는 파일은 **이미지만** 가능합니다. PDF, 문서, 오디오, 동영상 등은 카카오톡 플랫폼 특성상 지원되지 않습니다. 다른 파일을 보내려면 웹 앱이나 Telegram, Slack 등 다른 메신저를 이용하세요.
{% endhint %}

### 파일 받기

Crew가 파일(문서, 스프레드시트, 이미지 등)을 만들면 카카오톡 채팅에 **다운로드 링크**를 보내드립니다. 링크를 탭하면 바로 다운로드할 수 있고, 링크는 24시간 동안 유효합니다.

### 음성 메시지

카카오톡에서 보낸 음성 메시지는 Crew에게 전달되지 않습니다 — 파일명만 도착하고 실제 음성은 전달되지 않아요. 음성 입력을 하려면 웹 앱의 음성 모드를 이용하거나 직접 텍스트로 입력해 주세요.

### 채널 간 소통

카카오톡에서 다른 채널로 결과를 보내달라고 하거나, 반대로 다른 채널에서 카카오톡으로 보내달라고 할 수도 있어요:

> "이 요약 내 Slack으로도 보내 줘."

> "이메일 확인해서 보고서 카카오톡으로 보내 줘." (웹이나 다른 메신저에서)

Crew는 연결된 모든 채널에서 자유롭게 소통할 수 있습니다.

## 프로액티브 인텔리전스

카카오톡에서도 **프로액티브 인텔리전스**를 받을 수 있습니다. 모닝 브리핑, 미팅 준비, 이메일 알림 등 Crew가 자동으로 보내주는 인사이트를 카카오톡으로 바로 받아보세요.

설정 방법:

1. 웹 앱에서 **설정 → 프로액티브 인텔리전스**로 이동
2. 원하는 모듈을 활성화
3. 전달 채널로 **카카오톡** 선택

{% hint style="warning" %}
카카오톡으로 프로액티브 메시지를 받을 때마다 모듈 자체 크레딧 외에 **메시지당 10 크레딧**이 추가로 차감됩니다. 카카오톡 플랫폼의 메시지 발송 비용 때문이에요. Telegram, Slack, Discord 등 다른 메신저에는 이 추가 비용이 없습니다.
{% endhint %}

## 참고 사항

* 페어링 코드는 **10분** 후 만료됩니다. 만료되면 웹 앱에서 새 코드를 발급받으세요.
* 카카오톡 계정 하나당 Crew 계정 **하나**만 연결할 수 있습니다.
* Crew는 대화에서 사용하는 언어에 맞춰 응답합니다.
* 복잡한 작업으로 처리 시간이 길어지는 경우, 비동기 콜백을 통해 응답이 준비되면 전달됩니다.
* 프로액티브 메시지는 **텍스트로만** 전달됩니다. 파일이 포함된 인사이트는 다운로드 링크로 보내드립니다.

## 연결 해제

카카오톡 연결을 해제하려면:

1. Crew 웹 앱에서 **메신저**로 이동
2. 카카오톡 옆의 **연결 해제** 클릭
3. 즉시 연결이 해제됩니다

언제든 설정 과정을 반복하여 다시 연결할 수 있습니다.
