要开始使用自定义配置文件应用程序,请单击设置在最左边的菜单栏中,然后进入集成,最后定制的概要文件

一旦安装完毕,您就可以开始配置您的自定义配置文件了设置

自定义配置文件应用程序需要四件事才能正常运行:

  1. 服务器上的一个HTTP/HTTPS端点URL, Groove服务器可以调用它。亚博和万博
  2. 端点必须返回有效的JSON。
  3. 您的JSON键不能包含任何空格。
  4. 在每个票据旁边显示的HTML模板。

在安装之后,你需要告诉我们,你想要我们显示什么,你想要它看起来:

标题

允许您自定义文字上面您的自定义配置文件。

HTML模板

这就是事情开始变得有趣的地方。在我们从Webhook中获取自定义属性之后,你可以使用一个液态模板将它们直接呈现在模板页面上。要插入一个属性到你的html简单包装双花括号,像这样:

“名字:{{preferred_name}}”

请注意有几个保留字段Groove将总是覆盖:亚博和万博

  • :名称(您的自定义配置文件)
  • :状态(用户处于groove状态)亚博和万博
  • :电子邮件(用户)
  • : first_name(用户)
  • : last_name(用户)
  • : full_name(用户)

请使用不同的字段名称在你的webhook有效负载,以避免碰撞。

不过,插入变量仅仅是个开始。我们强烈推荐查看液体文件。尤其是使用if语句并不是所有客户都可以使用的自定义属性格式化文本的过滤器。看看我们在Groove帐户中使用的模板的一部分,看看有什么可能:亚博和万博

Webhook URL

我们将在客户发来的每条新消息之后使用此URL从服务器获取您的自定义属性。我们将使用带有电子邮件和api_token参数的GET请求。您应该检查给定的api_token是否与您的帐户中的api_token匹配,并为给定的电子邮件地址返回非嵌套的JSON。

测试

在保存之前,你应该提供一个真正的客户的电子邮件地址,并测试你的Webhook和自定义配置文件工作的预期。我们将从您的服务器获取详细信息并呈现一个示例。

最终结果

一旦一切看起来像你想要的方式并且被保存,所有的新门票将包括你的自定义配置文件在屏幕的右边。

JSON的例子

JSON应该作为单级散列返回。这是正确的:

嵌套键不起作用。这个例子是不正确的:

自定义配置文件数据获取

默认情况下,每次从电子邮件地址收到传入消息时,都会提取自定义配置文件数据。如果您需要刷新未收到新消息的旧会话并获取新数据,您可以通过单击自定义配置文件顶部的按钮手动刷新数据。