Skip to main content

​
What are Integrations?

Integrations connect your assistant to third-party services, allowing your flows to book appointments, check availability, and perform other actions through external APIs.

​
Setting Up an Integration

To use integration tools, you first need to connect the service:
  1. Navigate to Integrations in your team dashboard
  2. Find the integration you want to connect (e.g., Calendly)
  3. Click Connect and follow the authentication flow
  4. Enter your API key or authorise access when prompted
  5. Save the integration
Once connected, the API credentials are securely stored and automatically used by any tools that require them. You don’t need to enter API keys when configuring individual tool steps.

​
Available Integrations

Each card on the Integrations page carries a category badge: Calendar, CRM, AI Model, Communication or Built-in. For most integrations, the gear icon on a connected card opens an Integration Settings dialog. For Agentbox and Rex it opens a full page with the import settings instead.

​
AI provider keys

The AI Model cards (SCX, OpenAI, Google AI and Anthropic) let your team bring its own provider key. Every script step runs on the default model included with your plan unless you pin it to another model. Once a provider is connected, its models appear in the step’s model menu in the script editor, and steps pinned to them run on your team’s key. See Steps Overview for choosing a step’s model. Connecting a provider asks for two fields: The key and base URL are checked with the provider when you click Connect. If the check fails, the connection is not saved. If the provider is later disconnected, steps pinned to its models run on the default model until you reconnect, and the script editor marks them Model unavailable.

​
Connecting an External AI App (MCP Clients)

Integrations connect Voxworks out to other services. MCP Clients works the other way around: it lets an outside AI assistant, such as Claude, connect in to your Voxworks team to work on scripts, surveys and recommendations and look into your calls. See the MCP Connector tab for how to connect one and what it can do.

​
Requesting New Integrations

Additional integrations are available on request. If you see an integration in the Integrations page that isn’t yet connected:
  1. Click on the integration you’re interested in
  2. This flags your interest to the Voxworks team
  3. We’ll follow up to discuss your requirements and enable the integration
Integrations are typically built out for specific clients, so the full functionality of a given third-party application’s interface might not be available. If your team needs additional features from a connected application, contact the Voxworks team directly to discuss what can be added.

​
How Integrations Work with Tools

When you add a tool step that requires an integration (like a Calendar Booking tool):
  1. The tool automatically retrieves the API credentials from your team’s integrations
  2. No manual API key entry is needed in the flow configuration
  3. If the integration is not connected, the tool does not appear in the tool picker; a step that already uses it fails on calls (for calendar tools the step follows its failure branch) until you reconnect.
This means you can:
  • Configure integrations once at the team level
  • Use integration tools across multiple scripts without re-entering credentials
  • Update API keys in one place when they expire

​
Troubleshooting

If an integration tool fails:
  1. Check integration status — Verify the integration is connected in Integrations
  2. Refresh credentials — Some tokens expire; reconnect the integration if needed
  3. Check permissions — Ensure the API key has the required permissions
  4. Review error messages — Tools write error details to spoken error variables (e.g., [Calendar - Booking Error - Spoken])

​
Next Steps