Skip to main content
IntegrationMicrosoft Teams Workflow webhook
Availability2026.2 or later

Webhook

Create it in Teams

Configure

Point GermainUX at it

Test

Validate end to end

Troubleshoot

Fix common issues

Overview

Configure Microsoft Teams notifications to allow GermainUX to send alerts and other notifications directly to a Microsoft Teams channel. The integration uses a Microsoft Teams Workflow webhook:
GermainUXHTTP RequestMicrosoft Teams WorkflowTeams Channel
Configuration consists of two steps:
  1. Create a webhook Workflow in Microsoft Teams.
  2. Configure GermainUX to send notifications to the webhook URL.

Create a Webhook in Microsoft Teams

In Microsoft Teams:
1

Open the Team and Channel

Open the Team and Channel where GermainUX notifications should be posted.
2

Open More options

Select More options (…) next to the Channel.
3

Select Workflows

Select Workflows.
4

Choose the webhook template

Search for and select: Send webhook alerts to a channel
5

Configure the Workflow

Configure the Workflow and select the Team and Channel that should receive GermainUX notifications.
6

Save

Select Save.
7

Copy the webhook URL

Once the Workflow is created, copy the generated webhook URL.
The webhook URL is the endpoint GermainUX will call when sending a notification.
Keep the webhook URL secure. Anyone with access to a usable webhook URL may be able to submit requests to the associated Workflow, depending on its authentication configuration.

Configure GermainUX

In GermainUX, configure an HTTP-based action to call the Microsoft Teams webhook. Go to:
Germain WorkspaceLeft MenuSettingsAutomation
Configure the action with the webhook URL generated by Microsoft Teams. The request should use:
The exact request body must correspond to the payload expected by the Microsoft Teams Workflow.

Configure the Message

Configure the Teams Workflow and GermainUX request so that useful information about the detected condition is included in the notification. For example, a GermainUX notification may contain:
  • Alert or issue
  • Severity
  • Application
  • KPI
  • Current value
  • SLA threshold
  • Error
  • Friction
  • Users or sessions affected
  • AI analysis
  • AI recommendation
  • Time detected
  • Link back to GermainUX
A simple notification could appear as:

GermainUX Alert

Application: Salesforce
Issue: Response Time SLA Violation
Severity: High
Response Time: 8.2 seconds
Users Affected: 143
Detected: 10:42 AM
Open GermainUX for additional analysis.

Configure the Trigger

Once the Microsoft Teams request is configured, associate it with the GermainUX condition that should trigger the notification. For example:
SLA ViolationSend Teams Notification
Or:
New Error DetectedAnalyze ErrorDetermine ImpactSend Teams Notification
Or:
Conversion Friction DetectedIdentify Affected VisitorsSend Teams NotificationInvestigate in GermainUX
The trigger can be configured according to the GermainUX monitoring, SLA, Rule, or Automation associated with the use case.

Test the Notification

After configuration:
1

Trigger the action

Trigger the GermainUX action manually or generate a test condition.
2

Check the request

Verify that GermainUX successfully executes the HTTP request.
3

Open the channel

Open the configured Microsoft Teams Channel.
4

Check the notification

Verify that the notification appears.
5

Check the content

Confirm that the message contains the expected GermainUX information.
6

Check the link

If a GermainUX link is included, verify that it opens the expected dashboard or investigation context.
The complete validation path is:
GermainUX ConditionHTTP RequestTeams WorkflowTeams ChannelNotification

Troubleshooting

If the Teams notification is not received, verify:
  • The Microsoft Teams Workflow is enabled.
  • The webhook URL configured in GermainUX is correct.
  • GermainUX can reach the Microsoft endpoint.
  • The HTTP request uses POST.
  • The request uses the expected JSON format.
  • The Teams Workflow accepts the submitted payload.
  • The Workflow is configured for the correct Team and Channel.
  • The Workflow execution history shows that the request was received.
  • GermainUX did not report an error while executing the request.
Review the Microsoft Teams Workflow configuration and execution history.
Review the GermainUX HTTP action, webhook URL, network connectivity, and any applicable security restrictions.

Security

Treat the Microsoft Teams webhook URL as sensitive configuration.
  • Do not expose the webhook URL in dashboards, documentation, tickets, or other locations accessible to unauthorized users.
  • Limit access to the GermainUX configuration containing the webhook.
  • Send only information that the destination Teams Channel is authorized to receive.
  • Avoid including PII, PHI, credentials, tokens, or other sensitive information unless specifically authorized.
  • Review access to the destination Team and Channel before sending production notifications.

Microsoft Teams Workflow Ownership

Microsoft Teams Workflows are associated with their owners. For production integrations, ensure appropriate ownership and administration of the Workflow so that GermainUX notifications do not stop if the original Workflow owner leaves the organization or loses access.
Microsoft recommends adding appropriate co-owners to maintain continuity for business-critical Workflows.

Additional Resources

AI

Insights & Recommendations

Analytics

Analytics Features

Automation

Automation Features

Dashboard

Dashboards and Reports

Reports

Reports (Automatic, Scheduled)

Management

Management Features

Get Help

Contact GermainUX Support

The Germain Team can help you set this up.

Can't find what you need?

Search all GermainUX docs with Ctrl + K, or use the feedback buttons at the bottom of this page to tell us what is missing.

The content of this document is proprietary to GERMAIN SOFTWARE LLC.