アクションフローでのmonday.comアクションの使い方

Suite、すべてのバージョン

Team、Growth、Professional、EnterpriseまたはEnterprise Plus

Support

Team、ProfessionalまたはEnterprise

要約：◀▼

APIトークンを使用してアクションフローをmonday.comに接続することで、項目の作成、更新、削除、コメントの追加、アイテムのステータスやオーナーの管理といったタスクを自動化できます。このインテグレーションにより、プラットフォーム間でデータを同期し、手動での更新作業を必要とせずにチーム間のコラボレーションやタスク管理を向上させ、ワークフローを効率化できます。

アクションビルダーをmonday.comなどの外部システムに接続すると、管理者は自動化ワークフロー内でZendeskと外部システムを連携させることができます。これにより、コラボレーションを強化し、複数のプラットフォームにまたがる一貫した利用体験を維持できます。

メモ：アクションフロー内の外部システムに関わるステップは、総称して「外部アクション」と呼ばれます。

この記事では、以下のトピックについて説明します。

アクションビルダーをmonday.comに接続する
アクションフローでmonday.comアクションを使用する

アクションビルダーをmonday.comに接続する

外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。

外部システムに接続してアクションフローで外部アクションを使用する場合は、以下のベストプラクティスをお勧めします。

アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
すべてのインテグレーションでは、必要なスコープへのアクセスが要求されます。ただし、外部システムへの接続を承認する前に、スコープを確認し、妥当性を検証することが重要です。
OpenAIなどのAPIキーベースのツールの認証情報を管理する場合は、キーを安全な保管庫または認証情報マネージャーに保存することをお勧めします。

APIトークンを生成するには

monday.comコネクションには、認証用のAPIトークンが必要です。APIトークンは安全に保管し、他人と共有しないでください。パスワードと同様に扱ってください。

monday.comで自分のプロフィール画像に移動します。
「開発者」をクリックします。
「APIトークン」に移動します。
新しいトークンを生成します。
トークンを保存するか、ウィンドウを開いたままにして、Zendeskにコピー＆ペーストできるようにしておきます。
このトークンは、アクションビルダーをmonday.comに接続する際に必要になります。

また、https://[自分のアカウント].monday.com/apps/manage/tokens にアクセスして、トークンを管理することもできます。詳細については、monday.comの認証に関するドキュメントをご覧ください。

アクションビルダーをmonday.comに接続するには

管理センターで、サイドバーにある「 アプリおよびインテグレーション」をクリックし、「アクション」>「アクションフロー」を選択します。
アクションフローを新規作成するか、既存のアクションフローを編集します。
ステップサイドバーを開きます。
「外部アクション」セクションで、「monday.com」をクリックします。
「接続」をクリックします。
monday.comの指示に従って、monday.comのAPIトークンを入力し、接続を完了します。
メモ：アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。

接続が完了すると、接続していることを示すインジケーター、接続したインスタンスの詳細情報、およびmonday.comで利用可能なアクションが表示されます。

アクションフローでmonday.comアクションを使用する

以下のmonday.comアクションを使用できます。

項目を作成
項目を参照
項目を更新
項目のステータスを更新
項目のオーナーを更新
サブアイテムを作成
コメントを追加
項目をグループに移動
項目を削除
すべての項目をリスト
ボードを参照
ユーザーを参照

項目を作成する

「項目を作成」アクションを使用して、monday.comのボードに、カスタム列値を含む項目を新規作成します。

このアクションには以下の入力と出力が含まれます。

変数

入力

	変数
入力	必須：`Board`、`Item name` オプション：`Group`、ボード固有の列ボードを選択すると、そのボードのカスタム列の追加の入力フィールドが表示される。テキスト、ステータス、日付、担当者、およびmonday.comでサポートされているその他の列タイプに、値を設定できる。列の値は、各列のID、テキスト、値、およびタイプを含む配列として返される。
出力	項目の詳細：item_id、board_id、group_id、item_name、item_url、board_name、group_title、created_at、creator_id、state、およびcolumn_values配列など。

必須：Board、

Item
                                            name

オプション：Group、ボード固有の列

ボードを選択すると、そのボードのカスタム列の追加の入力フィールドが表示される。テキスト、ステータス、日付、担当者、およびmonday.comでサポートされているその他の列タイプに、値を設定できる。列の値は、各列のID、テキスト、値、およびタイプを含む配列として返される。

出力項目の詳細：item_id、board_id、group_id、item_name、item_url、board_name、group_title、created_at、creator_id、state、およびcolumn_values配列など。

項目を参照する

「項目を参照」アクションを使用して、IDで特定の項目の詳細を取得します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：`Item ID`
出力	項目の詳細情報：item_id、item_name、item_url、state、board （IDと名前を含む）、group（IDとタイトルを含む）、column_values array、creator（IDと名前を含む）、created_at, and updated_at など。

項目を更新する

「項目を更新」アクションを使用して、既存の項目の列の値を変更します。

このアクションには以下の入力と出力が含まれます。

変数

入力

	変数
入力	必須：`Board`、`Item ID` オプション：ボード固有の列ボードを選択すると、そのボードのカスタム列の追加の入力フィールドが表示される。更新する列の値のみ入力する。指定しなかった列の既存の値は変更されない。
出力	項目の詳細：item_id、item_name、item_url、board_id、board_name、group_id、group_title、state、updated_at、およびcolumn_values配列など。

必須：Board、

Item
                                            ID

オプション：ボード固有の列

ボードを選択すると、そのボードのカスタム列の追加の入力フィールドが表示される。更新する列の値のみ入力する。指定しなかった列の既存の値は変更されない。

出力項目の詳細：item_id、item_name、item_url、board_id、board_name、group_id、group_title、state、updated_at、およびcolumn_values配列など。

項目のステータスを更新する

「項目のステータスを更新」アクションを使用して、ステータス列のステータスラベルを変更します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：`Item ID`、`Board`、`Status column`、`Status label`
出力	項目の詳細：item_id、item_name、item_url、board_id、board_name、group_id、group_title, state、status_column_id、およびupdated_status_valueなど。

項目のオーナーを更新する

「項目のオーナーを更新」アクションを使用して、項目の「メンバー」列にユーザーを割り当てます。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：`Item ID`、`Board`、`People column`、`User` 「People column」フィールドには、選択したボードのPeopleタイプの列に基づいて選択肢が動的に表示される。「User」フィールドは、ワークスペースのユーザーを検索して選択することができる。
出力	項目の詳細：item_id、item_name、item_url、board_id、board_name、group_id、group_title、state、people_column_id、people_column_value、assignee_user_idなど。

サブアイテムを作成する

「サブアイテムを作成」アクションを使用して、既存の親項目の下にサブアイテムを作成します。サブアイテムは、親項目のサブアイテムボード内に作成され、親項目のボードコンテキストを継承します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：`Parent item ID`、`Item name`
出力	サブアイテムの詳細：subitem_id、subitem_name, subitem_url、parent_item_id、parent_item_name、board_id、board_name, group_id, group_title、state、created_at、およびcolumn_values配列など。 subitem_urlには、monday.comでサブアイテムを表示するための直接リンクが記載されている。

コメントを追加する

「コメントを追加」アクションを使用して、項目にコメントまたは更新情報を投稿します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：`Item ID`、`Comment`
出力	コメントの詳細：update_id、item_id、comment_text、created_at、およびcreator object（IDと名前を含む）。

項目をグループに移動する

「項目をグループに移動」アクションを使用して、同じボード内の別のグループに項目を移動します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：`Item ID`、`Board`、`Group` 「Group」フィールドには、選択したボードで利用可能なグループに基づいて動的にデータが入力される。項目を移動できるのは、同じボード上のグループ間のみ。
出力	項目の詳細：item_id, item_name、item_url、board_id、board_name、destination_group_id、destination_group_title、およびstateなど。

項目を削除する

「項目を削除」アクションを使用して、monday.comから項目を完全に削除します。

重要：この操作を行うと、項目が完全に削除され、元に戻すことはできません。慎重に使用してください。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：`Item ID`
出力	削除された項目IDと削除確認ステータス。

すべての項目をリストする

「すべての項目をリスト」アクションを使用して、ボード内の項目、またはすべてのボードにまたがる項目を取得します。

このアクションには以下の入力と出力が含まれます。

変数

入力

	変数
入力	オプション：`Board`、`Limit` ボードが指定されていない場合、このアクションはワークスペース内のアクセス可能なすべてのボードを対象に検索を行う。「Limit」フィールドは、返される項目の最大数を指定する（デフォルト：25）。
出力	項目の配列：項目オブジェクト（各オブジェクトにitem_id、item_name、item_url、state、board_id、board_name、group_id、group_title、およびcolumn_values配列が含まれる）およびhas_moreブール値フラグなど。 has_moreフラグは、指定された上限を超えて追加の項目が存在するかどうかを示す。

オプション：Board、Limit

ボードが指定されていない場合、このアクションはワークスペース内のアクセス可能なすべてのボードを対象に検索を行う。「Limit」フィールドは、返される項目の最大数を指定する（デフォルト：25）。

出力

項目の配列：項目オブジェクト（各オブジェクトにitem_id、item_name、item_url、state、board_id、board_name、group_id、group_title、およびcolumn_values配列が含まれる）およびhas_moreブール値フラグなど。

has_moreフラグは、指定された上限を超えて追加の項目が存在するかどうかを示す。

ボードを参照する

「ボードを参照」アクションを使用して、特定のボードの詳細情報を取得します。このアクションを使用して、それぞれのデータ型を含む利用可能なすべてのグループや列など、ボードの構造を確認できます。この情報は、動的なワークフローを構築する際に役立ちます。

このアクションには以下の入力と出力が含まれます。

	変数
入力	オプション：`Board ID`
出力	ボードの詳細情報：board_id、board_name、description、state、board_kind、ワークスペースオブジェクト（IDと名前を含む）、groups配列（それぞれにIDとタイトルを含む）、およびcolumns配列（それぞれにID、タイトル、タイプを含む）など。

ユーザーを参照する

「ユーザーを参照」アクションを使用して、ユーザーIDまたはメールアドレスでユーザー情報を取得します。

このアクションには以下の入力と出力が含まれます。

変数

入力

	変数
入力	オプション：`User ID`、`Email` 参照するユーザーの「User ID」または「Email」のいずれかを入力する。両方を指定した場合、「User ID」が優先される。
出力	ユーザーの詳細情報：user_id、name、email、title、photo_url、およびaccount object（IDと名前を含む）など。 photo_urlには、monday.com内のユーザーのプロフィール画像への直接リンクが含まれます。

オプション：User ID、Email

参照するユーザーの「User ID」または「Email」のいずれかを入力する。両方を指定した場合、「User ID」が優先される。

出力

ユーザーの詳細情報：user_id、name、email、title、photo_url、およびaccount object（IDと名前を含む）など。

photo_urlには、monday.com内のユーザーのプロフィール画像への直接リンクが含まれます。