JavaScript API
加载挂件脚本后可用的全局方法。
Respondo.init(config)
初始化并挂载挂件。必须调用一次。返回挂件实例。
const widget = Respondo.init({
agentId: 'YOUR_AGENT_ID'
});Respondo.identify(identity)
将用户身份附加到当前会话。请在登录后调用。带有邮箱或 userId 时会立即创建联系人,即使用户从未打开聊天。signedUpAt(Date、Unix 秒数或 ISO 8601 字符串)是用户在你的产品中注册的时间;未提供时,联系人的注册日期保持为空。
Respondo.identify({
email: 'user@example.com',
name: 'John Doe',
userId: 'usr_123',
signedUpAt: '2024-05-31T10:00:00Z',
userHash: 'hmac_sha256_signature', // 可选,用于身份校验
metadata: { plan: 'pro' },
properties: { // 自定义联系人属性
account_type: 'enterprise', // 键在 Agent Settings 中定义
region: 'eu-west'
}
});Respondo.track(name, properties?)
为当前访客记录一次客户端事件(例如购买、套餐升级)。事件可以启动由事件触发的 Tours,并计入 tour 目标。通过 keepalive 尽力投递,因此在页面跳转前一刻触发的事件(结账跳转)也能送达。请在 init() 之后调用。
事件还会打开正在等待它们的弹出式调查(When and where):在匹配的页面上立即打开,或在 30 分钟内到达这样的页面时打开(例如重定向之后)。
Respondo.track('purchase_completed', {
plan: 'pro',
amount: 49
});Respondo.startSurvey(surveyId)
立即在任意页面打开一个已上线的弹出式调查,忽略 Show on、页面规则、页面停留时间、触发事件和受众。ID 请在调查编辑器(Additional ways to share)中复制。访客已回答过的调查不会再次显示。可以在小部件加载完成之前调用。
Respondo.startSurvey('<survey-id>');Respondo.open(message?) / Respondo.close()
通过您自己的按钮打开或关闭消息窗口。向 open 传入字符串,即可在打开时预填输入框。请在 Respondo.init() 之后调用;在启动按钮仍在出现过程中发出的调用,会在它出现后立即生效。
Respondo.open();
Respondo.open('I have a question about my invoice');
Respondo.close();Respondo.destroy()
从页面中移除挂件。适用于 SPA 中导航到不应显示挂件的页面时。它不会清除访客的身份或已保存的对话 —— 登出时请使用 Respondo.reset()。
// 从页面中移除挂件
Respondo.destroy();
// 之后如需要可重新初始化(会恢复同一个对话)
Respondo.init({ agentId: 'YOUR_AGENT_ID' });Respondo.reset()
登出 / 共享设备交接。从浏览器中清除匿名访客 id、已保存的对话和会话令牌,在服务器端吊销会话令牌使其副本失效,并重新挂载一个全新的匿名挂件。请在您应用的登出钩子中调用它。
// 登出时 —— 清除身份、对话和会话,重新开始
Respondo.reset();自动数据收集
挂件会在每次对话中自动捕获并存储以下内容:
| 数据 | 来源 |
|---|---|
| 客户端 IP | HTTP 头 |
| 浏览器 / 操作系统 | User-Agent 头 |
| 语言 | Accept-Language 头 |
| 时区 | Intl API(JavaScript) |
| 页面 URL | window.location |
| 来源页(Referrer) | Referer 头 |