Sofia Sales CLI

Command-line client for the Sofia Sales API.

npm install --global @sofiasales/cli

For an interactive, read-only session, pair this computer in a browser:

sofia login

The read-only browser credential expires after 30 days. Its secret is stored in macOS Keychain, Linux Secret Service, or Windows DPAPI; it is never written to the normal CLI config file. sofia logout revokes the credential on the server and removes it locally. API credentials remain the intended method for CI and sending.

export SOFIA_API_KEY='...'
export SOFIA_API_SECRET='...'
sofia diagnose
sofia contacts marina
sofia agenda confirmed

Set SOFIA_API_URL to a HTTPS Sofia Sales origin only when needed. Browser login accepts the production origin by default; local development also requires SOFIA_CLI_ALLOW_CUSTOM_ORIGIN=true. Set SOFIA_CHANNEL_ID to scope message and agenda requests to one channel.

Replying requires an explicit confirmation and an idempotency key:

sofia messages reply +5511999999999 'Olá!' --confirm --idempotency-key reply-20260826-001