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

​
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 application connect in to your scripts and flows, so you can work on a script from that application instead of the script editor. Go to Settings > MCP Clients to see and manage these connections.

​
Authorising an app

You start the connection in the other application. It sends you to a Voxworks screen headed Authorize {clientName}, which explains that “{clientName} is requesting access to your Voxworks scripts and flows”, then lists under This will allow it to: exactly what it is asking for: Below that is a Team picker — “The client will act within this team’s data.” Pick the team the app should work in. Then choose Approve or Deny. If something goes wrong you will see one of three outcome pages: MCP access is not enabled, Authorization cancelled, or Authorization error.

​
Managing connected apps

The MCP Clients page has one card, Connected MCP Clients — “Applications you have authorized to access your scripts and flows over MCP. Revoke a client to immediately cut off its access.” Each row shows the application and the date it was connected, as Authorized {date}. With nothing connected the card reads No connected clients yet. Revoking a client cuts its access off straight away. The app has to be authorised again from scratch before it can read or change anything.

​
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 will fail with an error
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