披露：此说明的作者是常联系会员，这意味着如果您决定通过插件作者的链接进行购买，插件作者将获得佣金，您无需支付任何费用。
Constant Contact 集成模块允许您将通过您的联系表格收集的联系数据发送到 Constant Contact API 。您可以通过几个简单的步骤创建可靠的电子邮件订阅服务。
您需要一个 Constant Contact 用户帐户才能使用此集成。如果您还没有帐户，请先注册以创建一个帐户，然后再继续。
连接到 API 连接到 API
此集成模块使用 Constant Contact V3 API 。要从您的 WordPress 网站开始使用 API，您首先需要注册一个应用程序以获取稍后将使用的 API 密钥和应用程序机密。
要注册应用程序，请移至 app.constantcontact.com 上的 “我的应用程序” 页面，然后单击右上角的 “新建应用程序” 按钮。
系统会要求您提供应用程序名称。您可以随时更改名称，所以暂时将其命名为 “Contact Form 7 Integration for (your site title) ” 。
单击保存，然后您将被定向到详细信息页面。
在详细信息页面上，您将在第一个字段中找到 API 密钥。单击 API Key 字段旁边的 Generate Secret 按钮以生成应用程序密钥。复制 API 密钥和应用程序机密，因为您将在下一步中使用它们。
接下来，在浏览器的另一个选项卡中打开 WordPress 网站的管理屏幕。移动到 Contact > Integration 菜单页面，找到一个名为 Constant Contact 的框。
单击设置集成按钮；它将显示一些输入字段。将您在上一步中复制的字符串粘贴到 API Key 和 App Secret 字段中。
您将在两个字段下找到 Redirect URI 只读字段。复制此字段值并将其粘贴到 app.constantcontact.com 上 “详细信息” 页面上的 “重定向 URI” 字段中。
在 “详细信息” 页面上更改字段值后，单击右上角的 “保存” 按钮。
现在，您几乎完成了必要的设置。返回 WordPress 管理屏幕中的 Contact > Integration 菜单页面，然后单击 Connect to the Constant Contact API 按钮开始授权过程。
如果您已正确设置所有内容，您将被定向到 Constant Contact 登录页面（如果您尚未登录），并会被要求授权您注册的应用程序以访问您的 Constant Contact 帐户.
之后，您将被重定向回 WordPress，并发现框的边框颜色已更改为蓝色。蓝色边框表示已成功创建与 API 的连接。
联系人属性映射联系人属性映射
现在，您的联系表单和 Constant Contact API 已连接。
每次收到有效的表单提交时，Contact Form 7 都会向 Constant Contact API 发送一个请求，让 Constant Contact 根据提交将联系人数据添加到其数据库中。
Constant Contact 的联系人数据由不同类型的属性组成，例如名字、姓氏、电子邮件地址、电话号码、职位、生日等。要构建对 API 的请求，Contact Form 7 需要知道哪个输入字段联系表的哪个属性对应 Constant Contact 的联系数据的哪个属性。
Contact Form 7 使用以下基于名称的映射表来确定输入字段和联系人属性之间的对应关系。例如，如果 [email* your-email] 表单中有 form-tag (name: your-email)，则通过该字段的值将用于 email_address 联系人的属性。
| 表单字段名称 | 联系物业 |
|---|---|
| your-first-name | first_name |
| your-last-name | last_name |
| your-name | first_name 和 last_name(*1) |
| your-email | email_address |
| your-job-title | job_title |
| your-company-name | company_name |
| your-birthday-month | birthday_month |
| your-birthday-day | birthday_day |
| your-birthday | birthday_month 和 birthday_day(*2) |
| your-anniversary | anniversary |
| your-phone-number | phone_numbers |
| your-address-street | street_addresses.street |
| your-address-city | street_addresses.city |
| your-address-state | street_addresses.state |
| your-address-postal-code | street_addresses.postal_code |
| your-address-country | street_addresses.country |
*1 — 如果表单中没有 your-first-nameoryour-last-name 字段但有一个 your-name 字段，则 your-name 字段值的第一个单词将用于 first_name 联系属性，其余的将用于 last_name 属性。
*2 — 如果表单中没有 your-birthday-month 和 your-birthday-day 字段，但有 your-birthday 一个日期值为 YYYY-MM-DD 格式的字段，则该值的月和日部分将分别用于 birthday_month 和 birthday_day 联系人属性。
在某些情况下，您可能觉得此映射不适合您的实际表单字段。对于这种情况，Contact Form 7 提供了 wpcf7_constant_contact_contact_post_request_builder 过滤器钩子。虽然它需要一些 PHP 编码来创建过滤器功能，但您可以使用此过滤器自定义联系人创建请求中的任何内容。
获得同意获得同意
强烈建议您在将联系人数据添加到订阅列表之前获得联系表单提交者的明确同意。这不仅是因为未经同意收集和使用个人数据是非法的。这也是因为将电子邮件发送给非预期接收者会导致垃圾邮件投诉率很高。
对于检查提交者是否同意将其联系数据添加到 Constant Contact 订阅列表的表单字段，Contact Form 7 提供了 consent_for:constant_contactform-tag 选项。您可以使用以下示例中的选项：
[接受您的同意可选 consent_for:constant_contact] 将我添加到 Constant Contact 订阅列表。 [/验收]
如果您的联系表单中有此表单标签（接受复选框），则仅当提交者选中该复选框以确认他们的同意时，Contact Form 7 才会将联系数据发送到 Constant Contact API 。
指定联系人列表指定联系人列表
Constant Contact 允许您将收集到的联系人数据分组到联系人列表（也称为 “电子邮件列表” 或简称 “列表”）中。
Contact Form 7 的 Constant Contact Integration 支持为通过您的联系表格收集的新联系人指定联系人列表。
如果您还没有联系人列表，请转至 “ Constant Contact” 仪表板并尝试创建您的第一个列表。然后，返回 WordPress 管理屏幕。在联系表单编辑器屏幕中，您会发现在那里添加了 Constant Contact 选项卡面板。在此选项卡面板中，如果您想通过此联系人表单向联系人列表添加新联系人，请选中联系人列表复选框，然后选择联系人列表。
上次修改 2021.12.27