DHL Integration Template

Integriere DHL-Versandservices in deine Mid-call Actions und ermögliche es deinem KI-Assistenten, während Kundengesprächem automatisch Versandlabels zu erstellen, Sendungen zu verfolgen und Logistik-Prozesse zu optimieren.

Überblick & Funktionen

Automated Shipping

Sofortige Versandlabel-Erstellung während Sales-Calls
Multi-Produkt-Support (Paket, Warenpost, Express)
Automatische Adress-Validierung und -Korrektur
Integration mit E-Commerce-Systemen und CRM

Logistics Management

Echtzeit-Sendungsverfolgung und Status-Updates
Retouren-Management und Return-Labels
Versandkosten-Kalkulation und Optimierung
B2B und B2C Versand-Workflows

DHL API & Business Account Setup

1. DHL Developer Portal & Credentials

DHL Business Account vorbereiten

Stelle sicher, dass du einen DHL Business-Account hast
Notiere deine DHL-Abrechnungsnummer (14-stellig)
Sammle deine Standard-Absenderdaten

DHL Developer Portal registrieren

API-Zugang beantragen:
Besuche das DHL Developer Portal
Account erstellen mit Business-Daten
API-Zugang für "Paket DE API" beantragen
Sandbox-Credentials für Testing erhalten

API-Credentials konfigurieren

Authentication:
  Method: Basic Auth (User:Password)
  
Sandbox-Environment:
  URL: https://api-sandbox.dhl.com/parcel/de/shipping/v2/
  User: Sandbox-Username
  Password: Sandbox-Password
  
Production-Environment:
  URL: https://api.dhl.com/parcel/de/shipping/v2/
  User: Production-Username 
  Password: Production-Password

Basic Auth String generieren

Base64-Encoding:
  Format: "username:password"
  Beispiel: "dhl_user:dhl_password"
  
Base64-Result:
  echo -n "dhl_user:dhl_password" | base64
  → "ZGhsX3VzZXI6ZGhsX3Bhc3N3b3Jk"

Versandlabel-Tool konfigurieren

Konfiguration im Famulor Interface

Werkzeugdetails
Header-Konfiguration
Request Body Template

Feld	Wert
Name*	`DHL Versandlabel erstellen`
Beschreibung	”Erstellt automatisch ein DHL-Versandlabel basierend auf Kunden- und Produktdaten”
Funktionsname*	`create_dhl_label`
Funktionsbeschreibung*	“Erstellt ein DHL Versandlabel. Verwenden Sie dies, wenn ein Kunde eine Bestellung aufgibt oder Sie Dokumente/Produkte versenden möchten.”
HTTP-Methode	`POST`
Timeout (ms)	`10000`
Endpoint*	`https://api-sandbox.dhl.com/parcel/de/shipping/v2/orders`

{
  "Authorization": "Basic {{DHL_CREDENTIALS}}",
  "Content-Type": "application/json",
  "User-Agent": "Famulor-MidCall-DHL/1.0"
}

{
  "profile": "STANDARD_GRUPPENPROFIL",
  "shipments": [
    {
      "product": "{product}",
      "billingNumber": "{billing_number}",
      "refNo": "{reference_number}",
      "shipper": {
        "name": "{shipper_name}",
        "addressStreet": "{shipper_street}",
        "addressHouse": "{shipper_house}",
        "postalCode": "{shipper_postal}",
        "city": "{shipper_city}",
        "country": "DEU",
        "email": "{shipper_email}",
        "phone": "{shipper_phone}"
      },
      "consignee": {
        "name": "{receiver_name}",
        "addressStreet": "{receiver_street}",
        "addressHouse": "{receiver_house}",
        "postalCode": "{receiver_postal}",
        "city": "{receiver_city}",
        "country": "{receiver_country}",
        "email": "{receiver_email}",
        "phone": "{receiver_phone}"
      },
      "details": {
        "weight": {
          "uom": "kg",
          "value": "{weight}"
        },
        "length": {
          "uom": "cm",
          "value": "{length}"
        },
        "width": {
          "uom": "cm", 
          "value": "{width}"
        },
        "height": {
          "uom": "cm",
          "value": "{height}"
        }
      },
      "services": [
        {
          "product": "preferredNeighbour",
          "detail": "{preferred_neighbor}"
        }
      ]
    }
  ]
}

Parameter-Schema

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string",
      "enum": ["V01PAK", "V53WPAK", "V54EPAK"],
      "description": "DHL-Produkt: V01PAK (DHL Paket), V53WPAK (Warenpost), V54EPAK (Europaket)",
      "default": "V01PAK"
    },
    "billing_number": {
      "type": "string",
      "description": "DHL-Abrechnungsnummer (14-stellig)"
    },
    "reference_number": {
      "type": "string",
      "description": "Ihre interne Referenznummer (Bestell-ID, etc.)"
    },
    "shipper_name": {
      "type": "string",
      "description": "Absender Name/Firma"
    },
    "shipper_street": {
      "type": "string",
      "description": "Absender Straße (ohne Hausnummer)"
    },
    "shipper_house": {
      "type": "string",
      "description": "Absender Hausnummer"
    },
    "shipper_postal": {
      "type": "string",
      "description": "Absender Postleitzahl"
    },
    "shipper_city": {
      "type": "string",
      "description": "Absender Stadt"
    },
    "receiver_name": {
      "type": "string",
      "description": "Empfänger Name"
    },
    "receiver_street": {
      "type": "string",
      "description": "Empfänger Straße"
    },
    "receiver_house": {
      "type": "string",
      "description": "Empfänger Hausnummer"
    },
    "receiver_postal": {
      "type": "string",
      "description": "Empfänger PLZ"
    },
    "receiver_city": {
      "type": "string", 
      "description": "Empfänger Stadt"
    },
    "receiver_country": {
      "type": "string",
      "description": "Empfänger Land (3-stelliger ISO-Code, z.B. 'DEU', 'AUT', 'CHE')",
      "default": "DEU"
    },
    "weight": {
      "type": "number",
      "description": "Paketgewicht in Kilogramm",
      "minimum": 0.1,
      "maximum": 31.5
    },
    "length": {
      "type": "number",
      "description": "Paketlänge in cm (optional)",
      "maximum": 120
    },
    "width": {
      "type": "number",
      "description": "Paketbreite in cm (optional)",
      "maximum": 60
    },
    "height": {
      "type": "number",
      "description": "Pakethöhe in cm (optional)",
      "maximum": 60
    }
  },
  "required": ["product", "billing_number", "receiver_name", "receiver_street", "receiver_postal", "receiver_city", "weight"]
}

Praktische Anwendungsszenarien

Szenario 1: Sofort-Versand bei Bestellung

Bestellung während Gespräch

Sales-Call-Kontext:
  Kunde: "Perfekt! Wann kann ich mit der Lieferung rechnen?"
  
KI: "Ich bereite den Versand sofort vor. Können Sie mir Ihre Lieferadresse bestätigen?"

Address-Collection:
  "Max Mustermann, Musterstraße 15, 80331 München"

KI: "Ich erstelle das DHL Versandlabel für Max Mustermann..."

Automatische Label-Erstellung

create_dhl_label Parameter:
  product: "V01PAK"
  billing_number: "22222222220101"
  reference_number: "ORDER-2024-001"
  receiver_name: "Max Mustermann"
  receiver_street: "Musterstraße"
  receiver_house: "15"
  receiver_postal: "80331"
  receiver_city: "München" 
  receiver_country: "DEU"
  weight: 2.5

Versand-Response & Tracking

{
  "shipments": [
    {
      "shipmentNumber": "12345678901234567890",
      "returnShipmentNumber": "98765432109876543210",
      "label": {
        "url": "https://api.dhl.com/parcel/de/shipping/v2/orders/labels/abc123def456"
      }
    }
  ]
}

Success-Kommunikation: "Versandlabel wurde erstellt. Sendungsnummer: {{response.shipments[0].shipmentNumber}}"

Passende Seiten: Introduction und Building Flows und Debugging Runs.

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

DHL Integration

DHL Integration Template

Überblick & Funktionen

Automated Shipping

Logistics Management

DHL API & Business Account Setup

1. DHL Developer Portal & Credentials

Versandlabel-Tool konfigurieren

Konfiguration im Famulor Interface

Parameter-Schema

Praktische Anwendungsszenarien

Szenario 1: Sofort-Versand bei Bestellung

Versand-Response & Tracking

​DHL Integration Template

​Überblick & Funktionen

Automated Shipping

Logistics Management

​DHL API & Business Account Setup

​1. DHL Developer Portal & Credentials

​Versandlabel-Tool konfigurieren

​Konfiguration im Famulor Interface

​Parameter-Schema

​Praktische Anwendungsszenarien

​Szenario 1: Sofort-Versand bei Bestellung

​Versand-Response & Tracking

DHL Integration Template

Überblick & Funktionen

DHL API & Business Account Setup

1. DHL Developer Portal & Credentials

Versandlabel-Tool konfigurieren

Konfiguration im Famulor Interface

Parameter-Schema

Praktische Anwendungsszenarien

Szenario 1: Sofort-Versand bei Bestellung

Versand-Response & Tracking