Chat Channels
Managing Channels
List, update, pause, and delete your connected chat channels.
Managing Channels
All channels share the same trpc.channels.* API regardless of provider.
UI
Go to User Settings → Chat Channels to see all your connected channels. From there you can:
- Change default space — tasks will be created in the new space going forward
- Pause / Resume — paused channels ignore incoming messages but keep the connection
- Delete — removes the webhook and disconnects the channel
API
// List all your channels
const channels = await trpc.channels.list.query();
// Change default space
await trpc.channels.update.mutate({ id: "ch_...", defaultSpaceId: "space_new" });
// Pause (messages ignored, connection kept)
await trpc.channels.update.mutate({ id: "ch_...", isActive: false });
// Resume
await trpc.channels.update.mutate({ id: "ch_...", isActive: true });
// Disconnect (removes webhook, deletes channel)
await trpc.channels.delete.mutate({ id: "ch_..." });Troubleshooting
| Problem | Solution |
|---|---|
| Bot doesn't respond | Check isActive is true via channels.list |
| "No default space set" | Update the channel with a defaultSpaceId |
| Can't connect locally | Use a tunnel (ngrok) — platforms can't reach localhost |
| Invalid token error | Re-copy the full token from the platform's bot settings |
| Tasks not in dashboard | Check the channel's defaultSpaceId matches the space you're viewing |