# Integrations overview

> Connect Bookbag to the tools your store runs on — Shopify, Slack, WhatsApp, Zapier — and push events to your own systems with signed webhooks. Manage them all from your workspace.

Integrations connect Bookbag to the rest of your stack. Some feed your agent knowledge and powers (your store, your help center, your messaging platforms); others push Bookbag's events out to wherever you want them. Together they make the agent a first-class part of your operations instead of a silo.

> **WHO CAN MANAGE INTEGRATIONS:** Connectors are managed per agent, on the agent’s **Integrations** tab. Credentials are encrypted at rest and never returned in the dashboard once saved. See [Members & roles](/docs/workspace/members).

## Two kinds of integration

| Kind | Direction | Examples |
| --- | --- | --- |
| Connectors | Into Bookbag | Shopify, Stripe, Slack, Zendesk, HubSpot, Salesforce, Cal.com — ground the agent, give it powers, or hand off to a human. |
| Outbound webhooks | Out of Bookbag | Push events like a new lead or a finished conversation to your CRM, data warehouse, or Zapier. |

## The Integrations tab — per agent

Each agent has its own **Integrations** tab: a gallery of every connector Bookbag supports. Search for a service, click **Connect**, and enter its credentials. Connections are scoped to that agent, so different agents can use entirely different accounts (e.g. two agents each pointing at their own Shopify store or Stripe account) with no cross-over.

> **WHY PER-AGENT:** Agents often represent different brands, stores, or use-cases that need their own isolated credentials. Keeping connectors on the agent means each one only ever sees the accounts you connected to it.

Connecting a service only stores the credentials. To have the agent actually *use* it, add the matching connector action under that agent's **Actions** tab — there the agent picks which capability it can call (look up an order, create a ticket, fetch a subscription) and you describe when to use it.

## Available integrations

| Connector | What the agent can do |
| --- | --- |
| **Shopify** | Catalog search, order status & tracking, customer & address updates, add-to-cart. |
| **Stripe** | Signed-in customers view subscriptions & invoices, cancel/reactivate, and update billing — see [Stripe](/docs/integrations/stripe). |
| **Slack** | Post messages and hand off conversations to a channel. |
| **Zendesk / Freshdesk / Zoho Desk / Help Scout** | Escalate to a human by creating a support ticket. |
| **Intercom** | Escalate by starting an Intercom conversation. |
| **HubSpot / Salesforce** | Create and sync contacts; create leads and escalate cases. |
| **Cal.com / Calendly / Google Calendar** | Show availability and book meetings / create events. |

- [Shopify](/docs/integrations/shopify) — Ground answers in your catalog and enable live order lookups.
- [Stripe](/docs/integrations/stripe) — Identity-bound billing & subscription self-service.
- [Slack](/docs/integrations/slack) — Answer in Slack and get notified about escalations.
- [WhatsApp](/docs/integrations/whatsapp) — Two-way messaging and outbound campaigns over the Cloud API.
- [Zapier](/docs/integrations/zapier) — Connect Bookbag to thousands of apps with no code.
- [Webhooks](/docs/integrations/webhooks) — Send signed event payloads to your own endpoints.

## How connectors authenticate

Different platforms authenticate differently, but the dashboard hides the details:

- **API keys / tokens** — most connectors (Shopify, Stripe, Slack, ticketing, CRM) take their keys on the agent’s **Integrations** tab. Secrets are encrypted at rest and never shown back. See [Credentials & security](/docs/skills/credentials).
- **OAuth** — for data sources you're redirected to the provider to approve access, then bounced back connected (used by Notion knowledge import when configured).
- **Webhooks** — for messaging channels, you also register a Bookbag inbound URL on the platform. See [Deploy & channels](/docs/deploy/overview).

## What's next

- [Shopify](/docs/integrations/shopify) — The most important integration for ecommerce support.
- [Webhooks](/docs/integrations/webhooks) — Wire Bookbag events into your own systems.
- [Developer guides](/docs/developers/overview) — Build deeper custom integrations against the API.
