Bot-Verbindung: die KI in Ihrem eigenen System nachschlagen lassen

Was es tut

• Vor dem Gespräch: Wenn Ihr System lookup_caller anbietet, erkennt Twilper den Anrufer oder Besucher.
• Während des Gesprächs: Die KI ruft die Tools Ihres Systems auf (zum Beispiel Produktsuche, Bestellstatus, Optionen und Preise). Im Website-Chat sieht der Besucher kurz einen Hinweis, dass nachgeschlagen wird.
• Bestelldetails nennt die KI erst nach Bestellnummer plus E-Mail-Adresse oder Postleitzahl.

Was Sie brauchen

• Einen https-Endpoint in Ihrem eigenen System, gebaut wie unter twilper.com/integrations/api beschrieben.
• Einen Signaturschlüssel mit mindestens 32 Zeichen (oder Sie lassen Twilper einen erstellen).

Einrichten

1. 1

   Schritt 1: Die Bot-Verbindung öffnen

   Gehen Sie zu "Integrationen" und scrollen Sie zu "Verbindung mit Ihrem eigenen System (Bot-Verbindung)".

   

2. 2

   Schritt 2: Den Endpoint eingeben

   Geben Sie die Adresse Ihres Systems in das Feld "Endpoint-URL" ein, zum Beispiel https://ihreseite.de/api/twilper/channel.

3. 3

   Schritt 3: Schlüssel und aktivieren

   Fügen Sie Ihren eigenen Schlüssel in das Feld "Signaturschlüssel" ein oder lassen Sie es leer, damit einer erstellt wird. Haken Sie "Verbindung aktiv" an und klicken Sie auf "Speichern".

Regeln und Einstellungen

• Jede Anfrage ist mit HMAC-SHA256 signiert. Ihr System muss die Signatur prüfen und Anfragen ohne gültige Signatur ablehnen.
• Jede Anfrage enthält einen Kontext mit Kanal, Anrufer oder Besucher und der Angabe, ob die Identität verifiziert ist. Geben Sie nur Daten zurück, die zu dieser Person gehören.
• Die KI nutzt im Website-Chat, in WhatsApp und am Telefon dieselben Tools.

Testen

• Nutzen Sie "Verbindung testen" auf der Karte: Wählen Sie einen Kanal (Website-Chat, WhatsApp oder Telefon), tippen Sie eine Nachricht wie "Wo ist meine Bestellung?" und klicken Sie auf "Test senden". Sie sehen die Antwort und welche Tools die KI aufrufen darf.
• Stellen Sie danach dieselbe Frage im echten Website-Chat und prüfen Sie die Logs Ihres Systems.

Häufige Probleme

• Die KI antwortet selbst statt Ihres Systems: Ihr Endpoint hat nicht innerhalb von 6 Sekunden (Tools: 4 Sekunden) geantwortet oder einen Fehler zurückgegeben. Twilper greift dann auf die eingebaute KI zurück.
• Signatur stimmt nicht: Verwenden Sie den unveränderten Body (raw body) und denselben Schlüssel wie in Twilper.