Connecting Integrations

Integrations let your bots do things in other apps — send a Slack message, file a GitHub issue, create a Notion page. Connect once, then any bot or workflow can use them.

What an integration gives a bot

Integration	Example capabilities	Common bot
Slack	send channel messages, summarize threads, alert humans	Support triage bot
Gmail	read mail, draft replies, send approved messages	Daily inbox analyst
Notion	search pages, create pages, update databases	Knowledge ops bot
Telegram	receive user messages, reply from a bot channel	Community assistant
Web widget	answer visitors on your site	Customer support bot

Connect an app

1. Go to Integrations in the dashboard.
2. Pick an app (Slack, Gmail, Notion, GitHub, Calendar…) and authorize it. Most use OAuth — you approve access in the provider's own window.
3. Once connected, its capabilities become available to your bots and as App nodes in the Orchestrator.

Use it in a bot

Declare the capability and call it:

hivelang
bot Notifier {
  instructions { Post important updates to Slack. }

  capabilities {
    slack.postMessage
  }

  on user.message {
    call slack.postMessage with {
      channel: "#general",
      text: input
    }
    respond with "Posted to Slack."
  }
}

If an app isn't connected, a bot or workflow step that needs it will tell you which integration to connect.

Connect Slack

1. Open Dashboard -> Integrations.
2. Choose Slack.
3. Approve the workspace in Slack's OAuth window.
4. Pick the channels the bot is allowed to post into.
5. Test with a safe message like Hello from Bothive.

hivelang
call slack.postMessage with {
  channel: "#support",
  text: "New refund request needs review."
}

Connect Telegram

1. Create a bot in Telegram with @BotFather.
2. Copy the bot token.
3. Open Dashboard -> Bots -> Channels.
4. Choose Telegram and paste the token.
5. Save, then message your Telegram bot to confirm it replies.

Use Telegram for lightweight community bots, private assistants, and mobile-first support.

Connect Notion

1. Open Dashboard -> Integrations and choose Notion.
2. Approve access to the right workspace.
3. Select the pages or databases the bot can read/write.
4. In your bot, use Notion actions only for the pages you approved.

hivelang
call notion.createPage with {
  database: "Content Calendar",
  title: "Draft launch post",
  body: "Outline the launch announcement and next steps."
}

Connect the web widget

1. Open the bot you want to publish.
2. Go to Channels or Developer -> Embed.
3. Enable the web widget.
4. Copy the snippet into your site.
5. Test as a visitor and check Live Logs for the run trace.

Troubleshooting

Problem	Check
Bot says an app is not connected	Reconnect the provider in Integrations
Slack message fails	Confirm the bot can access that channel
Notion search is empty	Share the target page/database with the integration
Telegram does not reply	Confirm the token and webhook/channel setup
Web widget loads but cannot answer	Check bot visibility, API key, and quota

Your own apps too

Need an app Bothive doesn't list? Use Connect your own API to turn any HTTP API into a set of capabilities.

Next steps

• Connecting integrations into workflows — fire flows on app events.
• Build your first bot — give a bot real-world actions.