Slack

Slack is a popular team-based chat application that has revolutionized the way that development teams communicate. Buddybuild offers a first-class integration with Slack, providing notifications for build status, feedback submissions, and crash reports directly to the Slack channels that you use.

There are a number of sub-sections on this page:

This section describes how to navigate to the Slack integration settings, and is referred to by several procedures described on this page.

  1. Log in to the buddybuild dashboard.

  2. The App Settings button Click App Settings button in the top toolbar. The Default build configuration screen is displayed:

    The Default build configuration screen

  3. The Integrations button In the left navigation bar, click the Integrations button. The first of the Integrations screens (Apple Dev Connection) is displayed:

    The Apple Dev Connection screen

  4. The Slack button In the left navigation, click the Slack button. The Slack screen is displayed:

    The Slack screen

    If you have previously configured Slack, you might instead see:

    The Slack screen with existing configuration

Connect your Slack team

These steps describe how to establish a connection between buddybuild and a specific Slack team. You can create as many Slack team connections as required.

  1. Navigate to the Slack integration settings

  2. Depending on whether you have an existing connection, or not, perform one of the following:

    1. The Connect with Slack button If you do not already have a Slack connection configured, click the Connect with Slack button.

    2. The Add new button The Connected teams tab If you do have an existing Slack connection, click the Connected teams tab and then the Add new button.

  3. When you are not logged in to Slack, the Slack authentication screen is displayed:

    The Slack authentication screen

    Enter your Slack team, email address, and then password to login to Slack.

  4. Once you are logged in to Slack, the Slack authorization screen is displayed:

    The Slack authorization screen

  5. The Slack authorize button Here, you are giving permission to buddybuild to connect to your Slack team and send notifications to your channels. Click the Authorize button. The Connection confirmation screen is displayed:

    The Connection confirmation screen

  6. Choose whether you want to use this Slack connection for all apps, or just the current app:

    1. The Yes, share with all apps button Click the Yes, share with all apps button if you want to use this Slack connection with all apps.

    2. The No thanks! button Click the No thanks! button if you want to use this Slack connection with only the current app.

    In either case, the Slack screen is displayed again, showing the Configure Slack tab:

    The Slack Screen with initial all branches configuration

At this point, the initial connection process is complete! By default, a configuration panel for All branches is opened; continue with the Channel selection section.

Configure branches

This section describes how to configure buddybuild’s Slack integration for branches, including for All branches, specific branches, or patterns that can match branches and/or tags.

All branches

You can configure notifications for all branches.

  1. Navigate to the Slack integration settings

  2. The Add new button You can configure buddybuild notifications for all branches of your application, or you can configure notifications for a specific branch. Click the appropriate Add new button. The Slack screen is displayed, which now includes the All branches notifications configuration panel:

    The All branches notifications configuration panel

  3. Continue with Channel selection.

Branch specification

You can configure notifications for a specific branch, or a pattern that can match branches and/or tags.

  1. Navigate to the Slack integration settings

  2. The Add new button Click the Add new button beside the Notifications for specific branches subheading.

    You can Choose a specific branch which configures notifications for one branch, or Define a pattern to match which configures notifications for any matching branches or tags.

Choose a specific branch

  1. Click the Choose a specific branch tab. The Specific Branch selection screen is displayed:

    The Specific Branch selection screen

  2. If you have many branches, click the branch filter field and enter the name of the desired branch (or portion thereof); the list of branches displays only matching branches.

  3. The Branch add button Move your pointer over the branch you want to choose. An Add button appears at the right of the row. Click the Add button. The Slack screen is displayed, which now includes a branch-specific notifications configuration panel:

    A branch-specific notification configuration panel

  4. Continue with Channel selection.

Define a pattern to match

  1. Click the Define a pattern to match tab. The Branch pattern selection screen is displayed:

    The Branch pattern selection screen

  2. Click the branch filter field and enter the pattern that the desired branches should match; the list of branches displays only matching branches.

  3. By default, the pattern applies to both tags and branches. You can choose to apply the pattern to Tags only, or to Branches only. Click the appropriate checkbox. The list of branches updates accordingly.

  4. The Create button Click the Create button. The Slack screen is displayed, which now includes a pattern-specific notifications configuration panel:

    A pattern-specific notifications configuration panel

  5. Continue with Channel selection.

Channel selection

This section describes how to select the Slack channel to which buddybuild should send notifications.

  1. The Channel selection dropdown In the appropriate notifications configuration panel, click the Channel selection dropdown. The Channel selection menu is displayed.

    If your team uses many Slack channels, you might notice a slight delay before the Channel selection menu is ready.

  2. The Channel selection menu Select the channel to which buddybuild should send notifications. The Notifications configuration tabs become enabled:

    The Build tab

Note
The Team dropdown When you have multiple teams configured, each notification configuration panel includes the team selection dropdown. Click the dropdown and select the appropriate team. When you select a different team, the Channel dropdown updates accordingly.

At this point, you can adjust the configuration for Build, Deployment, and Feedback notifications. Click the associated tab to display and adjust those specific settings.

Configure notifications

This section describes the available kinds of notifications and their options.

Build notifications

The Build tab

On the Build tab, the following notification configuration options are available:

  • The Build success menu Build success: You can choose to receive buddybuild notifications for:

    • All successful builds: whenever your application builds successfully.

    • Only when the build gets fixed: for the first successful build after one or more build failures.

    • None: no notifications for build success are sent.

  • The Build failures menu Build failures: You can choose to receive buddybuild notifications for:

    • All build failures: whenever your application fails to build successfully.

    • Only when the build breaks: for the first failed build after one or more successful builds.

    • None: no notifications for build failures are sent.

  • Xcode updates: Click the toggle button to enable/disable notifications whenever buddybuild makes a new version of Xcode available.

    Note
    This option is only available for All branches. It is not available for specific-branch or pattern-specific configuration.

Deployment notifications

The Deployment tab

Note
Deployment notifications are only available for All branches. They are not available for specific-branch or pattern-specific configuration.

Click the associated toggle button to adjust these notification configuration options:

  • User failed to install a build: when enabled, receive a notification whenever a test user fails to install a build.

  • Device added to Apple account: when enabled, receive a notification whenever a new device is associated with your iTunes Connect account.

  • Failed upload to App Store: when enabled, receive a notification when buddybuild’s attempt to upload a build to iTunes Connect fails for any reason.

  • Tester unsubscribed from a deployment group: when enabled, receive a notification when one of your test users elects to stop receiving announcements of new builds.

Feedback notifications

The Feedback tab

  • User Feedback: Click the toggle button to enable/disable notifications whenever a test users sends feedback about your application.

  • The Crash reports menu Crash reports: You can choose to receive buddybuild notifications for:

    • All crash reports: whenever your application crashes on a test user’s device.

    • New crash report types: for new types of crashes that have not previously been reported.

    • None: no notifications for application crashes are sent.

Edit notification configuration

Individual notification settings can be adjusted at any time. Adjustments take effect immediately for all future notifications.

All branches

You can only adjust individual settings in the all branches panel, or by deleting notification configuration; there are no other editing options.

Branch-specific notifications

Once branch-specific notifications settings are established, it is not possible to adjust which branch they apply to. If you need to accomplish this, create branch-specific settings for the "new" branch and then delete the original branch-specific settings. See Branch specification and Delete notification configuration for details.

Pattern-specific notifications

The pencil button You can adjust the pattern for pattern-specific notification settings, by clicking the Pencil icon at the top right of the appropriate panel. The Edit branch pattern screen is displayed:

The Edit branch pattern screen

The Save button Adjust the pattern as necessary (see Define a pattern to match for more details), then click the Save button.

Delete notification configuration

The Trashcan icon When you need to delete notification configuration settings, for all branches, specific branches, or pattern-specific branches or tags, click the Trashcan icon at the top right of the appropriate panel. The panel is removed, and notifications based on the deleted configuration cease immediately.

Delete team connection

The steps to delete a team connection differ between connections that are available for all apps and connections available for select apps.

  1. The all-apps indicator For connections available for all apps

    1. Log in to the buddybuild dashboard.

    2. Select Manage Org in the avatar dropdown Move your mouse pointer over your avatar in the top right corner. A dropdown menu appears.

    3. Select Manage Org. The Manage Organization screen appears:

      The Manage Organization screen

    4. The Integrations button In the left navigation, click the Integrations link. The first of the Integrations screens (Apple Dev Connection) is displayed:

      The Apple Dev Connection screen

    5. The Slack button In the left navigation, click the Slack button. The Slack screen is displayed, showing all of the shared Slack teams:

      The Slack screen

    6. The Trashcan icon Click the Trashcan icon beside the team connection you wish to delete. A delete confirmation dialog appears:

      The Slack connection delete confirmation dialog

    7. The Delete Slack team button Click the Delete Slack team button to complete the deletion of the connection.

      The Cancel button If you want to continue using the Slack team connection, click the Cancel button.

  2. For other connections, not available to all apps

    1. Navigate to the Slack integration settings

    2. Click the Connected teams tab. The connected teams are displayed:

      The list of connected teams If you are not signed into your Slack account, you are asked to enter your Slack credentials.

    3. The Trashcan icon Click the Trashcan icon beside the team connection you wish to delete. A delete confirmation appears:

      The Connection delete confirmation panel

    4. The Delete button Click the Delete button to complete the deletion of the connection.

Note

If buddybuild’s authorization to send notifications to a team is ever revoked, notifications for this team connection are not sent and the Connected teams tab displays a banner indicating the situation:

The Connected Teams screen showing the revoked app

You now have a choice:

  1. The Re-connect button Click the Re-connect button to re-authorize notifications from buddybuild; the Connect your Slack team process begins.

  2. The Delete button To delete the connection from buddybuild, click the Delete button.

After reconnection, you may have to perform Channel selection again, especially if you use different credentials to authorize buddybuild.

results matching ""

    No results matching ""