Benutzerdefinierte API-Aktionen

Kunde: "Was ist der Status meiner Bestellung?"

Agent: (sammelt Bestellnummer vom Kunden)

[Agent ruft API auf]
→ GET https://api.company.com/orders/12345
← { "status": "shipped", "tracking": "1Z999AA10123456789" }

Agent: "Ihre Bestellung wurde versandt! Ihre Sendungsverfolgungsnummer ist
       1Z999AA10123456789 und sollte bis Freitag ankommen."

Kunde: "Was ist der Status meiner Bestellung?"

Agent: "Gerne prüfe ich das für Sie. Aus Sicherheitsgründen muss ich zuerst
       Ihre Identität überprüfen. Was ist Ihre Kundennummer?"
Kunde: "12345"

Agent: "Und zur Verifizierung, was ist Ihre Telefon-PIN?"
Kunde: "5678"

[Agent ruft zuerst Verifizierungs-API auf]
→ POST https://api.company.com/auth/verify
  Body: {"customer_id": "12345", "phone_pin": "5678"}
← { "verified": true, "customer_name": "Max Mustermann" }

[Nur wenn verifiziert, dann Bestellabfrage aufrufen]
→ GET https://api.company.com/customers/12345/orders
← { "orders": [{"id": "ORD-789", "status": "shipped", ...}] }

Agent: "Vielen Dank, Max. Ich habe Ihre Identität verifiziert. Ihre Bestellung
       ORD-789 wurde versandt und sollte bis Freitag ankommen."

Bevor Sie sensible Kundeninformationen nachschlagen:

1. Kunden-ID und Telefon-PIN sammeln
2. Aktion 'Kunde verifizieren' verwenden
3. Wenn Verifizierung fehlschlägt:
   - "Ich kann diese Informationen nicht verifizieren. Aus Sicherheitsgründen
      muss ich Sie zu unserem Verifizierungsteam verbinden."
   - Zu menschlichem Agent weiterleiten
4. Wenn Verifizierung erfolgreich:
   - Mit 'Bestellung nachschlagen' oder anderen sensiblen Aktionen fortfahren

{
  "customer_id": "{{customer_id}}",
  "status": "contacted",
  "timestamp": "{{current_datetime}}"
}

Name: order_number
Typ: string
Beschreibung: Bestellnummer des Kunden
Beispiel: ORD-12345
Erforderlich: Ja

Wenn ein Kunde nach seinem Bestellstatus fragt:

1. Nach seiner Bestellnummer fragen
2. Aktion 'Bestellstatus nachschlagen' verwenden
3. Statusinformationen mit ihm teilen

Wenn die Aktion einen Fehler zurückgibt:
- 404: "Ich sehe keine Bestellung mit dieser Nummer"
- 500: "Ich habe gerade Probleme, auf das System zuzugreifen"
- Anbieten, dass jemand sie zurückruft

# Ihre Aktion hat eine Variable: order_number (erforderlich, string)

Kunde: "Was ist mein Bestellstatus?"
Agent: "Gerne prüfe ich das für Sie. Was ist Ihre Bestellnummer?"
Kunde: "ORD-12345"
Agent: [Ruft API mit order_number="ORD-12345" auf]

# Variable: email (nicht erforderlich, Standard: "not-provided@example.com")

Agent sammelt E-Mail, wenn Kunde sie angibt, verwendet sonst Standard

URL: https://api.company.com/orders/{{order_number}}
Body: {"email": "{{customer_email}}"}

{{contact.first_name}}
{{contact.last_name}}
{{contact.email}}
{{contact.phone_number}}
{{contact.id}}

{{agent_number}}
{{agent_name}}
{{agent_id}}
{{direction}}          # inbound/outbound
{{medium}}            # phone/web
{{current_datetime}}  # ISO 8601 Zeitstempel