設定Webhook

連結已複製

記事番号:040600

在kintone中使用Webhook，當在kintone的應用程式中執行特定操作時，會將內容傳送給指定的外部服務。
例如，不必撰寫程式即可設定當新增記錄時，自動將內容發表在聊天室服務的整合功能。

Webhook的架構

連結已複製

將支援與許多服務整合的工具指定為Webhook的整合對象，即可將此類工具支援的各種服務與kintone整合。
支援整合的工具有Zapier、Microsoft Power Automate、IFTTT等。

示意圖：Webhook的架構

設定Webhook後，當有人在kintone的應用程式中執行以下操作時將會傳送通知。

レコードの追加
編輯記錄
レコードの削除
填寫回覆
更新狀態（流程管理的狀態更新時）

關於在kintone中操作時的通知參數，請參閱以下頁面。
操作kintone時傳送的Webhook通知內容

設定流程

連結已複製

設定Webhook的步驟如下。

(1) 在整合支援工具（Zapier等）中設定觸發程序
(2) 在kintone中設定Webhook
(3) 透過整合支援工具設定動作

設定範例

連結已複製

以下使用Zapier說明「在kintone中新增記錄時向Gmail傳送通知」的設定範例。

事前準備

連結已複製

設定Webhook前，請準備以下項目。

建立Gmail帳號
建立kintone的應用程式

準備完成後，進行以下設定。

(1) 在Zapier中設定觸發程序

連結已複製

存取Zapier網站，點選［Sign up］建立新的Zapier帳號。
若已經有Zapier帳號，點選［Log in］登入您的帳號。
Zapier
點選Zapier網站上的［Create Zap］。

提示

在Zapier中，各項整合設定稱為Zap。選擇整合來源與整合對象的服務並建立Zap。
在觸發程序選擇畫面的搜尋欄中輸入「Webhook」，點選［Webhooks by Zapier］。
在［Event］中選擇［Catch Hook］，點選［Continue］。
在接下來顯示的畫面中同樣點選［Continue］。
此時會產生Webhook URL，點選［Copy］。
請先將URL貼在文字編輯等程式中。

接下來，在kintone中設定Webhook。請保持開啟Zapier的網頁。

(2) 在kintone中設定Webhook

連結已複製

在［記錄清單］畫面中，點選畫面右上方齒輪形狀的［設定應用程式］圖示。
在［應用程式的設定］畫面中，點選［設定］分頁的［自訂／服務整合］中的［Webhook］。
在［Webhook］畫面中，點選［新增］。
在［新增Webhook］畫面中，輸入要設定的Webhook說明。
輸入的說明將顯示在Webhook的設定清單畫面。最多可輸入64個字元。
在［Webhook URL］中，貼上「在Zapier中設定觸發程序」的步驟6中複製的URL。
在Zapier中設定觸發程序
貼上的URL不需要開頭的「https://」，請刪除。
URL欄最多可輸入1,024個字元。
在［傳送通知的條件］中，指定要傳送Webhook通知的操作。
此處勾選［新增記錄］。
勾選［啟用此Webhook］。
在初始設定中已勾選。
點選畫面右下方的［儲存］。
在［Webhook］畫面中，點選畫面上方顯示的訊息中的［應用程式的設定］，或點選畫面左下方的［返回應用程式的設定］。
在［應用程式的設定］畫面中，點選［更新應用程式］。
在［更新應用程式］對話方塊中，點選［更新應用程式］。
在kintone的應用程式中新增記錄，測試在Zapier中設定的觸發程序。
回到Zapier網站中，點選［Test trigger］。
確認測試成功後，點選［Continue with selected record］。
測試未成功時，請多試幾次［Test trigger］。
若仍測試失敗，請確認［Webhook URL］中複製貼上的URL是否有誤。