Ga naar inhoud
PynPyn

Een bericht opmaken

Dezelfde editor schrijft elke e-mail, direct message en kanaalpost. Hij toont het bericht ongeveer zoals de ontvanger het ziet, met een Slack-avatar en tijdstempel op een Slack-stap, en behoudt de opmaak die het medium ondersteunt: Slack kent geen uitlijning, dus die knoppen zijn daar verborgen.

The message editor with the Widgets menu open: Avatar, Custom Token, Custom Token Block, Embed Form, Link Button and Link to Library Content.
De berichteditor met het menu Widgets open.

Selecteer tekst en gebruik de werkbalk voor vet, cursief en onderstrepen, Heading, Subheading en Blockquote, opsommingen en genummerde lijsten, links (een webadres of mailto:) en, in e-mail, links, gecentreerd en rechts uitlijnen. Ongedaan maken en opnieuw uitvoeren zitten ook in de werkbalk. Selecteer Expand editor (het pijltjesicoon boven de editor) om in een schermvullende editor te schrijven en sluit die om terug te keren.

  1. Typ @ op de plek waar de waarde komt. Er opent een lijst tokens; typ door om te filteren, bijvoorbeeld @pref voor principal.preferredName.

  2. Selecteer het token. Het verschijnt als een pil. principal-tokens gaan over de ingeschreven medewerker; recipient-tokens over wie het bericht ontvangt; date.reference is de referentiedatum van de enrollment.

  3. Voor een veld dat niet in de lijst staat selecteer je Insert token in de werkbalk en dan Employee Field…. Kies in het dialoogvenster Employee Field onder Select an employee field het veld, kies onder Apply to of het geldt voor de Principal of automation (de standaard) of de Recipient of message, typ een Fallback (Optional) die wordt getoond wanneer het veld leeg is, en selecteer Insert.

  4. Voor een kolom uit een mailmerge-spreadsheet selecteer je Insert widget, dan Custom Token, en typ je de kolomnaam, bijvoorbeeld startLocation. Selecteer het geplaatste token om te wisselen tussen Plain Text en Bulleted List. Custom Token Block geeft een waarde van meerdere regels weer als eigen alinea of lijst.

Tokens somt elk token op met de tekst waarop Pyn terugvalt wanneer de waarde ontbreekt, bijvoorbeeld Employee voor een ontbrekende naam.

Selecteer Insert media (het afbeeldingsicoon) om een afbeelding, gif of video van je computer te uploaden of er een te kiezen uit Media. Selecteer een ingevoegde afbeelding om die uit te lijnen of te schalen. Plak een YouTube- of Vimeo-link op een eigen regel en hij wordt een ingesloten speler. Media in een bericht invoegen loopt een upload door.

Insert widget (het puzzelstukje) bevat de interactieve onderdelen: Avatar (een foto; selecteer de ingevoegde widget en kies Principal, Principal’s Buddy, Principal’s Manager of Recipient onder Show the avatar of), Custom Token en Custom Token Block, Embed Form, Link Button, Mention Principal, Link to Library Content en, in e-mail, Raw HTML Block. Knoppen en formulieren staan in Een knop aan een bericht toevoegen.

Mention Principal wordt alleen op Slack-stappen aangeboden; zie Mensen en kanalen mentionen.

Op een Slack-stap wordt een mention een echte Slack-melding wanneer het bericht wordt verstuurd. Drie vormen werken, zowel in een direct bericht als in een kanaalpost.

De ingeschreven medewerker. Selecteer Insert widget en dan Mention Principal. Het voegt een @Principal-pil in die een echte Slack-mention van de ingeschreven medewerker wordt, zodat “Please welcome @Principal to the team” die persoon een melding geeft. Heeft die medewerker geen lid in de Slack-workspace waar het bericht doorheen gaat, dan wordt de pil in plaats daarvan als diens naam verstuurd, bijvoorbeeld “@Jane Doe”.

Een collega, op Slack-gebruikersnaam. Typ @ en de Slack-gebruikersnaam als gewone tekst, bijvoorbeeld @jane.doe. Typ je @, dan opent de tokenlijst; druk op Escape, of klik ergens anders, om die te sluiten en de tekst te houden zoals getypt. Bij het versturen matcht Pyn de gebruikersnaam, zonder onderscheid tussen hoofdletters en kleine letters, met de leden van de Slack-workspace van de sender en vervangt hem door een mention van die persoon. De gebruikersnaam is de @name op het Slack-profiel, niet de weergavenaam. Een gebruikersnaam die bij niemand hoort, ook die van iemand die de Slack-workspace heeft verlaten, blijft in het bericht staan zoals getypt, en het bericht wordt toch verstuurd. Een e-mailadres wordt nooit als mention behandeld. Houd een gebruikersnaam buiten linktekst: een gematchte gebruikersnaam in een link wordt uit de link gehaald.

Iedereen in het kanaal. Typ @here, @channel of @everyone als gewone tekst. Pyn verstuurt elk ervan als een Slack-broadcast, zodat Slack een melding stuurt naar de mensen op wie het woord slaat, net als wanneer je het in Slack typt. Ze worden nooit gematcht met een lid dat here of channel heet, en in een link blijven ze linktekst.

Preview toont een gebruikersnaam en een broadcast zoals getypt. Send a test to yourself verstuurt het bericht via Slack met elke mention omgezet, dus zo controleer je of een gebruikersnaam matcht. Zie Een preview bekijken en een test sturen.

Een conditionele sectie toont een deel van een bericht aan slechts een deel van de mensen, bijvoorbeeld een alinea over parkeren voor het kantoor in Austin binnen één welkomstmail.

  1. Zet de cursor waar de sectie komt en selecteer Conditional section (het trechtericoon) in de werkbalk. Het dialoogvenster Conditional Section opent.

  2. Geef de sectie een Name (Optional) en kies onder Apply to of ze wordt getoetst aan de Recipient of message (de standaard) of de Principal of automation.

  3. Stel Lifecycle, Included en Excluded in zoals bij een stapdoelgroep, controleer de Audience Preview en selecteer dan Update.

  4. Schrijf binnen de sectie. Selecteer haar opnieuw om de regels te wijzigen of haar te verwijderen met Remove.

Inhoud in een sectie waar de persoon niet aan voldoet wordt uit diens bericht gelaten, en ook uit een gepersonaliseerde Preview. Zie De doelgroep van een stap instellen voor hoe lifecycle en groepen matchen.

Waar Raw HTML-e-mail voor je workspace is ingeschakeld, open je het tabblad Advanced van de stap en zet je Email body op Raw HTML voor een volledig ontworpen template die Pyn precies zo moet versturen als geschreven. De tekst wordt een veld HTML; schrijf daar je markup met Liquid-outputtags voor tokens, bijvoorbeeld {{ principal.preferredName }}. Pyn past geen thema of styling toe, de HTML is beperkt tot 200.000 tekens, ongeldige Liquid verhindert het publiceren van de automation, en een naam die Pyn niet kan herleiden blijft in de e-mail staan zoals getypt. Preview rendert de HTML voor de medewerker die je kiest, en Send a test to yourself verstuurt hem zoals een echte verzending dat zou doen. Een raw HTML-stap in een workspace zonder ingeschakelde Raw HTML-e-mail bounct bij het versturen. De keuze Email format op hetzelfde tabblad (Left, Centered of Full width) en de schakelaar Include the sender’s signature (verified email senders) gelden alleen voor een opgemaakt bericht en verdwijnen zodra Email body op Raw HTML staat; een Raw HTML-e-mail wordt zonder de handtekening van de sender verstuurd. Zie Een e-mailstap toevoegen.

Met Liquid-condities varieer je de tekst binnen één e-mail, bijvoorbeeld per kantoor. Pyn evalueert {% if %}, {% elsif %}, {% else %} en {% case %} met {% when %} voor elke ontvanger wanneer het bericht wordt opgemaakt, en één when kan meerdere waarden opsommen. Ze nemen de plaats in van Conditional section, dat alleen op een opgemaakt bericht werkt.

{% if employeeField.recipient.location == "Warsaw" %}
<p>Parking is on level -1.</p>
{% elsif employeeField.recipient.location == "Tbilisi" %}
<p>Bring your passport on your first day.</p>
{% else %}
<p>Your manager will share the office details.</p>
{% endif %}
{% case employeeField.recipient.location %}
{% when "Tbilisi", "Limassol" %}
<p>Your desk is booked through the office app.</p>
{% else %}
<p>Ask reception for a desk.</p>
{% endcase %}

Vergelijk een waarde altijd met ==, != of case, of gebruik != blank om te controleren of een medewerkersveld een waarde heeft. Een token dat op zichzelf wordt getest, zoals {% if employeeField.recipient.location %}, is altijd waar: een ontbrekende waarde wordt vervangen door zijn fallback, en dat is lege tekst voor een medewerkersveld en de kolomnaam voor een custom.-token.

Waar Raw HTML-e-mail voor je workspace is ingeschakeld, biedt Insert widget op een e-mailstap Raw HTML Block aan voor een ontworpen onderdeel van een opgemaakte e-mail, zoals een banner of een handtekening. Het wordt niet aangeboden op Slack-stappen of in Library-content.

Het blok is één blok binnen de e-mail. De e-mail houdt de standaard e-maillay-out van Pyn, een gecentreerde kolom van maximaal 600 pixels breed, en de HTML van het blok staat in een eigen rij tussen de blokken eromheen. Raw HTML voor e-mail vervangt daarentegen de hele tekst en verstuurt die zonder die lay-out.

  1. Zet de cursor waar het blok komt, selecteer Insert widget en dan Raw HTML Block.

  2. Plak of schrijf je markup in het veld HTML. Tokens en condities zijn Liquid, zoals in Raw HTML voor e-mail: bijvoorbeeld {{ principal.preferredName }} en {% if %}.

  3. Selecteer Save. Ongeldige Liquid wordt onder het veld getoond en het blok kan pas worden opgeslagen als het is opgelost.

De editor toont de HTML van het blok met de tokens zoals geschreven; selecteer het blok om het te wijzigen. Preview en Send a test to yourself vullen de tokens in. Pyn verstuurt de HTML precies zoals geschreven en controleert niet of die welgevormd is: een niet-gesloten tag kan de lay-out van de rest van de e-mail breken, dus stuur eerst een test.

  • Elk blok bevat maximaal 200.000 tekens.
  • Het blok wordt weggelaten uit de platte-tekstversie van de e-mail.
  • Links binnen het blok worden niet getrackt: een klik erop verschijnt nooit als Clicked of Actioned. Gebruik een Link Button voor een getrackte link.
  • Een blok binnen een Conditional section wordt alleen verstuurd naar de mensen die aan de sectie voldoen.
  • Een e-mail met een Raw HTML Block in een workspace zonder ingeschakelde Raw HTML-e-mail bounct bij het versturen, net als een Raw HTML-e-mail.