设置Webhook

記事番号:040600

在Kintone中使用Webhook,可在对Kintone的应用进行特定的操作时,将其内容发送至指定的外部服务。
例如,无需编程即可设置类似于在发生记录添加时将其内容发送至聊天工具的整合。

Webhook的机制

将用于整合多种网络服务的工具指定为Webhook的整合对象,即可将其所支持的服务与Kintone进行整合。
用于整合网络服务的工具有:Zapier、Microsoft Power Automate、IFTTT等。

插图:Webhook的机制

设置Webhook后,当Kintone应用中发生以下操作时可收到通知:

  • レコードの追加
  • 编辑记录
  • レコードの削除
  • 发送通知的范例
  • 更新状态(流程管理的状态被更新时)

关于Kintone中发生操作的通知参数,请参考以下页面:
Kintone发生操作时发送的Webhook的通知内容

Webhook的设置流程

按照以下步骤设置Webhook。

(1) 在整合支援工具(如Zapier)中设置触发器
(2) 在Kintone中设置Webhook
(3) 在整合支援工具中设置动作

设置示例

此处以使用Zapier,设置“当Kintone中发生记录添加时向Gmail发送通知”为例进行说明。

预先准备

在设置Webhook前,请进行以下准备:

  • 创建Gmail账号
  • 创建Kintone的应用

完成准备后,进行以下设置:

(1) 在Zapier中设置触发器

  1. 前往 Zapier 网站,点击“注册”创建新的 Zapier 帐户。
    如果您已有 Zapier 帐户,请点击“登录” Please login.
    Zapier 网站

  2. 点击Zapier的Web网站中的[Create Zap]。

  3. 在触发器选择页面中的搜索框中输入“Webhook”,点击[Webhooks by Zapier]。截图:选择Webhook触发器

  4. 在[Event]中选择[Catch Hook],点击[Continue]。截图:选择[Catch Hook]

  5. 以下页面中,也直接点击[Continue]。截图:显示选择Event后的页面

  6. 生成Webhook URL后,点击[Copy]。
    请将URL粘贴至文本编辑器中。截图:用线框圈出[Copy]

接下来在Kintone中设置Webhook。请暂时不要关闭Zapier的Web页面。

(2) 在Kintone中设置Webhook

  1. 在[记录列表]页面中,点击页面右上方的齿轮状 [设置应用]图标。
    截图:用线框圈出[设置应用]图标

  2. [应用的设置]页面中,点击[设置]标签中[自定义/服务整合]下的[Webhook]

  3. 在[Webhook]页面点击[添加]。

  4. 在[添加Webhook]页面中,输入要设置的Webhook的说明。
    输入的说明将显示在Webhook设置的列表页面。最多可输入64个字符。

  5. 将步骤6中复制的URL粘贴至[Webhook URL]中。
    在Zapier中设置触发器
    所粘贴的URL无需开头的“https://”,请删除。
    URL栏中最多可输入1,024个字符。截图:显示[添加Webhook]的页面

  6. 在[发送通知的条件]中指定要发送Webhook通知的操作。
    本例中勾选[添加记录]。截图:显示[发送通知的条件]

  7. 勾选[启用此Webhook]。
    初始设置为勾选状态。

  8. 点击页面右下方的[保存]

  9. [Webhook]页面中,点击页面上方弹出信息中的[应用的设置]或页面左下方的[返回应用的设置]

  10. 在[应用的设置]页面中点击[更新应用]。

  11. [更新应用]对话框中点击[更新应用]

  12. 为了对Zapier中设置的触发器进行测试,在Kintone的应用中添加新的记录。

  13. 返回Zapier的Web网站,点击[Test trigger]。
    截图:页面中显示[Test trigger]

  14. 确认测试成功后,点击[Continue with selected record]。
    如未成功,请多次点击[Test trigger]进行尝试。
    如依然失败,请确认[Webhook URL]中复制粘贴的URL是否有误。

(3) 在Zapier中进行动作设置

  1. 显示Zapier的动作设置后,选择[Gmail]。
    截图:用线框圈出[Gmail]

  2. 动作事件页面中,在[Event]中选择[Send Email],点击[Continue]。
    截图:在[Event]选择[Send Email]

  3. 选择Gmail账号,点击[Continue]。
    未登录Gmail时,将显示确认允许登录Gmail的页面。截图:选择Gmail的账号

  4. 设置发送至Gmail的通知内容。
    [To]中输入要接收通知的Gmail地址,在[Subject]、[Body]等处设置必要的内容后,点击[Continue]。
    截图:设置发送至Gmail的通知内容

  5. 确认设置内容,点击[Test & continue]。

  6. 点击[Publish Zap]。

  7. 确认收件人的Gmail中已收到邮件,点击[Publish & Turn On]。

已启用所设置的Zap。

更改Kintone的Webhook的设置

可之后更改Kintone的Webhook的设置内容。步骤如下:

  1. 在[记录列表]页面中,点击页面右上方的齿轮状 [设置应用]图标。
    截图:用线框圈出[设置应用]图标

  2. [应用的设置]页面中,点击[设置]标签中[自定义/服务整合]下的[Webhook]

  3. 在[Webhook]页面中,点击想要更改设置的Webhook最右列的[编辑]图标。
    截图:用线框圈出[编辑]

  4. 在[编辑Webhook]页面中,编辑设置内容,点击[保存]。

  5. [Webhook]页面中,点击页面上方弹出信息中的[应用的设置]或页面左下方的[返回应用的设置]

  6. 在[应用的设置]页面中点击[更新应用]。

  7. [更新应用]对话框中点击[更新应用]