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

# Microsoft Teams

> Send incidents to a Teams channel with an Incoming Webhook.

The Microsoft Teams integration delivers an **Adaptive Card** to the channel you choose, with the incident context and a direct link to the dashboard.

## Setting it up

<Steps>
  <Step title="Create an Incoming Webhook in Teams">
    In the target channel, add the **Incoming Webhook** connector, name it `aciona.me` and copy the generated URL.
  </Step>

  <Step title="Add the integration in aciona.me">
    Under **Integrations**, add the Microsoft Teams integration and paste the URL. Owners and admins can do this.
  </Step>

  <Step title="Set the icon (optional)">
    Use the official aciona.me icon in the connector settings, so cards are recognizable in the channel.
  </Step>

  <Step title="Send a test alert">
    Trigger a test incident and confirm the card arrives.
  </Step>
</Steps>

## What arrives in the channel

An Adaptive Card with severity, title, service, origin, current owner and an **Open incident** button.

As with Slack, the card follows the incident lifecycle — creation, acknowledgement, assignment, escalation and resolution.

<Note>
  Dates on Teams cards are shown explicitly in UTC, to avoid ambiguity between members in different timezones.
</Note>

## Best practices

<AccordionGroup>
  <Accordion title="A channel dedicated to incidents" icon="hash">
    Keeps the history readable and makes it easy to configure Teams' own notifications for that channel.
  </Accordion>

  <Accordion title="Teams does not replace push" icon="triangle-alert">
    A channel card is visibility, not paging. Whoever is on call needs push on their phone.
  </Accordion>

  <Accordion title="Mind the payload size" icon="ruler">
    Teams caps Adaptive Card size. Incidents with very long descriptions may be truncated in the card — the dashboard always has the full content.
  </Accordion>
</AccordionGroup>

## Troubleshooting

| Symptom                        | What to check                                                           |
| ------------------------------ | ----------------------------------------------------------------------- |
| Nothing arrives in the channel | The integration is active in aciona.me and the connector URL is valid   |
| It used to work and stopped    | The connector was removed or the channel was archived                   |
| Card renders unformatted       | The Teams client is out of date, or org policy restricts Adaptive Cards |