Text (SMS)

# Text (SMS)

This tool provides a simple SMS channel backed by Textbelt and stored in Clono's database so agents can query shared conversations and send messages by phone number.

For generic requests like "text someone", "send a message", or "send an SMS", **default to this tool**.
Only switch to `blooio` when the user specifically wants **iMessage**, **MMS**, or any **media/attachment** behavior.

## MMS (not supported)

- **Outbound:** Only plain **SMS** is sent (text body). **MMS is not supported** — you cannot attach or send photos, videos, or other media through this integration.
- **Inbound:** **MMS replies are not supported.** If someone replies with image-only or other MMS content, Clono may not receive or store a usable message (empty body replies are rejected). Tell users to use **SMS text** or share a **link** to media if needed.

## Environment

- `TEXTBELT_API_KEY`: required (paid key for replies; free key can send but cannot receive replies).
- `CLONO_PUBLIC_URL`: recommended (used to construct the reply webhook URL).

## Key concepts

- **Threads** are keyed by the recipient's E.164 number inside a shared Textbelt inbox. Everyone using Clono talks in the same conversation for the same external phone number.
- **Reply routing**: inbound Textbelt replies are matched by the sender's phone number and stored back into that shared conversation.

## Operations

- `text.send`
  - Send an **SMS** to a phone number (normalized to E.164). Replies land in the shared conversation for that recipient. **No MMS or attachments.**

- `text.list_threads`
  - List recent shared SMS threads.

- `text.list_messages`
  - List messages for a shared thread by contact phone.