集成与渠道
集成是 OneTrace.pro 与外部服务之间的连接:邮件服务器、短信网关、即时通讯机器人、广告平台或文件存储。旅程和群发通过已接入的渠道运行,受众导出和广告转化通过广告平台运行,定期数据导入则通过数据源运行。
在菜单中打开用户互动 → 集成。

已接入的集成按类型分组。类型多于一种时,卡片上方会出现带计数的筛选:全部、渠道、CRM 等。
可以接入哪些服务
通过添加集成按钮接入新的集成:窗口中的服务按类型分组,还可以按名称搜索服务。页面上分组标题旁的 + 按钮会直接打开该类型的窗口。
渠道:用于发送消息。
| 渠道 | 工作方式 |
|---|---|
| 邮件 | 平台邮件服务:从您在发信域名中连接的域名发送,DKIM 签名、退信、投诉和屏蔽列表均自动处理;或自有 SMTP 服务器:地址、端口、加密方式、用户名和密码。两种方式都需要填写发件人地址和名称,并可开启打开和点击追踪。使用自有 SMTP 服务器时,可以指定退信域名和退信邮箱,使无法送达的邮件自动将地址退订。客户发送到支持地址的邮件可以接收到在线聊天中,参见聊天中的收件 |
| SMS | 可选服务商:SMS.ru、SMSC.ru、Twilio 或您自己网关的 HTTP API。投递状态会发送到集成中显示的网址 |
| Telegram | 在 BotFather 中创建的机器人:只需令牌,机器人会自动获取接收消息的网址 |
| Viber(商业消息) | 通过聚合商按电话号码发送消息:SMSC.ru、Infobip 或您自己的 HTTP API |
| Viber 机器人 | 使用合作伙伴后台中的令牌接入 Viber 机器人,并可为新订阅者设置欢迎语 |
| MAX 机器人 | 使用 business.max.ru 中的令牌接入 MAX 即时通讯工具的机器人,可设置欢迎消息和“分享手机号”按钮,参见MAX 机器人 |
| VK 社区 | 使用访问密钥以社区名义发送消息,“增长版”套餐起提供,参见VK 社区 |
| Instagram Direct | 通过您在 Meta 中的应用从 Instagram 商业账号发送消息,“增长版”套餐起提供,参见Instagram Direct |
| Facebook Messenger | 通过您在 Meta 中的应用以 Facebook 主页名义发送消息,“增长版”套餐起提供,参见Facebook Messenger |
| WhatsApp Business Cloud API:号码 ID、账户 ID、令牌和 Meta 应用密钥 | |
| Web Push | 浏览器通知;密钥自动生成,订阅由网站上的代码收集,参见接入网站 |
| 移动推送 | Android 和 iOS 应用中的通知:Firebase 的包名和服务账号、bundle id 和 APNs 密钥,参见移动应用 |
| 应用内消息 | 在已打开的应用内部显示的弹窗、横幅或全屏;“增长版”套餐起提供,参见移动应用 |
| Wallet 卡券 | Apple Wallet 和 Google Wallet 中的会员卡:Apple Pass Type ID 证书、Google Issuer ID 和服务账号;“增长版”套餐起提供,参见 Wallet 卡券 |
| Webhook | 向您的服务器发送包含消息数据的请求,例如用于您自己的通知系统 |
受众导出:Webhook、S3(CSV)、Meta Custom Audience、Yandex Audiences、VK Ads 和 Google Ads Customer Match。
广告转化:Meta Conversions API、Yandex Metrica 和 Google Ads 线下转化、VK Ads 线下事件,参见广告转化。
数据源:网址文件、S3 中的文件和 Google 表格。
数据仓库:S3(NDJSON)、Google Cloud Storage、BigQuery、Snowflake、ClickHouse 和 PostgreSQL,用于导出项目数据。该分组在“企业版”套餐中显示。
CRM:amoCRM、Kommo、Bitrix24、HubSpot、Pipedrive、Zoho CRM、Odoo、Salesforce 和 Microsoft Dynamics 365:联系人、线索和交易进入用户档案与事件,旅程中有用于交易和任务的节点,还可将分群导出回 CRM,参见 CRM。该分组自“增长版”套餐起显示。
同一类型可以接入多个集成:例如,两台分别用于营销邮件和交易邮件的 SMTP 服务器。在模板、旅程和群发中,您可以选择通过哪个集成发送。
如何接入集成
- 点击添加集成并选择服务,例如邮件。窗口左侧是带说明的集成类型,顶部是按名称搜索。
- 设置名称,它会显示在模板、旅程和导出中,例如“营销邮件”。
- 填写设置。字段下方的提示说明了在服务后台的何处获取令牌或密钥。
- 点击保存。如需选择其他服务,请点击返回。
- 在集成卡片上点击测试。


对于部分服务,保存后设置中会出现系统字段,例如 WhatsApp 的 Webhook 网址和验证令牌(Verify token),或 SMS 的投递状态网址。请将它们复制到服务后台,否则将无法收到投递状态和传入消息。
Telegram、Viber 机器人、MAX 机器人和 WhatsApp 通过您的 OneTrace.pro 部署地址接收传入消息:该地址必须能通过 HTTPS 从互联网访问。
MAX 机器人
- 在 business.max.ru 上创建机器人(俄罗斯法人、个体经营者或自雇人士可以发布机器人),并复制令牌:“Чат-боты” → ⋮ → “Настройки”。
- 点击添加集成,选择MAX 机器人,粘贴机器人令牌并保存。机器人会自动获取接收消息的网址,其名称会显示在设置中。
- 如有需要,可以设置欢迎消息和**“分享手机号”按钮**的文字:客户启动机器人时,机器人会发送它们。

机器人只能给启动过它的用户发消息。客户可以通过两种方式与档案关联:
- 通过链接:您的服务器为已登录的客户生成链接
https://max.ru/{机器人}?start=…(POST /api/v1/max/link,与 Telegram 相同),客户通过该链接打开机器人; - 通过号码:客户点击欢迎消息中的“分享手机号”按钮。如果 MAX 确认该号码属于客户本人的账号,机器人会关联到使用该电话号码的档案。转发的他人联系人名片不会被关联。
启动机器人即订阅该渠道,停止机器人或删除对话即退订。客户发给机器人的消息会成为 max.message 事件,并从“增长版”套餐起成为在线聊天中的会话。MAX 没有投递报告:被接受的消息即视为已送达。MAX 的规则禁止在服务消息中发布广告。
VK 社区
- 在社区中打开 Manage community → Messages,开启社区消息。
- 在 Manage community → API usage → Access tokens 中点击“Create token”,勾选“Community management”“Community messages”“Photos”权限;如果规则需要回复评论,还需勾选“Wall”。
- 点击添加集成,选择VK 社区,粘贴社区访问密钥并保存。OneTrace.pro 会检查密钥的权限,自动在社区设置中添加 Callback API 服务器,并显示社区名称和地址。
- 如有需要,可以设置欢迎语:允许接收社区消息的用户会收到它。

社区只能给允许接收消息的人发消息:主动发过消息、点击了“Allow messages”或通过 vk.me 链接进入的人。这就是对该渠道的订阅,禁止消息则视为退订。您的服务器可以将用户与客户档案关联:POST /api/v1/vk/link 为已登录的客户生成链接 https://vk.me/{社区}?ref=…,同一标记也可以作为密钥传给“Allow messages”小组件。
消息中可以发送文字、图片和链接按钮。VK 不接受通过链接提供的图片:OneTrace.pro 会自动上传文件,每次群发只上传一次。用户的消息会成为 vk.message 事件和在线聊天中的会话,帖子评论则会触发关键词规则。删除集成时,Callback API 服务器也会从社区设置中移除。
Instagram Direct
Instagram 通过您在 Meta 中的应用接入:用于您自己的账号时,无需通过 Meta 的应用审核。
- 在 Meta for Developers 中创建应用,添加 Instagram 产品,并在使用 Instagram 登录的 API 设置中连接商业账号。
- 点击“生成访问令牌”并复制令牌。需要
instagram_business_basic、instagram_business_manage_messages权限,回复评论还需要instagram_business_manage_comments。在同一处复制 Instagram 应用密钥。 - 点击添加集成,选择Instagram Direct,粘贴令牌和密钥并保存。设置中会出现 Webhook 地址和验证令牌。
- 在应用的 Webhook 设置(Instagram 部分)中填写该地址和令牌。OneTrace.pro 可以自动为账号订阅事件。

令牌有效期为 60 天,OneTrace.pro 会自动续期。如果续期失败,错误会显示在集成卡片上:请在旧令牌过期前生成新令牌并保存集成。
Instagram 只允许在对方发消息后的 24 小时内给其发消息。群发和旅程会跳过更早发过消息的人:消息不会发送,订阅保留。如果应用拥有 Human Agent 权限且集成中开启了客服回复最长 7 天,聊天客服可以在之后最长 7 天内回复。
用户的第一条消息即订阅该渠道,“stop”即退订。用于关联档案的带标记对话链接由 POST /api/v1/instagram/link 生成:https://ig.me/m/{账号}?ref=…。消息和快拍回复会成为 instagram.message 事件和在线聊天中的会话,评论则会触发关键词规则。
Facebook Messenger
Messenger 与 Instagram 一样,通过您在 Meta 中的应用接入:用于您自己的主页时,无需通过 Meta 的应用审核。
- 在 Meta for Developers 中创建应用,并添加 Messenger 产品。
- 在 Messenger → API 设置中连接 Facebook 主页,并生成具有
pages_messaging权限的主页令牌。需要永久令牌:OneTrace.pro 不会为其续期。在应用设置 → 基本中复制应用密钥。 - 点击添加集成,选择 Facebook Messenger,粘贴令牌和密钥并保存。OneTrace.pro 会找到该主页,为其订阅消息,并显示 Webhook 地址和验证令牌。
- 在应用的 Webhook 设置(Messenger 部分)中填写该地址和令牌。
Messenger 与 Instagram 一样,只允许在对方发消息后的 24 小时内给其发消息:群发和旅程会跳过更早发过消息的人。如果应用拥有 Human Agent 权限且集成中开启了客服回复最长 7 天,聊天客服可以在最长 7 天内回复。
用户的第一条消息即订阅该渠道,并会收到集成设置中的欢迎语,“stop”即退订。用户的档案会获得标识符 facebook_psid(与您的主页之间的对话编号),如果主页能看到其 Facebook 姓名,也会一并获得。消息、照片和文件会成为 messenger.message 事件和在线聊天中的会话。客服的快捷回复按钮在 Messenger 中会显示为真正的按钮。
聊天中的收件
在邮件集成中,聊天中的收件分组会将客户发送到支持地址的邮件接收到在线聊天中。客服的回复通过同一集成发送到同一往来邮件中。方式:
- IMAP 邮箱:客服邮箱的服务器、端口、加密方式、登录名、密码和文件夹。新邮件每分钟读取一次并标记为已读。
- Webhook:保存后会显示带有令牌的 Webhook 地址。请在邮件服务中将其设置为收件地址。支持的服务:Postmark:Inbound webhook;SendGrid:Inbound Parse,勾选或不勾选“POST the raw, full MIME message”均可;Mailgun:带 forward 操作的 Routes;Cloudflare Email Workers:转发完整邮件。地址中的令牌需保密:请勿公开该地址。 如果地址可能已泄露,请勾选更换 Webhook 地址并保存:将生成新地址,旧地址不再接收邮件。只有能管理该集成的成员才能看到地址。
两种方式都必须填写支持地址:客户向该地址发信,它同时也是客服邮件中的回复地址。
测试与状态
测试按钮会连接服务并显示结果:“连接正常”及详细信息(机器人名称、短信服务商余额、可访问的存储桶),或“测试失败”及错误信息。上次测试的时间显示在卡片上。
| 状态 | 含义 |
|---|---|
| 正常 | 连接正常 |
| 错误 | 上次测试或配置失败;错误信息显示在卡片上。请修正设置并重新测试 |
| 已停用 | 集成已通过其设置中的已启用开关关闭;不会通过它发送消息 |
通过自有 HTTP API 测试 SMS 时,只会确认网关地址可访问:真实短信需要付费,因此请通过模板发送测试消息来检查实际发送。
修改与删除
- 编辑会打开设置。密码、令牌和密钥保存后不再显示:将此类字段留空即可保留原值。
- 如需暂时停止发送,请关闭已启用开关,设置会被保留。
- 删除集成:将不再通过它发送消息,使用此连接的导出和数据源会因错误而停止。 对于 Telegram、Viber 和 MAX 机器人以及 SMS.ru,平台会自行移除其 webhook。如果服务不可用,将显示警告,请您在机器人设置或服务账户中手动移除 webhook。
谁可以管理集成
| 操作 | 角色 |
|---|---|
| 查看集成 | “所有者”“管理员”“经理” |
| 接入、修改、测试和删除 | “所有者”“管理员” |
成员的角色可以限定于特定集成,参见成员与角色。这样的成员在此板块中只能看到自己的集成,并且仅在角色允许时才能管理它们。他无法接入新集成:这需要整个项目的权限。在模板和旅程编辑器中,他仍可以从项目中所有已接入的集成中进行选择。
注意事项
- 渠道本身不检查订阅和频率:这些规则对所有渠道通用,在消息规则页面中设置。
- 在该页面还可以关闭不需要的扩展,例如 WhatsApp。关闭的扩展会从项目的集成、模板和旅程中消失。
- 在 WhatsApp 中,首条消息和群发只能使用经 Meta 批准的模板;自由文本只能在客户发送消息后的 24 小时内发送。Meta 模板、商品轮播和 WhatsApp 表单请参阅 WhatsApp 购物。
- 使用平台邮件服务时,DKIM、SPF 和退信记录只需在连接域名时添加一次,参见发信域名。使用自有 SMTP 服务器时,SPF、DKIM 和 DMARC 需要在服务器一侧和您的域名上配置。