> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vybe.build/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Integrations in Chat

> How the AI uses your connected integrations to fetch data, take actions, and build features during a conversation

When you chat with the AI in Vybe, it can access your connected integrations to fetch data, execute actions, and wire up your app to external services. You describe what you need in plain language, and the AI figures out which integration to use and how.

***

## How it works

The AI has access to all integrations connected to your organization (and your personal connections). When you describe what you need, the AI:

1. **Identifies the relevant integration** — Based on your prompt, the AI determines which connected service has the data or action you need.
2. **Selects the right action** — Each integration exposes a set of actions (like "list issues" or "send message"). The AI picks the appropriate one.
3. **Executes the action** — The AI runs the integration action and returns the results directly in the chat.

You do not need to specify which integration to use or how to call it. The AI handles the details.

***

## Examples

Here are common ways you can use integrations through the chat:

### Fetching data

> Show me all open Jira tickets assigned to the engineering team.

The AI uses the Jira integration to query your projects, filters for open tickets assigned to engineering, and displays the results in a formatted table.

> Pull our last 30 days of Stripe charges and display them in a table.

The AI uses the Stripe integration to fetch recent charges, then presents them in a sortable table with amount, customer, status, and date columns.

> What are our top-performing Google Ads campaigns this month?

The AI queries the Google Ads integration for campaign performance metrics and summarizes the results.

### Taking actions

> Create a Slack channel called "project-apollo" and invite the engineering team.

The AI uses the Slack integration to create the channel and send invitations.

> Create a new Jira issue in the Backend project: "Fix login timeout bug", priority High, assigned to Sarah.

The AI creates the issue in Jira with the specified details and confirms the result.

> Send an email to the team with this week's sales summary.

The AI uses the Gmail integration to compose and send the email.

### Exploring available data

> What data can I get from HubSpot?

The AI lists the available capabilities for your HubSpot connection — contacts, companies, deals, and more — so you know what is available before you build.

> Show me the fields available in our Salesforce Leads object.

The AI queries your Salesforce connection and displays the field names, types, and descriptions.

***

## Connecting integrations on the fly

If you ask the AI to use a service that is not connected yet, it will prompt you to connect it. A button appears in the chat that takes you directly to the authorization flow for that service.

For example, if you say:

> Show me our Linear issues.

And Linear is not connected, the AI will respond with a message explaining that Linear needs to be connected, along with a button to set up the connection. Once you authorize the integration, you can continue the conversation and the AI will use it immediately.

***

## Integration visibility

The AI can only use integrations you have access to. Visibility depends on how the integration was connected:

| Visibility       | Who can use it                   |
| ---------------- | -------------------------------- |
| **Organization** | All members of your workspace    |
| **You only**     | Only the person who connected it |

If you cannot see an integration in the chat, check the Integrations page to verify it is connected and that its visibility includes you. Organization-level integrations are available to everyone; personal integrations are only available to the person who connected them.

<Note>
  When building features that other team members will use, connect integrations with **Organization** visibility so the AI can access them in anyone's chat session.
</Note>

***

## What the AI can do with integrations

The AI's capabilities depend on the actions each integration exposes. In general:

| Capability  | Description                                                        |
| ----------- | ------------------------------------------------------------------ |
| **Search**  | Find records matching specific criteria                            |
| **List**    | Retrieve collections of records (issues, contacts, channels, etc.) |
| **Read**    | Get detailed information about a specific record                   |
| **Create**  | Add new records to a service                                       |
| **Update**  | Modify existing records                                            |
| **Execute** | Run service-specific actions (send email, trigger workflow, etc.)  |

Not every integration supports all capabilities. See [All Integrations](/integrations/all-integrations) for a full list of each service's available actions.

***

## Tips for effective prompts

* **Be specific about what you want.** Instead of "show me Salesforce data," say "show me all Salesforce opportunities closing this quarter with a value over \$50,000."
* **Use @mention to specify an integration.** Type `@` followed by the integration name (e.g., `@Slack` or `@Jira`) to explicitly tell the AI which integration to use. This ensures the AI knows exactly which service you mean, especially when multiple integrations could have similar data.
* **Ask what is available** if you are unsure. Prompts like "what integrations are connected?" or "what can I do with Jira?" help you discover capabilities.
* **Chain actions together.** You can ask the AI to combine multiple integrations in a single request: "Pull open Jira tickets, find the assignees in Slack, and send each person a reminder about their overdue tickets."
