要約:◀▼
アクションフローをAsanaと連携させることで、ワークフロー内で直接プロジェクトやタスクを作成、更新、管理することができます。このインテグレーションにより、サポート環境を離れることなく、コメントの追加やフォロワーの指定、業務の整理を行うことが可能です。セキュリティを確保するため、コネクションには専用のサービスアカウントを使用し、権限を慎重に確認してください。利用可能なアクションには、プロジェクトやタスクの作成、詳細情報の更新、コメントやフォロワーの追加、タスクの削除などがあります。
アクションビルダーをAsanaなどの外部システムに接続すると、管理者は自動化ワークフロー内でZendeskと外部システムを連携させることができます。これにより、コラボレーションを強化し、複数のプラットフォームにまたがるシームレスな体験を維持できます。
Asanaは、チームが業務を整理、追跡、管理するための業務管理プラットフォームです。アクションビルダー用のAsanaコネクタを使用すれば、Zendeskのアクションフローから直接、タスクやプロジェクトの作成・管理、コメントやフォロワーの追加、業務の整理を行うことができます。
Asanaをアクションビルダーに接続する
外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。
- アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
- すべてのインテグレーションは、必要なスコープへのアクセスを要求します。ただし、外部システムへの接続を承認する前に、スコープを確認し、妥当性を検証することが重要です。
- APIキーベースのツール(OpenAIなど)の資格情報を管理する場合、キーは、セキュアな保管場所または資格情報管理ツールに保存することをお勧めします。
- 管理センターで、サイドバーにある「
アプリおよびインテグレーション」をクリックし、「アクション」>「アクションフロー」を選択します。 - アクションフローを新規作成するか、既存のアクションフローを編集します。
- ステップサイドバーを開きます。
- 「外部アクション」セクションで、「Asana」をクリックします。
- 「接続」をクリックします。
- Asanaの指示に従って認証を行い、接続を確立します。
Asanaコネクションは、OAuth 2.0の認証コードグラント方式を使用しています。コネクションを承認すると、Asanaにリダイレクトされ、ZendeskアカウントにAsanaへのアクセス権限を付与します。
メモ:アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
接続が完了すると、接続していることを示すインジケーター、接続したインスタンスの詳細情報、およびAsanaで利用可能なアクションが表示されます。
アクションフローでのAsanaアクションの使い方
Asanaアクションステップを使用して、プロジェクトやタスクの作成、更新、管理を行うことができます。
プロジェクトを作成する
「プロジェクトを作成する」アクションを使用して、Asanaワークスペースに新しいプロジェクトを作成します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須:Workspace、Nameオプション: |
| 出力 | プロジェクトの詳細情報:GID、名前、メモ、Permalink URL、ワークスペース情報、チーム情報、オーナー情報など |
タスクを作成する
「タスクを作成する」アクションを使用して、指定された情報を含む新しいタスクをAsanaに作成します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須:Workspace、Name、Projectオプション: |
| 出力 | タスクの詳細情報:GID、名前、メモ、完了状況、期限、固定リンクURL、担当者情報、ワークスペース情報、関連プロジェクトなど |
プロジェクトを更新する
「プロジェクトを更新する」アクションを使用して、既存のプロジェクトのプロパティを更新します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須:Project GIDオプション: |
| 出力 | プロジェクトの詳細情報:GID、名前、アイコン、アーカイブ済みステータス、Permalink URLなど |
タスクを更新する
「タスクを更新する」アクションを使用して、Asanaの既存のタスクを更新します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須:Task GIDオプション: |
| 出力 | タスクの詳細情報:GID、名前、完了ステータス、完了のタイムスタンプ、およびPermalink URLなど |
プロジェクトにタスクを追加する
「プロジェクトにタスクを追加する」アクションを使用して、既存のタスクをプロジェクトに追加し、必要に応じて配置を指定します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須:Task GID、Projectオプション:
メモ:選択は
Insert
after または Insert before のいずれか一方を選択してください。両方は選択しないでください。 |
| 出力 | 成功ステータス |
タスクにコメントを追加する
「タスクにコメントを追加する」アクションを使用して、既存のタスクにコメントを追加します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須:Task GID、Textオプション: |
| 出力 | コメントの詳細情報:GID、リソースタイプ、作成日時、コメントタイプ、本文、ピン留めステータス、作成者情報、および対象タスク情報など |
タスクにフォロワーを追加する
「タスクにフォロワーを追加する」アクションを使用して、既存のタスクにフォロワーを追加します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須:Task GID、Workspace、Follower
|
| 出力 | タスクのGIDおよびフォロワーのGIDと名前を含む配列 |
タスクを削除する
「タスクを削除する」アクションを使用して、タスクをAsanaから完全に削除します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須:Task GID
|
| 出力 | 成功ステータス |