> ## 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.

# HubSpot Lead-Erstellung

> Automatische Lead-Generierung und -Qualifizierung in HubSpot direkt während Telefongesprächem

# HubSpot Lead-Erstellung Template

Transformiere eingehende Anrufe automatisch in qualifizierte Leads in deinem HubSpot CRM. Dieses Tool ermöglicht es deinem KI-Assistenten, während des Gesprächs neue Kontakte zu erstellen, zu qualifizieren und mit relevanten Informationen anzureichern.

## Überblick & Funktionen

<CardGroup cols={2}>
  <Card title="Automatische Lead-Erfassung" icon="magic">
    * Echtzeit-Kontakterstellung aus Gespräch
    * Intelligente Datenextraktion (Name, E-Mail, Firma)
    * Lead-Score-Berechnung basierend auf Gespräch
    * Automatische Kategorisierung und Tagging
  </Card>

  <Card title="BANT-Qualifizierung" icon="star">
    * Budget-Assessment durch Gesprächsanalyse
    * Authority-Level-Bestimmung
    * Need-Analysis und Pain-Point-Identifikation
    * Timeline-Ermittlung für Kaufentscheidung
  </Card>
</CardGroup>

## Lead-Erstellung-Tool konfigurieren

### 1. Basis-Tool-Setup

<Tabs>
  <Tab title="Tool-Konfiguration">
    | Parameter         | Wert                                                                                                                                                                             |
    | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Funktionsname** | `create_hubspot_lead`                                                                                                                                                            |
    | **Beschreibung**  | "Erstellt einen neuen Lead in HubSpot basierend auf Gesprächsinformationen. Verwenden Sie dies, wenn ein potentieller Kunde Interesse zeigt und noch nicht im System existiert." |
    | **HTTP-Methode**  | `POST`                                                                                                                                                                           |
    | **Timeout**       | `7000ms`                                                                                                                                                                         |
    | **URL**           | `https://api.hubapi.com/crm/v3/objects/contacts`                                                                                                                                 |
  </Tab>

  <Tab title="Headers">
    ```yaml theme={null}
    Authorization: "Bearer IHRE_HUBSPOT_API_KEY"
    Content-Type: "application/json"
    User-Agent: "Famulor-LeadGen/1.0"
    ```
  </Tab>
</Tabs>

### 2. Request Body Template

```json theme={null}
{
  "properties": {
    "firstname": "{first_name}",
    "lastname": "{last_name}",
    "email": "{email_address}",
    "phone": "{phone_number}",
    "company": "{company_name}",
    "jobtitle": "{job_title}",
    "website": "{company_website}",
    "lifecyclestage": "lead",
    "leadsource": "phone_call",
    "hs_lead_status": "NEW",
    "lead_score": "{calculated_score}",
    "notes_last_updated": "{conversation_summary}",
    "budget_range": "{estimated_budget}",
    "timeline": "{buying_timeline}",
    "pain_points": "{identified_challenges}",
    "interest_level": "{engagement_score}",
    "hs_analytics_source": "famulor_ai_call",
    "createdate": "{current_timestamp}"
  }
}
```

### 3. Parameter-Schema

```json theme={null}
{
  "type": "object",
  "properties": {
    "first_name": {
      "type": "string",
      "description": "Vorname des Kontakts"
    },
    "last_name": {
      "type": "string", 
      "description": "Nachname des Kontakts"
    },
    "email_address": {
      "type": "string",
      "format": "email",
      "description": "E-Mail-Adresse des Leads"
    },
    "phone_number": {
      "type": "string",
      "description": "Telefonnummer des Kontakts"
    },
    "company_name": {
      "type": "string",
      "description": "Name des Unternehmens"
    },
    "job_title": {
      "type": "string",
      "description": "Position/Jobtitel des Kontakts"
    },
    "company_website": {
      "type": "string",
      "description": "Website des Unternehmens (falls erwähnt)"
    },
    "calculated_score": {
      "type": "integer",
      "description": "Lead-Score basierend auf Gesprächsqualität (0-100)",
      "minimum": 0,
      "maximum": 100
    },
    "conversation_summary": {
      "type": "string",
      "description": "Zusammenfassung der wichtigsten Gesprächspunkte"
    },
    "estimated_budget": {
      "type": "string",
      "description": "Geschätzter oder genannter Budget-Range"
    },
    "buying_timeline": {
      "type": "string",
      "description": "Zeitrahmen für Kaufentscheidung"
    },
    "identified_challenges": {
      "type": "string",
      "description": "Im Gespräch identifizierte Herausforderungen/Pain Points"
    },
    "engagement_score": {
      "type": "string",
      "enum": ["low", "medium", "high"],
      "description": "Interesse-Level basierend auf Gesprächsengagement"
    }
  },
  "required": ["first_name", "last_name", "phone_number"]
}
```

## Intelligente Lead-Qualifizierung

### BANT-Framework Implementation

```mermaid theme={null}
flowchart TD
    A[Gespräch beginnt] --> B[Kontakt-Grunddaten sammeln]
    B --> C{Budget erwähnt?}
    C -->|Ja| D[Budget-Range erfassen]
    C -->|Nein| E[Budget-Indikation suchen]
    D --> F{Authority-Level?}
    E --> F
    F --> G[Entscheidungsbefugnis bewerten]
    G --> H{Need identifiziert?}
    H -->|Ja| I[Pain Points dokumentieren]  
    H -->|Nein| J[Bedarf-Exploration]
    I --> K{Timeline genannt?}
    J --> K
    K --> L[Lead-Score berechnen]
    L --> M[create_hubspot_lead]
    M --> N[Follow-up-Aktivitäten planen]
```

<AccordionGroup>
  <Accordion title="Budget-Assessment">
    **Automatische Budget-Erkennung**:

    ```yaml theme={null}
    Direktangaben:
      "Unser Budget liegt bei 50.000€" → budget_range: "50k-60k"
      "Wir haben etwa zehntausend Euro eingeplant" → budget_range: "10k-15k"

    Indirekte Hinweise:
      "Wir sind ein kleines Startup" → budget_range: "under_10k"
      "Das Budget ist nicht das Problem" → budget_range: "flexible"
      "Wir müssen schauen..." → budget_range: "limited"

    Lead-Score-Einfluss:
      High Budget (&gt;50k): +25 Punkte
      Medium Budget (10-50k): +15 Punkte  
      Low Budget (&lt;10k): +5 Punkte
      Unbekannt: 0 Punkte
    ```
  </Accordion>

  <Accordion title="Authority-Assessment">
    **Entscheidungsbefugnis-Klassifikation**:

    ```yaml theme={null}
    Decision Maker:
      Indikatoren: "Ich bin der Geschäftsführer", "Das kann ich entscheiden"
      Lead-Score: +30 Punkte
      Tag: "decision_maker"

    Influencer:
      Indikatoren: "Ich bin der IT-Leiter", "Ich empfehle das dann weiter"
      Lead-Score: +20 Punkte
      Tag: "influencer"

    Gatekeeper:
      Indikatoren: "Ich sammle erst mal Informationen", "Das muss ich weiterleiten"
      Lead-Score: +10 Punkte
      Tag: "gatekeeper"

    User/Stakeholder:
      Lead-Score: +5 Punkte
      Tag: "stakeholder"
    ```
  </Accordion>

  <Accordion title="Need-Analysis">
    **Pain-Point-Kategorisierung**:

    ```yaml theme={null}
    Technical Challenges:
      Keywords: "Integration", "Performance", "Skalierung"
      Category: "technical_needs"
      Urgency: high

    Business Challenges:  
      Keywords: "Effizienz", "Kosten", "Wachstum", "Konkurrenz"
      Category: "business_needs"
      Urgency: medium-high

    Compliance/Security:
      Keywords: "DSGVO", "Sicherheit", "Audit", "Compliance"
      Category: "compliance_needs"
      Urgency: high

    Process Optimization:
      Keywords: "Automatisierung", "Workflow", "Prozess"
      Category: "process_needs"
      Urgency: medium
    ```
  </Accordion>

  <Accordion title="Timeline-Assessment">
    **Buying-Timeline-Klassifikation**:

    ```yaml theme={null}
    Immediate (0-1 Monat):
      Indikatoren: "sofort", "dringend", "so schnell wie möglich"
      Timeline: "immediate"
      Lead-Score: +25 Punkte

    Short-term (1-3 Monate):
      Indikatoren: "in den nächsten Monaten", "bis Quartalsende"
      Timeline: "1-3_months"
      Lead-Score: +20 Punkte

    Medium-term (3-6 Monate):
      Indikatoren: "dieses Jahr noch", "mittelfristig"
      Timeline: "3-6_months" 
      Lead-Score: +15 Punkte

    Long-term (6+ Monate):
      Indikatoren: "nächstes Jahr", "langfristige Planung"
      Timeline: "6+_months"
      Lead-Score: +10 Punkte

    Undefined:
      Timeline: "undefined"
      Lead-Score: +5 Punkte
    ```
  </Accordion>
</AccordionGroup>

## Erweiterte Lead-Anreicherung

### Company-Enrichment-Tool

<Tabs>
  <Tab title="Tool-Konfiguration">
    ```yaml theme={null}
    Funktionsname: enrich_hubspot_company
    Beschreibung: "Reichert Lead mit Firmendaten an, basierend auf Firmenname oder Website"
    HTTP-Methode: POST
    URL: https://api.hubapi.com/crm/v3/objects/companies
    ```
  </Tab>

  <Tab title="Request Body">
    ```json theme={null}
    {
      "properties": {
        "name": "{company_name}",
        "domain": "{company_website}",
        "industry": "{identified_industry}",
        "numberofemployees": "{estimated_company_size}",
        "annualrevenue": "{estimated_revenue}",
        "company_source": "ai_conversation_analysis",
        "description": "{company_description_from_conversation}"
      }
    }
    ```
  </Tab>
</Tabs>

### Lead-Company-Association

```json theme={null}
{
  "associations": [
    {
      "to": {
        "id": "{company_id}"
      },
      "types": [
        {
          "associationCategory": "HUBSPOT_DEFINED",
          "associationTypeId": 1
        }
      ]
    }
  ]
}
```

## Praktische Implementierung

### Szenario 1: Inbound-Lead aus Cold-Call

<Steps>
  <Step title="Erstkontakt & Datensammlung">
    ```yaml theme={null}
    KI-Assistent: "Darf ich fragen, mit wem ich spreche?"
    Kunde: "Hier ist Max Mustermann von der Beispiel GmbH"

    → Automatic Data Extraction:
      first_name: "Max"
      last_name: "Mustermann"  
      company_name: "Beispiel GmbH"
    ```
  </Step>

  <Step title="Bedarf-Exploration">
    ```yaml theme={null}
    KI: "Wobei kann ich Ihnen denn helfen?"
    Kunde: "Wir suchen eine neue CRM-Lösung. Unser aktuelles System 
            ist zu langsam und die Integration funktioniert nicht."

    → Pain Point Analysis:
      pain_points: "Performance-Probleme, Integration-Challenges"
      category: "technical_needs"
      urgency: "high"
    ```
  </Step>

  <Step title="BANT-Qualifizierung">
    ```yaml theme={null}
    Budget: "Was haben Sie sich budgetmäßig vorgestellt?"
    Authority: "Wer trifft bei Ihnen die Entscheidung für Software?"
    Need: "Welche Funktionen sind für Sie am wichtigsten?"
    Timeline: "Bis wann möchten Sie eine Lösung implementiert haben?"

    → Lead-Score-Berechnung basierend auf Antworten
    ```
  </Step>

  <Step title="Lead-Creation & Follow-up">
    ```yaml theme={null}
    create_hubspot_lead(
      first_name: "Max",
      last_name: "Mustermann",
      company_name: "Beispiel GmbH", 
      calculated_score: 75,
      timeline: "1-3_months",
      pain_points: "CRM Performance & Integration issues"
    )

    → Automatic Follow-up Task Creation
    → Sales-Team-Benachrichtigung
    ```
  </Step>
</Steps>

### Szenario 2: Warm-Lead mit hohem Intent

```mermaid theme={null}
sequenceDiagram
    participant C as Caller
    participant AI as KI-Assistant
    participant LC as Lead Creation Tool
    participant CC as Company Creation Tool
    participant DT as Deal Tool
    participant NT as Notification Tool
    
    C->>AI: "Ich habe Ihre Anzeige gesehen..."
    AI->>AI: High-Intent-Signal erkannt
    C->>AI: Teilt Kontaktdaten & Bedarf
    AI->>LC: create_hubspot_lead (Score: 85)
    LC-->>AI: Lead erstellt (ID: 12345)
    AI->>CC: create/enrich_company
    CC-->>AI: Company-ID
    AI->>DT: create_initial_opportunity
    DT-->>AI: Deal erstellt  
    AI->>NT: notify_sales_team (Hot Lead!)
    AI->>C: "Perfekt! Ich verbinde Sie mit unserem Experten..."
```

## Response-Verarbeitung & Follow-up

### Erfolgreiche Lead-Erstellung

```json theme={null}
{
  "id": "lead12345",
  "properties": {
    "firstname": "Max",
    "lastname": "Mustermann",
    "email": "max@beispiel.de",
    "company": "Beispiel GmbH",
    "lifecyclestage": "lead",
    "hs_lead_status": "NEW",
    "lead_score": "75",
    "createdate": "2024-01-15T10:30:00.000Z"
  },
  "createdAt": "2024-01-15T10:30:00.000Z"
}
```

### Automatische Follow-up-Workflows

<AccordionGroup>
  <Accordion title="Sofortige Aktionen">
    **Unmittelbar nach Lead-Erstellung**:

    ```yaml theme={null}
    1. Lead-Bestätigungs-E-Mail senden
    2. Sales-Team-Benachrichtigung (bei Score &gt;70)
    3. CRM-Aufgabe erstellen: "Lead-Follow-up innerhalb 24h"
    4. Lead in entsprechende HubSpot-Liste einordnen
    5. Marketing-Automation-Sequenz starten
    ```
  </Accordion>

  <Accordion title="Zeitverzögerte Workflows">
    **24-48 Stunden später**:

    ```yaml theme={null}
    Wenn kein Sales-Kontakt erfolgte:
      → Automated Follow-up E-Mail
      → SMS-Erinnerung (bei hohem Score)
      → Manager-Eskalation (bei Score &gt;80)

    Nach 1 Woche:
      → Lead-Nurturing-E-Mail-Serie
      → LinkedIn-Connection-Request
      → Re-Engagement-Call planen
    ```
  </Accordion>

  <Accordion title="Lead-Scoring-Updates">
    **Kontinuierliche Score-Anpassung**:

    ```yaml theme={null}
    E-Mail-Engagement: +5 Punkte
    Website-Besuche: +3 Punkte pro Session
    Content-Downloads: +10 Punkte
    Demo-Request: +25 Punkte
    Pricing-Page-Besuche: +15 Punkte
    ```
  </Accordion>
</AccordionGroup>

## Duplicate-Management

### Intelligent Duplicate Detection

<Tabs>
  <Tab title="Pre-Creation-Check">
    ```yaml theme={null}
    Tool: check_existing_contact
    Method: GET
    URL: https://api.hubapi.com/crm/v3/objects/contacts/search

    Search-Criteria:
      - E-Mail-Adresse (exakter Match)
      - Telefonnummer (normalisierter Vergleich)
      - Firmenname + Nachname (fuzzy Match)

    Wenn Match gefunden:
      → update_existing_contact statt create_new
      → Lead-Score addieren statt überschreiben
      → Conversation-History anhängen
    ```
  </Tab>

  <Tab title="Post-Creation-Cleanup">
    ```yaml theme={null}
    HubSpot-Workflow:
      Trigger: Neue Kontakt-Erstellung
      Bedingung: Duplicate-Score &gt;80%
      Aktion: 
        - Merge-Vorschlag an Sales-Team
        - Temporary-Hold auf Automated Follow-ups
        - Manual Review Required Tag
    ```
  </Tab>
</Tabs>

## Erweiterte Konfigurationen

### Industry-Specific Lead Templates

<AccordionGroup>
  <Accordion title="SaaS/Tech Companies">
    ```yaml theme={null}
    Additional_Fields:
      tech_stack: "Aktuelle Software-Landschaft"
      integration_requirements: "Benötigte Integrationen" 
      user_count: "Anzahl geplanter User"
      compliance_requirements: "DSGVO, SOC2, etc."
      current_solution: "Bestehende Lösung"
      
    Custom_Scoring:
      Enterprise_Size (+20): &gt;500 Employees
      High_Tech_Stack (+15): Modern APIs mentioned
      Compliance_Needs (+10): Security/Privacy concerns
    ```
  </Accordion>

  <Accordion title="E-Commerce">
    ```yaml theme={null}
    Additional_Fields:
      platform_current: "Aktuelle E-Commerce-Plattform"
      monthly_revenue: "Monatlicher Umsatz"
      product_count: "Anzahl Produkte"
      international_sales: "Internationale Verkäufe?"
      growth_challenges: "Hauptwachstumshürden"
      
    Custom_Scoring:
      High_Revenue (+25): &gt;100k monthly
      Growth_Stage (+15): "schnell wachsend"
      Multi_Channel (+10): "Omnichannel"
    ```
  </Accordion>

  <Accordion title="Professional Services">
    ```yaml theme={null}
    Additional_Fields:
      service_focus: "Hauptdienstleistungsbereich"
      client_size_focus: "Zielkundengruppe"
      current_tools: "Aktuell genutzte Tools"
      team_size: "Größe des Teams"
      billing_model: "Abrechnungsmodell"
      
    Custom_Scoring:
      Established_Practice (+20): &gt;3 Jahre
      Growing_Team (+15): Hiring mentioned
      Process_Pain (+10): Efficiency issues
    ```
  </Accordion>
</AccordionGroup>

### Multi-Language Support

```yaml theme={null}
German_Localization:
  field_labels:
    firstname: "Vorname"
    lastname: "Nachname" 
    company: "Unternehmen"
    jobtitle: "Position"
  
  pain_point_detection:
    efficiency: ["Effizienz", "Produktivität", "Zeitersparnis"]
    cost: ["Kosten", "Budget", "Einsparung", "ROI"]
    growth: ["Wachstum", "Skalierung", "Expansion"]
    competition: ["Konkurrenz", "Wettbewerb", "Marktposition"]
```

## Quality Assurance & Monitoring

### Lead-Quality-Metriken

| Metrik                    | Beschreibung                                  | Zielwert    |
| ------------------------- | --------------------------------------------- | ----------- |
| **Data Completeness**     | % der Leads mit vollständigen Kerndaten       | >90%        |
| **Lead-Score-Accuracy**   | Korrelation Score vs. tatsächliche Conversion | >0.7        |
| **Duplicate-Rate**        | % der durch Tool erstellten Duplicates        | \<5%        |
| **Sales-Acceptance-Rate** | % der von Sales akzeptierten Leads            | >80%        |
| **Speed-to-Lead**         | Zeit von Gespräch bis Sales-Kontakt           | \<2 Stunden |

### Automated Quality Checks

<Steps>
  <Step title="Data-Validation">
    ```yaml theme={null}
    Pre-Creation-Checks:
      - E-Mail-Format validieren
      - Telefonnummer normalisieren  
      - Firmenname gegen Blacklist prüfen
      - Spam-Pattern-Detection
    ```
  </Step>

  <Step title="Score-Validation">
    ```yaml theme={null}
    Score-Plausibility:
      - Score vs. Data-Completeness Check
      - Timeline vs. Budget Consistency
      - Authority vs. Company Size Logic
    ```
  </Step>

  <Step title="Post-Creation-Verification">
    ```yaml theme={null}
    Automated_Follow-up:
      - E-Mail-Deliverability-Test
      - Phone-Number-Validation
      - Company-Website-Verification
      - Social-Media-Profile-Enrichment
    ```
  </Step>
</Steps>

***

<Card title="Integration-Empfehlungen" icon="link">
  Optimiere deine Lead-Generierung durch zusätzliche Tool-Kombinationen:

  * [HubSpot Deal Management](/de/automation-platform/mid-call-tools/integration-templates/hubspot-deal-management) für Sales-Pipeline-Verwaltung
  * [Webhook-Integration](/de/automation-platform/mid-call-tools/integration-templates/webhook-automation) für komplexe Multi-System-Workflows
  * [SendGrid Integration](/de/automation-platform/mid-call-tools/integration-templates/sendgrid-integration) für automatische Follow-up-E-Mails
</Card>

<Tip>
  **Pro-Tipp**: Beginne mit einem konservativen Lead-Score-Algorithmus und optimiere basierend auf tatsächlichen Conversion-Daten. Ein zu aggressives Scoring kann zu Lead-Überflutung des Sales-Teams führen.
</Tip>

<Warning>
  **Datenschutz-Hinweis**: Stelle sicher, dass alle erfassten Leads explizit der Kontaktaufnahme zugestimmt haben, und implementiere DSGVO-konforme Opt-out-Mechanismen.
</Warning>

<Tip>
  Statt einzelner HTTP-Aktionen ein ganzes Toolset auf einmal? Externen **MCP-Server** verbinden — Tools werden automatisch erkannt. Siehe [MCP-Server](/de/platform/mcp-servers).
</Tip>