Slack

Integrating with Slack allows you to send custom automatic messages to your Slack channel.

Register a Slack OAuth app

1. Sign in to your Buddy self-hostedinstance as admin.
2. Go to Integrations, click Add a new integration, and select Slack from the list.
3. Click Configure Slack app.

Image loading...

4. In Slack, go to Slack API → Apps and click Create New App.
5. Select From an app manifest.
6. Select the Slack workspace for your app.
7. Enter the app manifest in the YAML format. Provide the authorization callback URL of your instance in redirect_urls.

yaml
display_information:
  name: Buddy
  description: Simple Git hosting with easy Deploy and CI
features:
  bot_user:
    display_name: Buddy Self-Hosted
    always_online: true
oauth_config:
  redirect_urls:
    - https://{YOUR_INSTANCE_URL}/callback
  scopes:
    bot:
      - channels:read
      - chat:write
      - files:write
      - groups:read
      - team:read
      - users:read
settings:
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false

Image loading...

8. Click Create.
9. Scroll down to the App Credentials section, copy the Client ID and Client Secret, and paste them into the corresponding fields in Buddy.

Image loading...

10. Click Save changes and restart Buddy to apply the changes.
11. Add a Slack action to one of your pipelines.
12. Define the name of the integration and click Start OAuth authorization.

Image loading...

13. Click Allow to give Buddy access to your Slack workspace.

Image loading...