[{"data":1,"prerenderedAt":803},["ShallowReactive",2],{"search-de":3,"content-de-examples\u002Fevent-automation":4,"surround-de-\u002Fexamples\u002Fevent-automation":796},[],{"id":5,"title":6,"body":7,"description":13,"extension":790,"meta":791,"navigation":194,"path":792,"seo":793,"stem":794,"__hash__":795},"content_de\u002F4.examples\u002F3.event-automation.md","Event-Automatisierung",{"type":8,"value":9,"toc":778},"minimark",[10,14,19,22,26,29,135,147,151,156,396,400,454,458,520,524,531,592,595,685,689,692,719,745,749,774],[11,12,13],"p",{},"Lösen Sie Automatisierungen mit eigenen Events aus — für den Trial-Lebenszyklus, die Feature-Adoption und mehr.",[15,16,18],"h2",{"id":17},"funktionsweise","Funktionsweise",[11,20,21],{},"Wenn Sie ein Event über die API senden, prüft Owlat, ob eine aktive Automatisierung einen passenden Trigger besitzt. Ist das der Fall, läuft die Automatisierung für diesen Kontakt — sie versendet E-Mails, wartet vor dem nächsten Schritt oder verzweigt anhand einer Bedingung. Die Automatisierungen definieren Sie im Dashboard; Ihr Code löst lediglich die Events aus.",[15,23,25],{"id":24},"ihre-events-planen","Ihre Events planen",[11,27,28],{},"Legen Sie ein einheitliches Namensschema fest, bevor Sie mit dem Senden beginnen. Hier ein Beispiel für den Trial-Lebenszyklus eines SaaS-Produkts:",[30,31,32,48],"table",{},[33,34,35],"thead",{},[36,37,38,42,45],"tr",{},[39,40,41],"th",{},"Event-Name",[39,43,44],{},"Wann auslösen",[39,46,47],{},"Vorgeschlagene Eigenschaften",[49,50,51,72,87,104,118],"tbody",{},[36,52,53,60,63],{},[54,55,56],"td",{},[57,58,59],"code",{},"trial_started",[54,61,62],{},"Benutzer legt ein Konto an",[54,64,65,68,69],{},[57,66,67],{},"planName",", ",[57,70,71],{},"trialDays",[36,73,74,79,82],{},[54,75,76],{},[57,77,78],{},"feature_activated",[54,80,81],{},"Benutzer probiert ein zentrales Feature aus",[54,83,84],{},[57,85,86],{},"featureName",[36,88,89,94,97],{},[54,90,91],{},[57,92,93],{},"trial_expiring",[54,95,96],{},"3 Tage vor Ablauf des Testzeitraums",[54,98,99,68,102],{},[57,100,101],{},"daysLeft",[57,103,67],{},[36,105,106,111,114],{},[54,107,108],{},[57,109,110],{},"trial_expired",[54,112,113],{},"Testzeitraum endet",[54,115,116],{},[57,117,67],{},[36,119,120,125,128],{},[54,121,122],{},[57,123,124],{},"plan_upgraded",[54,126,127],{},"Benutzer wechselt zu einem kostenpflichtigen Plan",[54,129,130,68,132],{},[57,131,67],{},[57,133,134],{},"mrr",[136,137,140],"callout",{"title":138,"type":139},"Namenskonventionen","tip",[11,141,142,143,146],{},"Verwenden Sie ",[57,144,145],{},"snake_case"," für Event-Namen. Namen müssen mit einem Buchstaben beginnen und dürfen Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten (maximal 100 Zeichen).",[15,148,150],{"id":149},"events-senden","Events senden",[152,153,155],"h3",{"id":154},"trial-gestartet","Trial gestartet",[157,158,159,308],"code-group",{},[160,161,167],"pre",{"className":162,"code":163,"filename":164,"language":165,"meta":166,"style":166},"language-typescript shiki shiki-themes github-light github-dark-dimmed","import { Owlat } from '@owlat\u002Fsdk-js'\n\nconst owlat = new Owlat('lm_live_...')\n\nawait owlat.events.send({\n  email: 'mira@acme.io',\n  eventName: 'trial_started',\n  eventProperties: {\n    planName: 'Pro',\n    trialDays: 14,\n  },\n})\n","TypeScript","typescript","",[57,168,169,189,196,225,230,245,257,268,274,285,296,302],{"__ignoreMap":166},[170,171,174,178,182,185],"span",{"class":172,"line":173},"line",1,[170,175,177],{"class":176},"s7YZ4","import",[170,179,181],{"class":180},"sYgZi"," { Owlat } ",[170,183,184],{"class":176},"from",[170,186,188],{"class":187},"s-HuK"," '@owlat\u002Fsdk-js'\n",[170,190,192],{"class":172,"line":191},2,[170,193,195],{"emptyLinePlaceholder":194},true,"\n",[170,197,199,202,206,209,212,216,219,222],{"class":172,"line":198},3,[170,200,201],{"class":176},"const",[170,203,205],{"class":204},"sviXB"," owlat",[170,207,208],{"class":176}," =",[170,210,211],{"class":176}," new",[170,213,215],{"class":214},"sPO5f"," Owlat",[170,217,218],{"class":180},"(",[170,220,221],{"class":187},"'lm_live_...'",[170,223,224],{"class":180},")\n",[170,226,228],{"class":172,"line":227},4,[170,229,195],{"emptyLinePlaceholder":194},[170,231,233,236,239,242],{"class":172,"line":232},5,[170,234,235],{"class":176},"await",[170,237,238],{"class":180}," owlat.events.",[170,240,241],{"class":214},"send",[170,243,244],{"class":180},"({\n",[170,246,248,251,254],{"class":172,"line":247},6,[170,249,250],{"class":180},"  email: ",[170,252,253],{"class":187},"'mira@acme.io'",[170,255,256],{"class":180},",\n",[170,258,260,263,266],{"class":172,"line":259},7,[170,261,262],{"class":180},"  eventName: ",[170,264,265],{"class":187},"'trial_started'",[170,267,256],{"class":180},[170,269,271],{"class":172,"line":270},8,[170,272,273],{"class":180},"  eventProperties: {\n",[170,275,277,280,283],{"class":172,"line":276},9,[170,278,279],{"class":180},"    planName: ",[170,281,282],{"class":187},"'Pro'",[170,284,256],{"class":180},[170,286,288,291,294],{"class":172,"line":287},10,[170,289,290],{"class":180},"    trialDays: ",[170,292,293],{"class":204},"14",[170,295,256],{"class":180},[170,297,299],{"class":172,"line":298},11,[170,300,301],{"class":180},"  },\n",[170,303,305],{"class":172,"line":304},12,[170,306,307],{"class":180},"})\n",[160,309,314],{"className":310,"code":311,"filename":312,"language":313,"meta":166,"style":166},"language-sh shiki shiki-themes github-light github-dark-dimmed","curl -X POST https:\u002F\u002Fyour-deployment.convex.site\u002Fapi\u002Fv1\u002Fevents \\\n  -H \"Authorization: Bearer lm_live_...\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"email\": \"mira@acme.io\",\n    \"eventName\": \"trial_started\",\n    \"eventProperties\": {\n      \"planName\": \"Pro\",\n      \"trialDays\": 14\n    }\n  }'\n","curl","sh",[57,315,316,334,344,353,361,366,371,376,381,386,391],{"__ignoreMap":166},[170,317,318,321,324,327,330],{"class":172,"line":173},[170,319,312],{"class":320},"sOLd2",[170,322,323],{"class":204}," -X",[170,325,326],{"class":187}," POST",[170,328,329],{"class":187}," https:\u002F\u002Fyour-deployment.convex.site\u002Fapi\u002Fv1\u002Fevents",[170,331,333],{"class":332},"s74oq"," \\\n",[170,335,336,339,342],{"class":172,"line":191},[170,337,338],{"class":204},"  -H",[170,340,341],{"class":187}," \"Authorization: Bearer lm_live_...\"",[170,343,333],{"class":332},[170,345,346,348,351],{"class":172,"line":198},[170,347,338],{"class":204},[170,349,350],{"class":187}," \"Content-Type: application\u002Fjson\"",[170,352,333],{"class":332},[170,354,355,358],{"class":172,"line":227},[170,356,357],{"class":204},"  -d",[170,359,360],{"class":187}," '{\n",[170,362,363],{"class":172,"line":232},[170,364,365],{"class":187},"    \"email\": \"mira@acme.io\",\n",[170,367,368],{"class":172,"line":247},[170,369,370],{"class":187},"    \"eventName\": \"trial_started\",\n",[170,372,373],{"class":172,"line":259},[170,374,375],{"class":187},"    \"eventProperties\": {\n",[170,377,378],{"class":172,"line":270},[170,379,380],{"class":187},"      \"planName\": \"Pro\",\n",[170,382,383],{"class":172,"line":276},[170,384,385],{"class":187},"      \"trialDays\": 14\n",[170,387,388],{"class":172,"line":287},[170,389,390],{"class":187},"    }\n",[170,392,393],{"class":172,"line":298},[170,394,395],{"class":187},"  }'\n",[152,397,399],{"id":398},"feature-aktiviert","Feature aktiviert",[160,401,403],{"className":162,"code":402,"language":165,"meta":166,"style":166},"await owlat.events.send({\n  email: 'mira@acme.io',\n  eventName: 'feature_activated',\n  eventProperties: {\n    featureName: 'team_invite',\n  },\n})\n",[57,404,405,415,423,432,436,446,450],{"__ignoreMap":166},[170,406,407,409,411,413],{"class":172,"line":173},[170,408,235],{"class":176},[170,410,238],{"class":180},[170,412,241],{"class":214},[170,414,244],{"class":180},[170,416,417,419,421],{"class":172,"line":191},[170,418,250],{"class":180},[170,420,253],{"class":187},[170,422,256],{"class":180},[170,424,425,427,430],{"class":172,"line":198},[170,426,262],{"class":180},[170,428,429],{"class":187},"'feature_activated'",[170,431,256],{"class":180},[170,433,434],{"class":172,"line":227},[170,435,273],{"class":180},[170,437,438,441,444],{"class":172,"line":232},[170,439,440],{"class":180},"    featureName: ",[170,442,443],{"class":187},"'team_invite'",[170,445,256],{"class":180},[170,447,448],{"class":172,"line":247},[170,449,301],{"class":180},[170,451,452],{"class":172,"line":259},[170,453,307],{"class":180},[152,455,457],{"id":456},"trial-läuft-ab","Trial läuft ab",[160,459,461],{"className":162,"code":460,"language":165,"meta":166,"style":166},"await owlat.events.send({\n  email: 'mira@acme.io',\n  eventName: 'trial_expiring',\n  eventProperties: {\n    daysLeft: 3,\n    planName: 'Pro',\n  },\n})\n",[57,462,463,473,481,490,494,504,512,516],{"__ignoreMap":166},[170,464,465,467,469,471],{"class":172,"line":173},[170,466,235],{"class":176},[170,468,238],{"class":180},[170,470,241],{"class":214},[170,472,244],{"class":180},[170,474,475,477,479],{"class":172,"line":191},[170,476,250],{"class":180},[170,478,253],{"class":187},[170,480,256],{"class":180},[170,482,483,485,488],{"class":172,"line":198},[170,484,262],{"class":180},[170,486,487],{"class":187},"'trial_expiring'",[170,489,256],{"class":180},[170,491,492],{"class":172,"line":227},[170,493,273],{"class":180},[170,495,496,499,502],{"class":172,"line":232},[170,497,498],{"class":180},"    daysLeft: ",[170,500,501],{"class":204},"3",[170,503,256],{"class":180},[170,505,506,508,510],{"class":172,"line":247},[170,507,279],{"class":180},[170,509,282],{"class":187},[170,511,256],{"class":180},[170,513,514],{"class":172,"line":259},[170,515,301],{"class":180},[170,517,518],{"class":172,"line":270},[170,519,307],{"class":180},[15,521,523],{"id":522},"kontakte-automatisch-anlegen","Kontakte automatisch anlegen",[11,525,526,527,530],{},"Wenn Sie Events für Benutzer auslösen, die möglicherweise noch nicht als Kontakt existieren, setzen Sie ",[57,528,529],{},"createContactIfNotExists",":",[160,532,534],{"className":162,"code":533,"language":165,"meta":166,"style":166},"await owlat.events.send({\n  email: 'new-lead@example.com',\n  eventName: 'trial_started',\n  eventProperties: { planName: 'Pro', trialDays: 14 },\n  createContactIfNotExists: true,\n})\n",[57,535,536,546,555,563,578,588],{"__ignoreMap":166},[170,537,538,540,542,544],{"class":172,"line":173},[170,539,235],{"class":176},[170,541,238],{"class":180},[170,543,241],{"class":214},[170,545,244],{"class":180},[170,547,548,550,553],{"class":172,"line":191},[170,549,250],{"class":180},[170,551,552],{"class":187},"'new-lead@example.com'",[170,554,256],{"class":180},[170,556,557,559,561],{"class":172,"line":198},[170,558,262],{"class":180},[170,560,265],{"class":187},[170,562,256],{"class":180},[170,564,565,568,570,573,575],{"class":172,"line":227},[170,566,567],{"class":180},"  eventProperties: { planName: ",[170,569,282],{"class":187},[170,571,572],{"class":180},", trialDays: ",[170,574,293],{"class":204},[170,576,577],{"class":180}," },\n",[170,579,580,583,586],{"class":172,"line":232},[170,581,582],{"class":180},"  createContactIfNotExists: ",[170,584,585],{"class":204},"true",[170,587,256],{"class":180},[170,589,590],{"class":172,"line":247},[170,591,307],{"class":180},[11,593,594],{},"Die Antwort gibt an, ob ein Kontakt angelegt wurde:",[160,596,600],{"className":597,"code":598,"language":599,"meta":166,"style":166},"language-json shiki shiki-themes github-light github-dark-dimmed","{\n  \"data\": {\n    \"eventId\": \"evt_m6e...\",\n    \"contactId\": \"j57...\",\n    \"eventName\": \"trial_started\",\n    \"triggeredAutomations\": 1,\n    \"contactCreated\": true\n  }\n}\n","json",[57,601,602,607,616,629,641,653,665,675,680],{"__ignoreMap":166},[170,603,604],{"class":172,"line":173},[170,605,606],{"class":180},"{\n",[170,608,609,613],{"class":172,"line":191},[170,610,612],{"class":611},"snmFh","  \"data\"",[170,614,615],{"class":180},": {\n",[170,617,618,621,624,627],{"class":172,"line":198},[170,619,620],{"class":611},"    \"eventId\"",[170,622,623],{"class":180},": ",[170,625,626],{"class":187},"\"evt_m6e...\"",[170,628,256],{"class":180},[170,630,631,634,636,639],{"class":172,"line":227},[170,632,633],{"class":611},"    \"contactId\"",[170,635,623],{"class":180},[170,637,638],{"class":187},"\"j57...\"",[170,640,256],{"class":180},[170,642,643,646,648,651],{"class":172,"line":232},[170,644,645],{"class":611},"    \"eventName\"",[170,647,623],{"class":180},[170,649,650],{"class":187},"\"trial_started\"",[170,652,256],{"class":180},[170,654,655,658,660,663],{"class":172,"line":247},[170,656,657],{"class":611},"    \"triggeredAutomations\"",[170,659,623],{"class":180},[170,661,662],{"class":204},"1",[170,664,256],{"class":180},[170,666,667,670,672],{"class":172,"line":259},[170,668,669],{"class":611},"    \"contactCreated\"",[170,671,623],{"class":180},[170,673,674],{"class":204},"true\n",[170,676,677],{"class":172,"line":270},[170,678,679],{"class":180},"  }\n",[170,681,682],{"class":172,"line":276},[170,683,684],{"class":180},"}\n",[15,686,688],{"id":687},"die-automatisierung-einrichten","Die Automatisierung einrichten",[11,690,691],{},"Sobald Ihr Code Events sendet, legen Sie die Automatisierung im Owlat-Dashboard an:",[693,694,695,703,713,716],"ol",{},[696,697,698,699],"li",{},"Gehen Sie zu ",[700,701,702],"strong",{},"Automatisierungen → Neue Automatisierung",[696,704,705,706,709,710,712],{},"Setzen Sie den Trigger auf ",[700,707,708],{},"Event empfangen"," und geben Sie den Event-Namen ein (z. B. ",[57,711,93],{},")",[696,714,715],{},"Fügen Sie Schritte hinzu — eine E-Mail senden, warten, eine weitere senden usw.",[696,717,718],{},"Veröffentlichen Sie die Automatisierung",[11,720,721,722,725,726,729,730,733,734,68,737,740,741,744],{},"Automatisierungen werden ausschließlich über den ",[700,723,724],{},"Namen"," des Events zugeordnet — der im Trigger gesetzte Event-Name muss exakt dem gesendeten ",[57,727,728],{},"eventName"," entsprechen. Event-Eigenschaften werden mit dem Event aufgezeichnet, beeinflussen die Zuordnung aber nicht, und sie werden ",[700,731,732],{},"nicht"," in die von der Automatisierung versendeten E-Mail-Templates eingefügt. Automatisierungs-E-Mails personalisieren ausschließlich über Kontaktfelder — ",[57,735,736],{},"{{firstName}}",[57,738,739],{},"{{lastName}}"," und ",[57,742,743],{},"{{email}}",".",[15,746,748],{"id":747},"nächste-schritte","Nächste Schritte",[750,751,752,760,767],"ul",{},[696,753,754,759],{},[755,756,758],"a",{"href":757},"\u002Fapi\u002Fevents","Referenz zur Events-API"," — vollständige Endpunkt-Dokumentation",[696,761,762,766],{},[755,763,765],{"href":764},"\u002Fexamples\u002Fcontact-sync","Kontaktsynchronisierung"," — sicherstellen, dass Kontakte existieren, bevor Events ausgelöst werden",[696,768,769,773],{},[755,770,772],{"href":771},"\u002Fguide\u002Fautomations","Leitfaden zu Automatisierungen"," — mehrstufige Abläufe im Dashboard bauen",[775,776,777],"style",{},"html pre.shiki code .s7YZ4, html code.shiki .s7YZ4{--shiki-default:#D73A49;--shiki-dark:#F47067}html pre.shiki code .sYgZi, html code.shiki .sYgZi{--shiki-default:#24292E;--shiki-dark:#ADBAC7}html pre.shiki code .s-HuK, html code.shiki .s-HuK{--shiki-default:#032F62;--shiki-dark:#96D0FF}html pre.shiki code .sviXB, html code.shiki .sviXB{--shiki-default:#005CC5;--shiki-dark:#6CB6FF}html pre.shiki code .sPO5f, html code.shiki .sPO5f{--shiki-default:#6F42C1;--shiki-dark:#DCBDFB}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sOLd2, html code.shiki .sOLd2{--shiki-default:#6F42C1;--shiki-dark:#F69D50}html pre.shiki code .s74oq, html code.shiki .s74oq{--shiki-default:#005CC5;--shiki-dark:#F47067}html pre.shiki code .snmFh, html code.shiki .snmFh{--shiki-default:#005CC5;--shiki-dark:#8DDB8C}",{"title":166,"searchDepth":191,"depth":191,"links":779},[780,781,782,787,788,789],{"id":17,"depth":191,"text":18},{"id":24,"depth":191,"text":25},{"id":149,"depth":191,"text":150,"children":783},[784,785,786],{"id":154,"depth":198,"text":155},{"id":398,"depth":198,"text":399},{"id":456,"depth":198,"text":457},{"id":522,"depth":191,"text":523},{"id":687,"depth":191,"text":688},{"id":747,"depth":191,"text":748},"md",{},"\u002Fexamples\u002Fevent-automation",{"title":6,"description":13},"4.examples\u002F3.event-automation","MeFw9uwljxJRvtDMZCkY2CKOdx1tEXk8qTnDTK1ZhwQ",[797,801],{"title":798,"path":799,"stem":800,"children":-1},"Rechnungs-E-Mail","\u002Fexamples\u002Fbilling-email","4.examples\u002F2.billing-email",{"title":765,"path":764,"stem":802,"children":-1},"4.examples\u002F4.contact-sync",1786915111699]