Webhook-Integration mit Famulor Automation

Mid-call Actions 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

Tool-Setup
Headers

Parameter	Wert
Funktionsname	`trigger_famulor_automation`
Beschreibung	”Startet einen Famulor Automation-Workflow mit Gesprächsdaten als Input. Verwende dies für komplexe Multi-System-Operationen.”
HTTP-Methode	`POST`
URL	`https://app.famulor.de/api/webhook/automation/{flow_id}`
Timeout	`15000ms`

Authorization: "Bearer FAMULOR_API_KEY"
Content-Type: "application/json"
X-Webhook-Source: "mid-call-action"
X-Conversation-ID: "{conversation_id}"

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

Workflow-Logik

Workflow-Name: "Smart Lead Processing"
Trigger: Webhook von Mid-call Action

Schritte:
  1. Duplicate-Check in HubSpot
  2. Wenn neu → Lead erstellen
  3. Wenn bekannt → Kontakt-Historie abrufen
  4. Lead-Scoring basierend auf:
     - Firmengröße (Clearbit/LinkedIn)
     - Budgetangaben aus Gespräch
     - Urgency-Level
     - Bisherige Interaktionen
  5. Team-Assignment basierend auf Score:
     - &gt;80: Enterprise Sales Team
     - 50-80: Standard Sales Team  
     - &lt;50: Inside Sales/Nurturing
  6. Follow-up-Sequence starten:
     - E-Mail-Bestätigung an Kunde
     - Slack-Notification an Team
     - Task-Creation in CRM
     - Calendar-Invite für Follow-up-Call

Bedingte Verzweigungen

Bedingungen_im_Workflow:
  Wenn urgency == "critical":
    → Sofortige SMS an Sales Manager
    → Prioritäts-Flag in CRM setzen
    → Meeting innerhalb 4 Stunden buchen
  
  Wenn competitor_mentioned:
    → Competitive Intelligence Tool triggern
    → Battle Card an Sales-Rep senden
    → Pricing-Strategy-Alert
  
  Wenn budget > 100k:
    → Enterprise Team assignment
    → C-Level Executive als Contact Owner
    → Custom Demo-Environment bereitstellen

2. Customer Success Automation

Support-Ticket-Workflow
Onboarding-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)

Trigger: intent == "onboarding"

Multi-System-Integration:
  1. Customer Success Platform:
     → Onboarding-Plan erstellen
     → Success Manager zuweisen
  2. E-Mail-Marketing:
     → Welcome-Serie starten
     → Resource-E-Mails senden
  3. Learning Management:
     → Training-Account erstellen
     → Kurse zuweisen
  4. Calendar:
     → Kickoff-Meeting buchen
     → Check-in-Termine setzen
  5. CRM-Updates:
     → Customer Journey Stage
     → Health Score initialisieren

3. Sales Opportunity Management

Erweiterte Webhook-Konfigurationen

Multi-Workflow-Orchestration

Parallel-Workflows

Haupt-Workflow: "Customer Intake Processing"

Parallel_ausgeführte_Sub-Workflows:
  1. CRM_Processing:
     - Lead/Contact Creation
     - Deal Management
     - Activity Logging
  
  2. Communication_Automation:
     - E-Mail Sequences
     - SMS Notifications
     - Slack Updates
  
  3. Data_Enrichment:
     - Company Information (Clearbit)
     - Social Media Profiles
     - Technographic Data
  
  4. Compliance_Processing:
     - DSGVO Consent Management
     - Data Retention Policies  
     - Audit Trail Creation

Sequential-Workflows mit Approval

Workflow: "High-Value-Lead-Processing"

Sequence:
  1. Initial_Processing:
     - Lead erstellen
     - Basic Enrichment
     - Score berechnen
  
  2. Approval_Gate:
     Wenn Lead-Score > 90:
       → Manager Approval erforderlich
       → Hold bis Approval
     Sonst:
       → Direct Processing
  
  3. Post_Approval:
     - Enterprise Team Assignment
     - Premium Onboarding initiieren
     - Executive Sponsor definieren
  
  4. Follow_up:
     - 24h Check-in
     - Weekly Status Updates
     - Quarterly Business Reviews planen

Error Handling & Retry Logic

Retry-Mechanismen
Partial Failure Handling

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

Workflow_mit_Fehlerbehandlung:
  Step_1_CRM_Update:
    Success: Continue to Step 2
    Failure: Log Error, Continue with Fallback
  
  Step_2_Email_Send:
    Success: Continue to Step 3
    Failure: Retry 2x, dann Skip
  
  Step_3_Slack_Notification:
    Success: Workflow Complete
    Failure: Log Warning, Complete Anyway

Compensation_Actions:
  Wenn kritische Steps fehlschlagen:
    → Alternative Notification Methods
    → Manual Task Creation
    → Admin Escalation

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

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

Monitoring & Alerting

Real-time Monitoring

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

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

Webhook-Sicherheit

Authentication:
  - Bearer Token für Famulor API
  - Webhook-Signatur-Verification
  - IP-Whitelisting für Webhook-Endpoints
  - Rate-Limiting für Webhook-Calls

Data_Protection:
  - Sensitive Daten nicht in URL-Parametern
  - HTTPS für alle Webhook-Calls
  - Payload-Verschlüsselung bei Bedarf
  - Automatic PII-Redaction in Logs

Compliance & Auditability

Audit_Trail:
  - Alle Webhook-Executions loggen
  - Data-Processing-Nachweise
  - User-Consent-Tracking
  - Retention-Policy-Compliance

DSGVO_Considerations:
  - Right-to-Deletion unterstützen
  - Data-Minimization-Principles
  - Purpose-Limitation beachten
  - Cross-Border-Transfer-Controls

Integration-Beispiele

Entdecke praktische Webhook-Workflow-Beispiele:

HubSpot Integration für CRM-Automatisierung
Slack Integration für Team-Benachrichtigungen
SendGrid Integration für E-Mail-Automation

Tipp: Beginne mit einfachen Webhook-Workflows und erweitere 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. Teste alle Workflows ausführlich in einer Staging-Umgebung, bevor du sie in der Produktion einsetzt.

Statt einzelner HTTP-Aktionen ein ganzes Toolset auf einmal? Externen MCP-Server verbinden — Tools werden automatisch erkannt. Siehe MCP-Server.

Mid-Call-Tools

Mid-Call-Tools Integrationen

Webhook-Integration mit Famulor Automation

Webhook-Integration mit Famulor Automation

Überblick der Webhook-Integration

Direkte API vs. Webhook

Erweiterte Möglichkeiten

Funktionsweise

Webhook-Tool konfigurieren

1. Basis-Konfiguration

2. Request Body Template

3. Parameter-Schema

Praxisbeispiele für Webhook-Workflows

1. Lead-Qualifizierung & -Routing

2. Customer Success Automation

3. Sales Opportunity Management

Erweiterte Webhook-Konfigurationen

Multi-Workflow-Orchestration

Error Handling & Retry Logic

Response-Verarbeitung

Webhook Response Format

KI-Integration der Webhook-Results

Performance & Monitoring

Webhook-Performance-Metriken

Monitoring & Alerting

Best Practices

Workflow-Design

Idempotenz sicherstellen

Performance-Optimierung

Security Considerations

Integration-Beispiele

​Webhook-Integration mit Famulor Automation

​Überblick der Webhook-Integration

Direkte API vs. Webhook

Erweiterte Möglichkeiten

​Funktionsweise

​Webhook-Tool konfigurieren

​1. Basis-Konfiguration

​2. Request Body Template

​3. Parameter-Schema

​Praxisbeispiele für Webhook-Workflows

​1. Lead-Qualifizierung & -Routing

​2. Customer Success Automation

​3. Sales Opportunity Management

​Erweiterte Webhook-Konfigurationen

​Multi-Workflow-Orchestration

​Error Handling & Retry Logic

​Response-Verarbeitung

​Webhook Response Format

​KI-Integration der Webhook-Results

​Performance & Monitoring

​Webhook-Performance-Metriken

​Monitoring & Alerting

​Best Practices

​Workflow-Design

Idempotenz sicherstellen

Performance-Optimierung

​Security Considerations

Integration-Beispiele

Webhook-Integration mit Famulor Automation

Überblick der Webhook-Integration

Funktionsweise

Webhook-Tool konfigurieren

1. Basis-Konfiguration

2. Request Body Template

3. Parameter-Schema

Praxisbeispiele für Webhook-Workflows

1. Lead-Qualifizierung & -Routing

2. Customer Success Automation

3. Sales Opportunity Management

Erweiterte Webhook-Konfigurationen

Multi-Workflow-Orchestration

Error Handling & Retry Logic

Response-Verarbeitung

Webhook Response Format

KI-Integration der Webhook-Results

Performance & Monitoring

Webhook-Performance-Metriken

Monitoring & Alerting

Best Practices

Workflow-Design

Security Considerations