Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.voxworks.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

IntegrationDescription
CalendlyAppointment booking, availability checking, and cancellation
O365 BookingsComplete O365 Bookings flow with availability, booking, SMS confirmation, and cancellation

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

How Integrations Work with Tools

When you add a tool step that requires an integration (like Calendly - Book Time):
  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