Ga naar inhoud
PynPyn

Stapopties

De tabellen noemen elk veld van een stap zoals de app het labelt, met de waarde die het bevat. Dezelfde vorm gebruiken de MCP-tools en exports, dus dit is het naslagwerk voor wie Pyn automatiseert.

Veld Label in de app Waarden
id Een uniek id dat Pyn toekent.
title Step title Vrije tekst; leeg toont het staptype.
type Gekozen in Add Step send-message, send-channel-message, invite-to-calendar-event, send-channel-invite, raise-ticket, add-message-to-context; zie hieronder.
state Enabled / Disabled enabled of disabled. Een uitgeschakelde stap wordt nooit verstuurd.
schedule.type relative of elapsed (After trigger) in een automation, absolute in een campaign.
schedule.offset Schedule Voor relative: een duur zoals { "days": -7 } of { "weeks": 2 }; negatief is vóór de referentiedatum. Voor elapsed: een positieve duur na het triggermoment in minutes, hours, days of weeks, zoals { "hours": 1 }; {} is Immediately.
schedule.date Scheduled date Voor absolute: een kalenderdatum, 2026-03-02.
schedule.hour, schedule.minute at 0 tot 23 en 0 tot 59.
schedule.timezone in recipient, of de naam van een tijdzone zoals Australia/Sydney.
schedule.deliverOn Days of Week Een of meer van MONDAY tot SUNDAY.
schedule.onSkippableDate On Non-Delivery Days deliver-anyway, deliver-before (vorige bezorgdag) of deliver-after (volgende bezorgdag).
audience Tabblad Audience lifecycle (een of meer van current, joiner, leave, terminated), includeGroups, excludeGroups (groeps-id’s). Ontbreekt het veld, dan alleen huidige medewerkers.
skipIfOverdue Skip if overdue at enrollment true om een stap over te slaan waarvan de datum al voorbij is wanneer iemand wordt ingeschreven.
reminders Reminders Maximaal drie in het zijpaneel (Add reminder verdwijnt bij drie), elk met offset (dagen na verzending), enabled en een optioneel message dat het zijpaneel niet instelt. Een stap die via de API of een MCP-server is geschreven kan er tot tien hebben.

schedule.hour, schedule.minute, schedule.timezone, schedule.deliverOn en schedule.onSkippableDate bestaan alleen op een relative- of absolute-planning. Een elapsed-planning heeft alleen type en offset, en een campaignstap kan die niet gebruiken.

send-message (een direct message of e-mail) en send-channel-message (een kanaalbericht) voegen toe:

Veld Label Waarden
medium Vastgelegd door het staptype slack of email.
sender From Een sender-id. Ontbreekt het veld, dan de standaard van de workspace.
conditionalSender From Een conditional-sender-id. Een stap heeft óf sender óf conditionalSender, nooit beide.
recipient To Een ontvanger, zie hieronder. De ontvanger van een kanaalbericht is een kanaal.
ccRecipients Cc Ontvangers, een willekeurig aantal, achter de link Cc naast To in het zijpaneel.
subject Subject Een document van één regel. Op een e-mail is dit het onderwerp; op een Slack-direct message het onderwerp van de e-mail die wordt verstuurd wanneer fallbackToEmail is ingesteld.
message De editor Het opgestelde bericht.
body, html Email body body: "html" met de Liquid-HTML in html voor een Raw HTML-e-mail; anders is het opgestelde message de inhoud. Alleen voor e-mail.
emailFormat Email format left of full-width; ontbreekt het veld, dan Centered. Bepaalt alleen de lay-out van een opgemaakte e-mail; een Raw HTML-e-mail wordt verstuurd zoals geschreven.
hideSignature Include the sender’s signature (verified email senders) true wanneer de schakelaar is uitgevinkt; ontbreekt het veld, dan sluit de handtekening van een geverifieerde e-mailsender de e-mail af. Alleen voor een opgemaakte e-mail.
deactivateUnfurlLinks, deactivateUnfurlMedia Advanced true om Slack-previews uit te schakelen.
fallbackToEmail, fallbackEmailSender Send by email if the recipient is not in Slack, en de From eronder true, met het id van een e-mailsender, op een Slack-direct message: een ontvanger die niet in Slack zit krijgt het bericht per e-mail van die sender, onder het subject van de stap. Een automation kan niet worden gepubliceerd zolang fallbackToEmail is ingesteld zonder sender en onderwerp. Zie Een direct message per e-mail versturen wanneer iemand niet in Slack zit.
escalations Escalations Maximaal drie, elk met offset (dagen na verzending), recipient (elke ontvanger behalve een groep of een conditional recipient) en enabled.
Vorm Label Velden
Relatief Employee, Manager, Skip-level Manager, Buddy, HRBP type: "relative", recipient een van employee, manager, skip-manager, buddy, hrbp; optioneel address met primary of personal.
Een persoon People type: "employee", recipient het medewerkers-id, optioneel address.
Een groep Groups (campaignstappen) type: "group", recipient het groeps-id. Elk lid ontvangt de stap.
Een kanaal Channels type: "channel", recipient het kanaal-id.
Een custom e-mailadres Custom Email Recipients type: "custom-email", recipient het id van de custom email recipient.
Een conditional recipient Conditional Recipients type: "conditional", recipient het id van de conditional recipient. Wordt voor elke ingeschreven medewerker bepaald uit de regels van de conditional recipient; geweigerd op campaignstappen.
Type Label in Add Step Extra velden
invite-to-calendar-event Invite to Calendar Event recipient (standaard Employee; het zijpaneel heeft er geen bediening voor); eventId (de agenda-afspraak); inviteTo met next-occurrence, next-occurrence-reference-date of all-occurrences.
send-channel-invite Add to Channel sender; recipient (wie wordt toegevoegd); channel (het kanaal-id); medium: "slack".
raise-ticket Raise Ticket integration (de Jira-koppeling), project, issueType, summary (één regel), description; medium: "jira". Geen ontvanger.
add-message-to-context Add Message to Employee Context en de andere rijen onder AI & Context recipient (wiens context).

Een campaigntemplate is een lijst mijlpalen, elk met id, title, emoji, color (een hexadecimale kleur), date (een kalenderdatum) en steps (stappen zoals hierboven, met absolute planningen). Een mijlpaal inschrijven maakt er een campaign van met die datum als referentiedatum. Zie Campaign Templates.