> ## Documentation Index
> Fetch the complete documentation index at: https://pentest-tools.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams integration

> Send security alerts to Microsoft Teams channels

The Microsoft Teams integration delivers security notifications to your Teams channels.

<Info>
  Available on **NetSec**, **WebNetSec**, and **Pentest Suite** plans.
</Info>

## Setting up Teams

<Steps>
  <Step title="Create webhook">
    In Teams, add an "Incoming Webhook" connector to your channel.
  </Step>

  <Step title="Copy URL">
    Copy the webhook URL generated by Teams.
  </Step>

  <Step title="Configure integration">
    In Pentest-Tools.com, go to Settings > Integrations > Microsoft Teams.
  </Step>

  <Step title="Paste URL">
    Enter the webhook URL and save. To control which events post to this channel, set up notification rules in Notifications.
  </Step>
</Steps>

## Creating the webhook

In Microsoft Teams:

1. Go to the channel where you want notifications
2. Click **... > Connectors**
3. Find **Incoming Webhook** and click **Configure**
4. Name the webhook (e.g., "Security Alerts")
5. Optionally upload a custom icon
6. Click **Create** and copy the URL

## Available notifications

This integration receives all notification types configured in your workspace. See [Notifications overview](/capabilities/notifications) for trigger types and conditions.

## Message cards

Teams notifications use Adaptive Cards:

* Tool name and scan status
* Trigger condition and scan result summary
* Link to the full report

## Channel strategy

<CardGroup cols={2}>
  <Card title="Security Team Channel" icon="shield">
    All security-related notifications.
  </Card>

  <Card title="Project Channels" icon="folder">
    Project-specific alerts.
  </Card>
</CardGroup>

### Recommended setup

| Channel           | Notifications              |
| ----------------- | -------------------------- |
| Security-Alerts   | Critical and High findings |
| Security-Activity | All scan completions       |
| Project channels  | Project-specific findings  |

## Best practices

<Tip>
  Use @mentions in Teams to alert specific people when critical findings are detected.
</Tip>

### Enterprise considerations

* Coordinate with IT for webhook permissions
* Follow your organization's data policies
* Consider compliance requirements

<Warning>
  Webhook URLs can be used by anyone who has them. Keep URLs confidential and rotate if compromised.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Webhook not working">
    * Verify URL is correct
    * Check connector is still active
    * Test webhook with a manual POST
  </Accordion>

  <Accordion title="Cards not formatting">
    * Check JSON payload format
    * Verify Teams supports the card version
  </Accordion>
</AccordionGroup>

## Related topics

* [Slack integration](/capabilities/integrations/slack)
* [Notifications](/capabilities/notifications)