​
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?

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

Need Help Setting Up?

Our integration specialists are available to guide you through the Discord setup process. Reach out for personalized assistance!
 Before you start, ensure you have:
  1. An active Convocore account with appropriate permissions
  2. Administrative access to the Discord server where you want to add the bot

​
Steps to Integrate Discord with Convocore

1

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 Discord Integration Location
2

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
Ensure you grant all necessary permissions for the bot to function properly. Missing permissions may cause integration issues.
Bot Authorization
3

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 Webhook Setup
4

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
If you don’t see the Copy Channel ID option, ensure Developer Mode is enabled in Discord’s Advanced Settings.
Channel ID Configuration
5

Complete Integration

  1. Review all entered information
  2. Click Submit & Add Channel
  3. Wait for confirmation message Integration Completion
6

Verify Integration

  1. Go to your Discord channel
  2. Type ping in the chat
  3. The bot should respond with pong
If you don’t receive a response, double-check the bot permissions and webhook configuration.
Integration Verification

​
Troubleshooting

Most integration issues can be resolved by verifying permissions and configuration settings.
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

Optimize Your Setup

Regular monitoring and maintenance of your Discord integration ensures optimal performance and user experience.
  • Test the bot in a private channel before deploying to public channels
  • Regularly verify bot functionality
  • Keep bot permissions updated as needed

​
Security Considerations

Protect your webhook URLs and never share them publicly. They can be used to send messages to your channel.
  • Regularly audit bot permissions
  • Monitor channel activity
  • Update webhook settings as needed