Birdy Bot is Birdy Grey's Slack assistant. It answers questions about products, orders, discount codes and the codebase, triages bugs, and posts scheduled messages. Other services use it to post to Slack without holding a Slack token.
| |
|---|
| Stack | Node 22, Express, TypeScript |
| Hosting | Cloud Run, birdy-bot service |
| Production | https://platform.birdygrey.com/apps/birdybot/v1 |
| Staging | https://platform.birdystaging.com/apps/birdybot/v1 |
| Repository | birdygrey/birdy-bot |
| API reference | API.md |
How people use itβ
| Where | What happens |
|---|
| @mention in a channel | Classifies the message and replies in the thread |
| DM (CX workspace) | Looks up a customer by email or an order by number, tracking number or shipment ID. replace <order> builds replacement options and a draft order |
/audit slash command | Runs a product audit through product-sync-service |
| Linear | Comments a triage analysis on new SITE issues labeled π₯ |
| Schedule | Weekly icebreaker, weekday PR review digest, fantasy football leaderboard |
Who calls its APIβ
| Caller | Endpoints |
|---|
| tally-api | /slack/post, to post finance alerts |
The /triage Claude skill | /slack/post, /react, /update, /read, /delete |
| Cloud Scheduler | /slack/icebreaker, /slack/pr-digest, /slack/fpl-digest |
Birdy Bot can only post in channels it has been invited to.