Triggers en acties

Een trigger is de gebeurtenis die een automatisering start, bijvoorbeeld een nieuw lid of een afgeronde cursus. Een actie is wat de automatisering daarna doet, bijvoorbeeld een tag toevoegen of een e-mail sturen. Dit artikel noemt ze allemaal, met hun velden.

Automatiseringen openen

Waar je ze vindt

In de editor heeft de Bibliotheek twee tabbladen: Triggers en Acties. De ingebouwde blokken staan onder MemberArea, gegroepeerd in Leden, Betalingen, Cursussen, Community, Evenementen, Partners en Hulpmiddelen. Integraties volgen onder hun eigen naam. Zoeken… doorzoekt namen en beschrijvingen. Klik op een blok of sleep het naar het canvas, en klik er daarna op om de velden in te vullen.

Een automatisering bouwen

Triggers voor leden

• Nieuw lid: er wordt een ledenaccount aangemaakt.
• Nieuw contact: er wordt een contact aangemaakt, bijvoorbeeld via een aanmeldformulier. Een contact is nog geen lid, dus acties voor leden doen niets tot je Contact omzetten naar lid gebruikt.
• Ledenveld gewijzigd: een ledenveld verandert. Kies het veld onder Ledenveld om alleen op dat veld te reageren; laat je het leeg, dan telt elk veld. De nieuwe waarde is voor de stappen beschikbaar als {{value}}. Nadat een veld is gewist, is die leeg.
• Lid ingelogd: een lid logt in, één keer per sessie.
• Tag toegepast en Tag verwijderd: een tag wordt aan een lid toegevoegd of bij een lid verwijderd. Kies de tag onder Tag om alleen op die tag te reageren; laat je het leeg, dan telt elke tag.
• Teamlid uitgenodigd: een beheerder nodigt een nieuw teamlid uit.
• Lid inactief: wordt één keer uitgevoerd als een lid een aantal dagen niet heeft ingelogd. Vul het aantal in onder Dagen inactief, zie “Een trigger beperken” hieronder. Leden die al inactief zijn als je de automatisering inschakelt, worden overgeslagen; de trigger reageert op leden die vanaf dan inactief worden.

Triggers voor betalingen

• Nieuwe klant: een betaalde bestelling maakt een nieuw ledenaccount aan.
• Nieuwe bestelling: een nieuwe bestelling is betaald.
• Afrekenen voltooid: een koper rondt het online afrekenen af, ongeacht welke betaalprovider de betaling heeft verwerkt.
• Betaling in verwerking: een uitgestelde betaling, zoals een SEPA-incasso, Klarna of Sofort, is geautoriseerd en het geld is nog onderweg. De koper heeft al toegang.
• Betaling mislukt: een betaling van een bestelling wordt geweigerd, of geld dat al als betaald was geboekt, wordt dagen later teruggevorderd.
• Abonnement verlengd: een terugkerend abonnement wordt met succes verlengd.
• Betaling terugbetaald: een bestelling wordt volledig of gedeeltelijk terugbetaald.
• Abonnement opgezegd: een lid zegt een abonnement op.
• Verlenging binnenkort: wordt een ingesteld aantal dagen vóór de verlenging van een abonnement uitgevoerd. Vul het aantal in onder Dagen voor verlenging.

Triggers voor cursussen

• Les afgerond: een lid rondt een les af.
• Cursus afgerond: elke verplichte les van een cursus is afgerond.
• Cursusvoortgang bereikt: wordt één keer uitgevoerd als de voortgang van een lid in een cursus een percentage passeert. Vul het in onder Percentagedrempel, bijvoorbeeld 50. Zonder die waarde wordt de trigger bij elke stap in de voortgang uitgevoerd.
• Examen gehaald en Examen niet gehaald: een lid haalt een examen of haalt het niet.

Alle vijf kun je met Cursus beperken tot één cursus. Een les of een examen kan in een module zitten die meerdere cursussen delen. De automatisering start dan nog steeds één keer per afgeronde les of examenresultaat, en Cursus klopt als een van die cursussen de cursus is die je hebt gekozen.

Triggers voor de community

• Community: bericht geplaatst: een lid plaatst een bericht, discussie of peiling. Forum beperkt de trigger tot één forum.
• Community: lid naar hoger niveau: een lid bereikt een hoger niveau.
• Community: melding geopend: inhoud wordt gemeld door een lid of door het systeem.
• Badge behaald: een lid behaalt een communitybadge. Badge beperkt de trigger tot één badge.

Triggers voor evenementen

• Evenementaanmelding: een lid meldt zich aan voor een evenement.
• Evenement bijgewoond: een lid wordt gemarkeerd als aanwezig, bijvoorbeeld bij de check-in.
• Evenement begint binnenkort: wordt een ingestelde tijd voor de start van een evenement uitgevoerd, één keer voor elk lid dat zich heeft aangemeld. Vul de uren in onder Uren voor de start, bijvoorbeeld 24.

Evenement beperkt de eerste twee tot één evenement.

Trigger voor partners

Partnercommissie goedgekeurd wordt uitgevoerd als een commissie is goedgekeurd en vastgezet voor uitbetaling. Deze trigger gaat alleen af als je een partnerprogramma hebt.

Planning en webhook

Volgens planning

Volgens planning (cron) start de automatisering op vaste tijden. De trigger heeft twee velden:

• Cron-expressie (verplicht): vijf delen voor minuut, uur, dag van de maand, maand en weekdag. 0 9 * * * betekent elke dag om 09:00, 0 9 * * 1 elke maandag om 09:00.
• Tijdzone: de tijdzone waar de tijden op slaan, bijvoorbeeld Europe/Berlin. Laat je het veld leeg, dan is het UTC.

De planning wordt elke minuut gecontroleerd. De eerste uitvoering vindt plaats op het eerstvolgende passende tijdstip nadat je de automatisering hebt ingeschakeld. Een geplande uitvoering heeft geen lid, dus gebruik deze trigger voor stappen die er geen nodig hebben, zoals een externe aanvraag of een integratie die iets naar je team stuurt.

Inkomende webhook

Inkomende webhook start de automatisering als een ander systeem er een verzoek naartoe stuurt, bijvoorbeeld je website, een formuliertool of Zapier.

1. Voeg de trigger toe en sla de automatisering op. Tot die tijd toont het paneel “Sla de automatisering op om de webhook-URL en het geheim aan te maken.” Een automatisering die uit een sjabloon is gemaakt, een duplicaat of een kopie voor een ander bedrijf heeft meteen een eigen adres en geheim.
2. Klik op de trigger. Het paneel toont de Webhook-URL met URL kopiëren en het Geheim met Geheim kopiëren.
3. Stuur in het andere systeem een POST-verzoek naar de URL. Zet het geheim in de header X-Automation-Secret. Stuur de gegevens als JSON.

Elk veld op het hoogste niveau van de body is voor de stappen beschikbaar als {{field}}. Bevat de body member_email met het adres van een van je leden, dan hoort de uitvoering bij dat lid en werken acties en variabelen voor leden.

De automatisering moet ingeschakeld en gepubliceerd zijn. Anders wordt de aanroep geweigerd, net als bij een verkeerd of ontbrekend geheim. Elke automatisering accepteert maximaal 120 aanroepen per minuut. Verdere aanroepen worden geweigerd tot de minuut voorbij is.

Standaard krijgt de aanroeper meteen {"ok": true, "triggers_fired": 1} terug, en de stappen worden op de achtergrond uitgevoerd. Volgt er in de flow een stap Reageren op webhook op deze trigger, dan wacht de aanroeper en krijgt die de status en de body die je in die stap instelt. Zet die stap vóór elke vertraging, anders krijgt de aanroeper het standaardantwoord. Een stap Reageren op webhook op een pad dat deze trigger nooit bereikt, verandert niets.

Voorwaarden, vertakkingen en vertragingen

Geheim vernieuwen maakt na je bevestiging een nieuw geheim aan. Het oude geheim werkt meteen niet meer, dus werk elk systeem bij dat het gebruikt.

Een trigger beperken

Veel triggers hebben velden die ze beperken tot één item of een tijd instellen. Ze staan in de instellingen van de trigger direct onder Type trigger, vóór Voorwaarden.

• Cursus, Evenement, Forum en Badge zijn lijsten met de namen van je items. De eerste optie, zoals Elke cursus of Elk evenement, haalt het filter weer weg, en de trigger reageert op elk item.
• Velden zonder lijst, zoals Product, Les of Agenda, nemen de ID van het item aan. Wil je zien welke ID’s een trigger meestuurt, open dan een eerdere uitvoering in Uitvoeringen en bekijk de Invoer van de trigger.

Drie triggers hebben een getal nodig en starten nooit zonder:

Vul een geheel getal van 1 of meer in. Zolang het veld leeg is of onder 1 ligt, markeert de editor de trigger met een waarschuwing zoals “‘Dagen inactief’ moet 1 of meer zijn.” en noemt hij die bij de problemen als je de automatisering inschakelt.

Triggers zonder zulke velden, bijvoorbeeld Nieuw lid of de triggers van een integratie, tonen in plaats daarvan Filters. Elke rij bestaat uit een sleutel en een waarde, en de trigger start de automatisering alleen als de gebeurtenis precies die waarde onder die sleutel meestuurt. Met Rij toevoegen voeg je meer rijen toe; alle rijen moeten overeenkomen.

Testen en uitvoeringen

Voorwaarden voor het lid

Voorwaarden controleert het lid voordat de automatisering start. Elke rij bestaat uit de naam van een veld van het ledenaccount en een waarde, bijvoorbeeld language en de. De trigger start de automatisering alleen als het lid in elke rij precies die waarden heeft.

Wil je meer controleren, zoals een tag die het lid heeft of een aangepast veld, voeg dan na de trigger een stap Voorwaarde of Filter toe.

Voorwaarden, vertakkingen en vertragingen

Acties voor leden

Acties voor leden werken op het lid van de uitvoering.

• Tag toevoegen en Tag verwijderen: met Tag kies je de tag.
• Aan groep toevoegen en Uit groep verwijderen: met Groep kies je de groep.
• Cursustoegang verlenen en Cursustoegang intrekken: met Cursus kies je de cursus. Een cursus die niet gepubliceerd is, wordt niet verleend; de uitvoering vermeldt dat er niets is veranderd.
• Ledenveld instellen: Ledenveld en Waarde. De waarde wordt opgeslagen zoals je die typt.
• Ledenveld wissen: het Ledenveld wordt voor het lid leeggemaakt.
• Contact omzetten naar lid: maakt van een contact een ledenaccount en neemt de velden ervan over. Welkomstmail versturen staat standaard aan.
• Lid deactiveren: deactiveert het account van het lid op je platform.
• E-mail sturen: één e-mail aan het lid, zonder afmeldlink. Gebruik voor marketingmails een e-mailreeks. Onderwerp en Hoofdtekst zijn verplicht. Laat Ontvanger leeg om het lid te mailen, of vul het e-mailadres van een ander lid van je platform in.
• Sms sturen: verstuurt een sms via Twilio. Bericht is verplicht. Vul je Twilio-account-SID, Twilio-auth-token en afzendernummer in; zonder alle drie gaat er geen sms uit. Vul bij het nummer van de ontvanger een nummer in of [|Phone|] voor het telefoonnummer van het lid. Heb je Twilio als integratie gekoppeld, dan gebruikt de eigen actie Sms sturen van Twilio die koppeling.

Acties voor de community

• Communitybericht aanmaken: plaatst namens het lid een bericht in het gekozen Forum. Forum toont de forums van je platform op naam en vereist dat de community is ingeschakeld. Artikeltitel is optioneel, de berichttekst is verplicht.
• Badge toekennen: geeft het lid de gekozen Badge.
• Punten toekennen: geeft het lid Punten, die meetellen voor niveaus. Reden is optioneel en verschijnt in de puntengeschiedenis.

Externe aanvraag versturen

Externe aanvraag versturen stuurt een HTTP-verzoek naar een server naar keuze, bijvoorbeeld om een nieuw lid door te geven aan je eigen systeem. Klik op Verzoek toevoegen om Verzoek bewerken te openen:

• Type verzoek: GET, POST, PUT of DELETE.
• Verzoek-URL: een https-adres. Het veld biedt ledenvelden aan om als variabele in te voegen.
• Headers: Aanvraagheader toevoegen voegt een Sleutel en een Waarde toe.
• Body: de Request-body als JSON, met een Voorbeeld ernaast.
• Respons: het antwoord van je laatste test.

Verzoek testen stuurt het verzoek meteen, met het lid dat je hebt gekozen onder Lid om te testen. Het tabblad Respons toont dan Response-headers, Response-body, Verzoekheaders en Request-body. Alleen openbare adressen zijn toegestaan, en het verzoek volgt geen omleidingen. Opslaan bewaart het verzoek.

Tijdens een uitvoering wordt het verzoek als JSON verstuurd, met een tijdslimiet van 15 seconden. Antwoordt je server met een fout, antwoordt hij niet op tijd of stuurt hij door, dan mislukt de stap en daarmee de uitvoering. De fout toont de status en het begin van het antwoord, bijvoorbeeld “Het verzoek gaf HTTP 503 terug: Service Unavailable”. Test het verzoek voordat je de automatisering inschakelt.

Variabelen

Variabelen voor leden

Tekstvelden van acties, zoals het onderwerp en de tekst van een e-mail, het sms-bericht, het communitybericht, de reden voor punten en de externe aanvraag, vervangen deze variabelen door de gegevens van het lid:

• [|First Name|] of : voornaam
• [|Last Name|] of : achternaam
• [|Email|] of : e-mailadres
• [|Phone|] of {settings.phone}: telefoonnummer uit het profiel
• [|Language|] of : taal
• [|Member Id|] of : ID van het lid
• [|Image|] of : profielfoto
• [|Registered at|] of : datum en tijd van registratie
• [|Last Login|] of : datum en tijd van de laatste keer inloggen
• [|Full Member Data|]: alle gegevens van het lid als JSON

Een ledenveld verschijnt als [|cf_…|] of {cf_…} met de ID van het veld; de externe aanvraag voegt het voor je in. Heeft een uitvoering geen lid, dan komen voornaam, achternaam, e-mail en telefoon uit de velden first_name, last_name, email en phone van de triggergegevens, als die erin staan.

Variabelen voor gegevens

De stappen Instellen, Voorwaarde, Filter, Vergelijken, Herhalen, Wachten tot datum en Reageren op webhook lezen de gegevens van de uitvoering:

• {{key}} haalt een waarde uit de triggergegevens of uit een eerdere stap, bijvoorbeeld {{amount}} van een bestelling of een veld dat je webhook heeft gestuurd.
• {{member.first_name}} en andere variabelen {{member.…}} lezen het lid van de uitvoering. {{member.tags}} en {{member.groups}} geven de tags en groepen van het lid terug.
• {{member.cf_…}} met de ID van een aangepast veld leest de waarde van het lid voor dat veld zoals die is opgeslagen. De ID is die in de variabele {cf_…} hierboven.

Velden van acties lezen {{key}} niet. Wil je webhookgegevens in een e-mail gebruiken, koppel de uitvoering dan met member_email aan een lid en gebruik de variabelen voor leden.

Triggers en acties van integraties

Als je een dienst koppelt, verschijnen de triggers en acties ervan in de bibliotheek onder de naam van de dienst. Tot de dienst gekoppeld is, blijven ze grijs met Koppelen; als je op een ervan klikt, opent het venster om te koppelen, en met Integratie toevoegen onderaan de bibliotheek koppel je meer diensten. Een automatisering met een dienst die niet gekoppeld is, kun je niet inschakelen. Met Integratie in de actie kies je het gekoppelde account dat wordt gebruikt.

Triggers komen van Stripe, GoHighLevel, Calendly, Digistore24, Shopify, Hotmart, CopeCart en WooCommerce, bijvoorbeeld voor aankopen, terugbetalingen, opzeggingen of boekingen.

Acties zijn beschikbaar voor:

• Automatiseringstools: Webhooks, Zapier, Make, n8n en Pabbly.
• E-mail en CRM: ActiveCampaign, Brevo, Customer.io, Drip, Flodesk, GetResponse, GoHighLevel, HubSpot, Intercom, Kit, Klaviyo, KlickTipp, Mailchimp, ManyChat, Pipedrive en Quentn.
• Berichten: Discord, Slack, Twilio en WhatsApp.
• Webshop en boekhouding: Shopify, lexoffice en sevDesk.
• Werktools: Airtable, Asana, ClickUp, Coda, Google Sheets, monday.com, Notion, Trello en Zoom.

Andere tools koppelen

Automatiseringen starten via de API

Met een API-sleutel kan jouw eigen software je automatiseringen opvragen, er een starten met eigen gegevens en de uitvoeringen ervan lezen.

API-sleutels en toegang voor ontwikkelaars

Gerelateerde artikelen

• Overzicht van automatiseringen
• Een automatisering bouwen
• Voorwaarden, vertakkingen en vertragingen
• Testen en uitvoeringen