@devries-cameron20 / composio Mirror · read-only / commits / 8b8aac493
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 23:30 UTC

docs(changelog): clarify app_token scope and tighten lifecycle bullet

- Rewrite step 5 to state exactly when an app_token is required: always for SLACK_DIRECT_MESSAGE_RECEIVED, and for SLACK_CHANNEL_MESSAGE_RECEIVED only when the event is from a private channel or multi-person DM (verified against Mercury's channel_message_received trigger, which sets authz_required dynamically on channel_type). - Change the slug-mapping table header to "app_token required?" and reflect the same distinction inline. - Retitle the lifecycle bullet to "Automatic handshakes and cleanup" and drop the "handled for you" phrasing. _(sent via Claude Code)_ Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Anshu Garg committed Apr 18, 2026 at 21:43 UTC 8b8aac4938fedd3dd0f6fb5476e41e4e757fb685
1 file changed +11 -6
docs/content/changelog/04-18-26-webhook-triggers-v2.mdx
+11 -6
@@ -30,7 +30,7 @@ This replaces V1's shared `/handle` URL per toolkit. Events arriving on a V2 URL
30
31 **Per-user authorization for app-level events.** On toolkits with per-user visibility — Slack being the first — V2 uses an app-level token (for Slack, an `xapp-…` token with `authorizations:read`) to resolve which connected users are authorized for a given event, so only those users' triggers fire. This underpins a new class of triggers for private channels, direct messages, and other per-recipient events, each routed only to the user the event was intended for.
32
33 -**Handshakes and lifecycle handled for you.** Composio automatically responds to provider verification challenges — Slack `url_verification`, Asana `X-Hook-Secret`, Outlook validation tokens, and so on — so callback URLs verify without any custom code on your side. Composio also deregisters user-level webhooks with the provider when the trigger is deleted.
33 +**Automatic handshakes and cleanup.** Composio responds to provider verification challenges — Slack `url_verification`, Asana `X-Hook-Secret`, Outlook validation tokens, and so on — so callback URLs verify without any custom code. User-level webhooks are also deregistered on the provider side when the trigger is deleted.
34
35 ## API reference
36
@@ -91,9 +91,14 @@ Store the signing secret before switching the provider's callback URL. If Slack
91
92 Set **Event Subscriptions → Request URL** in your Slack app to the `webhook_url` returned in step 2. Slack issues a `url_verification` challenge; Composio responds automatically and sets `verified_at` on the endpoint.
93
94 -### 5. (Optional) Add an app-level token for private channel and DM triggers
94 +### 5. Add an app-level token for private-scope events
95
96 -Required only for triggers that need per-user authorization.
96 +The app-level token is what lets Composio resolve per-user authorization for Slack's private-scope events.
97 +
98 +- `SLACK_DIRECT_MESSAGE_RECEIVED` always requires it.
99 +- `SLACK_CHANNEL_MESSAGE_RECEIVED` requires it for events from **private channels** and **multi-person DMs**; public-channel messages are delivered without it.
100 +
101 +Skip this step if you only need public-channel messages today — you can add the token later.
102
103 ```bash
104 curl -X PATCH "https://backend.composio.dev/api/v3/webhook_endpoints/ENDPOINT_ID" \
@@ -106,10 +111,10 @@ Generate the token from **Slack app → Basic Information → App-Level Tokens**
111
112 ### 6. Create V2 trigger instances
113
109 -| V1 slug (still supported) | V2 replacement | Notes |
114 +| V1 slug (still supported) | V2 replacement | `app_token` required? |
115 |---|---|---|
111 -| `SLACK_RECEIVE_MESSAGE` | `SLACK_CHANNEL_MESSAGE_RECEIVED` | Adds `channel_id`, `is_bot_message`, `is_thread_reply` filters |
112 -| `SLACK_RECEIVE_DIRECT_MESSAGE` | `SLACK_DIRECT_MESSAGE_RECEIVED` | Requires `app_token` for per-user authorization |
116 +| `SLACK_RECEIVE_MESSAGE` | `SLACK_CHANNEL_MESSAGE_RECEIVED` | Only for private channels and multi-person DMs; public channels work without it |
117 +| `SLACK_RECEIVE_DIRECT_MESSAGE` | `SLACK_DIRECT_MESSAGE_RECEIVED` | Always |
118
119 ```bash
120 curl -X POST "https://backend.composio.dev/api/v3/trigger_instances/SLACK_CHANNEL_MESSAGE_RECEIVED/upsert" \