Skip to main content

​
I cannot create or change an agent

Check the workspace switcher and your role. Viewers can review content. Editors and above can build and test agents; shared connections require Admin or Owner access. Manage user API keys through Labs. Phone and campaign controls also require the Labs super_user role.

​
A browser test has no audio

  1. Allow microphone access for the console in your browser and operating system.
  2. Check the selected input and output devices and try headphones.
  3. Open AI connections and confirm the required services and credentials are saved.
  4. End the test before starting another. If the connection fails, retry on a network that allows browser voice calls.

​
The agent uses old instructions

Save the draft, then test it. Production API routes use the published version. Publish the draft after you have verified it, and confirm that your integration targets the intended agent UUID or API Trigger UUID.

​
A phone call does not connect

Open Phone numbers and confirm the provider credentials, outbound default, and caller number. Enter the destination with its country code, such as +14155550100. Check the provider’s call record for restrictions or delivery errors. For incoming calls, check the number’s Inbound workflow assignment and follow the provider setup.

​
An API request fails

Use the correct host and the Labs credential required by the endpoint. API-key requests also require your workspace ID. Check the HTTP status and response body before retrying. A run-start request can place a call even if your application loses the response, so check recent runs before submitting it again. See authentication and errors.

​
A tool or webhook does not deliver data

Confirm the endpoint, HTTP method, credential, and parameter names. Test the endpoint from your own application, then inspect the tool or webhook result in the conversation. A webhook receiver should return promptly; save slow processing for your own background work.

​
Get help

Ask your workspace administrator or contact Bandwidth Labs. Include the agent ID, run ID, approximate time and timezone, and the visible error. Remove API keys, provider secrets, and unnecessary customer data from anything you share.