Connectors Overview
Connect CRMs, helpdesks, messaging, commerce, and payment tools with your own account — their actions become available to every agent automatically.
Connectors are pre-built integrations with third-party services. Each one is a small set of ready-made actions (create a lead, send a message, look up an order) that your voice agents can call as tools during a conversation — no HTTP request building required.
How connectors work
- Org-scoped: a connector is connected once per organization, not per agent. Go to /connectors to connect one.
- Bring your own account: connecting a service uses your organization's own account and credentials. Talkr never operates these services on your behalf beyond making the authenticated calls your agents trigger.
- Automatic tool availability: once a connector is connected, its actions appear automatically in every agent's tool picker for your organization — there's no separate step to register each action as a tool.
Attaching a connector's action to a workflow node and guiding the LLM on when to call it works the same way as any other tool. See Tools for that general mechanism (attaching tools to nodes, how the LLM decides when to call them, best practices for descriptions).
Auth types
Connectors use one of three authentication models:
OAuth2
You register your own app with the provider (Client ID/Secret, plus any provider-specific field like a subdomain), then authorize Talkr against it. Talkr never sees your provider login — only the resulting access token.
API Key
You paste an API key or access token generated in the provider's own dashboard. Stored as an encrypted organization credential.
Request Access
Truecaller, Google Verified Calls, and Google Verified SMS require manual business verification with no self-serve API. You submit an intake form and the Talkr team completes enrollment on your behalf. These three have no agent-callable actions — they affect how outbound calls/SMS are branded, not what an agent can do mid-call.
For OAuth2 connectors, Talkr shows you a redirect URI to register in your provider app (e.g. https://talkr.intelstacks.com/api/v1/credentials/oauth/hubspot/callback for HubSpot on the hosted instance). Register it, then paste your app's Client ID and Client Secret back into Talkr and continue to the provider's consent screen.
Google Calendar and Gmail share a single Google OAuth app — authorizing one connects both. Zoho Suite (CRM) and Zoho Desk work the same way, sharing one Zoho OAuth app.