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

# Integrations

> Connect Bothive agents to 25+ native tools — GitHub, Gmail, Slack, Stripe, Notion, and more.

<div className="hero-container">
  <h1 className="hero-title">
    Integrations
  </h1>

  <p className="hero-subtitle">
    25+ native integrations ready to connect. OAuth-managed, production-grade, and available in HiveLang capabilities.
  </p>
</div>

## Communication

<CardGroup cols={3}>
  <Card title="Telegram" icon="telegram" className="glass-effect">
    Send messages, receive updates, manage groups. Full bot API support.

    `telegram.sendMessage` `telegram.getUpdates`
  </Card>

  <Card title="Slack" icon="slack" className="glass-effect">
    Post messages, read channels, create threads, manage DMs.

    `slack.postMessage` `slack.readChannel`
  </Card>

  <Card title="Gmail" icon="envelope" className="glass-effect">
    Read, draft, send, and label emails. Full OAuth2 flow managed by Bothive.

    `gmail.readEmail` `gmail.sendEmail` `gmail.createDraft`
  </Card>

  <Card title="WhatsApp" icon="whatsapp" className="glass-effect">
    Send and receive messages via WhatsApp Business API.

    `whatsapp.sendMessage` *(beta)*
  </Card>

  <Card title="Discord" icon="discord" className="glass-effect">
    Bot messages, channel management, and server events.

    `discord.sendMessage` `discord.getChannels`
  </Card>

  <Card title="Twitter / X" icon="x-twitter" className="glass-effect">
    Post tweets, read timeline, reply to mentions, scheduled posting.

    `twitter.post` `twitter.readTimeline`
  </Card>
</CardGroup>

## Productivity & Docs

<CardGroup cols={3}>
  <Card title="Notion" icon="file-alt" className="glass-effect">
    Create, read, and update Notion pages and databases.

    `notion.createPage` `notion.queryDatabase`
  </Card>

  <Card title="Google Calendar" icon="calendar" className="glass-effect">
    Check availability, create events, send invites.

    `google_calendar.createEvent` `google_calendar.checkAvailability`
  </Card>

  <Card title="Google Drive" icon="folder" className="glass-effect">
    Read and create documents, spreadsheets, and slides.

    `google_drive.readFile` `google_drive.createDoc`
  </Card>

  <Card title="Airtable" icon="table" className="glass-effect">
    Read and write records to any Airtable base.

    `airtable.getRecords` `airtable.createRecord`
  </Card>
</CardGroup>

## Developer Tools

<CardGroup cols={3}>
  <Card title="GitHub" icon="github" className="glass-effect">
    Read repos, create issues, review PRs, post comments, search code.

    `github.createIssue` `github.getPRDiff` `github.addComment`
  </Card>

  <Card title="Jira" icon="jira" className="glass-effect">
    Create, update, and query Jira issues and projects.

    `jira.createIssue` `jira.getIssues`
  </Card>

  <Card title="Linear" icon="circle-dot" className="glass-effect">
    Create issues, update status, and query projects.

    `linear.createIssue` `linear.getIssues`
  </Card>
</CardGroup>

## Payments

<CardGroup cols={3}>
  <Card title="Stripe" icon="credit-card" className="glass-effect">
    Read customer subscriptions, invoices, and payment status.

    `stripe.getCustomer` `stripe.getInvoice`
  </Card>

  <Card title="Paystack" icon="money-bill" className="glass-effect">
    African payments. Check transactions, subscriptions, and customers.

    `paystack.verifyTransaction` `paystack.getSubscription`
  </Card>

  <Card title="Lemon Squeezy" icon="lemon" className="glass-effect">
    Manage digital product subscriptions and license keys.

    `lemonsqueezy.getOrder` `lemonsqueezy.getLicense`
  </Card>
</CardGroup>

## AI Providers

<CardGroup cols={2}>
  <Card title="OpenAI" icon="brain" className="glass-effect">
    GPT-4o, GPT-4o mini, GPT-4 Turbo. Streaming supported.

    Used in: `model: gpt-4o`
  </Card>

  <Card title="Anthropic" icon="robot" className="glass-effect">
    Claude 3.5 Sonnet, Claude 3 Opus, Haiku. Best for complex reasoning.

    Used in: `model: claude-3-5-sonnet`
  </Card>

  <Card title="Google Gemini" icon="google" className="glass-effect">
    Gemini 1.5 Pro, Gemini Flash. Multi-modal support.

    Used in: `model: gemini-1-5-pro`
  </Card>

  <Card title="Groq" icon="bolt" className="glass-effect">
    Ultra-fast inference for latency-critical agents.

    Used in: `model: groq/llama-3-70b`
  </Card>
</CardGroup>

## HiveLang v5 capability examples

### Communication agent

```hivelang theme={null}
bot NotificationBot {
  description: "Sends notifications across channels"

  capabilities {
    slack.postMessage
    telegram.sendMessage
    gmail.sendEmail
  }

  instructions {
    Send the same notification to Slack, Telegram, and email
    when triggered. Format the message appropriately for each channel.
  }

  on input {
    call slack.postMessage with { channel: "#alerts", text: input }
    call telegram.sendMessage with { chat_id: env.ALERT_CHAT_ID, text: input }
    call gmail.sendEmail with { to: env.ALERT_EMAIL, subject: "Alert", body: input }
  }
}
```

### Developer assistant

```hivelang theme={null}
bot PRReviewer {
  description: "Reviews GitHub pull requests automatically"

  capabilities {
    github.getPRDiff
    github.addComment
    github.labelPR
  }

  instructions {
    Review pull requests for:
    - Security vulnerabilities (critical — always flag)
    - Performance issues
    - Code style violations
    - Missing test coverage

    Be constructive. Label PRs as needs-review or approved.
  }
}
```

## Custom integrations

Don't see your tool? Build a custom integration with any REST or GraphQL API:

```hivelang theme={null}
bot CRMBot {
  description: "Connects to our custom CRM"

  capabilities {
    crm.getContact
    crm.updateContact
  }
}
```

Then define the capability handler in your integration config — specify the endpoint, auth method (API key, Bearer, or OAuth2), and response schema.

See the [Custom Integrations guide](/guides/custom-integrations) for the full walkthrough.

## Integration capability reference

| Integration     | Capability                    | Type  | Auth      |
| --------------- | ----------------------------- | ----- | --------- |
| GitHub          | `github.createIssue`          | Write | OAuth2    |
| GitHub          | `github.getPRDiff`            | Read  | OAuth2    |
| Gmail           | `gmail.readEmail`             | Read  | OAuth2    |
| Gmail           | `gmail.sendEmail`             | Write | OAuth2    |
| Slack           | `slack.postMessage`           | Write | OAuth2    |
| Notion          | `notion.createPage`           | Write | OAuth2    |
| Stripe          | `stripe.getInvoice`           | Read  | API Key   |
| Paystack        | `paystack.verifyTransaction`  | Read  | API Key   |
| Telegram        | `telegram.sendMessage`        | Write | Bot Token |
| Google Calendar | `google_calendar.createEvent` | Write | OAuth2    |

## Next reads

<CardGroup cols={3}>
  <Card title="Custom Integrations" icon="wrench" href="../guides/custom-integrations" className="glass-effect" />

  <Card title="Integration Capabilities" icon="list" href="../guides/integration-capabilities" className="glass-effect" />

  <Card title="Build Your First Agent" icon="hammer" href="../guides/build-your-first-agent" className="glass-effect" />
</CardGroup>