Integrations

Last updated By CloudaxAutomation

Connect third-party services to enhance your agents' capabilities. Integrations allow your AI agents to take real-world actions during conversations: booking meetings, looking up contact records, taking card payments, and syncing data with the tools your team already uses. Cloudax Connect currently supports Calendly for scheduling, HubSpot for CRM, and Cloudax Payments for in-call card collection. It also connects to your own infrastructure: save a Twilio account to reuse across number imports, and stream call telemetry to any OpenTelemetry backend for observability.

OAuth pop-up windows

Connecting an integration opens an OAuth authorisation pop-up. If your browser blocks pop-ups, you may need to allow them for the Cloudax Connect domain before proceeding. Check your browser's address bar for a blocked pop-up indicator.

Availability

Integration access depends on the workspace's connection entitlements and on the external service being configured. Standard CRM and carrier connections are not included in the entry self-serve tier; Enterprise arrangements can include the broader connection set, including telemetry export.

Calendly

Overview

Calendly lets agents check availability and book or cancel meetings during a call. Connect Calendly once for the workspace, then turn it on for each agent and choose which meeting types it may offer.

Connecting Calendly

Open Integrations or the agent

From the main sidebar open Integrations , or open an agent and choose Integrations. You can connect from either place.

Click Connect on Calendly

Choose Connect on Calendly. A sign-in window opens.

Authorise Calendly

Sign in to Calendly and allow Cloudax Connect to read your availability and create or cancel meetings. Click Allow to finish.

Wait for confirmation

The window closes and Calendly shows as connected for the workspace. This usually takes a few seconds.

Meeting types

Open an agent, go to Integrations , open Calendly, and choose which meeting types the agent may offer. Leave none selected to allow every type on the connected account.

If you add or change meeting types in Calendly, open the agent again so the list refreshes. Types you previously chose that no longer exist can be removed from the settings.

Using in agents

With Calendly connected, open the agent and turn on Use Calendly on calls . Choose whether the agent may book or cancel meetings. Deploy the agent when you are ready for the change to go live.

HubSpot

Overview

The HubSpot connection lets an agent update the caller’s contact after each call. Cloudax Connect finds the contact by phone or email, creates one if needed, and writes the fields you mapped from the call.

Connecting HubSpot

Open Integrations or the agent

From the main sidebar open Integrations , or open an agent and choose Integrations. You can connect from either place.

Click Connect on HubSpot

Choose Connect on HubSpot. A sign-in window opens.

Authorise HubSpot

Sign in to HubSpot, pick the portal to connect, grant access to contacts, and click Approve.

Wait for confirmation

The window closes and HubSpot shows as connected for the workspace. This usually takes a few seconds.

What gets written

After each call for an agent with HubSpot turned on, Cloudax Connect updates the contact using the fields you chose. Map the caller’s phone and optional call summary , then add any other details you want stored as contact properties.

Nothing is written until you turn HubSpot on for that agent and deploy. Agents that were only connected before this setting stay off until you enable them.

Using in agents

With HubSpot connected, open the agent, go to Integrations , and turn on Update HubSpot after each call . Choose the contact fields, add any extra details, then deploy. Only agents you switch on write to HubSpot.

Cloudax Payments

Overview

Cloudax Payments lets your voice agents collect card payments mid-call by sending the caller a one-time secure link over SMS. The caller pays from their handset, the agent confirms when the transaction completes, and the result is recorded against the call and any related ticket or order. PAN, CVV, and expiry data never touch your agent or our systems; Cloudax Payments is powered by an underlying PCI-compliant provider, and the agent only ever sees the outcome.

Connecting Cloudax Payments

From the Integrations page, click Connect on the Cloudax Payments card. You'll be asked for a small set of credentials supplied by your Cloudax onboarding contact:

  • Display name: A friendly label (e.g. “Production Pay”).
  • Client ID and Client Secret: Your provider credentials.
  • Base URL and OAuth Token URL: Pre-filled with the sensible defaults for our hosted environment; override only if you've been told to.
  • Return URL: Where the caller's browser lands after they pay.
  • SMS Alpha Tag: The short sender name shown when the payment link SMS arrives.

After saving, click Test connection to verify the credentials, then Copy webhook URL and configure it inside your payment provider's portal so payment outcomes flow back to Cloudax Connect. You can rotate the webhook secret at any time from the same panel without re-entering your OAuth credentials.

Using in Agents

Once connected, open the agent you want to enable payments for and switch on the Payments option in the agent editor. If your workspace has more than one payment provider configured you can pick which one this agent uses. The agent can then ask for and confirm payment amounts during a call; it sends the SMS link, stays on the line to talk the caller through it, and reads back the result once the callback comes in.

Tracking Payments

Once any agent has Cloudax Payments enabled, a Payments entry appears in the sidebar. The Payments page is a real-time table of every link the platform has issued: status (sent / processing / paid / failed), amount, customer mobile, the agent and call that initiated it, and a deep-link straight into the originating call log. Status updates stream over the same realtime channel as the calls dashboard, so a payment flips from processing to paid on screen the moment the webhook lands (no refresh required).

The sidebar entry only appears once you have at least one payments provider connected, so workspaces that don't use Cloudax Payments never see it.

Twilio Accounts

Overview

Connect one or more Twilio accounts to your workspace so their credentials are entered once and reused every time you import, buy, or manage a phone number (no more pasting an Account SID and Auth Token into every import). Accounts belong to the whole workspace, so any team member with the right permission can use a saved account without ever seeing the secret token.

Your credentials are encrypted at rest

The Account SID is stored in plaintext (it's an identifier, not a secret), but the Auth Token and any regional token are protected with envelope encryption, the same mechanism used for Cloudax Payments credentials. The token is never returned to the browser; cards only ever show a masked SID.

Connecting a Twilio account

Open the Integrations page

From the main sidebar, navigate to the Integrations page and find the Twilio card.

Open the account manager

Click Connect (or Manage if you already have accounts) to open the Twilio Accounts dialog.

Add the account

Enter a friendly name, the Twilio Account SID and Auth Token, and choose the account's region. Cloudax verifies the credentials against Twilio before saving, so a wrong token is caught immediately.

Reuse it anywhere

The saved account is now selectable wherever you import or buy Twilio numbers. Imported numbers stay linked to the account they came from, so credential lookups keep working.

Managing accounts

Each account row shows its friendly name, masked SID, region, and how many numbers were imported through it. You can re-verify credentials, update details, or disconnect an account you no longer use. Disconnecting is a soft action; numbers already imported keep working, so removing an account never breaks live routing.

OpenTelemetry Traces

Overview

Export a full trace of every completed call to your observability stack. When a call ends, Cloudax turns it into an OpenTelemetry (OTLP) trace: a root cloudax.conversation span with a child span per conversation turn (cloudax.recv.user_transcript, cloudax.recv.agent_response) and per tool call (cloudax.tool.*), annotated with latency, token, and cost attributes. Use it to monitor agent performance, debug slow turns, and keep a durable record of conversations in the tools you already run.

Works with any OTLP backend

Traces are sent as standard OTLP/HTTP JSON (a POST to {endpoint}/v1/traces), so any OpenTelemetry-compatible backend can ingest them. The dialog includes one-click presets for Grafana Tempo / Grafana Cloud, Honeycomb, and Datadog, plus a Custom / Generic OTLP option for self-hosted collectors or any other vendor.

Connecting a backend

Open the OpenTelemetry card

On the Integrations page, click Connect on the OpenTelemetry card to open the configuration dialog.

Pick your backend

Choose your vendor from the Backend dropdown. This pre-fills the endpoint placeholder and seeds the expected authentication header (for example x-honeycomb-team, DD-API-KEY, or Authorization); everything stays editable.

Enter the endpoint and auth headers

Paste your collector's OTLP endpoint. You can provide either the base host or a full /v1/traces URL; the path is added automatically when omitted. Add any authentication headers your backend requires as key/value pairs; header values are encrypted and never shown again.

Test the connection

Click Test connection to ship a small health-check span. Cloudax reports whether your backend accepted it, so you can confirm the endpoint and credentials before going live.

Save

Click Connect. Post-call export is on by default; every call now streams to your backend as it ends.

Post-call export

With Post-call export enabled, Cloudax automatically ships a trace to your backend after each call ends. Delivery is best-effort so observability never interferes with call handling; if your collector is briefly unreachable, the call itself is unaffected and you can always re-fetch the trace on demand (below). Toggle this off from the dialog if you only want on-demand exports.

On-demand export via the API

You can fetch any call's trace at any time from the public API by adding ?format=opentelemetry to the call-log endpoint. The response includes an otlp_traces object alongside the normal call data:

Fetch OTLP trace
GET /api/v1/call-logs/{id}?format=opentelemetry

This uses the same call-logs:read API-key scope as the rest of the call-logs API and is the reliable path for backfilling or re-processing historical calls. See the Developers reference for API keys and scopes.

Redaction is respected

If a call has been redacted for data-protection reasons, its transcript content is omitted from the exported trace while span timing and metrics are preserved, so your dashboards stay accurate without leaking personal data.

Managing Integrations

Each integration card on the Integrations page displays key information at a glance:

  • Connection status: a green badge for connected, grey for disconnected.
  • Authorised user: the name and email of the account that authorised the connection.
  • Last sync time: when data was last pulled from the third-party service.

Disconnecting an Integration

To disconnect a service, click the Disconnect button on its card. This revokes the OAuth token and removes the connection. Any agents that had the integration enabled will no longer be able to use its features; make sure to update those agents or disable the integration toggle in their settings first.

Refreshing Tokens

OAuth tokens are refreshed automatically behind the scenes. If a token expires unexpectedly (for example, if you revoke access from the third-party service directly), the integration card will show a warning status. Simply click Reconnect to re-authorise and restore the connection.