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 wird für seine Arbeitszeit abgerechnet. 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.

WhatsApp-Nachricht empfangen#

Ein Kunde hat an eine der WhatsApp-Nummern des Projekts geschrieben (siehe WhatsApp: Ihr Agent auf Ihrer Geschäftsnummer). Nur Kundennachrichten: Die Antworten Ihres Teams haben einen eigenen Auslöser. Grenzen Sie ihn ein mit Nummer (leer: jede Nummer des Projekts), Nachrichtentyp, Welche Nachrichten (jede Nachricht, die erste Nachricht eines Gesprächs oder eine Nachricht nach 24 Stunden Stille, die ein neues 24-Stunden-Fenster öffnet) und Text enthält, das auch in einer Bildunterschrift oder im Transkript einer Sprachnachricht sucht. Der Auslöser gibt den Schritten:

• from (die Telefonnummer des Kunden, leer, wenn er sie verbirgt), user_id (seine WhatsApp-Nutzer-ID, immer vorhanden), username, profile_name
• text (bei einer Sprachnachricht ihr Transkript), type, caption, media, location
• conversation_id, wamid, timestamp, number_id, number, contact_id, window_open_until, window_opened, first_in_conversation
• answered_by: wer diese Nachricht nach den Antworteinstellungen der Nummer beantwortet (agent, team_then_agent oder team), damit ein Board nur handelt, wenn Menschen antworten werden

Verwenden Sie event_id (gleich wamid), wenn das System, an das Sie senden, einen Schlüssel braucht, der sich nie wiederholt.

Ihr Team hat auf WhatsApp geantwortet#

Jemand aus Ihrem Team hat einem Kunden auf WhatsApp geantwortet, aus der Konsole oder aus der WhatsApp-Business-App auf dem Telefon. Grenzen Sie ihn ein mit Nummer, Gesendet aus (der Konsole oder der App auf dem Telefon) und Text enthält. Er gibt den text der Antwort, sent_by, rep_name (wer geantwortet hat, aus der Konsole), agent_paused_until, conversation_id und wamid sowie from und user_id des Kunden. Ein typischer Einsatz: die Antworten Ihres Teams in Ihrem CRM protokollieren.

Auf das echte Ereignis hören#

Die Auslöser Webhook empfangen, Anruf beendet (Telefonanlage), Von einem anderen Agent aufgerufen, WhatsApp-Nachricht empfangen und Ihr Team hat auf WhatsApp geantwortet 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, führen Sie das Board aus, das diesen Agent aufruft, schreiben Sie von einem Telefon an die WhatsApp-Nummer, oder antworten Sie einem Kunden aus der Konsole oder der WhatsApp-Business-App. 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.