设置消息格式
同一个编辑器撰写每一封电子邮件、每一条私信和每一条频道帖子。它大致按收件人将看到的样子显示消息,在 Slack 步骤上带 Slack 头像和时间戳,并保留该媒介支持的格式:Slack 没有对齐方式,所以那些按钮在那里是隐藏的。

选中文本并使用工具栏设置粗体、斜体和下划线,Heading、Subheading 和 Blockquote,项目符号列表和编号列表,链接(一个网址或 mailto:),以及在电子邮件上的左对齐、居中和右对齐。撤销和重做也在工具栏中。选择 Expand editor(编辑器上方的箭头图标)在全屏编辑器中撰写,关闭它即可返回。
-
在值所在的位置输入
@。一个令牌列表打开;继续输入可以筛选它,例如输入@pref找到principal.preferredName。 -
选择令牌。它以标签的形式出现。
principal令牌对应已注册的员工;recipient令牌对应收到消息的人;date.reference是注册的参考日期。 -
对于不在列表中的字段,选择工具栏中的 Insert token,然后选择 Employee Field…。在 Employee Field 对话框中,用 Select an employee field 选择字段,在 Apply to 下选择它适用于 Principal of automation(默认)还是 Recipient of message,输入字段为空时显示的 Fallback (Optional),然后选择 Insert。
-
对于邮件合并电子表格中的某一列,选择 Insert widget,然后选择 Custom Token,并输入列名,例如
startLocation。选择已放置的令牌,在 Plain Text 和 Bulleted List 之间切换。Custom Token Block 把多行的值渲染为单独的段落或列表。
令牌列出每一个令牌以及值缺失时 Pyn 回退到的文本,例如姓名缺失时的 Employee。
选择 Insert media(图片图标),从你的电脑上传图片、GIF 或视频,或从媒体中挑选一个。选择已插入的图片可以对齐或调整大小。把 YouTube 或 Vimeo 链接单独粘贴在一行,它会变成嵌入式播放器。在消息中插入媒体演示一次上传。
Insert widget(拼图图标)包含交互式元素:Avatar(一张照片;选择已插入的小组件,在 Show the avatar of 下选择 Principal、Principal’s Buddy、Principal’s Manager 或 Recipient)、Custom Token 和 Custom Token Block、Embed Form、Link Button、Mention Principal、Link to Library Content,以及在电子邮件上的 Raw HTML Block。按钮和表单在在消息中添加按钮中介绍。
Mention Principal 只在 Slack 步骤上提供;见提及人员和频道。
提及人员和频道
Section titled “提及人员和频道”在 Slack 步骤上,提及会在消息发送时变成真实的 Slack 通知。有三种形式可用,在私信和频道帖子中都一样。
已注册员工。选择 Insert widget,然后选择 Mention Principal。它插入一个 @Principal 标签,消息发送时变成对已注册员工的真实 Slack 提及,所以“Please welcome @Principal to the team”会通知到他们。如果该员工在消息所经由的 Slack 工作区中没有对应成员,标签会改为以他们的姓名发送,例如“@Jane Doe”。
按 Slack 用户名提及同事。以纯文本输入 @ 和对方的 Slack 用户名,例如 @jane.doe。输入 @ 会打开令牌列表;按 Escape 或点击其他位置关闭它,保留你输入的文本。消息发送时,Pyn 会在发件人的 Slack 工作区的成员中匹配这个用户名(不区分大小写),并把它替换为对该成员的提及。用户名是对方 Slack 个人资料上的 @name,不是显示名称。没有匹配到任何人的用户名(包括已离开 Slack 工作区的人)会按原样留在消息中,消息照常发送。电子邮件地址永远不会被当作提及。不要把用户名放进链接文本:链接内匹配到的用户名会被排除在链接之外。
频道中的所有人。以纯文本输入 @here、@channel 或 @everyone。Pyn 把每一个都作为 Slack 广播发送,所以 Slack 会通知该词所覆盖的人,就像你在 Slack 中输入它时一样。它们永远不会被匹配到名为 here 或 channel 的成员,在链接内则保持为链接文本。
Preview 按输入原样显示用户名和广播。Send a test to yourself 通过 Slack 发送消息并解析每一个提及,所以这是检查用户名是否匹配的方法。见预览并发送测试。
条件区块只向部分人显示消息的一部分,例如同一封欢迎邮件中给 Austin 办公室的停车说明段落。
-
把光标放在区块所在的位置,选择工具栏中的 Conditional section(漏斗图标)。Conditional Section 对话框打开。
-
给它一个 Name (Optional),并在 Apply to 下选择它是针对 Recipient of message(默认)还是 Principal of automation 匹配。
-
像设置步骤受众一样设置 Lifecycle、Included 和 Excluded,查看 Audience Preview,然后选择 Update。
-
在区块内撰写。再次选择它可以更改规则或 Remove 它。
这个人不匹配的区块中的内容会从他们的消息中去掉,也会从个性化的 Preview 中去掉。关于生命周期和群组如何匹配,见设置步骤受众。
电子邮件的 Raw HTML
Section titled “电子邮件的 Raw HTML”在为你的工作区启用了 Raw HTML 电子邮件时,打开步骤的 Advanced 标签页,把 Email body 设为 Raw HTML,用于 Pyn 必须原样发送的完整设计模板。正文变为一个 HTML 字段;在那里撰写你的标记,并用 Liquid 输出标签表示令牌,例如 {{ principal.preferredName }}。Pyn 不应用任何主题或样式,HTML 限制在 200,000 个字符以内,无效的 Liquid 会阻止自动化流程发布,Pyn 无法解析的名称会按原样留在电子邮件中。Preview 为你挑选的员工渲染 HTML,Send a test to yourself 像真实发送一样发送它。在没有启用 Raw HTML 电子邮件的工作区中,原始 HTML 步骤发送时会退回。同一标签页上的 Email format 选项(Left、Centered 或 Full width)和 Include the sender’s signature (verified email senders) 开关只适用于编排式消息,Email body 设为 Raw HTML 后它们就会消失;Raw HTML 电子邮件发送时不带发件人的签名。见添加电子邮件步骤。
Liquid 条件在同一封电子邮件内变换文本,例如按办公室区分。Pyn 在格式化消息时为每位收件人求值 {% if %}、{% elsif %}、{% else %} 以及带 {% when %} 的 {% case %},一个 when 可以列出多个值。它们取代了只对编排式消息有效的 Conditional section。
{% 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 %}始终用 ==、!= 或 case 比较一个值,或用 != blank 检查员工字段是否有值。单独测试一个令牌,例如 {% if employeeField.recipient.location %},永远为真:缺失的值会被它的回退取代,员工字段的回退是空文本,custom. 令牌的回退是列名。
Raw HTML Block
Section titled “Raw HTML Block”在为你的工作区启用了 Raw HTML 电子邮件时,电子邮件步骤上的 Insert widget 提供 Raw HTML Block,用于编排式电子邮件中某个设计好的部分,例如横幅或签名。Slack 步骤和 Library 内容中不提供它。
该区块是电子邮件中的一个块。电子邮件保留 Pyn 的默认电子邮件布局,即一个最宽 600 像素的居中栏,区块的 HTML 独占一行,位于前后的块之间。电子邮件的 Raw HTML 则替换整个正文,发送时不带该布局。
-
把光标放在区块所在的位置,选择 Insert widget,然后选择 Raw HTML Block。
-
在 HTML 字段中粘贴或撰写你的标记。令牌和条件是 Liquid,与电子邮件的 Raw HTML 中一样:例如
{{ principal.preferredName }}和{% if %}。 -
选择 Save。无效的 Liquid 显示在字段下方,修复之前区块无法保存。
编辑器按原样显示区块的 HTML 和其中的令牌;选择区块可以更改它。Preview 和 Send a test to yourself 会填入令牌。Pyn 完全按原样发送 HTML,不检查它是否格式良好:一个未闭合的标签可能破坏电子邮件其余部分的布局,所以先发送一次测试。
- 每个区块最多容纳 200,000 个字符。
- 区块不会出现在电子邮件的纯文本版本中。
- 区块内的链接不被跟踪:点击它们永远不会显示为 Clicked 或 Actioned。需要跟踪的链接请使用 Link Button。
- Conditional section 内的区块只发送给该条件区块匹配的人。
- 在没有启用 Raw HTML 电子邮件的工作区中,包含 Raw HTML Block 的电子邮件发送时会退回,与 Raw HTML 电子邮件一样。