> ## 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.

# Messenger

> Your own chats on Telegram, iMessage, KakaoTalk, Slack, WhatsApp, LINE and more, in one place, with sending only on your yes.

Messenger brings your own chats into Archetype: read and answer them on one page, hear when a message is for you, and let the agent read them. It is on by default and appears in the sidebar as **Messenger**, with the unread count. For turning plugins on and off, see [Plugins](https://docs.archetype.ing/en/extend/plugins.md).

## Connect an account

Open **Messenger → Add account** and pick a network.

| Network | How it signs in |
| - | - |
| Telegram | With a QR code |
| iMessage | Reads this Mac's Messages |
| KakaoTalk | Your own account |
| Slack | Your own workspace's direct messages and channels |
| WhatsApp | By linking a device |
| LINE | Your own account |
| Matrix bridges | The networks a Matrix homeserver's bridges bring |

KakaoTalk, LINE and WhatsApp need a part Messenger downloads the first time. A card shows what it is, who makes it, its license and size, with **Connect**; nothing is downloaded before you press it. **Accounts** lists it later with **Delete from this computer**.

Through Matrix bridges, Messenger can also reach Signal, Instagram, Facebook Messenger, Google Messages, LinkedIn, X and Bluesky. The bridges run on Apple silicon Macs and Linux, not on Intel Macs or Windows.

Each account shows whether it is connected. One that dropped tries again by itself; **Reconnect** tries now, or opens the network's sign-in.

Messenger runs outside the sandbox other plugins run in, because it runs each network's own helpers (iMessage through AppleScript, KakaoTalk's tools).

## The page

* Read and answer your chats.
* **Draft** and **Summarize** ask the folder's model.
* **Catch up**: what was said in a chat since you last read it, and what names or asks you first, with a jump to each. **Catch up on all** does it for the ten chats with the most unread.

In the page's chat, the open chat is attached as a chip, with a **Reply coaching** chip to ask for help with the answer.

## What the agent can do

| Tool | What it does | Asks you |
| - | - | - |
| `list_messenger_chats` | Lists chats | No |
| `read_messenger_chat` | Reads a chat | No |
| `search_messenger` | Searches messages | No |
| `catch_up_messenger` | Catches up on a chat or all; marks nothing read | No |
| `send_messenger_message` | Sends a message | Every time |

Before sending, you see the chat and network, the account, the exact text and the message it answers. Sending asks every time, even in `yolo`; with no one there to answer, it is refused. See [Approvals](https://docs.archetype.ing/en/use/approvals.md). The tools are there only once an account is signed in, and say which accounts they could not read.

## Notices

| Notice | When |
| - | - |
| **New messages** | A message from someone else in a chat that matters: every message in a one-to-one chat, only mentions of you in a group or channel, nothing from a muted or archived chat. A short "ok" or "thanks" is not told. At most once per chat in five minutes |
| **Sign-in needed** | A network ended an account's session. Told once until it is connected again |

Set a chat's level in the [config](https://docs.archetype.ing/en/reference/config.md) under `notifications.chats`, by its id or title: `"all"`, `"mentions"` or `"off"`.

## Event

**`message.received`**: a new message from someone else in a chat that is not muted, archived or read only, whatever its notice level. It carries the chat, network, whether it is a group, one line of the message and whether it mentions you. A [trigger](https://docs.archetype.ing/en/use/automations.md) can wake on it.

## Settings

In **Manage → Plugins → Messenger**:

| Setting | Default | What it does |
| - | - | - |
| **Protect connection attempts** | Off | Keeps sign-in attempts on this computer across restarts. A refused account stops retrying by itself; a wrong password or code ends that sign-in and waits before the next. A KakaoTalk account signs in by itself at most three times in 24 hours; **Reconnect** signs in once more |

## Works with

People reads your chats through Messenger, for the timeline and for when you were last in touch. Messenger offers no profile.


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