aiaibot Helpcenter
AppChangelog
  • Willkommen
  • Allgemein
    • Workspace, Projekte & Einstellungen
      • 2-Faktor-Authentifizierung
      • Workspace
      • Projekte
      • Projekt duplizieren
      • Benutzerverwaltung und Rollen
      • Passwort zurücksetzen
      • Profileinstellungen und persönliche Daten ändern
      • Datensicherheit
      • Feature Request und Bug Report
  • Chatbot
    • Integration
      • Domains konfigurieren
      • Integration über Slack
      • Website-Integration
      • Google Tag Manager Integration
      • Warum sehe ich meinen Chatbot nicht?
      • Cookies anpassen
      • Unblu Live-Chat integrieren
    • Stories & Story Builder
      • Story - Diagrammansicht
      • Konfiguration vom Chat Ende
      • Was ist der Story Builder?
      • Was ist eine Story?
      • Story Übersicht
      • Eine Story erstellen
      • Eine Story kopieren/duplizieren
      • Storys untereinander verlinken
      • Wie kann ich eine Story exportieren?
      • Eine Story wiederherstellen
      • Speichern, Entwurf- und Live-Version
      • Vorschau und Testen Ihres Chatbots
      • Chatbot Aussehen mit dem Styler anpassen
      • Verwendung von Variablen
      • Trigger
      • User Sessions
      • KPI Dashboard
    • Widgets
      • Modifier
      • Ghost message
      • Text
      • Medien
      • Benutzereingabe
        • Text, E-Mail und Telefon
        • Datum und Uhrzeit
        • Standort
      • Datei-Upload
      • Datei-Download
      • Dynamische Liste
      • Karussell
      • Entscheidung
      • Entscheidung Links
      • AI Indent
      • FAQ
      • Umfrage
      • Dialogübergabe an E-Mail
      • Live-Chat
      • Story Link
      • Sub Story
      • Checkpoint
      • Go-To Ziel
      • Variable
      • Robot
  • AI
    • Knowledge Base
      • Quelle
  • Robot
    • Workflows
      • Workflow Liste
      • Variablen
        • Datentypen
        • E-Mail-Variablen
      • Workflow Protokoll
      • Sub-Workflows
    • Plugins
      • AI
        • Suche in Wissensdatenbank
      • Chatbot
        • Konversationspfad festlegen
        • Dynamische Liste erstellen
        • Dynamische Liste befüllen
        • Nachricht an Chatbot senden
      • Textverarbeitung
        • Text in Datumsobjekte umwandeln
        • Datumsobjekte in Text umwandeln
        • Text erstellen
        • Dezimal-Variable formatieren
        • Text extrahieren
        • Umändern von Texten
        • Regular Expression abgleichen
        • Text verändern
        • Teilen eines Textes
        • Ersetzen im Text
        • Suche in Text
        • Text abschneiden
      • Collections
        • Element zur Collection hinzufügen
        • Element aus Collection lesen
        • Element entfernen
        • Collection löschen
        • Collection-Element prüfen
        • Elemente in einer Collection abzählen
        • Collection sortieren
        • Doppelte Elemente entfernen
        • Elemente zusammenängen
      • Speicher
        • Speichern eines Wertes
        • Laden eines Wertes
        • Speichern einer Datei
      • E-Mail und SMS
        • E-Mail senden
        • E-Mail verschieben
        • E-Mail ändern
        • E-Mail weiterleiten
        • Senden einer Textnachricht
      • Web
        • Dateiinhalt erkennen
        • Datei herunterladen
        • Dateien hochladen
        • URL-Parameter auslesen
      • REST APIs und JSON
        • API-Endpunkt aufrufen
        • Streaming API-Endpunkt aufrufen
        • JSON abfragen
        • Abfrage JSON (mehrfach)
        • JSON erstellen
        • REST Web-Service aufrufen
      • Datenbanken
        • Datenbank abfragen (SQL)
        • Datenbank aktualisieren
      • Session
        • Token senden
        • Token verifizieren
        • Authentifikation prüfen
        • Session beenden
      • Diverse
        • Rechnen mit Datum oder Zeitstempel
        • Workflow abbrechen
        • Öffnungszeiten
        • Zählen
        • Berechnung durchführen
        • ID generieren
        • Zufallszahl generieren
        • Log-Eintrag
        • Variablenwert bedingt setzen
        • Variablenwert setzen
        • Sub-Workflow ausführen
        • Warten
      • Muster für Datumsobjekte
    • Connectoren
      • Aktiv
        • Exchange Online
        • Timer
        • POP3 / IMAP
      • Passiv
        • Sub-Workflow
        • JSON
        • Webformular
      • Konfiguration
        • Microsoft Graph API
        • Datenbank
        • SMTP
    • Data Store
      • Key-Value Store
      • Projektvariablen
    • API Spezifikationen
      • Request-Header
      • Endpunkte
      • Platzhalter
      • JSON als Request-Body
    • Live Log
    • Sessionmanagement
    • Einstellungen
    • Microsoft Azure App Registration
    • Teams Integration
Bereitgestellt von GitBook
Auf dieser Seite
  • Einsatz von Platzhaltern
  • Beispiel
  1. Robot
  2. API Spezifikationen

Platzhalter

Zuletzt aktualisiert vor 6 Monaten

Damit Daten dynamisch in Endpunkte einfliessen können, kann mit sogenannten Platzhaltern gearbeitet werden. Diese Platzhalter können flexibel definiert und im Workflow Builder mit Variablen verknüpft werden. Bei der Ausführung des Workflows wird der Platzhalter durch den tatsächlichen Wert der zugewiesenen Variable ersetzt.

Ein Platzhalter muss im Format ${platzhalter} definiert werden, wobei der Name des Platzhalters zwischen den geschweiften Klammern {} angegeben wird. Der Name kann dabei beliebig gewählt werden, was eine hohe Flexibilität bei der Verwendung von Platzhaltern ermöglicht.

Einsatz von Platzhaltern

Platzhalter können an verschiedenen Stellen innerhalb der API Spezifikation verwendet werden, um dynamische Werte zur Laufzeit zu integrieren. Die möglichen Einsatzorte für Platzhalter sind:

  • Hostname der API: Der Hostname, also die Basis-URL der API, kann mit einem Platzhalter versehen werden, der zur Laufzeit durch den entsprechenden Wert ersetzt wird.

  • Wert eines Headers: Platzhalter können auch in den Headern eines HTTP-Requests verwendet werden, sodass zum Beispiel ein Authentifizierungstoken oder ein benutzerdefinierter Header dynamisch ersetzt wird.

  • Pfad des Endpunkts: Der Pfad, also die URL des Endpunkts, zu dem die Anfrage gesendet wird, kann ebenfalls Platzhalter enthalten, die durch Variablen ersetzt werden.

  • Body des Requests: Der Inhalt (Body) des HTTP-Requests kann mit Platzhaltern versehen werden, um Daten, wie z. B. Benutzereingaben oder dynamisch generierte Werte, zu übermitteln.

Diese Platzhalter bieten eine hohe Flexibilität, da Sie die API-Aufrufe dynamisch anpassen können, basierend auf den zur Verfügung stehenden Variablen im Workflow.

Beispiel

Der folgende Endpunkt hat zwei Platzhalter im Pfad und einen im Request-Body definiert:

Wird dieser Endpunkt im Workflow Builder mit dem Plugin API Endpunkt aufrufen verwendet, so muss für die drei Platzhalter userId, ticketId und description eine Variable ausgewählt werden. Der tatsächliche Wert der Variablen zur Laufzeit wird dann anstellte der Platzhalter eingefügt.

Endpunkt mit Platzhaltern
Variablenauswahl für Platzhalter