Auslöser

Ein Auslöser sagt dem Agenten, wann er loslegt. Ein Agent kann bis zu 20 Auslöser haben, zum Beispiel montags um acht und zusätzlich bei jeder neuen Konversation.

Auf der Seite des Agenten klickst du unter „Auslöser“ auf „Auslöser“ und wählst eine der drei Arten. Ohne Auslöser läuft der Agent nur, wenn du „Jetzt ausführen“ klickst.

Zeitplan

Unter „Häufigkeit“ wählst du „Stündlich“, „Täglich“, „Wöchentlich“ oder „Monatlich“, dazu Wochentage, Tag im Monat und Uhrzeit. Unten siehst du sofort, wann der nächste Lauf ist.

Bei stündlichen Läufen grenzt du mit „Nur zwischen“ die Zeit ein, etwa von 8 bis 18 Uhr.

Läuft der vorige Lauf noch oder wartet er auf dein Okay, fällt ein geplanter Lauf aus. So stapeln sich keine Läufe, die niemand ansieht.

Ereignis

Der Agent startet, sobald in hausverwalter.ai etwas passiert. Zur Wahl stehen:

• Konversationen: neue Konversation, neue Nachricht, Statuswechsel, erledigt oder wieder geöffnet
• Fälligkeiten: Konversation heute fällig oder überfällig
• Workflow: Karte erreicht eine Phase
• Formulare, Dokumente, Termine, Kontakte und Verträge: zum Beispiel ausgefüllt, gelesen, gebucht oder angelegt

Je nach Ereignis grenzt du weiter ein, etwa auf ein Board, einen Status, ein Formular, einen Tag oder einen Kanal. Der Agent bekommt dann genau das Objekt, um das es geht, also die neue Konversation oder den neuen Vertrag.

Darf der Besitzer das Objekt nicht sehen, läuft der Agent nicht. Kommen viele Ereignisse auf einmal, warten sie in einer Schlange, höchstens 200 pro Agent.

Webhook

Ein anderes System ruft den Agenten über eine eigene Adresse auf, zum Beispiel eure Buchhaltung nach einem Zahlungslauf. Nach dem Speichern siehst du Adresse und Schlüssel ein einziges Mal, kopier sie dir also gleich.

Das System schickt per POST ein JSON an die Adresse, den Schlüssel im Header „X-Hook-Token“. Der Agent liest den Inhalt als Daten, nie als Anweisung. Über „⋯“ › „Neue Adresse erzeugen“ tauschst du die Adresse aus, die alte hört sofort auf.