> ## 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.
# Asana Integration
> Automatische Task-Erstellung in Asana direkt während Kundengesprächem für nahtloses Projektmanagement und Follow-up-Tracking
# Asana Integration Template
Integriere Asana-Task-Management in deine Mid-call Actions und ermögliche es deinem KI-Assistenten, während Kundengesprächem automatisch Aufgaben zu erstellen, zu zuweisen und Projekte zu koordinieren - perfekt für agile Teams und Projektmanagement.
## Überblick & Funktionen
* Sofortige Task-Erstellung aus Gesprächsinhalten
* Intelligente Projekt-Zuordnung basierend auf Kontext
* Automatische Assignee-Bestimmung und Due-Date-Setting
* Integration mit Asana-Workflows und Custom Fields
* Cross-funktionale Task-Assignments
* Automatische Abhängigkeiten und Subtasks
* Integration mit Asana-Timeline und Portfolio-Management
* Real-time Team-Benachrichtigungen über neue Tasks
## Asana API & Workspace Setup
### 1. Asana API-Zugang einrichten
* Stelle sicher, dass du Admin-Rechte in deinem Asana-Workspace hast
* Navigiere zu "Admin Console" → "Apps" → "Service accounts"
* Oder verwende Personal Access Tokens für einfacheres Setup
```yaml theme={null}
Token-Generation:
1. Klicke auf dein Profilbild → "My Settings"
2. "Apps" → "Manage Developer Apps"
3. "Create New Personal Access Token"
4. Name: "Famulor Mid-Call Integration"
5. Token kopieren (beginnt mit "1/...")
```
```yaml theme={null}
Service-Account (für Teams/Business):
1. "Admin Console" → "Service accounts"
2. "Add service account"
3. Name: "Famulor Mid-Call Service"
4. Permissions: "Editor" oder "Member"
5. Token generieren und sicher speichern
```
```yaml theme={null}
Projekt-Setup:
- Projekt-IDs für verschiedene Bereiche sammeln
- Sales-Projekt: "1234567890123456"
- Support-Projekt: "2345678901234567"
- Business-Development: "3456789012345678"
Team-GIDs für Assignments:
- Sales-Team: "987654321098765"
- Support-Team: "876543210987654"
- DevOps-Team: "765432109876543"
```
## Mid-call Action konfigurieren
### Konfiguration im Famulor Interface
| Feld | Wert |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**\* | `Asana Task erstellen` |
| **Beschreibung** | "Erstellt automatisch neue Aufgaben in Asana basierend auf Gesprächsinhalten und Action Items" |
| **Funktionsname**\* | `create_asana_task` |
| **Funktionsbeschreibung**\* | "Erstellt eine neue Task in einem Asana-Projekt. Verwenden Sie dies, wenn während des Gesprächs Action Items, Follow-ups oder Projektaufgaben identifiziert werden." |
| **HTTP-Methode** | `POST` |
| **Timeout (ms)** | `5000` |
| **Endpoint**\* | `https://app.asana.com/api/1.0/tasks` |
```json theme={null}
{
"Authorization": "Bearer {{ASANA_TOKEN}}",
"Content-Type": "application/json",
"User-Agent": "Famulor-MidCall-Asana/1.0"
}
```
```json theme={null}
{
"data": {
"name": "{task_name}",
"notes": "{task_description}",
"projects": ["{project_id}"],
"assignee": "{assignee_email}",
"due_on": "{due_date}",
"start_on": "{start_date}",
"tags": ["{tag_1}", "{tag_2}"],
"custom_fields": {
"{priority_field_id}": "{priority}",
"{client_field_id}": "{client_name}",
"{source_field_id}": "mid-call-action"
}
}
}
```
### Parameter-Schema
```json theme={null}
{
"type": "object",
"properties": {
"task_name": {
"type": "string",
"description": "Name der Aufgabe (präzise und actionable)",
"examples": ["Follow-up Call mit Beispiel AG", "Demo vorbereiten für Max Mustermann", "Support-Ticket #12345 bearbeiten"]
},
"task_description": {
"type": "string",
"description": "Detaillierte Beschreibung der Aufgabe inkl. Kontext aus dem Gespräch"
},
"project_id": {
"type": "string",
"description": "Asana Projekt-ID (GID) für die Task-Zuordnung"
},
"assignee_email": {
"type": "string",
"format": "email",
"description": "E-Mail-Adresse des Asana-Users, der die Task übernehmen soll"
},
"due_date": {
"type": "string",
"format": "date",
"description": "Fälligkeitsdatum im Format YYYY-MM-DD"
},
"start_date": {
"type": "string",
"format": "date",
"description": "Startdatum der Aufgabe (optional)"
},
"priority": {
"type": "string",
"enum": ["Low", "Normal", "High", "Critical"],
"description": "Prioritätsstufe basierend auf Gesprächskontext",
"default": "Normal"
},
"client_name": {
"type": "string",
"description": "Kundenname für Task-Kategorisierung (optional)"
},
"tags": {
"type": "array",
"items": {"type": "string"},
"description": "Asana-Tags für Kategorisierung",
"examples": [["mid-call", "follow-up"], ["sales", "hot-lead"], ["support", "urgent"]]
},
"estimated_hours": {
"type": "number",
"description": "Geschätzte Arbeitszeit in Stunden (optional)",
"minimum": 0.5,
"maximum": 40
}
},
"required": ["task_name", "project_id"]
}
```
## Praktische Anwendungsszenarien
### Szenario 1: Sales Follow-up Task
```yaml theme={null}
Während des Sales-Calls:
Kunde: "Schicken Sie mir bis Freitag ein detailliertes Angebot"
KI-Assistant: "Selbstverständlich! Ich erstelle eine Aufgabe für unser Sales-Team..."
→ create_asana_task wird ausgelöst
```
```yaml theme={null}
Task-Details:
task_name: "Angebot erstellen: Beispiel AG - CRM-Integration"
task_description: "Kunde Max Mustermann von Beispiel AG benötigt detailliertes Angebot für CRM-Integration.
Gesprächskontext:
- Budget: ~50k€
- Timeline: Q1 2024
- Pain Points: Aktuelle Lösung zu langsam
- Entscheidungsträger: Max (Geschäftsführer)
Action Items:
- Technische Spezifikationen zusammenstellen
- Pricing für 50-User-Setup kalkulieren
- Case Study ähnlicher Kunden beifügen
- Termin für Angebotsvostellung vorschlagen"
project_id: "sales-pipeline-project-id"
assignee_email: "sales@company.com"
due_date: "2024-01-19"
priority: "High"
tags: ["mid-call", "hot-lead", "proposal-needed"]
```
### Szenario 2: Support-Ticket-Task-Management
**Support-Eskalation via Asana**:
```yaml theme={null}
Problem-Context:
Kunde: "Unser System ist seit 2 Stunden down!"
Automatische-Task-Creation:
task_name: "KRITISCH: System-Ausfall bei Beispiel AG"
project_id: "support-critical-project-id"
assignee_email: "devops@company.com"
due_date: "2024-01-15" (heute)
priority: "Critical"
Task-Description:
"🚨 KRITISCHER SYSTEM-AUSFALL
Kunde: Beispiel AG (Max Mustermann)
Problem: Kompletter System-Ausfall seit 14:00 Uhr
Business Impact: Produktions-Stopp, Revenue-Loss
Sofort-Maßnahmen erforderlich:
1. System-Status prüfen
2. Kunde innerhalb 30 Min kontaktieren
3. Workaround bereitstellen
4. Root-Cause-Analysis starten
SLA: 1-Stunden-Resolution-Target"
```
**Produkt-Entwicklung koordinieren**:
```yaml theme={null}
Feature-Request-Flow:
Kunde: "Könnten Sie eine Integration zu XY-System hinzufügen?"
Task-Creation:
task_name: "Feature Request: XY-System Integration"
project_id: "product-development-backlog"
assignee_email: "product-manager@company.com"
Custom-Fields:
customer_impact: "High" (mehrere Kunden betroffen)
estimated_effort: "Medium"
revenue_potential: "€25k+ ARR"
competitive_advantage: "Ja"
```
### Szenario 3: Partnership & Business Development
```mermaid theme={null}
flowchart TD
A[Partnership-Gespräch] --> B{Opportunity-Typ?}
B -->|Integration| C[Tech-Partnership Task]
B -->|Reseller| D[Channel-Partnership Task]
B -->|Strategic| E[Strategic-Alliance Task]
C --> F[create_asana_task]
D --> F
E --> F
F --> G[Task in Asana erstellt]
G --> H[Team-Assignment]
H --> I{Priorität?}
I -->|High| J[Sofortige Benachrichtigung]
I -->|Medium| K[Daily-Standup-Aufnahme]
I -->|Low| L[Weekly-Review-Aufnahme]
J --> M[Follow-up innerhalb 24h]
K --> N[Follow-up diese Woche]
L --> O[Follow-up nächste Woche]
```
## Response-Verarbeitung
### Erfolgreiche Task-Erstellung
```json theme={null}
{
"data": {
"gid": "1234567890123456",
"name": "Follow-up Call mit Beispiel AG",
"notes": "Kunde Max Mustermann benötigt detailliertes Angebot...",
"assignee": {
"gid": "9876543210987654",
"name": "Sales Manager"
},
"projects": [
{
"gid": "1111222233334444",
"name": "Sales Pipeline Q1"
}
],
"due_on": "2024-01-19",
"created_at": "2024-01-15T10:30:00.000Z",
"permalink_url": "https://app.asana.com/0/1111222233334444/1234567890123456"
}
}
```
### Natürliche Sprachintegration
**Template**: `"Ich erstelle die Aufgabe '{{task_name}}' in Asana..."`
**Kontextuelle Beispiele**:
```yaml theme={null}
Follow-up-Task:
"Ich erstelle eine Follow-up-Aufgabe für unser Sales-Team..."
Support-Task:
"Ich lege ein Support-Ticket in Asana für das Tech-Team an..."
Project-Task:
"Ich erstelle eine Projektaufgabe für die weitere Bearbeitung..."
```
**Standard-Template**: `"Aufgabe wurde erfolgreich in Asana erstellt."`
**Erweiterte Bestätigungen**:
```yaml theme={null}
Mit Assignee:
"Aufgabe wurde erstellt und an {assignee_name} zugewiesen."
Mit Deadline:
"Die Aufgabe wurde erstellt und hat ein Fälligkeitsdatum von {due_date}."
Mit Team-Kontext:
"Das {team_name}-Team wurde über die neue Aufgabe benachrichtigt."
Mit Link:
"Aufgabe erstellt. Sie können den Fortschritt hier verfolgen: [Link zur Task]"
```
## Erweiterte Asana-Features
### Custom Fields & Automation
```yaml theme={null}
Branchen-spezifische Custom Fields:
Sales-Tasks:
- Lead Score: Dropdown (Cold/Warm/Hot)
- Deal Size: Number field
- Competition: Multi-select
- Close Probability: Percentage
Support-Tasks:
- Severity: Dropdown (Low/Medium/High/Critical)
- Customer Tier: Dropdown (Basic/Pro/Enterprise)
- Resolution Time: Number (hours)
- Escalation Level: Dropdown
Project-Tasks:
- Client Name: Text field
- Project Phase: Dropdown
- Budget Allocated: Number
- Stakeholders: People field
```
```yaml theme={null}
Trigger-basierte Automatisierung:
Wenn Priority = "Critical":
→ Assignee sofort benachrichtigen
→ Due Date auf "heute" setzen
→ Manager als Follower hinzufügen
Wenn Tag = "mid-call":
→ Spezielle "Live Call" Statusfarbe
→ Automatisches Follow-up nach 24h
→ Team-Dashboard-Aufnahme
Wenn Client = "Enterprise":
→ Account Manager als Follower
→ Höhere Prioritätsstufe
→ Executive-Dashboard-Visibility
```
### Multi-Project-Workflows
```yaml theme={null}
Komplexe-Kundenanfrage-Workflow:
Lead aus Enterprise-Gespräch:
1. Sales-Task: "Proposal erstellen"
Project: Sales Pipeline
Assignee: Account Manager
2. Tech-Task: "Technical Deep Dive"
Project: Solution Engineering
Assignee: Solutions Architect
3. Legal-Task: "Contract Review"
Project: Legal & Compliance
Assignee: Legal Team
Dependencies:
Tech-Task → Sales-Task (blocking)
Sales-Task → Legal-Task (predecessor)
```
```yaml theme={null}
Portfolio-Level-Tracking:
Customer-Success-Portfolio:
- Onboarding-Tasks
- Health-Check-Tasks
- Renewal-Preparation-Tasks
Product-Development-Portfolio:
- Feature-Request-Tasks
- Bug-Report-Tasks
- Enhancement-Tasks
Go-to-Market-Portfolio:
- Campaign-Launch-Tasks
- Content-Creation-Tasks
- Partnership-Activation-Tasks
```
## Fehlerbehandlung & Troubleshooting
### Häufige API-Fehler
```yaml theme={null}
Ursache: Projekt-ID existiert nicht oder kein Zugriff
Asana-Response:
"errors": [{
"message": "project: Not a recognized ID",
"phrase": "project"
}]
Fallback:
"Die Aufgabe konnte nicht dem spezifischen Projekt zugeordnet werden.
Ich erstelle sie in Ihrem Standard-Inbox."
Resolution:
- Projekt-ID validieren
- Fallback auf User-Inbox
- Admin-Benachrichtigung über Konfigurationsfehler
```
```yaml theme={null}
Ursache: Assignee-E-Mail nicht in Asana-Workspace
Graceful-Handling:
"Aufgabe wurde erstellt, aber der Verantwortliche konnte nicht automatisch zugewiesen werden.
Bitte weisen Sie die Aufgabe manuell zu."
Automatische-Correction:
- Task ohne Assignee erstellen
- Default-Team-Lead als Assignee setzen
- Notification an Workspace-Admin
```
```yaml theme={null}
Asana-Rate-Limits:
- Standard: 1500 Requests/Minute
- Premium: 1500 Requests/Minute (gleich)
- Enterprise: Custom Limits möglich
Retry-Strategy:
- Exponential Backoff: 1s, 2s, 4s
- Max 3 Wiederholungsversuche
- Queue-System für Burst-Loads
User-Communication:
"Die Aufgabe wird erstellt. Bei hoher Systemlast kann das
einen Moment dauern..."
```
## Integration mit anderen Tools
### CRM-Synchronisation
```mermaid theme={null}
sequenceDiagram
participant C as Kunde
participant AI as KI-Assistant
participant A as Asana
participant CRM as HubSpot
participant S as Slack
C->>AI: "Können Sie mir bis Freitag ein Angebot schicken?"
AI->>CRM: Kontakt-Daten und Deal-Info abrufen
CRM-->>AI: Customer Details + Deal-Context
AI->>A: create_asana_task (Proposal Task)
A-->>AI: Task created (GID: 12345)
AI->>CRM: Task-ID als Activity protokollieren
AI->>S: Team-Benachrichtigung senden
AI->>C: "Aufgabe wurde erstellt. Sie erhalten das Angebot bis Freitag."
Note over A: Task-Notifications an Team
Note over CRM: Activity-Log aktualisiert
```
## Performance & Analytics
### Projektmanagement-KPIs
| Metrik | Beschreibung | Zielwert |
| ------------------------------ | ------------------------------------------ | -------- |
| **Task Creation Success Rate** | % erfolgreich erstellter Tasks | >99% |
| **Assignment Accuracy** | % korrekt zugewiesener Tasks | >95% |
| **Task Completion Rate** | % fristgerecht erledigter Mid-Call-Tasks | >80% |
| **Follow-up Conversion** | % der Tasks die zu Business-Results führen | >60% |
### Productivity Impact Tracking
```yaml theme={null}
Vorher/Nachher-Vergleich:
Ohne Mid-Call-Tasks:
- Follow-up-Rate: 45%
- Durchschnittliche Response-Zeit: 48h
- Vergessene Action Items: 25%
Mit Mid-Call-Tasks:
- Follow-up-Rate: 85%
- Durchschnittliche Response-Zeit: 6h
- Vergessene Action Items: 5%
```
```yaml theme={null}
Revenue-Tracking:
Mid-Call-Task → Follow-up-Action → Meeting → Deal
Conversion-Funnel:
- Tasks Created: 100%
- Tasks Completed on Time: 80%
- Follow-up Meetings Scheduled: 60%
- Deals Closed: 15%
```
## Best Practices
### Task-Design-Patterns
**Gute Beispiele**:
* "Demo vorbereiten: CRM-Features für Beispiel AG"
* "Follow-up Call: Budget-Bestätigung bis Freitag"
* "Proposal senden: 50k€ Enterprise-Deal"
**Vermeiden**:
* "Kunde anrufen"
* "Follow-up machen"
* "Angebot"
**Template-Struktur**:
```
Kontext: [Was ist passiert?]
Ziel: [Was soll erreicht werden?]
Details: [Spezifische Informationen]
Deadline: [Warum diese Frist?]
Success-Criteria: [Wann ist es erfolgreich?]
```
***
**Workspace-Zugriff**: Stelle sicher, dass alle automatisch erstellten Tasks von den zugewiesenen Team-Mitgliedern gesehen und bearbeitet werden können. Überprüfe regelmäßig die Projekt-Berechtigungen.
**Produktivitäts-Tipp**: Verwende Asana-Templates für wiederkehrende Task-Typen (Sales Follow-up, Support-Eskalation, etc.) um Konsistenz und Effizienz zu maximieren.
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).