Trello Integration

The Trello integration allows ButterStack to monitor your Trello boards for card changes and automatically track asset references mentioned in card descriptions.

Quick Setup

1. Get API Credentials
   • Go to https://trello.com/app-key
   • Copy your API Key
   • Click the “Token” link to generate a token
   • Authorize ButterStack to access your Trello account
   • Copy the generated token
2. Create Integration
   • In ButterStack, go to Project Settings → Integrations
   • Click “Add Integration” and select “Trello”
   • Enter your API Key and Token
   • Optionally specify a Board ID to monitor specific boards
   • Save the integration
3. Start Tracking Assets
   • Reference asset names in your Trello card descriptions
   • Example: “Update PlayerCharacter.uasset animation”
   • ButterStack will automatically detect asset references and track lineage

Features

Real-time Monitoring

• Automatically receives webhook notifications when cards are created, updated, or moved
• Tracks card status changes and assignments
• Monitors comments and attachments

Asset Lineage Tracking

• Scans card descriptions for asset references
• Links Trello cards to specific game assets
• Tracks asset usage across project management workflows

Webhook Management

• ButterStack automatically sets up webhooks for your boards
• No manual webhook configuration required
• Secure token-based authentication

Configuration Options

Board ID (Optional)

Specify a specific Trello board to monitor. If left blank, ButterStack will monitor all boards you have access to.

To find your Board ID:

1. Open your Trello board in a browser
2. Look at the URL: https://trello.com/b/BOARD_ID/board-name
3. Copy the BOARD_ID from the URL

Webhook Notifications

Enable or disable real-time webhook notifications. When enabled, ButterStack receives immediate updates when:

• Cards are created, updated, or deleted
• Cards are moved between lists
• Members are added or removed from cards
• Comments are added to cards
• Attachments are added or removed

Asset Reference Format

ButterStack automatically detects asset references in card descriptions when they follow these patterns:

• File extensions: .uasset, .umap, .cpp, .h, .cs, .js, .fbx, .png, .jpg, etc.
• Asset paths: /Content/Characters/Player.uasset
• Unity assets: PlayerController.cs, MainScene.unity

Examples

## Card Description Examples

### Good Asset References
- "Fix PlayerCharacter.uasset animation issue"
- "Update MainMenu.umap lighting"
- "Optimize Textures/Environment/Rock01.png"
- "Refactor Scripts/Player/PlayerController.cs"

### Will Be Tracked
- Any mention of files with game development extensions
- Asset paths starting with /Content/, /Source/, /Assets/
- Unity asset references with .unity, .cs, .prefab extensions

Troubleshooting

Connection Issues

• Verify your API Key and Token are correct
• Ensure your Trello account has access to the boards you want to monitor
• Check that the token hasn’t expired (tokens don’t expire by default)

Webhook Issues

• ButterStack automatically manages webhooks
• If webhooks stop working, try re-saving the integration
• Check the integration status in ButterStack for any error messages

Asset Detection Issues

• Ensure asset names include file extensions
• Use clear, unambiguous asset references
• Avoid abbreviations that might not be recognized

API Limits

Trello has rate limits for API calls:

• 300 requests per 10 seconds per API key
• 100 requests per 10 seconds per token

ButterStack respects these limits and will throttle requests as needed.

Security

• API credentials are encrypted and stored securely
• Webhook endpoints use secure tokens for authentication
• ButterStack only requests read and write permissions needed for operation
• No sensitive data is logged or stored beyond what’s necessary for functionality

Support

For issues with the Trello integration:

1. Check the integration status in ButterStack
2. Verify your API credentials are still valid
3. Ensure your Trello boards are accessible
4. Contact support with specific error messages if problems persist