# ChatGPT texts

> Save the texts you send your ChatGPT dot from macOS Messages.

When you text your ChatGPT dot from macOS Messages, Hansard can save that
one-to-one conversation. OpenAI gives each dot its own number, which the dot
sends as a contact card after you verify your phone number in the dot's
**Texting** settings in ChatGPT. There is no single number that everyone
texts. Capture stays off until you enter your dot's number under
**ChatGPT dot number** in **Settings → Imports → Messages assistants** and
select **Save number**.

You can also configure it from the CLI. Replace the synthetic example with
your dot's number, including its country code:

```sh
hansard config set imports.chatgptMessagesHandle "+12025550105"
hansard import --source chatgpt-messages --since all
```

If source selection is Custom, enable ChatGPT texts in the Agents list. The
watcher checks the configured conversation on its polling cadence. To stop
future capture, clear **ChatGPT dot number** and select **Save number**, or
run `hansard config unset imports.chatgptMessagesHandle`.
Previously archived history stays available.

ChatGPT texts appear with OpenAI in Stats, the source picker, and history
filters, as a source apart from your ChatGPT conversations and exports.
Filter them with `--provider chatgpt-messages`.

ChatGPT texts use the same Messages reader as [Instinct](https://www.hansard.dev/imports/instinct/) and
[Poke](https://www.hansard.dev/imports/poke/). The reader captures text, message times, reactions,
observed edits and unsends, reply references, link previews, and available
attachments from iMessage, RCS, and SMS chats with that number. One number
remains one continuous Hansard conversation. The dot's tasks, tools, models,
measured tokens, and billing information are unavailable in Messages.

Only selected rows and selected attachments enter the archive. Hansard never
archives the Messages database, other chats, or group conversations.
Offline rebuild uses the preserved selection. Attachments larger than 16 MiB,
missing files, and iCloud-offloaded files retain a descriptor with an
explicit reason. Hansard does not download offloaded files.

Capture from the Messages store on a Mac has not been verified yet. Do not
grant Full Disk Access to your terminal for it.

Texts you send your dot from an Android phone over RCS are not on the Mac,
so they are not imported.
