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

# Talk to Your Custom AI from Social Media

> Launch your Agent Server, then connect it to Telegram, Slack, or Discord.

## Launch the Agent Server

Open **Settings → Larkup Server → Server**, switch the toggle to **Agent**, and select **Launch server**.

<Frame caption="Launching the Agent Server">
  <img src="https://mintcdn.com/larkup/13l_fOT1PJRw-f4o/documentation/images/deploy/launch-agent-server.png?fit=max&auto=format&n=13l_fOT1PJRw-f4o&q=85&s=10c9ccf1a4dbdef4fbba456a45ee7157" alt="Larkup Server settings with the Agent Server ready to launch" width="2982" height="1384" data-path="documentation/images/deploy/launch-agent-server.png" />
</Frame>

If the Agent runs on your computer, it needs a public HTTPS address for a channel provider to reach it. Larkup can start a free ngrok tunnel for you when you connect a channel below.

## Connect a channel

Open **Settings → Larkup Server → Connections** and choose Telegram, Slack, or Discord. Every channel starts the same way: pick the Agent that should answer, then connect the provider.

<Frame caption="Connections tab with Telegram, Slack, and Discord">
  <img src="https://mintcdn.com/larkup/13l_fOT1PJRw-f4o/documentation/images/connections/connection-view.png?fit=max&auto=format&n=13l_fOT1PJRw-f4o&q=85&s=44f50504c4a484c4b6895e2c007844a2" alt="Connections tab showing available channels" width="2982" height="1384" data-path="documentation/images/connections/connection-view.png" />
</Frame>

<Tabs>
  <Tab title="Telegram">
    1. Open [@BotFather](https://t.me/BotFather) in Telegram, create a bot, and copy its token.
    2. Select **Telegram**, choose the Agent that should answer, paste the token, and save.
       Larkup registers the webhook automatically.

    <Frame caption="Configuring the Telegram connection">
      <img src="https://mintcdn.com/larkup/13l_fOT1PJRw-f4o/documentation/images/connections/connect-telegram.png?fit=max&auto=format&n=13l_fOT1PJRw-f4o&q=85&s=6c4ea42f606032e3f2d2f8de80610145" alt="Configure Telegram panel" width="2982" height="1384" data-path="documentation/images/connections/connect-telegram.png" />
    </Frame>

    3. Larkup shows an **Open Telegram bot** button once it verifies the bot. Send it a message.

    <Frame caption="Chatting with the Agent through Telegram">
      <img src="https://mintcdn.com/larkup/13l_fOT1PJRw-f4o/documentation/images/connections/telegram-chat-demo.png?fit=max&auto=format&n=13l_fOT1PJRw-f4o&q=85&s=c743c77b3d09b5ca50689ab0a678b5f6" alt="Telegram conversation with the Agent" width="1662" height="946" data-path="documentation/images/connections/telegram-chat-demo.png" />
    </Frame>
  </Tab>

  <Tab title="Slack">
    1. Select **Slack**, choose the Agent, and set its endpoint. Use **Use ngrok** if the Agent runs locally.
    2. Choose **OAuth**, then **Connect with Slack** and approve the app for your workspace. A workspace admin approves it once; nobody needs to copy a token.

    <Frame caption="Configuring the Slack connection">
      <img src="https://mintcdn.com/larkup/13l_fOT1PJRw-f4o/documentation/images/connections/connect-slack.png?fit=max&auto=format&n=13l_fOT1PJRw-f4o&q=85&s=f8c9f2ddfdae68685be71c77ea537cdb" alt="Configure Slack panel" width="3012" height="1442" data-path="documentation/images/connections/connect-slack.png" />
    </Frame>

    3. Mention the bot in a channel, or message it directly.

    <Frame caption="Chatting with the Agent in Slack">
      <img src="https://mintcdn.com/larkup/13l_fOT1PJRw-f4o/documentation/images/connections/slack-chat-demo.png?fit=max&auto=format&n=13l_fOT1PJRw-f4o&q=85&s=8191fea13f08ec5d71b4987162e74425" alt="Slack conversation with the Agent" width="1840" height="855" data-path="documentation/images/connections/slack-chat-demo.png" />
    </Frame>

    Want your own Slack app, name, and icon? Choose **Credentials** instead and paste your app's bot token and signing secret.
  </Tab>

  <Tab title="Discord">
    1. Select **Discord**, choose the Agent, and set its endpoint. Use **Use ngrok** if the Agent runs locally.
    2. Choose **OAuth**, then add Larkup's Discord app to one server.

    <Frame caption="Configuring the Discord connection">
      <img src="https://mintcdn.com/larkup/13l_fOT1PJRw-f4o/documentation/images/connections/connect-discord.png?fit=max&auto=format&n=13l_fOT1PJRw-f4o&q=85&s=3856ec9558265fc1d9590de76159e92f" alt="Configure Discord panel" width="3012" height="1442" data-path="documentation/images/connections/connect-discord.png" />
    </Frame>

    3. Mention the bot in a channel.

    <Frame caption="Chatting with the Agent in Discord">
      <img src="https://mintcdn.com/larkup/13l_fOT1PJRw-f4o/documentation/images/connections/discord-chat-demo.png?fit=max&auto=format&n=13l_fOT1PJRw-f4o&q=85&s=bf9a2e511583e64ff4dac84a1ab6b614" alt="Discord conversation with the Agent" width="1842" height="854" data-path="documentation/images/connections/discord-chat-demo.png" />
    </Frame>

    Want your own Discord app? Choose **Credentials** and paste its application public key.
  </Tab>
</Tabs>

For a deployed Agent, Larkup uses its stable deployment URL automatically. No tunnel is needed.