Eigene Werkzeuge: Telofy fragt Ihr System, während der Anrufer wartet.

Versandstatus, Lagerbestand, Auftragsstand: Telofy ruft im Gespräch eine Adresse Ihres Systems auf und nennt dem Anrufer das Ergebnis.

Antworten statt RückrufDer Anrufer erfährt den Stand sofort, und Ihr Team muss nicht zurückrufen.
Ihre Daten bleiben bei IhnenTelofy fragt nur an, was Sie als Werkzeug freigeben, und speichert die Antwort nicht in einem eigenen Datenbestand.
Läuft das System nicht, bricht nichts abFällt Ihr System aus, sagt Telofy ehrlich, dass es das gerade nicht nachsehen kann, und nimmt das Anliegen auf.

So legen Sie ein Werkzeug an

Sie brauchen eine https-Adresse, die eine Anfrage entgegennimmt und eine kurze Antwort als Text liefert.

1.Ziel bauenIhr System braucht eine Adresse, die einen POST mit JSON annimmt und innerhalb von vier Sekunden antwortet. Sie muss öffentlich erreichbar und https sein.
2.Werkzeug anlegenIm Portal unter Integrationen > Eigene Werkzeuge „Werkzeug anlegen“ wählen. Geben Sie Funktionsname, Beschreibung, Parameter-Schema und Ziel-Adresse an. Auf Wunsch ergänzen Sie einen Auth-Header samt Geheimnis.
3.Beschreibung genau schreibenDie Beschreibung entscheidet, wann Telofy das Werkzeug nutzt. Schreiben Sie, wonach der Anrufer fragen muss und welche Angabe Telofy dafür erfragt.
4.Antwort im festen AufbauAntworten Sie mit Status 2xx und einem JSON-Objekt mit dem Feld result, das den Satz enthält, den Telofy vorlesen soll.
5.Testanruf machenRufen Sie an und fragen Sie nach dem Gegenstand des Werkzeugs. Klappt es, hören Sie Ihre Antwort aus dem System.

Beispiel: Versandstatus

Parameter-Schema, das Telofy die Bestellnummer erfragen lässt:

{
  "type": "OBJECT",
  "properties": {
    "order_number": { "type": "STRING", "description": "Bestellnummer" }
  },
  "required": ["order_number"]
}

Telofy sendet:

POST /versandstatus HTTP/1.1
Content-Type: application/json

{ "arguments": { "order_number": "A-1042" } }

Ihr System antwortet:

{ "result": "Die Bestellung A-1042 wurde heute mit DHL verschickt und kommt voraussichtlich morgen an." }

Grenzen

  • Bis zu 10 Werkzeuge je Betrieb.
  • 4 Sekunden Zeit je Aufruf, Antwort höchstens 4.000 Byte, der Text in result wird auf 800 Zeichen gekürzt.
  • Weiterleitungen werden nicht verfolgt, private und interne Adressen abgelehnt.
  • Das Werkzeug ist für Auskünfte gedacht. Was Ihr System bei einem Aufruf tut, liegt bei Ihnen.

Ideen

  • Auftragsstand in der Werkstatt: „Ist mein Fahrzeug fertig?“
  • Lieferstatus im Onlinehandel
  • Mitgliedsstatus oder Restguthaben
  • Freie Plätze für einen Kurs

Das Anlegen steht auch in der Referenz für Entwickler.

Häufige Fragen dazu.

Kann Telofy über ein Werkzeug auch etwas in meinem System ändern?

Technisch ruft Telofy nur Ihre Adresse auf. Was Ihr System dabei tut, bestimmen Sie. Gedacht sind die Werkzeuge für Auskünfte; für Änderungen sollte Ihr System selbst absichern, was es zulässt.

Was hört der Anrufer, wenn mein System nicht antwortet?

Er hört nichts Technisches. Telofy sagt, dass es das gerade nicht nachsehen kann, und bietet an, das Anliegen aufzunehmen.

Kostet das extra?

Nein. Eigene Werkzeuge sind in jedem Tarif enthalten. Die Zeit, die der Aufruf im Gespräch braucht, zählt wie jede Gesprächsminute.

Hören Sie ihn, bevor Sie sich entscheiden.

Ein Klick, kein Formular, keine Anmeldung.