Connectors (Notification / Integrations)

Introduction
Connectors are the way API Fortress integrates with other services and platforms to send data and/or notifications to them. A big benefit to using the platform is how it can seamlessly integrate itself into your day-to-day operations without adding new daily work.

There are two levels of notification integrations:

  • Failures Only: this type will send a notification only when a test failure happens. This is typical for stateless services, like Slack.
  • Send All: Will send all events, including successes, which is very handy when the service will need to log everything or alter a state.

Currently Available
API Fortress has a fully featured API, as well as Webhooks. Any platform with an API can be integrated to work. With that said, we did preconfigure some, and are constantly adding new ones. Currently we have:

  • Slack
  • BigPanda
  • HipChat
  • StatusPage.io
  • JIRA
  • Twilio
  • DataDog
  • New Relic
  • Elastic

Setup
Connectors are part of the Alert Groups subsystem. They can only be set up by users with the “manager” role, and can be accessed by doing the following steps:

  1. Access the company settings page, by clicking the gear icon in the top right.
  2. Select “Alert groups” on the side menu.
  3. Create a new group (if needed).
  4. Click on the connectors icon. connectors
  5. Add a new Connector.
  6. Choose a service from the list.
  7. Enter the required information.

Once the Alert Group is set, you can assign it to a project by:

  1. Go back to the main dashboard.
  2. Edit a project.
  3. Select your Alert Group in the “Alert Distribution Group” field.
  4. Save the project.

Important Notes!
If you notice the Slack integration is not working for you, make sure you configured it properly.  We only need a portion of the webhook URL, not the entire thing.