跳转到内容
PynPyn

设置消息格式

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

The message editor with the Widgets menu open: Avatar, Custom Token, Custom Token Block, Embed Form, Link Button and Link to Library Content.
打开了 Widgets 菜单的消息编辑器。

选中文本并使用工具栏设置粗体、斜体和下划线,Heading、Subheading 和 Blockquote,项目符号列表和编号列表,链接(一个网址或 mailto:),以及在电子邮件上的左对齐、居中和右对齐。撤销和重做也在工具栏中。选择 Expand editor(编辑器上方的箭头图标)在全屏编辑器中撰写,关闭它即可返回。

  1. 在值所在的位置输入 @。一个令牌列表打开;继续输入可以筛选它,例如输入 @pref 找到 principal.preferredName。

  2. 选择令牌。它以标签的形式出现。principal 令牌对应已注册的员工;recipient 令牌对应收到消息的人;date.reference 是注册的参考日期。

  3. 对于不在列表中的字段,选择工具栏中的 Insert token,然后选择 Employee Field…。在 Employee Field 对话框中,用 Select an employee field 选择字段,在 Apply to 下选择它适用于 Principal of automation(默认)还是 Recipient of message,输入字段为空时显示的 Fallback (Optional),然后选择 Insert。

  4. 对于邮件合并电子表格中的某一列,选择 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 步骤上提供;见提及人员和频道。

在 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 办公室的停车说明段落。

  1. 把光标放在区块所在的位置,选择工具栏中的 Conditional section(漏斗图标)。Conditional Section 对话框打开。

  2. 给它一个 Name (Optional),并在 Apply to 下选择它是针对 Recipient of message(默认)还是 Principal of automation 匹配。

  3. 像设置步骤受众一样设置 Lifecycle、Included 和 Excluded,查看 Audience Preview,然后选择 Update。

  4. 在区块内撰写。再次选择它可以更改规则或 Remove 它。

这个人不匹配的区块中的内容会从他们的消息中去掉,也会从个性化的 Preview 中去掉。关于生命周期和群组如何匹配,见设置步骤受众。

在为你的工作区启用了 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 电子邮件时,电子邮件步骤上的 Insert widget 提供 Raw HTML Block,用于编排式电子邮件中某个设计好的部分,例如横幅或签名。Slack 步骤和 Library 内容中不提供它。

该区块是电子邮件中的一个块。电子邮件保留 Pyn 的默认电子邮件布局,即一个最宽 600 像素的居中栏,区块的 HTML 独占一行,位于前后的块之间。电子邮件的 Raw HTML 则替换整个正文,发送时不带该布局。

  1. 把光标放在区块所在的位置,选择 Insert widget,然后选择 Raw HTML Block。

  2. 在 HTML 字段中粘贴或撰写你的标记。令牌和条件是 Liquid,与电子邮件的 Raw HTML 中一样:例如 {{ principal.preferredName }} 和 {% if %}。

  3. 选择 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 电子邮件一样。