Setting up Asana as a Source

Guru’s Asana integration allows you to connect your project management content as a Source, enabling Guru to generate Answers using tasks and projects from Asana workspaces. Asana is supported as a Project Management Source.

👥

Access Required

Guru Access: You need to be an Admin, Source Creator, or relevant custom role to set up Sources

Asana Access: The authenticating user must have access to the Asana workspace and associated Projects and Tasks. API access is available on all Asana plans that support integrations.


Setting Up Asana as a Source

  1. In Guru, go to Manage.
  2. Select Sources, then click Add Source.
  3. Choose Asana from the list of integrations.
  4. Authenticate using your Asana account credentials (recommended).
  5. Filter data to start pulling content in from a specific start date (optional).
  6. Follow the prompts to sign in to your Asana account.
  7. Add a display name for the Source (optional) and click Connect Source.
  8. Assign which Guru Groups should have access to this content.

Objects Synced from Asana

Primary objects are the objects used to generate the search record.

Common Model / What You'll See During Setup

Objects/Data Brought In

Key Fields

Ticket

Primary Objects: Task items with details

• Name • Description • Ticket type • Status (Enum) • Due date • Creator (UUID) • Assignees (Array) • Parent ticket (UUID) • Ticket URL • Tags (Array) • Completed at • Remote created at • Remote updated at • Remote ID • Remote data

Viewer

Users who can view tasks

• User (UUID) • Team (UUID)

Comment

Comments/stories on tasks

• Body • HTML body • User (UUID) • Ticket (UUID) • Remote created at • Remote ID • Remote data

Attachment

File attachments on tasks

• File name • File URL • Ticket (UUID) • Remote created at • Remote ID • Remote data

Collection

Projects and sections

• Name • Description • Collection URL • Access level (Enum) • Parent collection (UUID) • Viewers (Unknown) • Remote created at • Remote updated at • Remote ID • Remote data

User

User profiles

• Name • Email address • Avatar • Roles (Array) • Remote ID • Remote data

Role

User roles and permissions

• Name • Remote ID • Remote data

Team

Workspace teams

• Name • Description • Remote ID • Remote data

Tag

Labels/tags on tasks

• Name • Remote ID • Remote data


Permissions

  • When you connect Asana as a source in Guru, you'll permission that content in Guru. Learn more here.
  • If someone is not provided with access in Guru to this source, they will not see Asana results in searches or when chatting with Guru.

Frequently asked questions about Asana

Can I connect multiple Projects or Workspaces? Yes. Each Source connection supports one Workspace. To connect multiple, repeat the setup process for each Workspace or subset of Projects.