HubSpot

Email checker for HubSpot. Verify contacts and clean email lists in HubSpot CRM.

在联系人创建或更新时自动验证电子邮件地址，保持您的 HubSpot CRM 清洁并提高潜在客户质量。

概述

将 EmailVerify 与 HubSpot 集成可帮助您：

立即判定潜在客户 - 在联系人进入 CRM 时验证电子邮件
维护数据质量 - 保持联系人数据库清洁
改善可递送性 - 确保营销邮件送达真实用户
降低退信率 - 在营销活动前过滤无效地址

集成方式

方式	最适合	复杂度
工作流	自动化验证	低
自定义代码	高级逻辑	中
Zapier/Make	无代码自动化	低
直接 API	完全控制	高

方式 1：HubSpot 工作流（推荐）

使用带有 Webhooks 的 HubSpot 工作流自动验证电子邮件。

步骤 1：创建自定义属性

首先，创建用于存储验证结果的属性：

前往设置 → 属性
点击 创建属性
创建以下属性：

属性名称	类型	字段类型
电子邮件验证状态	单行文本	文本
电子邮件验证分数	数字	数字
电子邮件验证日期	日期	日期选择器
是否为一次性电子邮件	单个复选框	复选框

步骤 2：创建工作流

前往 自动化 → 工作流
点击 创建工作流 → 从头开始
选择 基于联系人 的工作流
设置注册触发器：

触发器：联系人被创建
或
触发器：电子邮件被更新

步骤 3：添加 Webhook 操作

添加操作：触发 Webhook
配置 Webhook：

方法： POST

URL：

https://api.emailverify.ai/v1/verify

请求头：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

请求正文：

{
  "email": "{{contact.email}}"
}

步骤 4：处理响应

添加 自定义代码 操作来处理响应：

const response = JSON.parse(event.webhook.response);

// 将验证结果映射到联系人属性
const outputFields = {
  email_verification_status: response.status,
  email_verification_score: response.score,
  email_verified_date: new Date().toISOString(),
  is_disposable_email: response.result.disposable
};

// 返回要更新的属性
callback(outputFields);

步骤 5：根据结果分支

根据验证状态添加分支逻辑：

如果 email_verification_status 等于 "valid"
  → 继续潜在客户培育
  → 添加到营销列表

如果 email_verification_status 等于 "invalid"
  → 从营销列表中移除
  → 将生命周期阶段更新为"其他"

如果 email_verification_status 等于 "unknown"
  → 添加到"需要审核"列表

方式 2：使用 Operations Hub 自定义集成

对于高级用例，使用带有自定义代码的 HubSpot Operations Hub：

创建自定义代码操作

const axios = require('axios');

exports.main = async (event, callback) => {
  const email = event.inputFields['email'];

  try {
    const response = await axios.post(
      'https://api.emailverify.ai/v1/verify',
      { email },
      {
        headers: {
          'Authorization': `Bearer ${process.env.EMAILVERIFY_API_KEY}`,
          'Content-Type': 'application/json'
        }
      }
    );

    const result = response.data;

    callback({
      outputFields: {
        verification_status: result.status,
        verification_score: result.score,
        is_deliverable: result.result.deliverable,
        is_disposable: result.result.disposable,
        is_role_based: result.result.role,
        is_free_email: result.result.free
      }
    });
  } catch (error) {
    callback({
      outputFields: {
        verification_status: 'error',
        error_message: error.message
      }
    });
  }
};

设置环境密钥

前往设置 → 集成 → 私有应用
创建私有应用或使用现有应用
添加密钥：EMAILVERIFY_API_KEY

方式 3：Zapier 集成

对于无代码实现，使用 Zapier：

Zap 配置

触发器：HubSpot → 新联系人
    ↓
操作：Webhooks → POST 到 EmailVerify
    ↓
操作：HubSpot → 更新联系人

配置：
  - 电子邮件：{{Contact Email}}
  - 要更新的属性：
    - email_verification_status: {{status}}
    - email_verification_score: {{score}}

有关详细说明，请参阅我们的 Zapier 集成指南。

应用场景

1. 潜在客户评分增强

将电子邮件质量添加到您的潜在客户评分模型：

潜在客户分数调整：
  - 有效的企业电子邮件：+15 分
  - 有效的免费电子邮件：+5 分
  - 一次性电子邮件：-20 分
  - 基于角色的电子邮件：-5 分
  - 无效电子邮件：-50 分

工作流实现：

如果 email_verification_status = "valid"
  且 is_disposable_email = false
  且 is_free_email = false
    → HubSpot 分数增加 15

如果 is_disposable_email = true
    → HubSpot 分数增加 -20

2. 营销列表清洁

在营销活动前清理列表：

创建活跃列表：
  - email_verification_status = "valid"
  - is_disposable_email = false
  - 营销联系人 = true

从营销活动中排除：
  - email_verification_status = "invalid"
  - 或 is_disposable_email = true

3. 销售团队通知

在高质量潜在客户到达时提醒销售人员：

如果 email_verification_status = "valid"
  且 email_verification_score > 0.9
  且 is_free_email = false
    → 发送内部通知
    → 为销售代表创建任务

4. 表单提交验证

验证表单提交的电子邮件：

工作流触发器：任意表单的表单提交

操作：
  1. 使用 EmailVerify 验证电子邮件
  2. 如果有效 → 继续正常流程
  3. 如果无效 → 发送"请使用有效电子邮件"通知

批量验证

对于现有联系人，创建批量验证工作流：

选项 1：计划工作流

触发器：计划（每周）
注册条件：联系人满足
  - email_verified_date 未知
  - 或 email_verified_date 超过 90 天
  - 限制：每次运行 1000 个联系人

选项 2：导出和导入

将联系人导出到 CSV
使用 EmailVerify 批量 API 或仪表板
将结果导入回 HubSpot

// 批量验证脚本
const contacts = await hubspot.crm.contacts.getAll();
const emails = contacts.map(c => c.properties.email);

// 提交到 EmailVerify 批量 API
const job = await emailVerify.verifyBulk(emails);

// 等待完成
const results = await emailVerify.getBulkResults(job.job_id);

// 更新 HubSpot 联系人
for (const result of results) {
  await hubspot.crm.contacts.update(
    result.email,
    {
      properties: {
        email_verification_status: result.status,
        email_verification_score: result.score
      }
    }
  );
}

自定义联系人属性参考

创建以下属性以实现完整集成：

属性	内部名称	类型	选项
电子邮件验证状态	`email_verification_status`	下拉菜单	valid, invalid, unknown, accept_all
验证分数	`email_verification_score`	数字	0-1
验证日期	`email_verified_date`	日期	-
是否为一次性	`is_disposable_email`	复选框	-
是否基于角色	`is_role_based_email`	复选框	-
是否免费提供商	`is_free_email_provider`	复选框	-
是否全接收域	`is_catchall_domain`	复选框	-

报告和仪表板

创建验证报告

构建报告以跟踪电子邮件质量：

联系人质量报告：

按验证状态统计总联系人数
验证分数分布
一次性电子邮件百分比

潜在客户来源质量：

按潜在客户来源统计验证状态
跨渠道比较质量

趋势分析：

随时间变化的无效电子邮件
清理后的改进

仪表板小部件

小部件 1：电子邮件质量饼图
  - 分段：valid, invalid, unknown
  - 过滤器：最近 30 天创建

小部件 2：验证分数直方图
  - X 轴：分数范围 (0-0.5, 0.5-0.8, 0.8-1.0)
  - Y 轴：联系人数量

小部件 3：一次性电子邮件趋势
  - 随时间变化的折线图
  - 目标：减少到 5% 以下

最佳实践

1. 在入口点验证

在创建联系人时立即验证电子邮件：

表单提交
导入流程
API 集成
手动输入

2. 定期重新验证

电子邮件有效性会随时间变化：

为活跃联系人设置每月重新验证
在重大营销活动前重新验证
跟踪验证日期以识别过时数据

3. 处理未知结果

对于 unknown 状态的电子邮件：

不要立即移除它们
标记为待审核
24 小时后尝试重新验证
使用发件人声誉数据作为备用信号

4. 按质量分段

根据电子邮件质量创建智能列表：

高质量：
  status = "valid" 且 score > 0.8 且 disposable = false

中质量：
  status = "valid" 且 (score <= 0.8 或 disposable = true)

低质量：
  status = "invalid" 或 status = "unknown"

5. 保护发件人声誉

永远不要向无效电子邮件发送：

从所有营销列表中排除 invalid 状态
监控营销活动后的退信率
调查不良数据的来源

故障排除

工作流未运行

检查注册条件
验证工作流已开启
检查是否有冲突的工作流
查看工作流错误日志

Webhook 错误

验证 API 密钥正确
检查 Webhook URL 可访问
在工作流历史中查看请求/响应
先在 Postman 中测试 API 调用

属性未更新

检查属性内部名称是否完全匹配
验证自定义代码返回正确的字段名称
检查用户对属性更新的权限

HubSpot

ActiveCampaign 集成

Zapier 集成

API 参考

On this page