From 7eacaa819a025b450a0e2d67cf8e3fc3208aa615 Mon Sep 17 00:00:00 2001 From: webbjordy Date: Tue, 17 Mar 2026 23:44:35 -0700 Subject: [PATCH 1/2] docs(KNO-12105): update push engagement status copy in message-statuses Replace outdated "Not currently supported" push entries in the engagement status section with accurate copy. Push read/open status is not implicitly managed by Knock but can be set manually via the message engagement API using the knock_message_id from the push payload. Knock's mobile SDKs handle this automatically on tap. Same correction applied to the link-clicked push entry. Co-Authored-By: Claude Sonnet 4.6 --- content/send-notifications/message-statuses.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/send-notifications/message-statuses.mdx b/content/send-notifications/message-statuses.mdx index 51b04c909..1b43032fc 100644 --- a/content/send-notifications/message-statuses.mdx +++ b/content/send-notifications/message-statuses.mdx @@ -134,7 +134,7 @@ Knock will implicitly manage this status only for the following channel configur - **Email** — [Knock open tracking](/send-notifications/tracking) needs to be enabled. - **In-app** — When you're using the [Knock ReactFeedProvider SDK](/in-app-ui/react/feed). -- **Push** — Not currently supported. +- **Push** — Not implicitly managed by Knock. However, you can manually set this status using the message engagement API with the `knock_message_id` from the push payload. If you're using one of Knock's mobile SDKs, this is handled automatically when a notification is tapped. - **SMS** — Not directly supported. But, if [Knock link tracking](/send-notifications/tracking) is enabled, we will count a link-click action as also an open event. - **Chat** — Not directly supported. But, if [Knock link tracking](/send-notifications/tracking) is enabled, we will count a link-click action as also an open event. - **Webhook** — Not currently supported. @@ -151,7 +151,7 @@ Knock will implicitly manage this status only for the following channel configur - **Email** — [Knock link tracking](/send-notifications/tracking) needs to be enabled. - **In-app** — [Knock link tracking](/send-notifications/tracking) needs to be enabled for link-clicks to count towards this status. In addition, for in-app messages where the message is itself a link, message clicks will also count. (Note: that clicking “mark all as read” does not result in a message being marked as clicked; rather, as the phrasing implies, we bulk update the message engagement statuses to opened/read.) -- **Push** — Not currently supported. +- **Push** — Not implicitly managed by Knock. You can manually set this status using the message engagement API with the `knock_message_id` from the push payload. - **SMS** — [Knock link tracking](/send-notifications/tracking) needs to be enabled. - **Chat** — [Knock link tracking](/send-notifications/tracking) needs to be enabled. - **Webhook** — Not currently supported. From 58ceb3a39f8f44b18daf769ef1d4b5ca392461d0 Mon Sep 17 00:00:00 2001 From: webbjordy Date: Wed, 18 Mar 2026 14:51:18 -0700 Subject: [PATCH 2/2] docs(KNO-12105): correct push link-clicked entry per reviewer feedback Replace incorrect "can manually set link_clicked" copy with accurate explanation: push notifications don't support clickable links so Knock link tracking is unavailable for push. Direct readers to the interacted status with metadata for tap event tracking instead. Co-Authored-By: Claude Sonnet 4.6 --- content/send-notifications/message-statuses.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/send-notifications/message-statuses.mdx b/content/send-notifications/message-statuses.mdx index 1b43032fc..b3cd4d654 100644 --- a/content/send-notifications/message-statuses.mdx +++ b/content/send-notifications/message-statuses.mdx @@ -151,7 +151,7 @@ Knock will implicitly manage this status only for the following channel configur - **Email** — [Knock link tracking](/send-notifications/tracking) needs to be enabled. - **In-app** — [Knock link tracking](/send-notifications/tracking) needs to be enabled for link-clicks to count towards this status. In addition, for in-app messages where the message is itself a link, message clicks will also count. (Note: that clicking “mark all as read” does not result in a message being marked as clicked; rather, as the phrasing implies, we bulk update the message engagement statuses to opened/read.) -- **Push** — Not implicitly managed by Knock. You can manually set this status using the message engagement API with the `knock_message_id` from the push payload. +- **Push** — Not supported. Push notifications don't support clickable links within their content, so Knock link tracking is not available for push. To track tap events on a push notification, use the [`interacted` status](#interacted) with its `metadata`. - **SMS** — [Knock link tracking](/send-notifications/tracking) needs to be enabled. - **Chat** — [Knock link tracking](/send-notifications/tracking) needs to be enabled. - **Webhook** — Not currently supported.