Plugins and connectors

Let your agent read and write real data in a conversation: Google Sheets, Calendar, CRMs and more.

6 min read

What it is

A plugin (also called a connector) links an app you already use to your agent. With Google Calendar the agent can book a visit. With Google Sheets it can look up a price or add a row. Plugins are set up per agent: an agent only uses the apps connected to it.

Before you start

  • Only the account owner can connect, change or remove an app. Team members can see which apps each agent uses.
  • Have the login of the app ready, for example your Google account.
  • Know which agent should use it. A connection belongs to one agent. Other agents keep their own connections.

What's live today

  • Google Workspace: Sheets, Calendar, Drive and Docs run inside a live conversation. A Gmail mailbox is a channel, not a connector: connect it under Channels, then Email.
  • CRMs: HubSpot, Zoho CRM, Salesforce, GoHighLevel, LeadSquared, and your own CRM's API.
  • Commerce and payments: Shopify, Logic ERP, Razorpay (payment check) and delivery partners for shipping quotes and tracking.
  • Scheduling: Calendly and Cal.com.
  • Team and support apps: Slack, Telegram, Discord, Notion and Freshdesk.
  • Custom HTTP tools: call any external API from a chat.
  • Lead webhook: every captured lead can be sent as a signed POST to your own endpoint. Choose it in the agent's Instructions, under Lead Destinations.

Find your apps on the Plugins page

  • Open Plugins and pick the agent at the top. Apps are grouped by kind, such as Google, Scheduling and CRM. Use Search connectors to find one.
  • Switch between All and In use to see only the apps this agent already uses.
  • Each card shows its state: Not connected, Connected, Live for this agent, Finish setup, Needs attention or Unavailable.
  • Live for this agent means the agent can use it now. Live, recheck due means it worked but was not checked in the last 15 minutes. Open it and press Re-check connection.
  • A card also shows its coverage. Full means the agent can use every action the app offers. Selected actions means only a chosen set. You still choose which channels and files it may use.

Connect an app

The Connect wizard walks you through seven steps. A bar at the top shows where you are.

  1. 1On the app's card choose Connect. The wizard opens.
  2. 2For which agent: pick the agent that will use the app.
  3. 3Pick an app: choose it from the list, or use Search apps.
  4. 4Sign in: a new tab opens. Approve access there, then come back. The sign-in link works for 10 minutes.
  5. 5Which data: pick what the agent may open, for example one spreadsheet or one calendar, or Whole account.
  6. 6What it may do: choose Look up only, Look up + add or change, or Everything. Look up + add or change never deletes or shares.
  7. 7Where: choose which channels may use the app, such as WhatsApp or your website. A channel marked Not allowed yet stays blocked until you allow it.
  8. 8Review and turn on: use Test the connection, and when it says Connection works choose Turn on for (your agent's name).

Examples

  • Google Sheets: pick the spreadsheet in Which data. Under Where, you can give each channel its own tabs, so one channel can use the price list tab and another a different tab.
  • Google Calendar: pick the calendar in Which data, then choose Look up + add or change so the agent can book.

Tell the agent when to use the app in its Instructions, for example: when a customer wants a visit, book it in the calendar.

Change or disconnect

  1. 1On the Plugins page open the app's card (the button reads Manage).
  2. 2To check it still works, choose Re-check connection.
  3. 3To remove it, choose Disconnect and confirm. This revokes the connection for this agent only. Other agents keep their own.

If a card says Sign-in expired, Sign-in failed or Turned off at the provider, choose Reconnect and sign in again.

Still need help with this setup? Contact BodhX support

Plugins and connectors · BodhX AI