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

# Connect Discord

> Connect your Discord server to your AI agent on Convocore.

# Discord Integration

Welcome to the Convocore Discord integration guide! This document will help you quickly connect and configure Discord with Convocore, enabling seamless communication between your Discord server and AI agent.

## Why Integrate Discord with Convocore?

<Tip>
  Discord integration allows your AI agent to interact directly with users in
  your Discord server, providing automated responses and assistance 24/7.
</Tip>

By integrating Discord with Convocore, you can:

* Automate responses to common user queries
* Provide round-the-clock support in your Discord server
* Streamline community management and engagement

## Prerequisites

<Card title="Need Help Setting Up?" icon="question" href="https://landing.convocore.ai/">
  Our integration specialists are available to guide you through the Discord
  setup process. Reach out for personalized assistance!
</Card>

Before you start, ensure you have:

1. An active [Convocore](https://convocore.ai/) account with appropriate permissions
2. Administrative access to the Discord server where you want to add the bot

***

## Steps to Integrate Discord with Convocore

<Steps>
  <Step title="Locate Discord Integration">
    1. Log in to your Convocore dashboard
    2. Navigate to the **Channels** tab
    3. Find the **Discord** option
    4. Click on **Connect**

           <img src="https://mintcdn.com/convocore/uZzIbBiivXuGDpf1/images/discord-tut/discord0.png?fit=max&auto=format&n=uZzIbBiivXuGDpf1&q=85&s=df0d963b206b856a5161ce64ea901888" alt="Discord Integration Location" width="1920" height="1024" data-path="images/discord-tut/discord0.png" />
  </Step>

  <Step title="Add Bot to Discord Server">
    1. In the configuration modal, locate the **Add to Discord** button
    2. Click the button to open Discord's authorization window
    3. Select your target Discord server from the dropdown
    4. Review and approve the required permissions:
       * Send Messages
       * Read Messages/View Channels
       * Other relevant permissions

    {" "}

    <Warning>
      Ensure you grant all necessary permissions for the bot to function properly.
      Missing permissions may cause integration issues.
    </Warning>

    <img src="https://mintcdn.com/convocore/uZzIbBiivXuGDpf1/images/discord-tut/discord1.png?fit=max&auto=format&n=uZzIbBiivXuGDpf1&q=85&s=db2ccb80bf400c4f480e89c2cd4f0ce1" alt="Bot Authorization" width="1919" height="987" data-path="images/discord-tut/discord1.png" />
  </Step>

  <Step title="Set Up Discord Webhook">
    1. In your Discord server, navigate to the desired channel
    2. Click the gear icon (⚙️) to access **Edit Channel**
    3. Go to **Integrations** > **Webhooks**
    4. Click **New Webhook**
    5. Configure the webhook:
       * Set a name for the webhook
       * Click **Copy Webhook URL**
    6. Return to Convocore dashboard
    7. Paste the webhook URL in the **Webhook URL** field

           <img src="https://mintcdn.com/convocore/uZzIbBiivXuGDpf1/images/discord-tut/discord9.png?fit=max&auto=format&n=uZzIbBiivXuGDpf1&q=85&s=37f5717ed764505efb02bf5d32afc46e" alt="Webhook Setup" width="1919" height="988" data-path="images/discord-tut/discord9.png" />
  </Step>

  <Step title="Configure Channel ID">
    1. Return to your Discord server
    2. Right-click on the target channel
    3. Select **Copy Channel ID**
    4. Paste the ID in the **Channel ID** field on Convocore

    {" "}

    <Tip>
      If you don't see the Copy Channel ID option, ensure Developer Mode is enabled
      in Discord's Advanced Settings.
    </Tip>

    <img src="https://mintcdn.com/convocore/uZzIbBiivXuGDpf1/images/discord-tut/discord8.png?fit=max&auto=format&n=uZzIbBiivXuGDpf1&q=85&s=83dab7a980286f7e6262601861f2d5ef" alt="Channel ID Configuration" width="1849" height="916" data-path="images/discord-tut/discord8.png" />
  </Step>

  <Step title="Complete Integration">
    1. Review all entered information
    2. Click **Submit & Add Channel**
    3. Wait for confirmation message

           <img src="https://mintcdn.com/convocore/uZzIbBiivXuGDpf1/images/discord-tut/discord11.png?fit=max&auto=format&n=uZzIbBiivXuGDpf1&q=85&s=1bf964b52b903867b6195405e06f5f1b" alt="Integration Completion" width="1918" height="946" data-path="images/discord-tut/discord11.png" />
  </Step>

  <Step title="Verify Integration">
    1. Go to your Discord channel
    2. Type `ping` in the chat
    3. The bot should respond with `pong`

    {" "}

    <Note>
      If you don't receive a response, double-check the bot permissions and webhook
      configuration.
    </Note>

    <img src="https://mintcdn.com/convocore/uZzIbBiivXuGDpf1/images/discord-tut/discord12.png?fit=max&auto=format&n=uZzIbBiivXuGDpf1&q=85&s=875cc5b50896a2e6de10d1cd6278391d" alt="Integration Verification" width="1852" height="921" data-path="images/discord-tut/discord12.png" />
  </Step>
</Steps>

***

## Troubleshooting

<Note>
  Most integration issues can be resolved by verifying permissions and
  configuration settings.
</Note>

Common issues and solutions:

* **Bot not responding**: Verify bot permissions and webhook URL
* **Channel ID errors**: Ensure Developer Mode is enabled and the correct ID is copied
* **Webhook failures**: Confirm the webhook URL is valid and properly configured

## Best Practices

<Card title="Optimize Your Setup" icon="chart-line">
  Regular monitoring and maintenance of your Discord integration ensures optimal
  performance and user experience.
</Card>

* Test the bot in a private channel before deploying to public channels
* Regularly verify bot functionality
* Keep bot permissions updated as needed

## Security Considerations

<Warning>
  Protect your webhook URLs and never share them publicly. They can be used to
  send messages to your channel.
</Warning>

* Regularly audit bot permissions
* Monitor channel activity
* Update webhook settings as needed