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.
- In Tools, click Add tool → From template, open the integration and click its connect button (for example Connect with Google).
- Sign in to the provider and review the permissions it asks for.
- Approve access. You return to the VoisX console and the integration shows as connected.
- 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:
| Provider | Extra value |
|---|---|
| Zendesk | Your Zendesk subdomain (yourcompany for yourcompany.zendesk.com) |
| Microsoft Dynamics 365 | Your environment URL, such as myorg.crm4.dynamics.com |
Some providers need a value after you sign in, on the same install form:
| Provider | Extra value |
|---|---|
| WhatsApp Business | The phone number ID of the number to send from |
| Google Ads | Your Google Ads API developer token |
OAuth integrations
| Provider | Integrations |
|---|---|
| Google Workspace (Gmail, Calendar, Contacts, Drive, Sheets), Google Analytics | |
| Microsoft | Microsoft Teams, Microsoft 365 (Outlook, SharePoint and OneDrive), Power BI, Dynamics 365 |
| Salesforce | Salesforce |
| HubSpot | HubSpot |
| Zoho | Zoho CRM |
| Zendesk | Zendesk |
| Calendly | Calendly |
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.
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:
- In Tools, click Add tool → From template and open the integration.
- Paste the key and any other values it asks for, such as a subdomain or account ID.
- 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
- Go to Tools and find the integration group.
- 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.