使用 Marketo API 和 Zapier 实现从 Google Sheets 自动填充并创建新的电子邮件

使用 Marketo API 和 Zapier 实现从 Google Sheets 自动填充并创建新的电子邮件，可以按照以下详细步骤进行操作。我还会标记出一些可能会出问题的地方，并提供解决建议。

---

步骤 1：准备工作

1. 安装和配置基本工具：

   • Marketo：确保你在 Marketo 中有管理员权限，并且已经准备好了要发送的电子邮件模板。
   • Google Sheets：准备包含邮件内容的表格。
   • Zapier：一个 Zapier 账户，用于创建自动化任务。
   • cURL 工具：Windows 用户可以使用以下方式安装 cURL，它用于在终端中调用 API：
     • 打开命令提示符，输入以下命令查看是否已安装 cURL：

       curl --version 

     • 如果没有安装，访问以下链接下载并安装 Windows 版的 cURL：cURL 官方下载页面。

2. Google Sheets 数据设置：

   • 创建一个 Google Sheets 表格，其中包含以下列：

     Email Subject	Email Body	Recipient
     Welcome Email	Hi {{Name}}, Welcome!	user@example.com
     Reminder Email	Don't forget our event.	anotheruser@example.com

---

步骤 2：在 Marketo 获取 API 凭据

1. 登录 Marketo：

   • 使用管理员账户登录 Marketo。

2. 创建 API Only 用户：

   • 导航到 Admin > Users & Roles。
   • 点击 Invite New User，然后：
     • 填写用户信息。
     • 在角色中选择 API Only。
     • 勾选 API Only User，完成创建。

3. 创建 LaunchPoint 服务：

   • 在 Marketo 的管理面板中，导航到 LaunchPoint。
   • 点击 New > New Service，填写以下信息：
     • Display Name：服务名称，如 Zapier Integration。
     • Service：选择 Custom。
     • API Only User：选择之前创建的 API Only 用户。

4. 获取 API 凭据：

   • 在 LaunchPoint 页面，点击刚创建的服务名称。
   • 你会看到 Client ID 和 Client Secret，稍后调用 API 时需要用到。

---

步骤 3：使用 cURL 测试 Marketo API

1. 获取 Access Token：

   • 打开 Windows 终端，执行以下命令以获取 Access Token：

   curl -X POST "https://YOUR-MARKETO-ENDPOINT/identity/oauth/token" ^ -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

   • 注意替换：
     • YOUR-MARKETO-ENDPOINT：例如 https://123-ABC-456.mktorest.com。
     • YOUR_CLIENT_ID 和 YOUR_CLIENT_SECRET：从 Marketo 的 LaunchPoint 中获取。

   可能出错点：

   • 如果返回 "Access token invalid" 或 "401 Unauthorized"，可能是你的 Client ID 或 Client Secret 填写有误，或 LaunchPoint 服务配置错误。检查 API Only 用户是否正确配置。

2. 列出文件夹：

   • 使用以下命令来列出 Marketo 中的所有文件夹，以获取 Folder ID：

   curl -X GET "https://YOUR-MARKETO-ENDPOINT/rest/asset/v1/folders.json?access_token=YOUR_ACCESS_TOKEN" 

   可能出错点：

   • 如果返回 "Access token expired"，你需要重新获取 Access Token。

---

步骤 4：配置 Zapier 工作流

1. 创建一个新 Zap：

   • 登录 Zapier，点击 Make a Zap 创建自动化任务。

2. 选择 Google Sheets 作为触发器：

   • 在 Trigger 应用中，选择 Google Sheets。
   • 选择 New Spreadsheet Row 作为触发事件。
   • 连接你的 Google Sheets 账号，并选择包含邮件数据的工作表。
   • 选择要监控的列（例如 Email Subject、Email Body 等）。

3. 添加 Webhook 动作：

   • 在 Action 中，选择 Webhooks by Zapier。
   • 动作类型选择 Custom Request。

4. 配置 Webhook 请求：

   • 在 Method 中选择 POST。

   • 在 URL 中输入：

     https://YOUR-MARKETO-ENDPOINT/rest/asset/v1/emails.json?access_token=YOUR_ACCESS_TOKEN 

   • Payload Type：选择 JSON。

   • Data：将 Google Sheets 的列映射到 API 请求中。输入如下 JSON 数据：

     { "name": "{{Email Subject}}", "folder": { "id": "YOUR_FOLDER_ID", "type": "Folder" }, "fromName": "Your Name", "fromEmail": "your-email@example.com", "subject": "{{Email Subject}}", "html": "{{Email Body}}", "text": "{{Email Body}}", "template": YOUR_TEMPLATE_ID } 

     注意替换：

     • YOUR_FOLDER_ID：从第 3 步中获取的文件夹 ID。
     • YOUR_TEMPLATE_ID：在 Marketo 中使用的电子邮件模板 ID（可以通过 API 调用或 UI 获取）。

   • Headers：

     { "Content-Type": "application/json" } 

5. Unflatten：选择 Yes，确保 JSON 数据以正确的格式传输。

6. 测试 Zap：

   • 点击 Test & Continue，验证是否能够正确创建电子邮件。
   • 如果 Zapier 提示错误，检查 API 请求和映射的 Google Sheets 数据是否正确。

---

步骤 5：验证和发送电子邮件

1. 在 Marketo 中验证：

   • 登录 Marketo，导航到指定的文件夹，查看是否成功创建了电子邮件。

2. 发送测试邮件：

   • 使用 Marketo 发送测试邮件，确认内容是否与 Google Sheets 中填写的数据一致。

---

常见问题和解决方案

1. Access Token Invalid：

   • 如果返回 "Access token invalid"，确保你的 Client ID 和 Client Secret 是正确的，且 Access Token 没有过期。

2. Folder ID 和 Template ID 错误：

   • 如果返回 "folder cannot be null" 或 "A valid template id is required"，确保你已通过 API 获取到正确的文件夹和模板 ID。

3. Zapier 映射错误：

   • 在 Zapier 中，确保 Google Sheets 中的列已正确映射到 name、subject 和 html 字段中。如果 Zapier 显示黄色警告或字段为空，确保表格的列标题与数据匹配。

4. 请求失败：

   • 如果 API 请求失败，检查 Zapier 中的 Webhook URL 是否正确，Access Token 是否有效，数据格式是否符合要求。

---

通过这些步骤，你应该能够在 Windows 环境下完成从 Google Sheets 到 Marketo 的自动电子邮件创建。