---
title: "HubSpot + OmniChannels.ai：从工作流直接触达联系人"
description: "通过自定义代码、webhook 或自动化工具，让 HubSpot 工作流调用 OmniChannels.ai API 发送 WhatsApp 与短信，并记录送达状态。"
canonical: "https://omnichannels.ai/zh/integrations/hubspot/"
language: "zh"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# HubSpot + OmniChannels.ai：从工作流直接触达联系人

Canonical: https://omnichannels.ai/zh/integrations/hubspot/
Language: zh
Publisher: OmniChannels.ai by BroadNet Technologies

**简而言之:** HubSpot 工作流可通过 REST API 发送 WhatsApp 与短信：订阅含自定义代码或 webhook 动作时直接使用，否则借助 Zapier、Make 或 n8n。送达状态经 webhook 记录到联系人。没有应用市场插件。

通过 API 和 Webhook 连接 · 通过 MCP 连接

## 您可以做什么

### 快速跟进新线索

表单提交产生线索后，工作流在取得对方同意的前提下，向其填写的号码发送 WhatsApp 模板或短信。

### 提醒联系人会议与到访

工作流延迟到某个日期属性（如已预约的演示或实地拜访）之前，在前一天发送提醒。

### 响应交易阶段变化

交易进入「合同已发送」或「成交」等阶段时，向关联联系人发送下一步说明。

### 发送续约提醒

在续约日期属性前的指定天数，把联系人或公司纳入工作流，并发送已审核的 WhatsApp 模板。

### 在时间线上记录状态与回复

你的自动化从我们的 webhook 接收送达状态和入站回复，并通过 HubSpot API 以备注或属性形式写入联系人。

### 让助手同时处理两边的数据

通过自己的连接器接入 HubSpot，并连接我们 MCP 服务器的 AI 助手，可以查找联系人并发送消息。

> 试着这样提问: "找出本周交易进入「已发送报价」阶段的 HubSpot 联系人，并向他们发送我们的 proposal_followup WhatsApp 模板。"

## 连接方式

HubSpot 自身不会调用 OmniChannels.ai API。在包含自定义代码动作的 HubSpot 订阅中，工作流可以运行一小段 JavaScript 或 Python 函数，调用我们的 API，Bearer 令牌保存为 HubSpot 密钥，从而完全掌控请求头和请求体。若订阅包含工作流 webhook 动作，也可使用，但通常把它指向自动化工具，比对齐我们的请求格式更省事。请查阅 HubSpot 当前的套餐说明。

没有这些功能时，可使用 Zapier、Make 或 n8n：HubSpot 触发器启动自动化，由其向我们的 API 发送 HTTP 请求。回传方向上，OmniChannels.ai 账户中的 webhook URL 指向同一个自动化工具或你自己的接口，由它按你保存的消息 ID 匹配状态，并通过 HubSpot API 更新联系人。

- 发送：自定义代码动作、工作流 webhook 动作，或 Zapier、Make、n8n
- 单条短信为 JSON 请求；批量及大多数其他渠道使用 multipart/form-data
- 把返回的消息 ID 保存在联系人或自动化中，用于匹配状态
- 24 小时窗口之外由企业主动发起的 WhatsApp 消息需要已审核的模板
- AI 方面：请另行将助手接入 HubSpot；我们的 MCP 服务器不读取 HubSpot 数据

## 设置步骤

1. **申请 API 访问权限:** 申请测试权限并获取 API 令牌。测试消息只会发送到你已验证的本人号码。 (指南: https://omnichannels.ai/developers/authentication/)
2. **选择 HubSpot 的发送方式:** 若 HubSpot 订阅包含自定义代码动作则直接使用，否则把 HubSpot 连接到 Zapier、Make 或 n8n。 (指南: https://omnichannels.ai/developers/zapier-make-webhooks/)
3. **构建发送请求:** 调用带 JSON 请求体的 POST /sms/sendSms，或 OpenAPI 规范中的渠道接口，把手机号和联系人属性映射到消息中。 (指南: https://omnichannels.ai/developers/sms/)
4. **保存消息 ID:** 把 API 响应中的 ID 写入联系人属性或自动化的数据存储，以便之后匹配状态。
5. **把状态回传 HubSpot:** 请我们的团队把账户 webhook 指向你的自动化，再通过 HubSpot API 在联系人上创建备注或更新属性。 (指南: https://omnichannels.ai/developers/webhooks/)
6. **用自己的号码测试:** 将使用你已验证号码的测试联系人纳入工作流，确认消息送达且状态出现在时间线上。

## 示例工作流程

HubSpot 工作流 (线索创建、交易阶段变化或续约日期到达) → 自定义代码或自动化 (自定义代码动作，或 Zapier、Make、n8n) → OmniChannels.ai API (发送消息并返回消息 ID) → 联系人手机 (WhatsApp 模板或短信已送达) → 状态回传 HubSpot (你的自动化把状态记录到联系人时间线)

## 常见问题

### HubSpot 应用市场里有 OmniChannels.ai 官方应用吗？

没有。你需要借助 HubSpot 自带的工作流功能（订阅中包含的自定义代码动作或 webhook），或使用自动化工具，携带令牌调用我们公开的 REST API。

### 需要哪种 HubSpot 套餐？

工作流中的自定义代码和 webhook 动作仅在部分 HubSpot 付费订阅中提供，请查阅 HubSpot 当前的套餐说明。如果你的套餐不含这些功能，Zapier、Make 或 n8n 等自动化工具也能完成同样的工作。

### 送达状态如何进入 HubSpot？

我们的平台会把状态和入站回复推送到你账户唯一的 webhook URL。把它指向你的自动化工具或接口，由其按保存的消息 ID 或手机号查找联系人，并通过 HubSpot API 写入备注或属性。

### AI 助手能利用 HubSpot 数据发送消息吗？

可以，前提是助手除了连接我们的 MCP 服务器，还通过 HubSpot 自己的连接器或 MCP 服务器接入了 HubSpot。我们的 MCP 服务器只发送消息和读取送达报告，不读取 HubSpot 记录。

## 开发者指南

- https://omnichannels.ai/developers/quickstart/
- https://omnichannels.ai/developers/sms/
- https://omnichannels.ai/developers/webhooks/
- https://omnichannels.ai/developers/zapier-make-webhooks/

## 厂商文档

- [Use webhooks with HubSpot workflows — HubSpot Knowledge Base](https://knowledge.hubspot.com/workflows/how-do-i-use-webhooks-with-hubspot-workflows)
- [HubSpot developer documentation](https://developers.hubspot.com/docs)

## 相关集成

- https://omnichannels.ai/zh/integrations/salesforce/
- https://omnichannels.ai/zh/integrations/zoho-crm/
- https://omnichannels.ai/zh/integrations/zapier/
- https://omnichannels.ai/zh/integrations/n8n/

HubSpot 是其所有者的商标。OmniChannels.ai 与 HubSpot 无关联，也未获得 HubSpot 的认可；本页介绍的是利用 HubSpot 自身的 MCP、HTTP 或 Webhook 功能建立的连接。

更新于: 2026-10-10