Integrations FAQs

To let your agent communicate on your Slack server, you need to

Step 1: Create a Slack app

Here is a simple quick-start guide. For more comprehensive info, see api.slack.com/docs.

The easiest way to create a Slack app is to use a manifest file as a template. Copy the template below,

{
   "display_information":{
      "name":"YOUR_APP_NAME",
      "description":"YOUR_APP_DESCRIPTION",
      "background_color":"#000000"
   },
   "features":{
      "app_home":{
         "messages_tab_enabled":true,
         "messages_tab_read_only_enabled":false
      },
      "bot_user":{
         "display_name":"YOUR_BOT_DISPLAY_NAME",
         "always_online":true
      }
   },
   "oauth_config":{
      "scopes":{
         "bot":[
            "app_mentions:read",
            "channels:read",
            "chat:write",
            "groups:read",
            "im:read",
            "users:read",
            "channels:history",
            "groups:history",
            "im:history",
            "channels:join",
            "im:write",
            "mpim:history"
         ]
      }
   },
   "settings":{
      "event_subscriptions":{
         "request_url":"https://agent-service-339911427090.europe-north2.run.app/api/slack/webhook",
         "bot_events":[
            "app_mention"
         ]
      },
      "org_deploy_enabled":false,
      "socket_mode_enabled":false,
      "token_rotation_enabled":false
   }
}

1. Visit api.slack.com/apps
2. Click "Create New App"
3. Choose "From a manifest"
4. Paste the above manifest
5. Replace YOUR_APP_NAME, YOUR_APP_DESCRIPTION, and YOUR_BOT_DISPLAY_NAME with your own info.
6. Click "Next" and "Create". Your app is now installed!
7. Copy the App ID.
8. Go to "OAuth & Permissions" and press the installation button under "OAuth Tokens". After doing so you should see "Bot User OAuth Token". Copy that value as well.

Understanding bot_events (Optional Customization)

The manifest above configures your agent to only respond when @-mentioned in channels. This prevents the agent from interfering in all conversations.

• app_mention - Agent responds when @-mentioned (✅ RECOMMENDED to prevent interference)

If you want different behavior, you can modify the bot_events section:

• Add message.im - Agent responds to every direct message (1-on-1 conversations)
• Add message.mpim - Agent responds to every message in multi-person DMs
• Add message.channels and message.groups - Agent responds to ALL messages in channels it's a member of (⚠️ WARNING: This can cause the agent to interfere in conversations)

For more information:

• The scopes define what the agent can do in Slack. See the full list of scopes.
• The bot_events define which events trigger the agent. See the full list of events.

Step 2. Configure the Slack capability in Abundly

Go to Settings -> Capabilities, enable Slack, and paste in the bot token and app ID.

Step 3. Add the App in Slack

Before you can use your agent, you need to add it to your Slack workspace:

1. In Slack, look at the bottom of your left sidebar for the Apps section
2. Click Add apps
3. Search for your app by name (the YOUR_APP_NAME you used in the manifest)
4. Click to add it
5. This enables you to chat directly with your agent and use it in channels

Step 4. Invite the Agent to Channels

Your agent must be invited to any channels where you want it to respond:

1. In Slack, open each channel where you want the agent to work
2. Type /invite @AgentName (where AgentName is the name of your bot)
3. The agent can now receive and respond to @-mentions in these channels

Troubleshooting: If the manifest approach didn't work

If you created your Slack app manually (without using the manifest), you may need to configure these settings:

Event Subscriptions:

1. In Slack app settings, click "Event Subscriptions"
2. Set "Request URL" to: https://agent-service-339911427090.europe-north2.run.app/api/slack/webhook
3. Ensure "Enable Events" is ON
4. Under "Subscribe to bot events", add app_mention

OAuth Scopes:

1. In Slack app settings, click "OAuth & Permissions"
2. Under "Bot Token Scopes", ensure these are present:
   • channels:read - To see public channels
   • groups:read - To see private channels
   • chat:write - To send messages
   • app_mentions:read - To receive mentions
3. If you added new scopes, reinstall the app and update the Bot Token in Abundly

Setting up Google Drive integration allows your agent to access and create Google Drive documents. Here's the complete setup process:

Step 1: Enable the capability

1. Go to your agent's Settings → Capabilities page
2. Find "Google Drive" in the capabilities list
3. Click "Create connection" and continue in the popup window

Step 2: Google approval flow

1. You'll be directed to Google's authorization page
2. Sign in to your Google account if prompted
3. Important: Accept this specific scope when prompted:
   • "See, edit, create, and delete only the specific Google Drive files you use with this app"
4. Click "Allow" to grant permissions

Step 3: Verify connection

After authorization, your Google Drive capability should show:

• Status: Connected
• Your connected token information
• Token owner details

Step 4: Start using Google Drive

Once connected, your agent can:

• Create documents: Ask your agent to create new Google Drive documents
• Access shared files: Add existing files using the document picker under "Docs"
• File management: Work with files you've explicitly shared with the agent

Important notes

• No service account needed: You should not need to use a service account for this integration
• Personal access only: The integration uses your personal Google account
• Selective access: The agent only has access to files you explicitly share or that it creates

Troubleshooting

If you encounter issues during setup:

1. Clear browser cache: Try clearing your browser cache and cookies
2. Different browser: Test the setup process in a different browser or incognito mode
3. Check permissions: Ensure you're using a Google account with appropriate permissions
4. Contact support: If you get stuck at any step, email support@abundly.ai with:
   • Which step you're stuck on
   • Screenshots of any error messages
   • Description of what you expected vs. what happened

What the agent can do once connected

• Create new Google Drive documents
• Read and edit documents you've shared
• Generate reports and save them to Drive
• Access files through the document picker interface

Abundly has limited Microsoft integration (Outlook and SharePoint available on request). We don't use Microsoft's LLM selection—we independently choose AI models based on performance for autonomous agent tasks. See our Integrations documentation for details.

Overview

The GitHub integration enables AI agents to interact with GitHub repositories for pull request management and repository monitoring. This capability streamlines development workflows by automating common GitHub tasks.

What the GitHub Integration Can Do

Pull Request Management:

• Merge pull requests with different merge methods (merge, squash, rebase)
• List and filter pull requests by status
• Get detailed pull request information including file changes and diffs

Repository Access:

• Browse repository files and directories
• Read file contents from any branch or commit
• List repository branches
• Track recent commits and changes

Monitoring:

• Monitor repository activity
• Track changes since specific commits or dates
• Access all repositories you have permissions for

GitHub Projects Support

The GitHub integration does not currently support GitHub Projects. It focuses on repository-level operations like pull requests, commits, and file management.

Common Use Cases

• Automatically merge approved pull requests
• Generate release notes from commit history
• Monitor repository activity and send notifications
• Support code review workflows
• Track changes for release management

Getting Started

1. Enable the Capability: Go to Settings → Capabilities and enable "GitHub"

2. Create a GitHub Token:

   • Visit GitHub Settings → Personal access tokens
   • Click "Generate new token (classic)"
   • Select these scopes: repo, read:org, and workflow (if needed)
   • Copy the token immediately

3. Configure:

   • Paste your token in the "token" field
   • Optionally specify repositories in "watchedRepositories" (e.g., yourorg/project1)
   • Click "Save github Credential"