> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Microsoft Teams Integration
> Automatisierte Team-Benachrichtigungen über Microsoft Teams direkt während Kundengesprächem für optimale Enterprise-Kommunikation
# Microsoft Teams Integration Template
Integriere Microsoft Teams Messaging in deine Mid-call Actions und ermögliche es deinem KI-Assistenten, während Kundengesprächem automatisch Nachrichten und Updates an Teams-Channels zu senden - perfekt für Enterprise-Umgebungen.
## Überblick & Funktionen
* Automatische Benachrichtigungen an Teams-Channels
* Rich-Card-Formatierung für professionelle Darstellung
* Integration in bestehende Microsoft 365 Workflows
* Compliance-konforme Unternehmens-Kommunikation
* Webhook-basierte Integration (keine App-Installation nötig)
* Adaptive Cards für interaktive Nachrichten
* Farbkodierung für Prioritäten und Kategorien
* Links zu SharePoint, Power BI und anderen MS-Tools
## Teams Webhook Setup
### 1. Incoming Webhook erstellen
* Öffne Microsoft Teams
* Navigiere zum gewünschten Channel (z.B. "Sales", "Support")
* Klicke auf "..." (Mehr Optionen) neben dem Channel-Namen
```yaml theme={null}
Webhook-Setup:
1. "Connectors" → "Configure" wählen
2. Nach "Incoming Webhook" suchen
3. "Add" → "Configure" klicken
4. Webhook-Details eingeben:
- Name: "Famulor Mid-Call Integration"
- Bild: Famulor Logo (optional)
- Beschreibung: "Automatische Benachrichtigungen aus Kundengesprächem"
```
```yaml theme={null}
Nach der Konfiguration:
1. Webhook-URL kopieren (sehr lang, beginnt mit https://...)
2. URL sicher speichern - wird als {{TEAMS_WEBHOOK_URL}} verwendet
3. Test-Nachricht senden zur Validierung
Format: https://outlook.office.com/webhook/abc.../IncomingWebhook/def.../ghi...
```
* Webhook funktioniert für alle Channel-Mitglieder
* Keine zusätzlichen App-Berechtigungen nötig
* Nachrichten erscheinen als "Famulor Mid-Call Integration"
## Mid-call Action konfigurieren
### Konfiguration im Famulor Interface
| Feld | Wert |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**\* | `Microsoft Teams Nachricht` |
| **Beschreibung** | "Sendet automatisch formatierte Nachrichten an Microsoft Teams-Channels für Enterprise-Team-Koordination" |
| **Funktionsname**\* | `send_teams_message` |
| **Funktionsbeschreibung**\* | "Sendet eine Nachricht an einen Teams-Channel via Webhook. Verwende dies für wichtige Business-Updates, Lead-Benachrichtigungen oder Support-Eskalationen." |
| **HTTP-Methode** | `POST` |
| **Timeout (ms)** | `5000` |
| **Endpoint**\* | `{{TEAMS_WEBHOOK_URL}}` |
```json theme={null}
{
"Content-Type": "application/json",
"User-Agent": "Famulor-MidCall-Teams/1.0"
}
```
**Hinweis**: Teams Webhooks benötigen keine Authorization-Header - die URL selbst dient als Authentifizierung.
```json theme={null}
{
"@type": "MessageCard",
"@context": "https://schema.org/extensions",
"title": "{title}",
"summary": "{title}",
"text": "{message}",
"themeColor": "{color}",
"sections": [
{
"activityTitle": "Famulor Mid-Call Assistant",
"activitySubtitle": "Live-Gespräch Update",
"facts": [
{
"name": "Zeit:",
"value": "{timestamp}"
},
{
"name": "Typ:",
"value": "{call_type}"
}
]
}
]
}
```
### Parameter-Schema
```json theme={null}
{
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Nachrichtentitel (wird prominent angezeigt)",
"examples": ["Neuer qualifizierter Lead", "Support-Eskalation", "Deal Update"]
},
"message": {
"type": "string",
"description": "Hauptinhalt der Nachricht (unterstützt Markdown-Formatierung)"
},
"color": {
"type": "string",
"description": "Theme-Farbe als Hex-Code für visuelle Kategorisierung",
"default": "0078D4",
"examples": ["0078D4", "28A745", "DC3545", "FFC107"]
},
"call_type": {
"type": "string",
"enum": ["Sales", "Support", "Partnership", "General"],
"description": "Art des Gesprächs für Kategorisierung",
"default": "General"
},
"priority": {
"type": "string",
"enum": ["Low", "Normal", "High", "Critical"],
"description": "Prioritätsstufe für Farbkodierung",
"default": "Normal"
},
"timestamp": {
"type": "string",
"description": "Zeitstempel des Gesprächs (wird automatisch generiert)",
"format": "date-time"
}
},
"required": ["title", "message"]
}
```
## Praktische Anwendungsszenarien
### Szenario 1: Sales-Lead-Benachrichtigung
**MessageCard-Template für High-Value-Lead**:
```json theme={null}
{
"@type": "MessageCard",
"@context": "https://schema.org/extensions",
"title": "🎯 Neuer Enterprise-Lead",
"summary": "Qualifizierter Lead mit hohem Potenzial",
"text": "Ein neuer qualifizierter Lead wurde während des Live-Gesprächs identifiziert.",
"themeColor": "28A745",
"sections": [
{
"activityTitle": "Lead-Details",
"activitySubtitle": "Sofortige Bearbeitung empfohlen",
"facts": [
{"name": "Kontakt:", "value": "Max Mustermann"},
{"name": "Unternehmen:", "value": "Beispiel AG"},
{"name": "E-Mail:", "value": "max@beispiel.de"},
{"name": "Lead-Score:", "value": "92/100"},
{"name": "Geschätztes Volumen:", "value": "€150.000"},
{"name": "Zeitrahmen:", "value": "Q1 2024"}
]
}
],
"potentialAction": [
{
"@type": "OpenUri",
"name": "CRM öffnen",
"targets": [{"os": "default", "uri": "https://your-crm.com/leads/12345"}]
},
{
"@type": "HttpPOST",
"name": "Lead übernehmen",
"target": "https://your-api.com/leads/claim/12345"
}
]
}
```
```yaml theme={null}
Farbschema für verschiedene Prioritäten:
Critical (Kritisch):
Farbe: "DC3545" (Rot)
Beispiel: System-Ausfall, Großkunden-Beschwerde
High (Hoch):
Farbe: "FF6B00" (Orange)
Beispiel: Hot Lead >100k€, Eskalation Manager
Normal:
Farbe: "0078D4" (Microsoft Blau)
Beispiel: Standard-Leads, Info-Updates
Success:
Farbe: "28A745" (Grün)
Beispiel: Deal closed, Problem gelöst
```
### Szenario 2: Support-Ticket-Eskalation
```json theme={null}
{
"@type": "MessageCard",
"@context": "https://schema.org/extensions",
"title": "🚨 Kritisches Support-Ticket",
"summary": "Sofortige Aufmerksamkeit erforderlich",
"text": "Ein kritisches Problem wurde während des Kundengesprächs gemeldet und erfordert sofortige Bearbeitung.",
"themeColor": "DC3545",
"sections": [
{
"activityTitle": "Problem-Details",
"activitySubtitle": "SLA: 1 Stunde Response-Zeit",
"facts": [
{"name": "Kunde:", "value": "Beispiel AG"},
{"name": "Kontakt:", "value": "Max Mustermann"},
{"name": "Problem:", "value": "API-Gateway nicht erreichbar"},
{"name": "Betroffene Services:", "value": "Produktionsumgebung"},
{"name": "Geschätzte Ausfallzeit:", "value": "30 Minuten"},
{"name": "Business Impact:", "value": "Hoch - Revenue-kritisch"}
]
},
{
"activityTitle": "Nächste Schritte",
"facts": [
{"name": "Zugewiesen an:", "value": "@DevOps-Team"},
{"name": "Ticket-ID:", "value": "#SUP-2024-0123"},
{"name": "Priorität:", "value": "P1 - Kritisch"}
]
}
],
"potentialAction": [
{
"@type": "OpenUri",
"name": "Ticket öffnen",
"targets": [{"os": "default", "uri": "https://support.company.com/tickets/SUP-2024-0123"}]
}
]
}
```
```yaml theme={null}
Teams-Mention-Integration:
In MessageCard-Text:
"text": "DevOps Team - Sofortige Aufmerksamkeit erforderlich!"
Erweiterte Mentions:
- Benutzer: "Max Mustermann"
- Teams: "Support-Team"
- Channel: "Channel Name"
Hinweis: Teams-Webhooks unterstützen @mentions in MessageCards begrenzt
```
### Szenario 3: Business-Intelligence-Updates
```mermaid theme={null}
flowchart TD
A[Kundenanruf] --> B{Gesprächstyp?}
B -->|Sales| C[Lead-Qualifikation]
B -->|Support| D[Problem-Assessment]
B -->|Upsell| E[Opportunity-Erkennung]
C --> F{Lead-Score?}
F -->|>80| G[Teams: Hot-Leads Channel]
F -->|50-80| H[Teams: Sales Channel]
F -->|<50| I[Teams: Nurturing Channel]
D --> J{Severity?}
J -->|Critical| K[Teams: Support-Critical + Management]
J -->|High| L[Teams: Support-Team]
J -->|Normal| M[Teams: Support-Queue]
E --> N[Teams: Account-Management Channel]
G --> O[MessageCard mit Lead-Details]
H --> O
I --> O
K --> P[MessageCard mit SLA-Timer]
L --> P
M --> P
N --> Q[MessageCard mit Upsell-Opportunity]
```
## Response-Verarbeitung & Erfolg
### Erfolgreiche Nachricht
```
Status: 200 OK
Body: "1" (Teams antwortet nur mit "1" bei Erfolg)
```
### Natürliche Sprachintegration
**Template**: `"Ich sende die Information an Microsoft Teams..."`
**Kontextuelle Beispiele**:
```yaml theme={null}
Bei Sales-Lead:
"Ich informiere das Sales-Team über diesen qualifizierten Lead..."
Bei Support-Issue:
"Ich eskaliere das Problem an das Support-Team in Microsoft Teams..."
Bei Partnership-Anfrage:
"Ich leite die Partnership-Anfrage an das Business Development Team weiter..."
```
**Template**: `"Nachricht wurde an Teams gesendet."`
**Erweiterte Bestätigungen**:
```yaml theme={null}
Mit Priorität:
"Kritische Benachrichtigung wurde an das Team gesendet."
Mit Follow-up:
"Das Team wurde benachrichtigt und wird sich innerhalb von [SLA-Zeit] melden."
Mit Action Items:
"Teams-Benachrichtigung gesendet - das Team kann direkt vom Chat aus reagieren."
```
## Erweiterte MessageCard-Features
### Interaktive Elemente
```json theme={null}
{
"potentialAction": [
{
"@type": "OpenUri",
"name": "CRM öffnen",
"targets": [
{"os": "default", "uri": "https://crm.company.com/lead/12345"}
]
},
{
"@type": "HttpPOST",
"name": "Lead übernehmen",
"target": "https://api.company.com/leads/claim",
"body": "{\"lead_id\": \"12345\", \"user\": \"{{user}}\"}"
},
{
"@type": "ActionCard",
"name": "Notiz hinzufügen",
"inputs": [
{
"@type": "TextInput",
"id": "note",
"title": "Deine Notiz",
"isMultiline": true
}
],
"actions": [
{
"@type": "HttpPOST",
"name": "Speichern",
"target": "https://api.company.com/leads/note"
}
]
}
]
}
```
```json theme={null}
{
"sections": [
{
"activityTitle": "Lead-Informationen",
"activitySubtitle": "Primäre Kontaktdaten",
"activityImage": "https://company.com/images/lead-icon.png",
"facts": [
{"name": "Name:", "value": "Max Mustermann"},
{"name": "Firma:", "value": "Beispiel AG"}
]
},
{
"activityTitle": "Qualifikation",
"activitySubtitle": "BANT-Bewertung",
"facts": [
{"name": "Budget:", "value": "€100k+ bestätigt"},
{"name": "Authority:", "value": "Entscheidungsbefugnis"},
{"name": "Need:", "value": "Akuter Bedarf"},
{"name": "Timeline:", "value": "Q1 2024"}
]
}
]
}
```
## Microsoft 365 Integration
### SharePoint & Power BI Links
```json theme={null}
{
"potentialAction": [
{
"@type": "OpenUri",
"name": "Sales-Unterlagen öffnen",
"targets": [
{
"os": "default",
"uri": "https://company.sharepoint.com/sites/sales/Documents/Proposals/"
}
]
},
{
"@type": "OpenUri",
"name": "Kundenhistorie",
"targets": [
{
"os": "default",
"uri": "https://company.sharepoint.com/sites/crm/Lists/Customers/"
}
]
}
]
}
```
```yaml theme={null}
Dashboard-Integration:
Sales-Performance: "https://app.powerbi.com/groups/.../reports/sales-dashboard"
Support-Metrics: "https://app.powerbi.com/groups/.../reports/support-metrics"
Customer-Analytics: "https://app.powerbi.com/groups/.../reports/customer-insights"
Dynamic-Links basierend auf call_type:
Sales → Sales-Dashboard
Support → Support-Metrics
Partnership → Business-Development-Dashboard
```
## Fehlerbehandlung & Troubleshooting
### Häufige Probleme
```yaml theme={null}
Ursachen:
- Webhook wurde deaktiviert oder gelöscht
- Falsche URL-Formatierung
- Expired Webhook-Konfiguration
Lösungsschritte:
1. Teams-Channel prüfen
2. Webhook-Konfiguration erneuern
3. Neue URL in Tool-Konfiguration aktualisieren
Fallback-Nachricht:
"Die Teams-Benachrichtigung konnte nicht zugestellt werden.
Das Team wird manuell informiert."
```
```yaml theme={null}
Häufige Formatfehler:
- Ungültiges JSON
- Fehlende @type oder @context
- Zu lange title/text-Felder
- Ungültige Action-Definitionen
Debugging:
- MessageCard-Validator verwenden
- Payload-Größe prüfen (max 28KB)
- Spezialzeichen escapen
Fallback:
Einfache Text-Nachricht ohne erweiterte Features
```
## Performance & Monitoring
### Teams-spezifische Metriken
| Metrik | Beschreibung | Zielwert |
| ------------------------- | ---------------------------------------- | ------------ |
| **Webhook Success Rate** | % erfolgreich zugestellter Nachrichten | >99.5% |
| **Message Delivery Time** | Zeit bis Nachricht in Teams erscheint | \<2 Sekunden |
| **Action Button Usage** | % der Nachrichten mit Button-Interaktion | >60% |
| **Webhook Uptime** | Verfügbarkeit der Webhook-Endpoints | >99.9% |
### Business Impact Tracking
```yaml theme={null}
KPIs:
- Zeit bis zur ersten Team-Reaktion auf Alert
- Durchschnittliche Problem-Lösungszeit
- Lead-Response-Zeit nach Teams-Benachrichtigung
```
```yaml theme={null}
Metriken:
- Anzahl Button-Clicks pro MessageCard-Typ
- Häufigste Action-Types
- Team-Member-Participation-Rate
```
## Enterprise-Compliance
### Sicherheits-Überlegungen
```yaml theme={null}
Sensitivity-Labels für Teams-Nachrichten:
Public: Allgemeine Benachrichtigungen
Internal: Team-spezifische Updates
Confidential: Kundendaten mit Lead-Informationen
Highly Confidential: Kritische Business-Intelligence
Implementation:
- Webhook-URLs nach Sensitivity-Level trennen
- Verschiedene Teams-Channels für verschiedene Classifications
- Automatische Data-Loss-Prevention-Checks
```
```yaml theme={null}
Microsoft 365 Compliance-Features:
- Message-Retention-Policies
- eDiscovery für Teams-Nachrichten
- Communication-Compliance-Monitoring
- Data-Loss-Prevention (DLP)
Logging:
- Alle Webhook-Calls in Audit-Log
- Message-Content-Classification
- User-Interaction-Tracking
```
***
**Enterprise-Hinweis**: Stelle sicher, dass deine Teams-Webhooks den IT-Security-Richtlinien deines Unternehmens entsprechen und regelmäßig auf Sicherheitslücken überprüft werden.
**Integration-Tipp**: Verwende verschiedene Webhook-URLs für verschiedene Channel-Typen (Sales, Support, etc.) um bessere Kontrolle über Nachrichten-Routing und -Formatierung zu haben.
Passende Seiten: [Introduction](/de/automation-platform/introduction) und [Building Flows](/de/automation-platform/building-flows) und [Debugging Runs](/de/automation-platform/debugging-runs).
Statt einzelner HTTP-Aktionen ein ganzes Toolset auf einmal? Externen **MCP-Server** verbinden — Tools werden automatisch erkannt. Siehe [MCP-Server](/de/platform/mcp-servers).