---
title: "Integrations"
section: "Integrations"
description: "Connect SmartestQA to Jira, Azure DevOps, Xray, Zephyr Scale, Confluence, Slack, Teams, WhatsApp, webhooks, CI/CD, Datadog, Dynatrace and a test mailbox."
url: https://docs.smartestqa.ai/en/integrations.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "integrations jira azure devops xray zephyr confluence slack teams whatsapp webhook ci cd github gitlab jenkins datadog dynatrace apm email imap smtp status active ready not configured disabled last test"
---
# Integrations

Integrations connect a SmartestQA project to the tools your team already uses: issue trackers, test management, chat, CI/CD, monitoring and a test mailbox. Each one is set up per project by an admin.

## In short

**On this page you can**

- Link tasks to Jira issues or Azure DevOps work items, both ways.
- Sync test cases and results with Xray and Zephyr Scale ; publish reports to Confluence .
- Send run results and task alerts to Slack , Teams , WhatsApp or any webhook.
- Start pipelines from GitHub Actions, GitLab CI, Jenkins or Azure Pipelines and fail the build on failures.
- Show Datadog or Dynatrace server metrics in load test reports; give test steps a mailbox.

**How to use it**

1. Select the project in the top bar: every integration belongs to one project.
2. Open Integrations under Configuration and click the card you need.
3. Click Setup , enter the address and token, then Test Connection .
4. Save and check that the page shows Active and Last test: OK .
5. Run a pipeline and confirm the result arrives in the other system.

**At a glance**

- **Where:** Main menu › **Configuration** › **Integrations**. Each card opens its own page, for example `/integrations/jira`.
- **Who:** Company **Admins**. Users do not see the menu item. See [roles](https://docs.smartestqa.ai/en/company-settings-roles.html).
- **Scope:** One project. Select the project first; the same Jira site can be connected to several projects, each with its own settings.
- **You need:** An account on the other system that may create an API token, webhook or app, and the address of that system.
- **Secrets:** Tokens, passwords and webhook addresses are stored encrypted and never shown again. Leave the field empty to keep the saved value.
- **Status:** Catalogue: **Active** or **Ready**. Integration page: **Not configured**, **Disabled** or **Active**, plus a separate **Last test** line. See [how statuses are decided](https://docs.smartestqa.ai/en/integrations-numbers.html#status-chips).
- **When things are sent:** Chat, webhook, APM, Zephyr and Azure DevOps Test Plans react to [pipeline](https://docs.smartestqa.ai/en/schedule-create.html) runs. Jira reacts when a task is created or changed. Timed syncs run in the background for Jira and Azure DevOps. Everything else runs when you click its button.

## Start from your question

I want to…

- [Send tasks to Jira](https://docs.smartestqa.ai/en/integrations-issue-trackers.html#jira-setup)
- [Use Azure DevOps Boards and Test Plans](https://docs.smartestqa.ai/en/integrations-issue-trackers.html#ado-setup)
- [Get pipeline results in Slack or Teams](https://docs.smartestqa.ai/en/integrations-notifications.html#slack)
- [Run tests from my CI and fail the build](https://docs.smartestqa.ai/en/integrations-cicd.html#set-up)
- [Read one-time codes from a mailbox in a test](https://docs.smartestqa.ai/en/integrations-email.html#set-up)

Something is wrong

- [“Please test the connection before proceeding”](https://docs.smartestqa.ai/en/integrations-troubleshooting.html#fix-test-first)
- [Jira says “Authentication failed”](https://docs.smartestqa.ai/en/integrations-troubleshooting.html#fix-jira-auth)
- [Slack or Teams stays silent after a run](https://docs.smartestqa.ai/en/integrations-troubleshooting.html#fix-no-notification)
- [The CI step says “trigger failed”](https://docs.smartestqa.ai/en/integrations-troubleshooting.html#fix-ci-trigger)
- [All integration problems](https://docs.smartestqa.ai/en/integrations-troubleshooting.html)

How does it work?

- [Why the card says Ready but the page says Disabled](https://docs.smartestqa.ai/en/integrations-numbers.html#status-chips)
- [Which run sends “Completed” and which “Failed”](https://docs.smartestqa.ai/en/integrations-notifications.html#events)
- [How to verify a webhook signature](https://docs.smartestqa.ai/en/integrations-webhooks.html#verify-signature)
- [When the CI step fails the build](https://docs.smartestqa.ai/en/integrations-cicd.html#exit-codes)
- [What the daily summary counts](https://docs.smartestqa.ai/en/integrations-numbers.html#daily-summary)

## Where integrations fit

Integrations are not a step of their own. They carry what SmartestQA does in **[Schedule](https://docs.smartestqa.ai/en/schedule.html)** and **[Report](https://docs.smartestqa.ai/en/report.html)** to other tools, and bring [requirements](https://docs.smartestqa.ai/en/analyze-requirements.html) and test cases in for **Analyze** and **[Automate](https://docs.smartestqa.ai/en/automate.html)**.

1. **Discover** — Pages, controls, rules
2. **Analyze** — Zephyr brings requirements; Confluence only through an AI assistant
3. **Automate** — Xray and Zephyr bring test cases
4. **Schedule** — CI/CD starts pipelines; chat and webhooks announce them ← this page
5. **Report** — Results go to Xray, Zephyr, Test Plans, Confluence, APM ← this page
6. **Maintenance** — [Tasks](https://docs.smartestqa.ai/en/tasks.html) go to Jira or Azure DevOps

## The catalogue

The **Integrations** page lists 17 cards. Several cards open the same page: GitHub Actions, GitLab CI and Jenkins open the CI/CD page on their tab, and Datadog and Dynatrace open the APM page.

| Card | Category filter | What it does | Direction | Read |
| --- | --- | --- | --- | --- |
| Jira | Defect | [Tasks](https://docs.smartestqa.ai/en/tasks.html) become Jira issues; status, priority, assignee and comments come back. | Both ways | [Jira](https://docs.smartestqa.ai/en/integrations-issue-trackers.html#jira) |
| Azure DevOps | Defect | Tasks become work items; state and assignee come back; [pipeline](https://docs.smartestqa.ai/en/schedule-create.html) results go to Test Plans. | Both ways | [Azure DevOps](https://docs.smartestqa.ai/en/integrations-issue-trackers.html#azure-devops) |
| Xray | Test | Test cases go to Xray Cloud as Tests, and Xray Tests come in as test cases. | Both ways | [Xray](https://docs.smartestqa.ai/en/integrations-test-management.html#xray) |
| Zephyr Scale | Test | Zephyr test cases and linked Jira issues come in; new test cases go out; run results go to a test cycle. | Both ways | [Zephyr Scale](https://docs.smartestqa.ai/en/integrations-test-management.html#zephyr) |
| BrowserStack | Test | Opens **Project Panel** › [**Mobile Config**](https://docs.smartestqa.ai/en/project-settings-mobile.html), where BrowserStack devices are set up. | — | [Mobile and desktop apps](https://docs.smartestqa.ai/en/quick-start-connect.html#connect-mobile-desktop) |
| Confluence | Doc. | Publishes [run reports](https://docs.smartestqa.ai/en/report.html) and test case documentation as Confluence pages. | Out | [Confluence](https://docs.smartestqa.ai/en/integrations-confluence.html) |
| Slack | Notification | Posts pipeline, task and daily summary messages to a channel. | Out | [Slack](https://docs.smartestqa.ai/en/integrations-notifications.html#slack) |
| Microsoft Teams | Notification | The same messages, to a Teams channel through a Workflows webhook. | Out | [Teams](https://docs.smartestqa.ai/en/integrations-notifications.html#teams) |
| WhatsApp Business | Notification | Failures and the daily summary to up to 20 phones, with approved templates. | Out | [WhatsApp](https://docs.smartestqa.ai/en/integrations-notifications.html#whatsapp) |
| Email (IMAP/SMTP) | Notification | A test mailbox that mail steps read (one-time codes, links) and send from. | Both ways | [Email](https://docs.smartestqa.ai/en/integrations-email.html) |
| Generic Webhook | CI/CD | Signed JSON events to any HTTP endpoint. | Out | [Webhooks](https://docs.smartestqa.ai/en/integrations-webhooks.html) |
| GitHub Actions, GitLab CI, Jenkins | CI/CD | A ready-made CI step starts a pipeline, waits, writes a JUnit report and sets the exit code. | In and back | [CI/CD](https://docs.smartestqa.ai/en/integrations-cicd.html) |
| Datadog, Dynatrace | Monitoring | Server metrics in [load test reports](https://docs.smartestqa.ai/en/report-load-tests.html); run start and end events in your APM. | Both ways | [APM](https://docs.smartestqa.ai/en/integrations-apm.html) |
| Active Directory (LDAP) | Identity | Opens **Company Settings** › [**Active Directory**](https://docs.smartestqa.ai/en/company-settings-active-directory.html). It is set for the whole company, not per project. | — | Company & users (in **Administration**) |

## The building blocks

- **Integration:** The saved settings for one outside system in one project: address, credentials, switches and mappings.
- **Connection test:** A read-only call to the other system with the credentials you entered, for example Jira’s “who am I”. Chat integrations send a real test message instead.
- **Integration Active:** The on/off switch on the integration page. Off keeps the settings but stops all sending and syncing.
- **Mapping:** The link between a SmartestQA item and its copy in the other system, for example task 412 ↔ `PAY-88`. Mappings stop duplicates on the next sync.
- **Sync:** One pass that sends or reads items. Manual syncs run when you click a button; timed syncs run in the background.
- **Event:** Something that happened in SmartestQA and can be announced: [pipeline](https://docs.smartestqa.ai/en/schedule-create.html) started, completed or failed; task created; deploy received.
- **Daily summary:** One message per day with yesterday’s runs and today’s open tasks, at the hour you pick.
- **Signing secret:** A random value shared with a webhook receiver so it can check that a request really came from SmartestQA.
- **Agent API key:** The key of a [test agent](https://docs.smartestqa.ai/en/agent-pool-agents.html) (host). CI jobs use it to start pipelines with that user’s project access.

## The screens

### The catalogue

![The Integrations catalogue.](https://docs.smartestqa.ai/media/shots/INT-SHOT-01.png)

- **Result count**: “*n* results”, the cards that match the search and filter.
- **Search** (**Search integrations...**): matches the card name and description.
- **Category filter**: All, Active (with the number of active integrations), Defect, Test, Notification, Doc., Monitoring, Identity, CI/CD.
- **Card**: logo, name, description, two feature tags and a status chip. Active cards are listed first.
- **“Couldn't load integration status.”** with **Retry** when the status call fails; the cards then all show Ready.

### An integration page

Every integration page has the same frame, so you find the same controls in the same place.

- **← Integrations**: back to the catalogue.
- **Status chip**: Not configured, Disabled or Active.
- **Last test**: OK, Failed, Testing… or Not tested, with the time. A failed test shows its message in the connection panel.
- **Refresh**: reloads the data without losing unsaved edits.
- ****Remove**** (Xray, Zephyr, Confluence, Azure DevOps): deletes the settings after a confirmation.
- ****Test Connection**** or **[**Send Test Message**](https://docs.smartestqa.ai/en/integrations-notifications.html#slack)**: appears once the integration is saved.
- ****Setup**** before the first save, ****Settings**** afterwards: opens the settings dialog.
- ****Unsaved changes**** bar: appears at the bottom when you edit on the page, with **Discard** and **Save**.

Jira, Xray, Zephyr Scale and Azure DevOps test the saved connection automatically when their page opens and the integration is on. Slack, Teams and WhatsApp do not, because their test posts a real message.

Video: [Integrations in three minutes](https://docs.smartestqa.ai/media/videos/INT-01.mp4) (3:00)

The catalogue, one integration set up from Setup to Last test OK, and the result arriving after a pipeline.

Video transcript: Integrations lists everything SmartestQA can connect to. The category row narrows it: defect trackers, test management, notifications, documentation, monitoring, identity and CI/CD. Active shows what is already connected. Nothing is connected in this project yet, so the list is empty. Jira syncs tasks with issues. Xray and Zephyr Scale sync test cases and run results. Slack sends test and task notifications. Confluence publishes reports. Generic Webhook sends signed events to any system, and starts pipelines from outside. A card marked Ready can be set up: open it and follow its steps.

## Before you start

| Integration | On the other system you need | Details |
| --- | --- | --- |
| Jira | Cloud: an Atlassian email and API token. Server/Data Center: a personal access token. A project you may create issues in. | [Jira](https://docs.smartestqa.ai/en/integrations-issue-trackers.html#jira-before) |
| Azure DevOps | A personal access token with Work Items, Test Management and Project and Team scopes. | [Azure DevOps](https://docs.smartestqa.ai/en/integrations-issue-trackers.html#ado-before) |
| Xray | Xray Cloud API key (Client ID and Client Secret) and the Jira project key. | [Xray](https://docs.smartestqa.ai/en/integrations-test-management.html#xray-before) |
| Zephyr Scale | Cloud: a Zephyr API access token. Data Center: a Jira personal access token. | [Zephyr Scale](https://docs.smartestqa.ai/en/integrations-test-management.html#zephyr-before) |
| Confluence | Confluence Cloud, an Atlassian email and API token, a space key and parent page IDs. | [Confluence](https://docs.smartestqa.ai/en/integrations-confluence.html#before) |
| Slack, Teams | An incoming webhook (Slack app) or a Workflows webhook (Teams) for the channel. | [Slack](https://docs.smartestqa.ai/en/integrations-notifications.html#slack), [Teams](https://docs.smartestqa.ai/en/integrations-notifications.html#teams) |
| WhatsApp | A WhatsApp Business number, a permanent system-user token and approved templates. | [WhatsApp](https://docs.smartestqa.ai/en/integrations-notifications.html#whatsapp) |
| Webhook | An HTTPS (or internal HTTP) endpoint that accepts JSON POSTs. | [Webhooks](https://docs.smartestqa.ai/en/integrations-webhooks.html) |
| CI/CD | A [pipeline](https://docs.smartestqa.ai/en/schedule-create.html) in SmartestQA, an [agent API key](https://docs.smartestqa.ai/en/agent-pool-agents.html#api-key), and a CI that can reach the SmartestQA API. | [CI/CD](https://docs.smartestqa.ai/en/integrations-cicd.html) |
| Datadog, Dynatrace | Datadog: API key and Application key. Dynatrace: a token with `metrics.read` and `events.ingest`. | [APM](https://docs.smartestqa.ai/en/integrations-apm.html) |
| Email | A dedicated test mailbox with IMAP on, and an app password. | [Email](https://docs.smartestqa.ai/en/integrations-email.html) |

## How credentials are handled

- **Tokens go into the integration form, nowhere else.** Never put a token or password into a test step, a note or a test case. Steps reach the mailbox through the Email integration, not with a password in the step.
- **Stored encrypted.** API tokens, client secrets, personal access tokens, app passwords, webhook addresses, signing secrets and custom header values are encrypted at rest.
- **Never shown again.** After saving, a token field shows dots or “Saved”. Leave it empty to keep the saved value; type a new one to replace it.
- **Changing the address needs the token again.** Zephyr Scale, Azure DevOps, WhatsApp, APM and webhook custom headers refuse to send a saved secret to a new server. Re-enter it when you change the address.
- **Use service accounts.** Create tokens for a technical user with access to the one project you connect. Then a person leaving the company does not break the integration.

> **Warning: What leaves SmartestQA**
>
> Issue trackers receive task names, descriptions, comments and attachments. Chat and WhatsApp messages carry [pipeline](https://docs.smartestqa.ai/en/schedule-create.html) names, counts and error text, never test data values. Webhooks carry the JSON described in [the payload](https://docs.smartestqa.ai/en/integrations-webhooks.html#payload). Check that the receiving system is allowed to hold that data.

## Without an integration

| You want | Without an integration | With an integration |
| --- | --- | --- |
| Results in your team chat | Someone opens [Report](https://docs.smartestqa.ai/en/report.html) and pastes a link | Slack, Teams or WhatsApp post them as runs end |
| Bugs in Jira | Copy each task by hand | [Tasks](https://docs.smartestqa.ai/en/tasks.html) become issues and their status comes back |
| Tests in a release [pipeline](https://docs.smartestqa.ai/en/schedule-create.html) | Start the pipeline by hand and check later | The CI step starts it, waits and fails the build |
| Any other system | Poll the SmartestQA API | A signed webhook arrives on each event |

An AI assistant connected through [MCP](https://docs.smartestqa.ai/en/mcp.html) can also read and drive the Jira, Xray, Confluence and mailbox integrations. See [MCP](https://docs.smartestqa.ai/en/integrations-faq.html#mcp).

## In this section

- [Jira & Azure DevOps](https://docs.smartestqa.ai/en/integrations-issue-trackers.html) — Connect tasks to Jira issues or Azure DevOps work items, map statuses and priorities, and publish runs to Test Plans.
- [Xray & Zephyr Scale](https://docs.smartestqa.ai/en/integrations-test-management.html) — Sync test cases with Xray Cloud or Zephyr Scale, bring Jira requirements in, and write pipeline results back.
- [Confluence](https://docs.smartestqa.ai/en/integrations-confluence.html) — Publish run reports and test case documentation to Confluence Cloud pages under parent pages you choose.
- [Slack, Teams & WhatsApp](https://docs.smartestqa.ai/en/integrations-notifications.html) — Post pipeline results, task alerts and a daily summary to a Slack or Teams channel or to WhatsApp phones.
- [Email (IMAP/SMTP)](https://docs.smartestqa.ai/en/integrations-email.html) — Connect a test mailbox so mail steps can wait for emails, read one-time codes and links, and send mail during a test.
- [Webhooks](https://docs.smartestqa.ai/en/integrations-webhooks.html) — Send signed JSON events for pipelines, tasks and deploys to any HTTP endpoint, and verify them on the receiving side.
- [CI/CD](https://docs.smartestqa.ai/en/integrations-cicd.html) — Start a SmartestQA pipeline from your CI, wait for it, get a JUnit report and fail the build when tests fail.
- [Datadog & Dynatrace (APM)](https://docs.smartestqa.ai/en/integrations-apm.html) — Show your servers’ CPU, memory and response times next to load test results, and mark test runs in your APM dashboards.
- [How the numbers work](https://docs.smartestqa.ai/en/integrations-numbers.html) — Every status chip, counter and figure on the integration pages and in their messages, with its formula and a worked example.
- [Troubleshooting](https://docs.smartestqa.ai/en/integrations-troubleshooting.html) — Every integration message and symptom, with why it happens, what to check and how to fix it.
- [FAQ, MCP & limits](https://docs.smartestqa.ai/en/integrations-faq.html) — Questions and answers about integrations, what AI assistants can do through MCP, and every limit.

## Related

- [Tasks and Jira](https://docs.smartestqa.ai/en/tasks-from-runs.html#jira)
- [Start pipelines from other systems (triggers)](https://docs.smartestqa.ai/en/schedule-triggers-queues.html)
- [Send deploys from CI](https://docs.smartestqa.ai/en/deployments-ci.html)
- [Mail steps](https://docs.smartestqa.ai/en/automate-steps-mail.html)
- [Integrations through MCP](https://docs.smartestqa.ai/en/mcp-workflows.html#integrations)
- [Secrets and credentials](https://docs.smartestqa.ai/en/data-source-secrets.html)
