Sazabi
Sandbox CLIs

Twilio

Give the Sazabi agent the Twilio CLI (twilio) in its sandbox to manage Twilio resources and inspect messaging and voice activity.

About

This CLI connection makes the Twilio CLI (twilio) available in the Sazabi agent's sandbox. The tool is baked into the sandbox image; connecting it authenticates (or configures the connection for) the already-installed CLI.

Prerequisites

  • A Sazabi project.
  • Your Twilio Account SID (TWILIO_ACCOUNT_SID), a Twilio API key (TWILIO_API_KEY), and the corresponding API secret (TWILIO_API_SECRET). Create an API key in the Twilio Console under Account > API keys & tokens.

Set up in the dashboard

Configure the sandbox in the dashboard under Settings > Sandbox CLIs.

Find Twilio in the catalog

In Settings > Sandbox CLIs, find Twilio under Browse sandbox CLIs and choose to connect it.

Provide credentials

Enter the required values: TWILIO_ACCOUNT_SID (your Twilio Account SID, beginning with AC), TWILIO_API_KEY (your Twilio API key SID, beginning with SK), and TWILIO_API_SECRET (the secret paired with that API key). Save to store them securely; Sazabi injects them into the sandbox when the agent runs.

Set up with the CLI

You can also configure the Twilio CLI connection with the Sazabi CLI (installed and authenticated — see CLI reference).

sazabi sandbox-clis set --type twilio --env TWILIO_ACCOUNT_SID=<your-account-sid> --env TWILIO_API_KEY=<your-api-key-sid> --env TWILIO_API_SECRET=<your-api-key-secret>

To validate the credentials without saving, run the same command with test in place of set (the test command also requires the --env flags).

Verify

Ask the agent, in a thread, to run the twilio CLI (a read-only or status command) and confirm it returns real output. If the command is not found, the CLI connection may not be enabled; if it runs unauthenticated or cannot connect, recheck the credentials.

Troubleshooting

Command not found — Confirm the Twilio CLI connection is enabled for the project under Settings > Sandbox CLIs.

Authentication or connection fails — Recheck the credential/connection values under Settings > Sandbox CLIs.

Further reading