All pages
Powered by GitBook
1 of 4

Loading...

Loading...

Loading...

Loading...

Social Agents

Integration with Social Platforms

Social Agents are specialized AI-driven accounts that can engage on behalf of your project across major platforms. They help you automate community management, amplify your reach, and keep engagement consistent.

Unlike trading agents in the terminal, social agents are currently managed through our web UI. This gives you a simple interface for connecting accounts, setting up behavior, and monitoring engagement.

Current Capabilities

Twitter/X Integration

  • Make posts directly from your agent.

  • Automatically reply to mentions.

  • Schedule recurring updates (e.g., daily stats).

  • Amplify token launches and community news.

Telegram & Discord

  • Agents will join your community chats.

  • Answer FAQs, provide updates, and moderate discussions.

  • Deliver scheduled content (e.g., token stats, event reminders).


Why Social Agents Matter

  • Consistency: Keep your community engaged 24/7.

  • Scalability: Handle larger audiences without scaling your human team.

  • Personalization: Agents can adopt specific tones and personalities to reflect your project’s brand.


How They Relate to the Terminal

While social agents are currently managed through the UI, they are being built to eventually connect seamlessly into the terminal. This means in the near future you’ll be able to:

  • Type in the terminal: “Have my agent post daily updates on X.”

  • Or: “Summarize our community sentiment from Telegram this week.”

For now, setup and management are done via the UI, but all roads lead toward a single command center in the terminal.

Discord Agent Integration Walkthrough

Create a Discord Application

  1. Go to

  2. Click "New Application" and give your application a name

Configure Discord Bot

  1. Click on Bot.

  2. Set a username and a nice unique icon for your bot.

  3. Toggle "Public Bot" off (if you don't want others to invite it).

  4. Enable "Message Content Intent" (for reading messages).

  5. Copy the Token (click "Reset Token" if needed, then store it safely).

Invite the Bot to your Server

  1. Go to the OAuth2 tab → OAuth2 URL Generator

  2. Under OAuth2 URL Generator, check bot

  3. Under Bot Permissions, check the appropriate text permissions you want. See screenshot fo recommended permissions

  4. Keep integration type to Guild Install

  5. Copy the generated URL and paste it on your browser to add the bot to your server

  6. Authorize your bot on your server

  7. Make sure you give your bot permissions on the channels you want it to interact with

Configure Discord Agent in aigentOS

  1. Go to your agent's configuration page. Under aigentOS, click the Discord Tab. Configure accordingly and click Save Agent Settings button

  2. And then click the Settings Tab

  3. Paste your Bot Token in the Discord Bot Token text box

  4. Add channel IDs you want your Discord agent to interact with. You can copy the channel id by right-clicking the channel in Discord and clicking Copy Channel ID from the context menu. And then paste the channel id in the textbox and click Add.

  5. Click the "Send Test Message" button in to verify that you have the correct channel ID. Remember that the Discord bot you created needs to have the correct permission in the channel you added.

Discord Developer Portal

X (Twitter) API Key Walkthrough

Setting up your agent on X is easy

Step 1 :Create a Twitter Developer Account and App

  • Sign-in with agent X account

  • Go to

Pick a tier

  • Setup billing for paid tier, or skip with free tier

Step 2: Get Twitter API Keys and Tokens

  • Navigate to User authentication settings under your app

  • Click Set up and configure authentication settings

  • Select Read & Write Access when configuring User Authentication

  • Provide following details and save them

  • Inside your app, navigate to Keys and tokens

  • Generate the following credentials

Step 3: Configure Twitter API in aigent.run

  • Open aigent.run and navigate to the Configure Agent page

  • Go to X (Twitter) → X Account tab

  • Enter the API credentials

  • Set the Agent Handle (your Twitter handle for the bot)

  • Select a suitable API Tier

    • Free

    • Basic

    • Pro

    • Enterprise

  • Click Save X API Settings

Step 4: Verify Connection

  • Click Test validity of credentials to check if Twitter credentials are working

  • If successful, your agent will now be able to interact with Twitter

https://developer.x.com/en

Telegram API Key Walkthrough

Simple Step-by-Step Guide

Step 1: Create Your Telegram Bot

  • Open Telegram and start a chat with BotFather.

  • Type the command /newbot to create a new bot.

  • Follow the prompts to:

    • Set a name for your bot.

    • Set a unique username (must end in bot).

  • Once done, you’ll receive a bot token (e.g., 123456789:ABCdefGhIjKlmNoPQRstuVWXyz).

More detailed tutorial here -

Keep this token secure. You’ll use it later on aigent.run.

Step 2: Add Bot Token to aigent.run

  • Visit and go to the Configuration tab.

  • Paste your bot token into the Bot Token field.

  • Click Save.

  • Use the Test Credentials button to check that the bot is connected correctly.

Step 3: Add the Bot to a Telegram Group

  • Create a new Telegram group or use one where you're already an admin.

  • Add your newly created bot to the group.

  • Once added, tap the group name → Manage Group → Administrators.

  • Promote your bot to Administrator status.

Step 4: Get the Group Chat ID

To get the chat ID you have to follow these steps:

  • Add @myidbot to the group you want to enable the agent in, and make it an Admin.

  • Contact the bot and send the /getid command to get your personal chat ID, or invite it into a group and use the /getgroupid command to get the group chat ID.

  • To get the Thread ID, the easiest way is this: Post a message to that topic, then right-click on it and select Copy Message Link. Paste it on a notepad and notice that it has the following structure https://t.me/c/XXXXXXXXXX/YY/ZZ

Step 5: Add the Chat ID to aigent.run

  1. Go back to the Configuration tab on aigent.run.

  2. Paste the Chat ID into the appropriate field.

  3. Click Send Test Message.

If everything is set up correctly, you’ll receive a message in your Telegram group saying:

"This is a test message from your AIgent."

That’s it! Your Telegram bot is now ready to send messages through aigent.run.

. The Thread ID is
YY
(integer).
core.telegram.org/bots/tutorial
aigent.run
@myidbot