专为 集成指南
企业级就绪
Nowdesk 自然融入 Drupal 的权限与角色模型。可全站部署,也可将组件限制在特定内容类型或用户角色上。
多语言网站支持
与 Drupal 内置多语言技术栈无缝协作。可自动检测访客语言,也可通过 URL 参数为每个翻译版本固定指定语言。
非营业时间 AI 机器人
当员工不在线时,Nowdesk AI 机器人处理常见问题、收集咨询信息,并将复杂问题路由至相关团队在下一个工作日跟进。
已认证用户数据预填
将 Drupal 当前用户的姓名和邮箱传入聊天组件,让客服即时看到身份信息——注册用户无需重复提交个人资料。
兼容 CSP 与安全策略
可将 Nowdesk 脚本域名添加到内容安全策略(CSP)头部,在启用实时聊天的同时保持 Drupal 严格的安全态势。
无需修改核心
集成完全位于主题的 page.html.twig 或自定义区块中——不触及 Drupal 核心或贡献模块。
如何将 Nowdesk 集成到 Drupal
创建 Nowdesk 账户
注册并完成入门向导。前往设置 → 杂项 → 安装 URL,复制您的安装 URL。
打开 Drupal 主题
在 Drupal 后台,前往外观,打开当前主题,在模板文件夹中找到 page.html.twig。
粘贴嵌入脚本
在 body 闭合标签前添加以下代码,将 [YOUR-SITE-URL] 替换为您的安装 URL。
<!-- Nowdesk 在线客服 --> <script src="[YOUR-SITE-URL]/js/min/jquery.min.js"></script> <script id="sbinit" src="[YOUR-SITE-URL]/js/main.js"></script>
清除缓存并验证
通过配置 → 性能 → 清除所有缓存清除缓存,在无痕模式下打开网站查看聊天气泡。
自定义聊天组件
返回 Nowdesk → 设置,调整颜色、欢迎语、营业时间及 AI 回复。
常见问题解答
Nowdesk 兼容 Drupal 8、9、10 和 11。嵌入方式使用所有现代 Drupal 版本均支持的标准 HTML 和 Twig 语法。用户对象的 Twig 变量名在 Drupal 9 和 10 中保持一致。
若使用贡献主题,对 page.html.twig 的编辑可能在主题更新时被覆盖。为避免此问题,建议创建子主题(Drupal 推荐方式),将自定义的 page.html.twig 放置其中。或者使用自定义区块方式,完全无需编辑主题文件。
可以。使用自定义区块方式时,在 区块布局 → 配置 → 可见性 → 角色 下设置仅对特定角色显示。在 page.html.twig 中,可使用 Twig 条件语句检查 user.roles。
是的。因为脚本放置在 </body> 之前,位于任何 Drupal 渲染数组之外,不受 BigPipe 占位符渲染的影响。组件在主要页面内容之后加载,这正是预期行为。
是的。多站点网络中的每个 Drupal 站点可独立包含嵌入脚本。通过为每个站点指向不同的安装 URL,或配置独立的组件设置,可为不同站点使用不同的 Nowdesk 收件箱。