Klaviyo

Sami B2B Onboarding 可以将每位提交申请的买家，或每位您批准的买家，添加到 Klaviyo 列表中。应用会使用您选择的答案创建或更新买家的 Klaviyo 资料，然后将其订阅到该列表。您只需为店铺添加一次 Klaviyo 密钥，每个表单各自选择自己的列表。

应用会向 Klaviyo 发送资料和列表订阅。它不会向 Klaviyo 发送事件。

注意

开始之前，您需要一个至少有一个列表的 Klaviyo 账户，以及应用中的管理员角色。

在 Klaviyo 中创建私有 API 密钥

1. 打开您的 API 密钥

   在 Klaviyo 中，打开 Settings › API keys。

2. 创建私有密钥

   点击 Create Private API Key，并为其取一个便于识别的名称，例如“Sami B2B Onboarding”。

   应用会读取您的列表、创建和更新资料，并将其订阅到列表。请选择 Full Access Key，或对 Lists、Profiles 和 Subscriptions 拥有完全访问权限的 Custom Key。

3. 复制密钥

   创建密钥并复制它。私有密钥以 pk_ 开头。

将密钥添加到应用

1. 打开 Klaviyo 面板

   前往 Forms，点击表单旁边的 Edit。在左侧栏中点击 Integrations。在 Connected apps 下，点击 Klaviyo 一行上的 Connect。

   Klaviyo 面板会打开，包含三个部分：Account、This form 和 Field mapping。

   

   在 Account 下添加 API 密钥之前，您无法选择列表或映射答案，但已经可以选择买家加入的时机以及 double opt-in 设置。

2. 粘贴密钥

   在 Account 下，点击 Set up。在 Klaviyo 对话框中，将密钥粘贴到 Private API key 中，然后点击 Save。

   您会看到 Keys saved。Account 一行现在会显示密钥的开头和结尾，其下的文字为 Used by every form in this store.

选择列表以及买家加入的时机

以下所有设置都位于 This form 下。

1. 在 List 中选择 Klaviyo 列表。应用读取您的列表时，该框会显示 Checking your keys…。
2. 在 Add the buyer to the list 中，选择 When the application is submitted（默认）或 When the application is approved。如果只想让您接受的买家进入列表，请选择批准时。
3. 保持勾选 Ask for consent before subscribing (double opt-in)，或取消勾选。请参阅下表。

Ask for consent before subscribing (double opt-in)	应用的做法
已勾选（默认）	请求 Klaviyo 将买家订阅到列表。如果该列表在 Klaviyo 中使用 double opt-in，Klaviyo 会先向买家发送确认邮件。
已取消勾选	直接将买家的资料添加到列表，不发送同意请求。

警告

只有在您已经获得买家同意接收您的营销邮件时，才可以取消勾选。

如果 List 无法填充，面板会说明原因：

提示	处理方法
Klaviyo would not accept that API key. Change it above and try again.	密钥有误、已在 Klaviyo 中删除，或无法读取列表。请创建新密钥，并通过 Change 粘贴。
Klaviyo didn’t answer. Close this panel and open it again to retry.	无法连接到 Klaviyo。请关闭面板后重新打开。
This Klaviyo account has no lists yet. Create one in Klaviyo, then reopen this panel.	请在 Klaviyo 中创建列表，然后重新打开面板。

将答案映射到 Klaviyo 字段

选择列表后，Field mapping 会列出表单中的问题。每个问题都有一个下拉菜单，初始为 Don’t send。请选择其对应填写的 Klaviyo 字段：Email、Phone、First name、Last name、Title、Organization、Address line 1、Address line 2、City、Region、Postal code 或 Country。

对于 Wholesale application 表单，可以先这样设置：

表单上的问题	Klaviyo 字段
Company name	Organization
First name	First name
Last name	Last name
Email	Email
Job title	Title
Address line 1, City, State or province, ZIP or postal code, Country	Address line 1、City、Region、Postal code、Country

表单中的收货地址和账单地址使用相同的问题名称。请只映射其中一个，不要两个都映射。列表中还会显示表单的标题，例如 Company information。它们不含答案，请保持为 Don’t send。

正如面板所说，An answer with no Klaviyo field is not sent. Email is what Klaviyo keys a profile by. 如果没有任何问题映射到 Email，应用会使用申请上的邮箱。同一位买家申请两次，会更新同一份资料。

连接并保存

1. 连接表单

   在面板底部，点击 Connect。按钮会变为 Disconnect，Connected apps 中的 Klaviyo 一行会显示 Connected。

   如果尚未保存密钥，会出现一条横幅，显示 Add your Klaviyo private API key first.

2. 保存表单

   点击保存栏中的 Save。您会看到 Form saved。保存之前不会向 Klaviyo 发送任何内容。

检查是否正常工作

1. 提交一份测试申请

   前往 Forms，点击表单旁边的 Copy link。在无痕浏览窗口中打开该链接，并使用您能够收信的邮箱提交一份申请，例如以 Acme Supply Co. 的名义。如果您选择了 When the application is approved，请在 Companies › Applications 中批准它。

2. 在应用中查看结果

   打开该申请。在其 Timeline 上，点击 Klaviyo · Acme Supply Co. 条目。它会展开并显示 Added to the Klaviyo list。同一条目也会出现在 Automation 的 Automations 标签页的 Recent runs 下，以及 Settings › Activity log 的 Emails 视图中。

3. 在 Klaviyo 中检查列表

   在 Klaviyo 中打开该列表，买家的资料就在其中。如果列表启用了 double opt-in，买家会在确认 Klaviyo 发送的邮件后加入。

如果条目显示的是其他内容：

结果	含义
Skipped — the answers have no email to subscribe	映射到 Email 的答案均无值，且申请本身也没有邮箱地址。请检查表单是否仍保留其邮箱字段。
Klaviyo refused the profile，后面跟着类似 (400) 的数字	如果是 401 或 403，说明 Klaviyo 拒绝了该密钥：请在 Account 下通过 Change 粘贴一个有效的密钥。如果是其他数字，说明 Klaviyo 不接受某个映射的答案。请检查您的映射，例如 Phone。
Klaviyo didn’t answer	无法连接到 Klaviyo，或 Klaviyo 拒绝了订阅。请在面板中检查密钥和列表。

注意

When the application is approved 会统计您的团队所做的批准、通过将买家添加到您已有的公司所做的批准，以及由 Shopify Flow 工作流所做的批准。由规则自行批准的申请不会发送到 Klaviyo。

断开表单或移除密钥

• 停止某个表单：打开其 Klaviyo 面板，点击 Disconnect，然后点击 Save。列表和映射会保留，以后可以重新连接。
• 更换密钥：在 Account 下，点击 Change，粘贴新密钥并点击 Save。将输入框留空则保留您已保存的密钥。
• 移除所有表单的密钥：在 Account 下，点击 Change，然后点击 Remove keys。对话框会提示 Every form in this store stops using Klaviyo until you add keys again. 点击 Remove keys 确认，或点击 Keep keys。您会看到 Keys removed。此操作立即生效，无需保存。

后续步骤

• Webhook（Zapier、Make、n8n） — 将申请事件发送到其他工具。
• 将答案映射到 Shopify — 选择哪些答案用于填写 Shopify 的客户和公司。
• 活动日志 — 查看应用执行的每一次投递。