Skip to main content

​
Asana

ShanoneのAsana連携では、115個のツールをエージェントに提供します — カタログの中でも最も網羅性の高い連携の一つで、タスクやプロジェクトだけでなく、ポートフォリオ、ゴール、カスタムフィールド、依存関係、時間管理、Webhookまでカバーしています。

​
はじめに

1

OAuthで接続する

エージェントにAsanaで何か作業をしてもらう(例:「Q3ロードマップのプロジェクトにタスクを作成して」)か、Shanoneダッシュボードのインテグレーションから事前に接続します。
2

ワークスペースを承認する

Shanoneにアクセスさせたいワークスペースについて、AsanaのOAuth承認画面で承認します。
3

リクエストを再試行する

接続が完了すると、asana_*ツールに対するshanone_execute_toolの呼び出しが成功するようになります。

​
利用可能なツール

Shanoneは Asana向けに115個のツールを提供しており、以下のカテゴリに分類されています。
asana_get_task, asana_list_tasks, asana_search_tasks, asana_create_task, asana_update_task, asana_complete_task, asana_assign_task, asana_add_comment, asana_delete_task, asana_add_tag
asana_get_subtasks, asana_create_subtask, asana_set_parent, asana_duplicate_task, asana_get_dependencies, asana_add_dependencies, asana_remove_dependencies, asana_get_dependents, asana_add_dependents, asana_remove_dependents, asana_get_task_followers, asana_add_followers, asana_remove_follower
asana_list_projects, asana_create_project, asana_get_project, asana_update_project, asana_delete_project, asana_duplicate_project, asana_get_task_counts, asana_search_projects, asana_get_project_memberships, asana_add_members_for_project, asana_remove_members_for_project, asana_add_followers_for_project, asana_remove_followers_for_project, asana_get_project_statuses, asana_create_project_status, asana_get_project_templates, asana_instantiate_project
asana_get_sections, asana_get_section, asana_create_section, asana_update_section, asana_delete_section, asana_insert_section, asana_get_tags_for_workspace, asana_create_tag, asana_update_tag, asana_get_tags_for_task, asana_remove_tag_for_task, asana_get_tasks_for_tag, asana_get_projects_for_task, asana_add_project_for_task, asana_remove_project_for_task, asana_move_task_to_section
asana_get_portfolios, asana_get_portfolio, asana_create_portfolio, asana_update_portfolio, asana_delete_portfolio, asana_get_items_for_portfolio, asana_add_item_for_portfolio, asana_remove_item_for_portfolio, asana_get_goals, asana_get_goal, asana_create_goal, asana_update_goal, asana_delete_goal, asana_add_followers_for_goal, asana_remove_followers_for_goal, asana_get_parent_goals, asana_get_goal_relationships, asana_add_supporting_relationship, asana_remove_supporting_relationship
asana_get_teams_for_workspace, asana_get_teams_for_user, asana_get_team, asana_create_team, asana_update_team, asana_get_team_memberships_for_team, asana_get_team_memberships_for_user, asana_add_user_for_team, asana_remove_user_for_team, asana_get_workspaces, asana_get_workspace, asana_update_workspace, asana_get_workspace_memberships_for_user, asana_get_workspace_memberships_for_workspace, asana_list_users, asana_get_user, asana_get_users_for_team, asana_get_users_for_workspace, asana_get_favorites_for_user
asana_get_custom_fields_for_workspace, asana_get_custom_field, asana_create_custom_field, asana_get_stories, asana_get_story, asana_update_story, asana_delete_story, asana_get_time_tracking_entries_for_task, asana_create_time_tracking_entry, asana_get_time_tracking_entry, asana_update_time_tracking_entry
asana_get_attachments_for_object, asana_get_attachment, asana_create_attachment, asana_delete_attachment, asana_get_webhooks, asana_get_webhook, asana_create_webhook, asana_delete_webhook, asana_create_batch_request, asana_typeahead_for_workspace

​
よくある使い方

スプリント/タスクのトリアージ

プロジェクト内の期限超過・未割り当てタスクを検索し、担当者を割り振る

ゴール & ポートフォリオの集計

ポートフォリオ配下のプロジェクトの進捗を、紐づくゴールと合わせてまとめる

チーム横断の依存関係マッピング

マイルストーンを再スケジュールする前に、タスクの依存関係・被依存関係を追跡する

時間管理レポート

タスクやプロジェクトの時間管理エントリを取得し、請求やキャパシティのレポートを作成する

​
トラブルシューティング

(enum/ドロップダウン型の)カスタムフィールドのオプションIDは、asana_get_custom_fieldが返す値と完全に一致させる必要があります — enum型フィールドには自由入力のテキストは使えません。
Asanaの検索APIは一度に1つのワークスペース内のみを検索し、独自のフィールド制限ルールがあります。workspaceパラメータがそのプロジェクトの実際のワークスペースと一致しているか確認してください。
Asanaは作成直後にWebhook先へのハンドシェイクリクエストへの即時応答を求めます — エンドポイントがハンドシェイクを完了できない場合、Asanaは黙ってWebhookを無効化します。