​
Webhook-Integration mit Famulor Automation

Mid-Call-Tools können nicht nur direkte API-Calls ausführen, sondern auch über Webhooks mit der Famulor Automation Platform verbunden werden. Dies ermöglicht komplexe, mehrstufige Workflows und die Nutzung aller verfügbaren Integrationen der No-Code-Plattform.

​
Überblick der Webhook-Integration

Direkte API vs. Webhook

Direkter API-Call: Einfache 1:1 Datenabfrage oder -übertragungWebhook-Integration: Komplexe Workflows mit mehreren Systemen, Datenverarbeitung und Geschäftslogik

Erweiterte Möglichkeiten

  • Multi-System-Integrationen in einem Workflow
  • Bedingte Logik und Entscheidungsbäume
  • Datenaufbereitung und -transformation
  • Zeitverzögerte Aktionen und Follow-ups

​
Funktionsweise

​
Webhook-Tool konfigurieren

​
1. Basis-Konfiguration

ParameterWert
Funktionsnametrigger_famulor_automation
Beschreibung”Startet einen Famulor Automation-Workflow mit Gesprächsdaten als Input. Verwenden Sie dies für komplexe Multi-System-Operationen.”
HTTP-MethodePOST
URLhttps://app.famulor.de/api/webhook/automation/{flow_id}
Timeout15000ms

​
2. Request Body Template

{
  "trigger_source": "mid_call_tool",
  "conversation_context": {
    "customer_email": "{email}",
    "customer_phone": "{phone}",
    "customer_name": "{full_name}",
    "company_name": "{company}",
    "conversation_summary": "{summary}",
    "detected_intent": "{intent}",
    "urgency_level": "{urgency}",
    "timestamp": "{current_timestamp}"
  },
  "workflow_parameters": {
    "lead_source": "phone_call",
    "follow_up_required": true,
    "priority": "{calculated_priority}",
    "assigned_team": "{team_assignment}"
  },
  "custom_data": {
    "budget_mentioned": "{budget_info}",
    "timeline_mentioned": "{timeline}",
    "pain_points": "{pain_points}",
    "competitor_mentioned": "{competitors}"
  }
}

​
3. Parameter-Schema

{
  "type": "object",
  "properties": {
    "flow_id": {
      "type": "string",
      "description": "ID des Famulor Automation Workflows, der ausgeführt werden soll"
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "E-Mail-Adresse des Kunden"
    },
    "phone": {
      "type": "string", 
      "description": "Telefonnummer des Kunden"
    },
    "full_name": {
      "type": "string",
      "description": "Vollständiger Name des Kunden"
    },
    "company": {
      "type": "string",
      "description": "Firmenname des Kunden"
    },
    "summary": {
      "type": "string",
      "description": "Zusammenfassung der wichtigsten Gesprächspunkte"
    },
    "intent": {
      "type": "string",
      "enum": ["support", "sales", "information", "complaint", "partnership"],
      "description": "Erkannte Gesprächsabsicht"
    },
    "urgency": {
      "type": "string",
      "enum": ["low", "medium", "high", "critical"],
      "description": "Dringlichkeitsstufe basierend auf Gesprächsinhalt"
    },
    "calculated_priority": {
      "type": "string",
      "enum": ["low", "medium", "high"],
      "description": "Berechnete Priorität für Follow-up-Aktionen"
    },
    "team_assignment": {
      "type": "string",
      "enum": ["sales", "support", "success", "technical"],
      "description": "Empfohlenes Team für Follow-up"
    },
    "budget_info": {
      "type": "string",
      "description": "Erwähnte Budget-Informationen"
    },
    "timeline": {
      "type": "string", 
      "description": "Genannter Zeitrahmen oder Deadline"
    },
    "pain_points": {
      "type": "array",
      "items": {"type": "string"},
      "description": "Array der identifizierten Pain Points"
    },
    "competitors": {
      "type": "array",
      "items": {"type": "string"},
      "description": "Erwähnte Konkurrenten oder alternative Lösungen"
    }
  },
  "required": ["flow_id", "email", "summary", "intent"]
}

​
Praxisbeispiele für Webhook-Workflows

​
1. Lead-Qualifizierung & -Routing

​
2. Customer Success Automation

Trigger: intent == "support"

Workflow-Steps:
  1. HubSpot-Ticket erstellen
  2. Ähnliche Tickets suchen (Knowledge Base)
  3. Wenn FAQ-Lösung existiert:
     → Automated Response E-Mail
     → Ticket als "self-service" markieren
  4. Wenn komplex:
     → Technical Team assignment
     → SLA-Timer starten
     → Kunden-Benachrichtigung über Response-Zeit
  5. Integration mit:
     → Jira (für Bug-Tracking)
     → Confluence (Knowledge Base Update)
     → Slack (Team-Communication)

​
3. Sales Opportunity Management

​
Erweiterte Webhook-Konfigurationen

​
Multi-Workflow-Orchestration

​
Error Handling & Retry Logic

Retry-Konfiguration:
  Max_Retries: 3
  Backoff_Strategy: exponential
  Initial_Delay: 2s
  Max_Delay: 30s
  
Retry-Bedingungen:
  - HTTP 429 (Rate Limiting)
  - HTTP 502/503 (Service Unavailable)
  - Timeout Errors
  - Network Connection Issues

Fallback_bei_Final_Failure:
  - Error-Notification an Admin
  - Fallback auf einfachen Direct API Call
  - Manual Processing Queue

​
Response-Verarbeitung

​
Webhook Response Format

{
  "workflow_id": "wf_12345",
  "execution_id": "exec_67890", 
  "status": "completed",
  "execution_time_ms": 3450,
  "results": {
    "lead_created": {
      "hubspot_contact_id": "12345",
      "lead_score": 85,
      "assigned_owner": "sales@beispiel.de"
    },
    "notifications_sent": {
      "email_confirmation": "sent",
      "slack_notification": "sent",
      "sms_alert": "skipped"
    },
    "follow_up_scheduled": {
      "task_id": "task_98765",
      "due_date": "2024-01-16T10:00:00Z",
      "assigned_to": "max.sales@beispiel.de"
    }
  },
  "errors": [],
  "warnings": [
    "SMS service temporarily unavailable"
  ]
}

​
KI-Integration der Webhook-Results

Natural_Language_Processing:
  Success_Response:
    "Perfekt! Ich habe Ihre Anfrage bearbeitet und ein Follow-up 
     für morgen um 10 Uhr eingeplant. Mein Kollege Max wird 
     sich bei Ihnen melden."
  
  Partial_Success:
    "Alles ist eingerichtet. Es gab einen kleinen technischen 
     Hinweis mit dem SMS-Service, aber die E-Mail-Bestätigung 
     haben Sie erhalten."
  
  Warning_Handling:
    "Ihre Anfrage wurde erfolgreich verarbeitet. Sollten Sie 
     nicht innerhalb der nächsten Stunde eine Bestätigung 
     erhalten, melden Sie sich gerne."

​
Performance & Monitoring

​
Webhook-Performance-Metriken

MetrikZielwertKritischer Wert
Execution Time<5 Sekunden>15 Sekunden
Success Rate>95%<85%
Retry Rate<10%>25%
Partial Success Rate>98%<90%

​
Monitoring & Alerting

1

Real-time Monitoring

Dashboard-Metriken:
  - Webhook-Erfolgsrate
  - Durchschnittliche Execution Time
  - Error-Rate nach Workflow-Type
  - Queue-Größe bei High Load
2

Alerting-Rules

Kritische_Alerts:
  - Success Rate &lt;90% über 5 Minuten
  - Execution Time &gt;10s für &gt;10 Requests
  - Error Rate &gt;20% über 2 Minuten

Warning_Alerts:
  - Queue-Größe &gt;50 Pending
  - Retry-Rate &gt;15%
  - einzelne Workflow-Failures

​
Best Practices

​
Workflow-Design

Idempotenz sicherstellen

  • Workflows können mehrfach ausgeführt werden
  • Duplicate-Checks implementieren
  • State-Management für Retry-Szenarien
  • Transaktionale Operationen verwenden

Performance-Optimierung

  • Parallel ausführbare Steps identifizieren
  • Timeout-Werte angemessen setzen
  • Unnötige API-Calls vermeiden
  • Caching für häufige Abfragen nutzen

​
Security Considerations

Integration-Beispiele

Entdecken Sie praktische Webhook-Workflow-Beispiele:
Tipp: Beginnen Sie mit einfachen Webhook-Workflows und erweitern Sie schrittweise. Die Famulor Automation Platform bietet umfangreiche Debugging-Tools, um Workflow-Executions zu verfolgen und zu optimieren.
Wichtiger Hinweis: Webhook-Workflows können komplexe Geschäftsprozesse automatisieren. Testen Sie alle Workflows ausführlich in einer Staging-Umgebung, bevor Sie sie in der Produktion einsetzen.