Setup Guides

Tools & Integrations.

Connect your workspace tools to enable your agent fleet. Each integration requires an API key or OAuth token — follow the steps below to get yours.

Integration

Slack.

Agents use Slack to communicate status updates, request approvals, and report incidents. You'll create a Slack App with Bot and User tokens.

01
Create a Slack App

Go to the Slack API portal and create a new app from scratch. Choose your target workspace.

URL https://api.slack.com/apps
02
Configure Bot Token Scopes

Navigate to OAuth & Permissions. Under Bot Token Scopes, add the following permissions:

Scopes channels:history channels:read chat:write chat:write.public files:read groups:read im:history im:read im:write reactions:read reactions:write users:read
03
Install to Workspace

Click "Install to Workspace" and authorize. Copy both the Bot User OAuth Token (xoxb-...) and, if needed, the User OAuth Token (xoxp-...).

Token format Bot Token: xoxb-XXXXXXXXXXXX-XXXXXXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXX User Token: xoxp-XXXXXXXXXXXX-XXXXXXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXX
04
Enable Event Subscriptions

Under Event Subscriptions, toggle on and set the Request URL to your agent endpoint. Subscribe to bot events: message.channels, message.im, app_mention.

Endpoint https://your-domain.com/api/slack/events
Integration

GitHub.

Agents interact with your repositories to create PRs, review code, manage issues, and trigger deployments. You'll create a GitHub App or Personal Access Token.

01
Create a GitHub App

Navigate to your organization settings and create a new GitHub App. This gives finer permission control than a PAT.

URL https://github.com/organizations/YOUR_ORG/settings/apps/new
02
Configure Permissions

Under Permissions, grant the following repository permissions:

Permissions Repository: Contents: Read & Write Issues: Read & Write Pull Requests: Read & Write Workflows: Read & Write Metadata: Read-only Organization: Members: Read-only
03
Generate Private Key

After creating the app, generate a private key (.pem file). Store it securely — this is used to authenticate as the App.

Environment GITHUB_APP_ID=123456 GITHUB_PRIVATE_KEY_PATH=./github-app.pem GITHUB_INSTALLATION_ID=78901234
04
Install on Repositories

Install the App on the specific repositories your agents will interact with. You can limit access to select repos for security.

Webhook https://your-domain.com/api/github/webhook
Integration

Atlassian.

Agents manage Jira tickets, update Confluence docs, and sync project status. You'll create an API token for Jira/Confluence Cloud.

01
Generate API Token

Log in to your Atlassian account and generate a new API token. This token authenticates API requests alongside your email.

URL https://id.atlassian.com/manage-profile/security/api-tokens
02
Configure Authentication

Use Basic Auth with your email and API token. The base URL is your Atlassian Cloud instance.

Environment ATLASSIAN_EMAIL=you@company.com ATLASSIAN_API_TOKEN=XXXXXXXXXXXXXXXXXXXXXXXX ATLASSIAN_BASE_URL=https://your-org.atlassian.net
03
Verify Access

Test your credentials with a simple API call to ensure the token works and has the right permissions.

Test command curl -u you@company.com:YOUR_API_TOKEN \ https://your-org.atlassian.net/rest/api/3/myself
04
Configure Project Keys

Set the Jira project key and Confluence space key that your agents will operate in. Agents will only access these scoped resources.

Environment JIRA_PROJECT_KEY=YUNO CONFLUENCE_SPACE_KEY=ENG