CircleCI has integrated chat notifications, automated email notifications, and web notifications. For Slack and Email, notifications are delivered on the success or failure of a workflow. Otherwise, notifications are delivered for each job for all other notification platforms. Consider the minimal CircleCI config below:
version: 2 jobs: build: docker: - image: circleci/<language>:<version TAG> steps: - checkout - run: <command> test: docker: - image: circleci/<language>:<version TAG> steps: - checkout - run: <command> workflows: version: 2 build_and_test: # < Slack and Email notifications will be delivered for workflows jobs: # All other notification integrations (HipChat, IRC, etc) will receive notification for each job. - build - test
Continue reading to learn how each notification type (chat, email, and web) is configurable.
Enable Chat Notifications
CircleCI supports Slack, HipChat, Campfire, Flowdock and IRC notifications. Configure chat notifications on the Project Settings > Chat Notifications page of the CircleCI application using the in-app instructions and links for each chat app.
Slack notifications will look like the following:
Set or Change Email Notifications
Use the Notifications page of the CircleCI application to set or change your default email address for notifications, to turn off email notifications, or get a notification email for every build.
Email notifications will look like the following:
Enable Web Notifications
Go to your CircleCI user settings. The link to turn on permissions is at the bottom in the Web Notifications section as shown in the screenshot:
Click the link to turn on permissions. Your browser will ask you to confirm that you want to allow notifications from CircleCI.
Click Allow as shown in the screenshot example.
Select the radio button to show notifications for completed builds. Note: To select the radio button, you may need to reload the page.
If you’ve previously denied CircleCI permission to send you web notifications then you’ll need to turn those permissions on in your browser, as CircleCI can’t request permission in this case. Use your browser settings to control notifications. In Google Chrome you can do this by clicking the lock icon in the URL bar and selecting Notifications from the Permissions Settings as shown in the following animation:
While the process is similar for other browsers, please refer to their individual documentation for handling web notifications.