messenger_settings_apply

# messenger_settings_apply

Save messenger settings in the Messenger app (pApp D00003). Tab titles 1–12 with all three tabs ordered and one visible; text limit 1–1000; gifting needs Z00008. Omitted settings are kept. Write: autonomous upload/download switches affect all autonomous rooms. A lost receipt stays pending and is never resent; task_resume only observes, and prepared work needs the identical apply. Called without confirmToken it previews and returns a confirmToken; repeating the same input with it executes once.

## Inputs

| Field | Required here | Contract |
| --- | --- | --- |
| `settings` | Yes | object |
| `settings.basicGroupName` | No | string; min length 1; max length 12; Group-chat tab title, 1–12 characters. |
| `settings.directName` | No | string; min length 1; max length 12; Direct-chat tab title, 1–12 characters. |
| `settings.autonomousGroupName` | No | string; min length 1; max length 12; Free group-chat tab title, 1–12 characters. |
| `settings.tabOrder` | No | array; items: `BASIC_GROUP`, `DIRECT`, `AUTONOMOUS_GROUP`; min items 3; max items 3; All three tab identifiers in the desired order, exactly once each. |
| `settings.basicGroupVisible` | No | boolean |
| `settings.directVisible` | No | boolean |
| `settings.autonomousGroupVisible` | No | boolean |
| `settings.readProcessing` | No | `AUTO`, `EXPLICIT`; Automatic or explicit read processing, matching the original settings screen. |
| `settings.maxMessageLength` | No | integer; minimum 1; maximum 1000; Direct-message text limit, 1–1000. |
| `settings.oldestFirstVisible` | No | boolean; Show the oldest-unanswered direct-chat sorting tab. |
| `settings.autonomousUploadImage` | No | boolean |
| `settings.autonomousUploadVideo` | No | boolean |
| `settings.autonomousUploadFile` | No | boolean |
| `settings.autonomousDownloadImage` | No | boolean |
| `settings.autonomousDownloadVideo` | No | boolean |
| `settings.autonomousDownloadFile` | No | boolean |
| `settings.giftingEnabled` | No | boolean; Show the direct-chat gifting option. Requires the installed Z00008 extension; does not buy or send a gift. |
| `settings.hideDistinctIdToUser` | No | boolean; Hide member distinct IDs from users in chat (Pages appearance editor dropdown; default shown). |
| `settings.groupMessageLabelVisible` | No | boolean; Show the group-message label on chat messages (Pages appearance editor). |
| `settings.sentStatusLabelVisible` | No | boolean; Show the sent-status label on chat messages (Pages appearance editor). |
| `settings.readStatusLabelVisible` | No | boolean; Show the read-status label on chat messages (Pages appearance editor). |
| `settings.onlineStateVisible` | No | boolean; Show the online-state indicator (Pages appearance editor). |
| `settings.elapsedSinceDisconnectVisible` | No | boolean; Show elapsed time since the last disconnection (Pages appearance editor). |
| `confirmToken` | No | string; pattern `^ct[a-f\d]{32}$`; The confirmToken from this tool's preview result. Omit it to preview; repeat the same input with it to execute. |