WPForms与Zendesk支持的集成

WPForms的Zendesk

与Zendesk支持的WPForms集成：成功提交表单后创建票证，zendesk全局凭据，选择所有或单个表单，API连接验证。

资料描述

Zendesk for WPForms插件将WordPress站点连接到Zendesk支持。 成功提交WPForms表单后，会在Zendesk端创建一个新的票证：从前缀（如果指定），表单名称和条目编号（条目）中收集主题;提交字段列在票证正文中;申请人（请求者）通过电子邮件从表单中确定（需要有效的电子邮件字段或类似于电子邮件的值）。

主要特点

-使用子域名、Zendesk用户的电子邮件和API令牌连接到Zendesk。
-表单模式：所有当前和未来的WPForms表单或仅在列表中标记的表单。
-启用和禁用与单个开关的集成。
-票主题前缀，默认优先级（低，正常，高，紧急），用逗号分隔的附加标签;wpforms和wpforms-form-ID自动添加到标签中。
-设置页面上的"测试连接"按钮（向users/me API请求）。
-PluginHub许可证：密钥在"设置→Zendesk WPForms"页面的"PluginHub许可证"块中输入（数据库中的pluginhub_license_key选项;匹配站点上其他PluginHub插件的密钥）。 如果没有此产品的活动许可证，则不会创建票证，并且激活测试不可用（您可以保存其余设置）。
-本地化：语言目录。po文件（下载翻译需要编译的.mo文件）。

技术细节

-WPForms事件：wpforms_process_complete，优先级50。
-门票创建：POST/api/v2/门票。json。
-检查连接：GET/api/v2/users/me。json。
-对Zendesk的HTTP请求是通过验证SSL证书来执行的。
-开发人员的过滤器：zdwf_ticket_subject，zdwf_ticket_body，zdwf_ticket;zdwf_ticket_created成功创建票证后的操作。

要求

-WordPress6.0或更高版本（根据插件标题）。
-PHP7.4或更高版本。
-安装和活动WPForms。
-有权使用所选电子邮件的API令牌的Zendesk帐户。
-具有PluginID的产品的有效PluginHub许可证（见下文）。

产品ID PluginHub（PluginID）

插件代码中设置了zdwf_pluginhub_plugin_id常量（默认值可以在wp-config中重新定义。php由定义字符串（'ZDWF_PLUGINHUB_PLUGIN_ID'，'your-uuid-from-directory'）;或由WordPress过滤器zdwf_pluginhub_plugin_id）。 站点设置中的许可证密钥必须根据PluginHub规则与本产品和站点域匹配。

安装工程

1. 安装并激活WPForms。
2. 安装Zendesk for WPForms插件并激活它。
3. 确保WordPress和PHP版本符合插件要求。

分步说明

步骤1。 PluginHub许可证

1. 打开"设置→Zendesk WPForms"。
2. 在"PluginHub许可证"块中，输入密钥https://pluginhub.pro 对于这个产品。
3. 单击页面底部的"保存更改"（一个按钮保存许可证和所有Zendesk字段）。

如果没有激活的许可证，则会在同一页面上显示警告;票证创建和zendesk连接验证按钮在激活之前不起作用。 如果另一个PluginHub插件已经在设置→常规中添加了一个关键字段，这是数据库中的相同选项—您可以在任何地方编辑它。

第二步。 Zendesk数据

1. 在Zendesk中，为代理用户创建一个API令牌（请参阅API管理部分，Zendesk文档中的当前路径）。
2. 在"设置→Zendesk WPForms"页面上，在Zendesk连接块中，指定子域（如在yourcompany中address.zendesk.com ，多余的。zendesk.com 你不必输入它）。
3. 指定为其发出令牌的同一用户的登录到Zendesk的电子邮件地址。
4. 插入API令牌（如果已保存令牌，则可以在更改其他设置时将该字段留空）。
5. 单击"测试连接"。 如果成功，将出现成功登录消息。 更改许可证密钥后，如有必要，请刷新页面，以便更新警告。

第三步。 整合和形式

1. 打开Zendesk中的Create tickets开关（为成功提交创建Zendesk tickets）。
2. 如有必要，请指定主题前缀、优先级和其他标记。
3. 选择"所有表单"或"仅选择";在第二种情况下，在列表中选择至少一个表单。
4. 保存更改。

第四步。 WPForms表格

1. 表单应该有一个接收申请人电子邮件的方式：最好是电子邮件类型字段。 如果没有有效的电子邮件地址，则不会创建票证，并且在启用WP_DEBUG时可能会将错误写入PHP错误日志。
2. 如果字段名称包含"名称"（插件逻辑），则申请人的名称将从名称或文本字段中替换。

第五步。 支票

从网站发送测试请求。 一张新票应该出现在Zendesk中。

常见问题

我是否需要在站点和Zendesk之间单独提供服务？

不，请求从WordPress服务器直接转到Zendesk API。

WPForms记录是否已保存？

是的，插件不会复盖标准的WPForms行为;票证是在成功处理提交后额外创建的。

API令牌存储在哪里？

在WordPress数据库中的zdwf_settings选项中。 通过管理面板删除插件时，根据卸载删除设置数据。php的。

如果票证没有创建，我应该检查什么？

-对于正确的PluginID，PluginHub许可证是否处于活动状态。
-是否启用集成以及是否在"仅选择"模式下选择表单。
-子域名、电子邮件和令牌是否填写；连接测试是否通过。
-表格中是否有申请人的有效电子邮件地址。

对于开发人员

-zdwf_pluginhub_plugin_id过滤器-在不编辑文件的情况下更改产品UUID。
-Wp-config中的常量ZDWF_PLUGINHUB_PLUGIN_ID。php-同样的目的。
-Pluginhub_license_check_url过滤器在共享文件pluginhub-license中设置。php如有必要，另一个许可证验证URL。

更改日志（简要）

1.0.2-插件设置页面上的PluginHub关键字段;一键保存与其余设置。

1.0.1-PluginHub许可，阻止门票和API测试没有许可证，警告设置页面，sslverify为Zendesk。

1.0.0是第一个版本。