Wissensdatenbank
Ereignisse aus Ihrer App
Melden Sie OpenEmail, was ein Kontakt in Ihrem Produkt getan hat, um eine Automatisierung zu starten oder eine Wartezeit zu beenden.
Details
- Ein Ereignis sagt, dass ein Kontakt in Ihrem Produkt etwas getan hat: eine Bestellung aufgegeben, eine Testphase begonnen, den Tarif gewechselt. Sie senden es mit POST /events und benennen den Kontakt über seine Adresse und das Ereignis mit einem Namen Ihrer Wahl, etwa order.placed.
- Ein Ereignis startet jede aktive Automatisierung, deren Auslöser es nennt, und beendet eine Wartezeit, die darauf gewartet hat. Ein Ja-oder-Nein-Schritt kann außerdem fragen, ob ein Kontakt in den letzten Tagen ein Ereignis ausgelöst hat.
- Eigenschaften reisen mit dem Ereignis mit, bis zu 50 Schlüssel. Ein Auslöser kann danach filtern und eine E-Mail kann sie als Vorlagenwerte verwenden, sodass eine Bestellnummer oder ein Tarifname in der Nachricht ankommt.
- Ereignisse werden 90 Tage aufbewahrt, und der Tab Personen einer Automatisierung zeigt, was Ihr Produkt über jeden Kontakt gemeldet hat. Ein Schlüssel oder eine App darf 600 Ereignisse pro Minute senden, und ein Sammelaufruf erfasst bis zu 100.
- Ereignisse gibt es in der REST API als POST /events und POST /events/batch, in jedem SDK als events.send und events.sendBatch, auf der Kommandozeile als openemail events und auf dem MCP-Server als sendContactEvent und sendContactEvents.