Skip to main content

Administrator messaging

An administrator account can reach and manage all agents its connection offers. It is separate from an agent account, which routes one bot or number to one agent. Choose the account kind when adding it; changing kind later requires removing and adding the account reference.

Set up a WhatsApp administrator number​

Open Settings → Admin, add a WhatsApp number and complete the same credential and callback steps as WhatsApp setup. Add the intended personal phone numbers to its Admin list.

catalex accounts add --platform whatsapp --name "Admin WhatsApp" --admin
catalex accounts admins list ACCOUNT_ID
catalex accounts admins add ACCOUNT_ID --phone +447700900123

Only admitted people can use it. An empty administrator list admits no one. This differs from a regular account’s empty allowlist. Use accounts admins remove to revoke someone. A remote service may require its administrator to maintain the list.

New Slack administrator bots are currently unavailable; previously configured ones continue to work. Regular Slack agent bots are supported. Do not create a regular account expecting it to have administrator authority. CatalEx-managed WhatsApp pairing, when offered, admits the paired people through its own linking flow.

Use the administrator conversation​

Send /help first to see the commands supported by your service. Common operations include:

Command or actionResult
/agentsList offered agents
/switchChoose an agent/session using the returned choices
/status allRead each agent’s selected or latest session state and connectivity
/new AGENTStart and select a fresh session for the named agent
/settings [AGENT]Inspect and change that agent’s supported settings
Reply to an agent messageContinue that agent’s session without changing the selected agent

When several agents speak in the same conversation, their messages identify the speaker. Answer a question using its own control or by replying to it; an ordinary message must not accidentally approve another agent’s request.

The settings flow can offer model, effort, writing, channels and agent limits, depending on capabilities. Deleting an agent or removing a channel asks for confirmation. Account credentials, administrator lists, account access rules and stopping CatalEx remain app/terminal operations. Check agent activity to see who changed a setting and its outcome.

Administrator commands are unavailable in ordinary agent conversations. An offline agent computer cannot apply a settings change; repair connectivity rather than repeating a command as a new request.