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",
            "message.im",
            "message.mpim"
         ]
      },
      "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. OPTIONAL: adjust the scopes and bot_events if you like.

• The scopes define what the agent can do in slack. Here is the full list of scopes.
• The bot_events define which types of events will cause the agent to be triggered. Without bot_events the agent can only send and not receive messages on Slack. Here the full list of events.
• Tip: With the configuration above, your agent will only be triggered if @-mentioned. If you want the agent to be triggered for all Slack messages in the channels that it is a member of, then add message.channels and message.groups to bot_events.

7. Click "Next" and "Create". Your app is now installed!
8. Copy the App ID.
9. Go to "Oauth & Permission" and press the installation button under "OAuth Tokens". After doing so you should see "Bot User OAuth Token". Copy that value as well.

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. Configure Event Subscriptions

Please note! Event subscriptions enables your agent to be triggered by events (eg new messages) on slack. If you prefer an agent that only posts to Slack, but that doesn’t listen to Slack, then this step is not necessary.

Your Slack app needs webhook configuration to notify your agent when new messages arrive:

1. While in Slack app settings, click on "Event Subscriptions" in the left sidebar
2. Set the "Request URL" to:
   • For production agents: https://agent-service-339911427090.europe-north2.run.app/api/slack/webhook
3. Ensure the "Enable Events" toggle is switched ON
4. Under "Subscribe to bot events" section, click "Add Bot User Event"
5. Add at least these events:
   • app_mention - To receive mentions in channels
   • message.im - To receive direct messages

4. Set Required OAuth Scopes

Your Slack app needs the right permissions to access channels and receive events:

1. In Slack app settings, click "OAuth & Permissions" in the left sidebar
2. Scroll to the "Scopes" section
3. Under "Bot Token Scopes", add the following scopes if they're not already present:
   • channels:read - To see public channels
   • groups:read - To see private channels
   • chat:write - To send messages
   • app_mentions:read - To receive mentions
4. If you've added new scopes, you'll need to reinstall the app to your workspace using the "Install to Workspace" button at the top of the page
5. After reinstalling, a new Bot Token will be generated. Update this in your agent platform.

5. 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 messages in these channels

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

No, Abundly is not integrated with the Microsoft ecosystem and does not use Microsoft's selection of language models. We make independent choices about which AI models to use based on performance for autonomous agent tasks.

If your Slack integration isn't working properly after following the basic setup, here are the most common issues and solutions:

1. Add the App in Slack First

Start by ensuring your app is properly added in Slack:

1. In Slack, look at the bottom of your left sidebar for the Apps section
2. Click Add apps
3. Search for and add your app
4. This enables you to chat directly with your agent in Slack

2. Configure Event Subscriptions (Critical for Listening)

Event subscriptions are necessary when you want your agent to listen to Slack messages, not just send them. If your agent isn't responding to messages, this is likely the issue:

1. In your Slack app settings, click Event Subscriptions in the left sidebar
2. Set the Request URL to: https://agent-service-339911427090.europe-north2.run.app/api/slack/webhook
3. Ensure the Enable Events toggle is switched ON
4. Under Subscribe to bot events section, click Add Bot User Event
5. Add at least these events:
   • app_mention - To receive mentions in channels
   • message.im - To receive direct messages

3. Understanding Response Behavior

With the basic configuration above, your agent will only respond to direct @mentions. If you want it to respond to general messages in channels, you need to add:

• message.groups (for private channels)
• message.channels (for public channels)

4. Invite the Agent to Channels

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

1. In each channel, type /invite @YourAgentName
2. The agent can then receive and respond to messages in those channels

5. Verify Required Scopes

Ensure your app has these OAuth scopes in OAuth & Permissions:

• channels:read - To see public channels
• groups:read - To see private channels
• chat:write - To send messages
• app_mentions:read - To receive mentions

6. Reinstall if Needed

If you've added new scopes or made configuration changes:

1. Use the Install to Workspace button in your app settings
2. Update the Bot Token in your Abundly agent settings with the new token

Still Not Working?

If you've completed all these steps and your agent still isn't responding:

1. Test by sending a direct message to your agent
2. Try @mentioning your agent in a channel where it's been invited
3. Contact support@abundly.ai with details about which specific steps aren't working

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"