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

# 메신저

> Telegram, iMessage, 카카오톡, Slack, WhatsApp, LINE 등 내 대화를 한곳에서. 보내는 일은 내가 승인할 때만.

메신저는 내 대화를 Archetype으로 가져옵니다. 한 화면에서 읽고 답하고, 나에게 온 메시지를 알림으로 받고, 에이전트가 대화를 읽게 합니다. 기본으로 켜져 있고 사이드바에 **메신저**로, 읽지 않은 수와 함께 나옵니다. 플러그인을 켜고 끄는 방법은 [플러그인](https://docs.archetype.ing/ko/extend/plugins.md)을 보세요.

## 계정 연결하기

**메신저 → 계정 추가**를 열고 네트워크를 고릅니다.

| 네트워크 | 로그인 방법 |
| - | - |
| Telegram | QR 코드로 로그인 |
| iMessage | 이 Mac의 메시지를 읽음 |
| 카카오톡 | 내 계정으로 로그인 |
| Slack | 내 워크스페이스의 DM과 채널 |
| WhatsApp | 기기를 연결해 로그인 |
| LINE | 내 계정으로 로그인 |
| Matrix 브리지 | Matrix 홈서버의 브리지가 잇는 네트워크 |

카카오톡, LINE, WhatsApp은 처음 연결할 때 메신저가 내려받는 구성 요소가 필요합니다. 무엇인지, 누가 만들었는지, 라이선스와 크기를 보여 주는 카드에 **연결**이 있고, 누르기 전에는 아무것도 내려받지 않습니다. 나중에 **계정**에서 **이 컴퓨터에서 지우기**로 지울 수 있습니다.

Matrix 브리지로 Signal, Instagram, Facebook Messenger, Google Messages, LinkedIn, X, Bluesky에도 닿습니다. 브리지는 Apple 실리콘 Mac과 Linux에서 돌고, Intel Mac과 Windows에서는 돌지 않습니다.

계정마다 연결 상태를 보여 줍니다. 끊긴 계정은 알아서 다시 시도하고, **다시 연결**을 누르면 지금 시도하거나 그 네트워크의 로그인을 엽니다.

메신저는 네트워크마다의 도구(iMessage의 AppleScript, 카카오톡의 도구)를 직접 실행하기 때문에, 다른 플러그인이 도는 샌드박스 밖에서 돕니다.

## 화면

* 대화를 읽고 답합니다.
* **초안**과 **요약**은 폴더의 모델에 묻습니다.
* **따라잡기**: 마지막으로 읽은 뒤 대화에서 오간 말과, 나를 부르거나 나에게 부탁한 것을 먼저 보여 주고 각 메시지로 이동할 수 있습니다. **모두 따라잡기**는 읽지 않은 메시지가 가장 많은 대화 열 개에 대해 합니다.

화면의 채팅에는 열어 둔 대화가 칩으로 붙고, 답장을 함께 고민할 **답장 코칭** 칩이 나옵니다.

## 에이전트가 하는 일

| 도구 | 하는 일 | 묻는지 |
| - | - | - |
| `list_messenger_chats` | 대화 목록 | 묻지 않음 |
| `read_messenger_chat` | 대화 읽기 | 묻지 않음 |
| `search_messenger` | 메시지 검색 | 묻지 않음 |
| `catch_up_messenger` | 한 대화나 전체 따라잡기. 읽음으로 표시하지 않음 | 묻지 않음 |
| `send_messenger_message` | 메시지 보내기 | 매번 |

보내기 전에 대화와 네트워크, 계정, 보낼 글 그대로, 답하는 메시지를 보여 줍니다. 보내는 일은 `yolo`에서도 매번 묻고, 답할 사람이 없으면 거부됩니다. [승인](https://docs.archetype.ing/ko/use/approvals.md)을 보세요. 도구는 계정에 로그인한 뒤에야 생기고, 읽지 못한 계정이 있으면 그렇다고 말합니다.

## 알림

| 알림 | 언제 |
| - | - |
| **새 메시지** | 중요한 대화에 다른 사람의 메시지가 왔을 때. 1:1 대화는 모든 메시지, 그룹과 채널은 나를 언급한 메시지만, 알림을 끄거나 보관한 대화는 알리지 않습니다. 짧은 "네", "감사합니다"는 알리지 않습니다. 한 대화에 5분에 한 번까지 |
| **로그인 필요** | 네트워크가 계정의 세션을 끝냈을 때. 다시 연결될 때까지 한 번만 알립니다 |

대화마다 알릴 정도는 [설정 파일](https://docs.archetype.ing/ko/reference/config.md)의 `notifications.chats`에 대화 id나 제목으로 `"all"`, `"mentions"`, `"off"` 중 하나를 적어 정합니다.

## 이벤트

**`message.received`**: 알림을 끄거나 보관하지 않았고 쓸 수 있는 대화에 다른 사람의 새 메시지가 왔을 때. 알림 정도와 상관없이 보냅니다. 대화, 네트워크, 그룹인지, 메시지 한 줄, 나를 언급했는지를 담습니다. [트리거](https://docs.archetype.ing/ko/use/automations.md)가 이 이벤트로 깨어날 수 있습니다.

## 설정

**관리 → 플러그인 → 메신저**에서:

| 설정 | 기본값 | 하는 일 |
| - | - | - |
| **연결 시도 보호** | 꺼짐 | 연결 시도를 이 컴퓨터에 남겨 재시작 뒤에도 지킵니다. 계정이 거부하면 자동 재시도를 멈추고, 비밀번호나 인증 코드가 틀리면 그 로그인을 끝내고 잠시 기다립니다. 카카오톡 계정은 24시간에 3번까지만 자동 로그인하고, **다시 연결**을 누르면 한 번 더 로그인합니다 |

## 함께 쓰는 곳

사람이 메신저를 통해 대화를 읽어 타임라인과 마지막 연락일을 채웁니다. 메신저는 프로필을 제공하지 않습니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.