chat-adapter-asana

Asana adapter for Chat SDK. Maps Asana task comment threads to the Chat SDK Thread/Message model.

Installation

npm install chat chat-adapter-asana

Usage

import { createMemoryState } from '@chat-adapter/state-memory'
import { Chat } from 'chat'
import { createAsanaAdapter } from 'chat-adapter-asana'

const bot = new Chat({
  userName: 'asana-bot',
  adapters: {
    asana: createAsanaAdapter({
      accessToken: process.env.ASANA_ACCESS_TOKEN!,
    }),
  },
  state: createMemoryState(),
})

bot.onNewMention(async (thread, message) => {
  await thread.post('Hello from Asana!')
})

// Wire up the webhook in your HTTP framework
// e.g. Next.js App Router:
export async function POST(request: Request) {
  return bot.webhooks.asana(request)
}

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | ASANA_ACCESS_TOKEN | Yes | Personal access token or service account token | | ASANA_WEBHOOK_SECRET | No | Stored automatically during webhook handshake |

Configuration

| Option | Type | Default | Description | |--------|------|---------|-------------| | accessToken | string | ASANA_ACCESS_TOKEN | Asana API access token | | baseUrl | string | "https://app.asana.com/api/1.0" | Asana API base URL | | userName | string | "asana-bot" | Bot display name | | logger | Logger | ConsoleLogger | Custom logger instance |

Platform setup

1. Create an Asana service account or use a personal access token from Asana Developer Console
2. Set up a webhook by calling the Asana webhooks API targeting your endpoint:

   curl -X POST https://app.asana.com/api/1.0/webhooks \
     -H "Authorization: Bearer $ASANA_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "data": {
         "resource": "<project_gid>",
         "target": "https://your-domain.com/api/webhooks/asana",
         "filters": [
           { "resource_type": "story", "action": "added" }
         ]
       }
     }'

3. The adapter automatically handles the webhook handshake (responds to X-Hook-Secret headers)
4. Set the webhook URL to https://your-domain.com/api/webhooks/asana

Concept mapping

| Asana | Chat SDK | |-------|----------| | Task | Thread | | Story (comment) | Message | | Story author | message.author | | Like on a story | Reaction (heart) | | @mention in comment | Mention detection |

Features

• Webhook handshake and HMAC-SHA256 signature verification
• Task comment threads (post, edit, delete)
• Message history (fetch task stories)
• Reactions (like/unlike stories)
• @mention detection
• Rich text support (Asana HTML to mdast)

Thread ID format

asana:{taskGid}

Task GIDs are Asana's numeric identifiers for tasks.

License

MIT