Operations-Agent: Auslöser

Ein Auslöser ist das erste Kästchen auf dem Board: Er bestimmt, wann der Ablauf läuft und mit welchen Daten er beginnt. Jede Art von Auslöser kann einmal auf einem Board stehen, und ein Board kann mehrere Arten enthalten (zum Beispiel einen Anruf der Telefonanlage und einen manuellen Lauf). Auslöser starten Läufe nur, solange der Agent aktiv ist; ein Testlauf aus dem Designer funktioniert in beiden Fällen.

Anruf beendet (Telefonanlage)#

Jeder von der Telefonanlage des Projekts protokollierte Anruf startet den Ablauf. Die Telefonanlage wird einmal für das ganze Projekt unter Integrationen verbunden (siehe Kontakte und Telefonanlagen-Anbindung). Der Auslöser gibt den Schritten:

• caller_number, caller_name, callee_number, callee_name, direction (eingehend, ausgehend, intern)
• duration_sec, status (angenommen, verpasst und so weiter), subject, extension (der Name des Nebenstellenbenutzers)
• recording_url (der Download-Link der Telefonanlage) und recording_ref (der Dateiname der Aufnahme)
• call_id, contact_id, contact_number

Ein verpasster Anruf hat keine Aufnahme. Die Schritte, die eine benötigen (Herunterladen, Transkribieren, Zusammenfassen, Bericht), markieren sich als Übersprungen: nichts zu tun, und der Lauf wird trotzdem abgeschlossen, sodass ein verpasster Anruf nie einen Lauf auf Wiederholungen warten lässt.

Behalten Sie recording_url innerhalb des Ablaufs: Der Link enthält das Download-Geheimnis der Telefonanlage. Um eine Aufnahme in einem anderen System zu identifizieren, senden Sie stattdessen recording_ref.

Ein Anruf der Telefonanlage kann mehrere Agents starten: Jeder aktive Agent mit diesem Auslöser läuft darauf.

Webhook empfangen#

Alles, was JSON senden kann, kann den Agent starten: Das Board zeigt die eigene URL des Agents im Inspektor (auch unter Einstellungen). Der Body der Anfrage wird zu den Daten des Auslösers, ein Feld order_id im Body ist also {{trigger.order_id}} in den Schritten.

Läuft nach Zeitplan#

Startet den Ablauf stündlich, jeden Tag um 09:00, an Werktagen um 09:00, jeden Montag um 09:00, am Ersten des Monats um 09:00 oder nach Ihrem eigenen Cron-Ausdruck, in der von Ihnen gewählten Zeitzone, höchstens alle fünf Minuten. Zwei Entscheidungen:

• Wenn der vorige Lauf noch läuft: diesen überspringen oder einreihen.
• Während eines Ausfalls verpasste Auslösungen: überspringen oder einmal ausführen.

Nach dem Speichern zeigt der Designer die geschätzten Läufe und Kosten pro Monat, denn jeder Lauf berechnet mindestens 30 Sekunden Automatisierung. Die Übersicht zeigt den nächsten geplanten Lauf. Der Auslöser liefert scheduled_for, fired_at, cron, timezone und missed_by_s.

Von einem anderen Agent aufgerufen#

Ein anderer Operations-Agent des Projekts übergibt diesem Daten, mit Anderen Agent aufrufen oder dem Verteiler. Die gesendeten Daten sind die Daten des Auslösers; caller_agent und caller_run_id geben an, wer aufgerufen hat. Verwenden Sie dies für Agents, die eine Aufgabe für mehrere andere erledigen.

Manueller Lauf#

Startet den Ablauf aus der Konsole oder über die API mit Daten, die Sie eingeben. Nützlich für Boards, die Sie bei Bedarf ausführen, etwa um eine Aufnahme anhand ihrer URL zu transkribieren.

Auf das echte Ereignis hören#

Die Auslöser Webhook empfangen, Anruf beendet (Telefonanlage) und Von einem anderen Agent aufgerufen haben im Inspektor eine Schaltfläche Mithören. Drücken Sie sie und lösen Sie dann das Ereignis aus: Senden Sie den Webhook aus dem anderen System, führen Sie an der Telefonanlage einen Anruf und legen Sie auf, oder führen Sie das Board aus, das diesen Agent aufruft. Das nächste Ereignis wird im Inspektor genau so angezeigt, wie der Auslöser es empfangen würde, formatiert, und es wird nicht ausgeführt, selbst wenn der Agent deaktiviert ist. Das Mithören dauert zehn Minuten. Drücken Sie Als Testdaten verwenden, um das Board mit genau diesen Daten auszuführen.

So lernen Sie am schnellsten die echten Feldnamen kennen, die ein System sendet, statt sie zu raten.