将联系表格7与Zendesk支持集成

Zendesk联络表格7

联系表单7与Zendesk支持的集成：在提交表单时自动创建票证，分别为每个表单设置字段，检查与API的连接。

资料描述

Zendesk For Contact Form7将您的WordPress站点与Zendesk支持连接起来：在成功向Zendesk提交Contact Form7表单后，将根据您的规则创建一个包含主题，文本，电子邮件和申请人姓名（请求者），优先

主要特点

-Zendesk全局设置：子域，zendesk登录电子邮件，API令牌，所有票证的默认标签。
-分别配置每个CF7表单：开/关、将表单字段与票证字段匹配、优先级、附加标签、将提交页面的URL添加到票证正文的选项。
-消息正文可以从一个字段中获取，也可以在一个文本中发送表单的所有字段（__all__模式）。
-设置页面上的"检查连接"按钮（对Zendesk API的简单请求）。
-PluginHub许可：Pluginhub端的设置→常规，域和产品验证中的共享密钥。
-可翻译界面（zendesk-cf7文本域，语言目录）。

技术细节

-使用ZENDESK RESTAPI v2（创建POST/api/v2/票证）。json票）。
-WordPress事件：wpcf7_before_send_mail（优先级20）。 CF7字母和表单的标准行为不会被取消;如果发生Zendesk错误，可能不会创建票证，但将表单发送给访问者通常是成功的—如果需要，请检查设置和日志。
-如果您的CF7版本支持，可以将支持CF7的票证ID或错误文本添加到发送结果的属性（add_result_props）中。

要求

-WordPress5.8或更高版本。
-PHP7.4或更高版本。
-主动联系表格7插件。
-Zendesk支持帐户，能够为发出请求的用户创建API令牌。
-本产品的当前PluginHub许可证（所有PluginHub插件每个站点设置一次密钥）。

安装及说明

安装插件

1. 将插件文件夹上传到wp-content/plugins/（或通过"插件→添加新"安装ZIP）。
2. 在WordPress管理面板中激活Zendesk For Contact Form7插件。
3. 确保安装并激活了联系表格7。

步骤1。 PluginHub许可证

1. 在管理面板中，打开"设置→常规"。
2. 找到Pluginhub许可证密钥字段（或类似的，如果由另一个PluginHub插件添加）。
3. 插入为本产品颁发的许可证密钥https://pluginhub.pro ，并保存设置。
4. 用于验证的站点的域取自站点地址（主页URL）;当您更改密钥或域时，验证将在API缓存中自动更新。

没有活动许可证：控制台中显示警告，zendesk中的票证创建被禁用，Zendesk连接验证按钮返回错误。 可以保存表单设置和全局字段。

第二步。 Zendesk数据

1. 在Zendesk中："管理→应用程序和集成→API→Zendesk API"-为代理用户创建API令牌。
2. 使用与此用户登录Zendesk相同的电子邮件地址（通常是代理的电子邮件）。
3. 在WordPress中，打开"联系人→Zendesk"（联系表格7子菜单）。
4. 填写:
   -Subdomain-仅子域名（例如，mycompany for https://mycompany ...zendesk.com ），没有https：//和没有。zendesk.com （插件将修剪掉多余的）。
   -Zendesk登录电子邮件—为其创建令牌的用户的电子邮件。
   -API令牌-插入令牌;它存储在站点的数据库中。 建议使用单独的令牌进行集成和定期轮换。
   -默认标记由逗号分隔，例如wordpress，contact_form_7。 它们被添加到每张票中。
5. 单击"保存更改"。
6. 单击"验证连接—-如果成功，将显示有关成功连接的消息。

第三步。 设置CF7表单

1. 打开"联系人→联系人表单"并编辑所需的表单。
2. 在"Zendesk票"metabox:
-启用"在zendesk中创建此表单的票证"。
   -主题字段是机票主题的CF7字段的名称（通常是您的主题或您自己的主题）。
   -Message/body-一个字段的名称，其中包含字母的文本或值__all__，以便表单中包含列表"key：value"的所有字段。
   -申请人的电子邮件字段通常是您的-电子邮件（必须是有效的电子邮件）。
   -申请人的姓名字段通常是您的姓名。
   -优先级为低/正常/高/紧急。
   -附加标签由逗号分隔;它们被添加到全局标签。
   -如有需要，启用"将提交页面的URL添加到票体"。
3. 保存表单。

第四步。 查看网站

从前端发送测试请求。 具有指定字段和标签的新票证应出现在Zendesk中。

对于开发人员

-过滤访问设置和metabox的能力：zendesk_cf7_capability（默认情况下，manage_options或常量WPCF7_ADMIN_READ_WRITE_CAPABILITY，如果设置）。
-PluginHub中的产品ID：wp-config中的常量ZENDESK_CF7_PLUGINHUB_PLUGIN_ID。php或zendesk_cf7_pluginhub_plugin_id过滤器。
-许可证验证URL（如果您需要代理/展台）：共享模块中的pluginhub_license_check_url过滤器pluginhub-license。php的。

常见问题

我需要一个单独的Zendesk插件吗？

非也。. 插件本身从您的WordPress服务器执行对Zendesk API的HTTPS请求。

联系表格7的电子邮件是否仍在发送?

是的. 集成不会取消标准CF7邮件发送（如果在表单中配置）。 票证是另外创建的.

票没有被创建，我应该检查什么？

-PluginHub许可证对本产品是否有效。
-子域名，电子邮件和令牌是否填写;"验证连接"是否工作。
-是否为特定表单启用复选标记，以及metabox中的字段名称是否与CF7表单标记中的字段名称匹配。
-是否指定了有效申请人的电子邮件字段（没有它就不会创建票证）。

API令牌存储在哪里？

在WordPress选项表中的zendesk_cf7_settings选项中。 卸载插件时，该选项将被删除（请参阅卸载。php）。

删除插件时是否删除了表单设置？

是：通过管理面板删除插件时，执行以下操作卸载。php-全局选项和_zendesk_cf7元从所有CF7联系人表单中删除。

屏幕截图

1. "联系人→Zendesk"页面：凭据，默认标记，连接验证。
2. CF7表单编辑器中的"Zendesk ticket"metabox。

更改日志

1.0.3
-使用非活动PluginHub许可证创建票证和API测试的限制;管理区域和表单的metabox中的警告。
-对zendesk(sslverify)的请求进行显式SSL验证。

1.0.2
-PluginHub许可连接，一般pluginhub-许可证。php，Zendesk_CF7_License类。

1.0.1
-修复：使用add_result_props而不是cf7中不存在的add_meta方法将结果发送到提交。

1.0.0
-首次公开发布：全局设置，表单上的metabox，通过API v2创建票证。

更新建议

1.0.3-推荐更新：使用PluginHub许可证正确操作，并安全地向Zendesk发送HTTPS请求。