您可以对聊天对话框应用许多 HTML 自定义设置。
HTML 聊天元素选项
df-messenger
元素的子元素可以是以下任何一种:
df-messenger-chat
:代理对话框始终处于打开状态df-messenger-chat-bubble
:可以使用打开或关闭气泡按钮打开或关闭代理对话框
针对 df-messenger
的 HTML 自定义
df-messenger
HTML 元素具有以下特性 (Attribute):
特性 | 输入政策 | 值 |
---|---|---|
agent-id |
需要 | 与 Dialogflow 代理关联的代理 ID。 |
allow-feedback |
可选 | 设置为 all 以允许最终用户就代理的回答提供反馈。 |
language-code |
需要 | 默认语言代码。 |
project-id |
需要 | 代理的项目 ID。 |
location |
可选 | 代理的区域。默认值为 global 。 |
intent |
可选 | 将在聊天对话框打开时调用的自定义事件。您可以使用将针对此事件调用并生成第一条客服人员消息的事件处理脚本。 |
oauth-client-id |
可选 | OAuth 身份验证是必需的。默认值为 null。如果未提供此属性的值,并且启用了 Dialogflow Messenger 的未经身份验证的访问权限,则未经身份验证的用户可以与该代理互动。如果提供了值,代理对话框将叠加“请求身份验证”(文本可以控制,请参阅 request-auth-text 通知,该通知要求用户登录才能使用代理。) |
storage-option |
可选 | 指定对话消息的本地存储空间。如果不应存储消息,请使用 none 。如果使用 none ,系统将在页面刷新或重新加载时清除所有消息。默认值为 sessionStorage。 |
session-ttl |
可选 | 设为持续会话的时长(以秒为单位),必须严格低于 86400 (1d) 且默认值为 1800(30 分钟)。 |
url-allowlist |
可选 | 允许从以逗号分隔的网址前缀列表加载图片。HTML 或 Markdown 响应中使用的图片网址必须以列出的前缀之一开头。使用 * 可允许所有网址。 |
max-query-length |
可选 | 定义文本查询的最大长度。如果值为负数,则长度不受限制。默认值为 256。其他文档。 |
针对 df-messenger-chat
的 HTML 自定义
df-messenger-chat
HTML 元素具有以下特性 (Attribute):
特性 | 输入政策 | 值 |
---|---|---|
chat-title |
可选 | 聊天框的标题,显示在其上方。 |
chat-subtitle |
可选 | 聊天框的副标题,显示在其上方,位于 chat-title 下方 |
chat-title-icon |
可选 | 聊天框标题中显示的图标,默认位于 chat-title 左侧 |
bot-writing-text |
可选 | 代理书写时显示的文字 |
bot-writing-image |
可选 | 代理编写代码时显示的图片。优先级高于 bot-writing-text 。 |
request-auth-text |
可选 | 用于身份验证的按钮文字。 |
placeholder-text |
可选 | 在输入字段中显示的文本(当该值为空时)。默认设置为“提问...”。 |
bot-actor-image |
可选 | 用于代理演员图片的图片来源。将显示在每组代理响应上。 |
user-actor-image |
可选 | 要用于用户演员图片的图片来源。会在每条用户消息中显示。 |
针对 df-messenger-chat-bubble
的 HTML 自定义
df-messenger-chat-bubble
HTML 元素具有与 df-messenger-chat
相同的属性以及下列附加属性:
属性 | 输入政策 | 值 |
---|---|---|
expanded |
可选 | 布尔值,用于确定聊天是否最初处于打开状态。如果未设置此政策,聊天对话中会记住最后一次的状态。 |
chat-icon |
可选 | 聊天气泡的图标。必须是可公开访问的 URI。 |
chat-close-icon |
可选 | 聊天气泡的关闭图标。必须是可公开访问的 URI。 |
chat-collapse-icon |
可选 | 标题栏中“收起”按钮的图标。必须是可公开访问的 URI。 |
anchor |
可选 | 定义聊天对话框相对于打开或关闭气泡的位置。值为以 - 分隔的两个方向单词(top 、bottom 、left 、right )。默认值为 top-left 。第一个方向定义锚点,第二个方向定义远离气泡的主展开方向。例如:top-left 位于气泡顶部,并向左上方展开(远离气泡)。 |
chat-width |
可选 | 定义聊天窗口的宽度。数值(以像素为单位)。默认值为 320 像素。 |
chat-height |
可选 | 定义聊天窗口的高度。数值(以像素为单位)。默认值为 480 像素。 |
allow-fullscreen |
可选 | 定义聊天窗口是否可以全屏打开。如果设置为 always ,则所有屏幕尺寸都将以全屏模式打开。如果设置为 small ,则在屏幕尺寸低于 500px 时打开全屏模式,否则作为正常窗口打开。可能会替换 chat-width 、chat-height 和 anchor (如果已设置)。 |
minimized |
可选 | 确定聊天最初是否以最小化形式打开。使用与 anchor 相同的逻辑。将在加载时执行初始 intent (如果已指定)。 |