Skip to main content

Connecting accounts

Every pre-built integration needs access to your account with the provider. VoisX supports two ways to connect: OAuth sign-in and API keys.

OAuth sign-in​

With OAuth you sign in to the provider and approve access. VoisX never sees your password.

  1. In Tools, click Add tool → From template, open the integration and click its connect button (for example Connect with Google).
  2. Sign in to the provider and review the permissions it asks for.
  3. Approve access. You return to the VoisX console and the integration shows as connected.
  4. Select the actions to enable and click Install integration.

VoisX stores the access token and refresh token for your project and refreshes the access token automatically before it expires.

Some providers need one extra value before you sign in:

ProviderExtra value
ZendeskYour Zendesk subdomain (yourcompany for yourcompany.zendesk.com)
Microsoft Dynamics 365Your environment URL, such as myorg.crm4.dynamics.com

Some providers need a value after you sign in, on the same install form:

ProviderExtra value
WhatsApp BusinessThe phone number ID of the number to send from
Google AdsYour Google Ads API developer token

OAuth integrations​

ProviderIntegrations
GoogleGoogle Workspace (Gmail, Calendar, Contacts, Drive, Sheets), Google Analytics
MicrosoftMicrosoft Teams, Microsoft 365 (Outlook, SharePoint and OneDrive), Power BI, Dynamics 365
SalesforceSalesforce
HubSpotHubSpot
ZohoZoho CRM
ZendeskZendesk
CalendlyCalendly

Each Google and Microsoft product is connected separately, so each one only asks for the permissions it needs. For example, connecting Google Sheets does not grant access to your Gmail.

note

Some organizations require an administrator to approve third-party apps. If the provider says that admin approval is required, ask your Google Workspace or Microsoft 365 administrator to approve the VoisX app, then connect again.

API keys and tokens​

Other integrations use an API key, token or service account that you create in the provider's own settings:

  1. In Tools, click Add tool → From template and open the integration.
  2. Paste the key and any other values it asks for, such as a subdomain or account ID.
  3. Select the actions to enable and click Install integration.

Keys are stored encrypted and are never shown again after you save them. Each integration page explains where to create the key and which permissions it needs.

Reconnect an account​

If the provider revokes access or a token stops working, the tool returns an error saying the connected account was rejected. To fix it, sign in again: in Tools, click Add tool → From template, open the same integration and click Reconnect.

Remove an integration​

  1. Go to Tools and find the integration group.
  2. Delete the integration. This removes all of its actions, and agents that use them lose access.

To fully revoke access, also remove the VoisX app or delete the API key in the provider's own security settings.

Was this page helpful?
On this page
Try it in the consoleBuild an agent and test it in the Playground.Open console →