ナビゲーションにスキップ

ClickUp

Webhookツールを使って、発信者からの依頼をClickUpタスクに変換します。

発信者から折り返し電話や見積もりなど、対応が必要な依頼を受けたとき、受付担当がチーム用のClickUpタスクを作成できます。Webhookツールを使うと、指定したリストにタスクが追加されます。

始める前に

1

個人用APIトークンを作成する

ClickUpでアバターを選択し、Settings → Apps を開きます。次に、API Token で Generate を選択します。トークンは pk_ で始まります。このトークンはユーザー本人として機能し、有効期限もないため、機密情報として扱ってください。対象リストのみにアクセスできるアカウントで生成することをおすすめします。

2

リストIDを確認する

ブラウザでリストを開きます。URL内の /li/ の後にある数字がリストIDです。

Webhookツールを作成する

Integrations に移動して Add integration を選択し、Webhook Tool を選びます。

フィールド値
Namecreate_clickup_task
Description「発信者へのフォローアップを約束した場合、またはチームでの対応が必要な依頼を発信者から受けた場合に、チーム用のタスクを作成する。」
MethodPOST
URLhttps://api.clickup.com/api/v2/list/LIST_ID/task
Request HeadersAuthorization:トークン。先頭に Bearer は付けない
Body Parametersname(文字列、必須):「発信者の名前と依頼内容を含む短いタイトル。例:見積もりについてJane Doeに折り返し電話する。」
description(文字列、必須):「発信者の名前、電話番号、依頼の詳細。」
priority(数値):「緊急は1、高は2、通常は3、低は4。1は緊急時にのみ使用する。」
Assign to agentsReceptionist

Enable を選択し、折り返し電話を依頼して受付担当をテストします。リストにタスクが表示されます。

このツールでは、期限と担当者は設定されません。ClickUpでは期限をミリ秒単位のUnixタイムスタンプで受け取りますが、受付担当が通話中に正確に算出するのは困難です。また、担当者はユーザーIDのリストとして指定する必要がありますが、Webhookツールでは送信できません。リストのClickUp自動化を使って新しいタスクに担当者と期限を設定するか、Zapier経由でタスクを処理してください。

トラブルシューティング

問題確認事項
ClickUpが401を返すヘッダーは Authorization とし、Bearer を付けずに pk_ トークンのみを指定します。
ClickUpが404またはリストエラーを返すURLのリストIDと、トークンのユーザーがリストを表示できることを確認します。
タスクに優先度が設定されていない優先度には1~4の数値を指定します。発信者の依頼が緊急でない場合は省略してください。
受付担当がタスクを作成しないツールの説明に、タスクを作成すべき状況を明記します。