Asana
12 min
the asana integration imports tasks from your asana projects into custify as tickets, linking them to the appropriate companies and people your customer success and sales teams get full visibility into project work, task status, and workload all within the custify 360° customer view key benefit see all asana tasks related to a customer directly on their company profile, including open/completed counts, overdue tasks, comments, and tags what this integration does once connected, the asana integration will import tasks from selected asana projects as tickets in custify match tasks to companies and people using configurable strategies import task comments as ticket replies, preserving author and timestamp import asana tags as ticket tags in custify calculate per company metrics total, open, completed, and overdue task counts keep data up to date via scheduled incremental syncs data synced from asana asana field custify field notes task name ticket title task notes ticket description html preserved when available assignee name/email assigned to used for person matching if enabled completed / not completed ticket status open or completed by default created date opened at due date metadata (due on) used for overdue calculation tags ticket tags new tags created in custify if needed comments (stories) ticket replies human comments only, not system events custom fields metadata all custom field values stored section membership metadata / status can be used as a ticket status permalink url metadata direct link back to asana company level metrics after each sync, custify updates these attributes on each matched company asana total tasks total tasks linked to the company asana open tasks tasks not yet completed asana completed tasks tasks marked as completed asana overdue tasks open tasks past their due date these metrics can be used in health scores, segments, playbooks, and dashboards before you begin make sure you have the following before connecting asana to custify an active asana account with access to the projects you want to import admin or integration settings access in custify a clear understanding of how your asana tasks relate to your custify companies — this determines which matching strategy to use how to set up the integration step 1 connect your asana account in custify, go to settings → integrations find asana in the list of available integrations click connect to asana you will be redirected to asana to authorize the connection log in to asana if prompted, then click allow you will be redirected back to custify automatically step 2 select workspace and projects if you have multiple asana workspaces, select the one you want to import from choose one or more projects to import tasks from only tasks from selected projects will be imported tip start with a small number of projects to test the setup before adding more step 3 configure entity matching this step determines how asana tasks get linked to your custify companies and people enable one or more of the following matching strategies match companies by custom field enable this if your asana tasks have a custom field containing a custify company id or company name select the field and choose whether to match on company id or company name match people by email in a custom field enable this if your asana tasks store a customer email in a custom field select the field that contains the email match by assignee email enable this if your asana task assignees are also contacts in custify best suited for setups where customers have asana accounts match by project to company mapping enable this if each asana project corresponds to a specific company set the custify attribute that stores the asana project gid for each company how to find a project gid open the project in asana — the gid is the number in the url https //app asana com/0/project gid/ step 4 configure import options import task comments as ticket replies imports all human written comments (enabled by default) import asana tags as ticket tags creates matching tags in custify (enabled by default) step 5 advanced options (optional) custom status field if you use a custom field for granular statuses (in progress, blocked, in review), select it here custom priority field if you track priority with a custom field, select it to import priority values into custify tickets use section as status enable this to use the asana board column name (to do, in progress, done) as the ticket status the custom status field takes precedence if both are configured step 6 trigger your first import click trigger first import to start the initial sync the integration will import all tasks from your selected projects depending on the number of tasks, this may take a few minutes sync types full sync imports all tasks from selected projects runs once on first activation or when triggered manually processes all comments, tags, and computes company metrics incremental sync only imports tasks modified since the last sync (with a 2 hour buffer to ensure no tasks are missed) runs automatically on a schedule and is much faster than a full sync troubleshooting tasks not importing? check project selection only tasks from selected projects are imported check matching configuration tasks that do not match any company or person are skipped verify custom field values values in asana must match the company id or name in custify exactly check integration status go to settings → integrations and confirm asana shows as connected and active wrong company linked? check the custom field value it must exactly match the company id or name in custify check for duplicates if multiple companies share the same name or id, the first match is used review matching priority company field matching takes precedence over assignee matching missing comments? verify that import task comments as ticket replies is toggled on only human written comments are imported system events are filtered out re run the sync to pick up comments added after the last sync integration not syncing? check the oauth connection it may have expired try disconnecting and reconnecting run a manual sync by clicking trigger first import contact custify support with your account details and any error messages privacy and security authentication uses oauth 2 0 you authorize custify directly through asana's consent screen no asana password is ever stored in custify tokens are encrypted and refreshed automatically custify requests read only access only and never writes, updates, or deletes anything in your asana account only tasks from selected projects are accessed file attachments are not imported only text content to revoke access disconnect from custify at settings → integrations → asana → disconnect , or revoke from asana at my settings → apps → manage developer apps
