ย 

Changelog

The latest releases and improvements to Knock.

New Relic observability extension

Today weโ€™re extending support for reporting notification metrics to New Relic. Previously, we only supported Datadog as an observability platform, but with todayโ€™s release, weโ€™re introducing support for reporting metrics to New Relic as well.

You can read more in the documentation about the types of metrics reported. Our New Relic extension is available to customers on our Enterprise plan only.

New outbound webhook event types

Today we're announcing support for new types of events in outbound webhooks, making it even easier to deeply integrate Knock into your application's workflow. With today's release, you can now listen to changes for any version-controlled content within your Knock dashboard, including workflows, email layouts, and translations.

You can find the full set of supported webhook events in the documentation and can create a webhook by going to the "Developers > Webhooks" section in the Knock dashboard.

Fixes and improvements

  • ๐Ÿ‘€ We greatly improved the bundle size in our @knocklabs/react package by removing the dependency on the date-fns library.

Our Flutter SDK

Today weโ€™re shipping our new Flutter SDK, which is a client-side SDK written in Dart to interact with the Knock API and to build in-app notification experiences in Flutter applications.

We have big plans for more in-product experiences that weโ€™ll be bundling into this SDK in the near future. Todayโ€™s release is a first step towards that future, giving the base primitives to easily bring all of the functionality of Knock into your applications in an easy-to-consume way.

You can learn more in our Flutter SDK documentation.

Fixes and improvements

  • ๐Ÿ‘€ We added a link to view usage for Enterprise customers under the "Billing" page
  • ๐Ÿ‘€ We redesigned the empty states across the dashboard
  • ๐Ÿ› We fixed an issue where our Vonage integration would fail when sending multi-part messages

Announcing commit diffs

Today weโ€™re releasing a big upgrade to the version control experience in Knock with commit diffs.

With this release, you can now:

  • View a commit to see what has changed between that commit and the prior version of the workflow.
  • Review a diff when promoting a commit to an environment. You will see the diff between the current state of that environment and the pending commit.
  • Audit the full history of commit diffs in your commit log to know exactly what's changed over time.

Read the full announcement here โ€”>

New Android SDK

Today, weโ€™re shipping our new Android SDK, which is a client-side SDK written in Kotlin to interact with the Knock API and to build in-app notification experiences in Android applications.

We have big plans for more in-product experiences that weโ€™ll be bundling into this SDK in the near future. Todayโ€™s release is a first step towards that future, giving the base primitives to easily bring all of the functionality of Knock into your applications in an easy-to-consume way.

You can learn more in our Android SDK Documentation, or get started now by following the installation instructions.

Fixes and improvements

  • ๐Ÿ‘€ We added support for edge runtimes, like Vercel and Cloudflare Workers, in our Node JS SDK
  • ๐Ÿ‘€ We now show a channel data tab when viewing an individual tenant in the dashboard

New React SDK

Today, weโ€™re shipping our new React SDK (@knocklabs/react), which provides a unified set of hooks and components for integrating Knock into your web applications. You can use our React package to power in-app notification experiences like feeds, toasts, and banners for your users, as well as powering notification configuration via our preferences API.

Our new SDK is the home of all in-product notification experiences powered by Knock, superseding the previous react-notification-feed package. If youโ€™re using the old package, you can read here on how to migrate.

We have big plans for more in-product experiences that weโ€™ll be bundling into this package in the near future. Todayโ€™s release is a first step towards that future, giving the base primitives to easily bring all of the functionality of Knock into your applications in an easy-to-consume way.

You can install the React SDK from NPM by running npm install @knocklabs/react and can find the package in our brand new Javascript monorepo.

Fixes and improvements

  • ๐Ÿ‘€ We improved the loading time of message views within the Dashboard
  • ๐Ÿ‘€ We now validate certificates when configuring an APNS channel
  • ๐Ÿ‘€ We now validate the service account JSON when configuring a FCM channel

Schedule one-off workflow runs

Earlier this year we released the ability to run recurring workflows for your users via our Schedules API. Today, we're releasing an extension to our schedules API with the ability to schedule a single workflow run in the future for one or more recipients. One-off schedules are perfect to enqueue a workflow that should be run at some future point, without you needing to write your own cron jobs to do so.

Here's an example of creating a one-off schedule for a set of recipients:

await knock.workflows.createSchedules("park-alert", {
  recipients: ["jhammond", "esattler", "dnedry"],
  scheduled_at: "2023-12-25 12:00:00Z"
  data: { type: "dinosaurs-loose" },
  tenant: "jpark",
});

You can learn more about running one-off or recurring schedules in the documentation.

Customize the response of the in-app feed

Today, weโ€™re launching additional privacy controls for our in-app feed API. Previously, when your recipientโ€™s in-app feeds were requested, the response would include the full recipient object, which could lead to personal data about your recipient being returned unnecessarily.

With today's release, you can now use allow or deny lists to control which fields are returned from any entity in your feed request. Here's an example in-app feed response filter:

{
  "actor": {
    "only": ["id"]
  },
  "data": {
    "except": ["credit_card_last4"]
  }
}

Read more in the documentation.

Fixes and improvements

  • ๐Ÿ› We fixed an issue where clicking links in a message preview could crash the dashboard
  • ๐Ÿ› We fixed an issue where using tenants as a recipient in a workflow trigger would stop workflow runs from showing

Promote individual commits in the CLI

You can now use the Knock CLI to promote individual commits. This was previously available in the dashboard, and today we're bringing it to the CLI. With this addition, it makes it easy to build specific deployement workflows that only promotes the resources you need.

Individual commit promotion is available now in the latest version of the CLI (v0.1.7) and is available across all plans. You can read more in the documentation.

Fixes and improvements

  • ๐Ÿ‘€ You can now go directly to the workflow editor from the workflows page using the 3-dot menu
  • ๐Ÿ‘€ You can now use cmd+return in the preview data editor to save the data and close the modal
  • ๐Ÿ› We fixed an issue where the update schedules endpoint was missing schema validation for an empty properties object
  • ๐Ÿ› We fixed an issue where breadcrumbs didn't load properly on our docs site
  • ๐Ÿ› We fixed a few tooltip and text display issues in the Dashboard

Manage email layouts via the CLI and management API

With the introduction of our CLI and management API earlier this year, we added support for working with both workflows and translations locally. Now, we've added support for managing email layouts via the CLI and management API, making it possible to pull down your email layouts locally, make changes to those layouts, and push them back up to Knock to be deployed.

Working with email layouts is available now in the latest version of the CLI (v0.1.x) and is available across all plans. You can read more in the documentation.

Control the number of items rendered in a batch template

While our batch function has always allowed an unlimited number of items to be accumulated per-batch, the number of items that could be rendered in a template from that batch has always been limited to the first or last 10 items. Today, we're adding a new setting into our batch function to control the number of items that can be rendered, with the ability to render up-to 100 items.

Batch render limits are available now on our Enterprise plan only. You can read more in the documentation, or contact our sales team today to arrange a demo.

Fixes and improvements

  • ๐Ÿ‘€ We now highlight the "Developers > Logs" menu item when viewing workflow runs
  • ๐Ÿ‘€ All new accounts now have an in-app feed channel setup by default
  • ๐Ÿ› We fixed a bug where in certain cases hourly schedules would not repeat

User deletion and right to be forgotten requests

We've expanded the scope of our user deletion endpoint. Now we permanently delete all content associated with a user upon receiving a deletion request. This means that Knock user deletion is now fully GDPR-compliant and can be used to programmatically process right to be forgotten requests. Previously we had supported these requests in an ad-hoc way through our customer support, but with this change you can now programmatically call the user delete or bulk delete APIs and have all content for a user permanently removed.

You can learn more in our user deletion documentation ->

Bypass recipient preference evaluation

We've introduced a per-workflow control to bypass recipient preferences. This is useful in situations where you need to force a critical notification through to a recipient (such as a password reset email) regardless of that recipient's channel preferences.

You can find the new preference control under "Manage workflow" in the workflow three-dot menu. You can learn more in the preferences documentation.

Fixes and improvements

  • ๐Ÿ‘€ We changed the admin role to be able to create and manage environments
  • ๐Ÿ‘€ We changed our combobox behavior for selecting recipients and actors to load a page of data to aid with selection
  • ๐Ÿ‘€ We added support for per-customer overrides for idempotency windows
  • ๐Ÿ› We fixed an issue where the workflow category selector was case sensitive
  • ๐Ÿ› We fixed an issue where the knock.messages.delivered metric was not being sent to Datadog

Set a maximum batch limit

Today we're releasing a new way to close your notification batches, by setting a maximum number of items allowed. This means a batch can now close either temporally (when the batch window ends), or when a certain number of items have been accumulated, giving you even more flexibility on how you batch your notifications.

You can set a maximum batch item limit under the batch step settings. Read more in the documentation.

Fixes and improvements

  • ๐Ÿ‘€ We added a new bulk add subscriptions API endpoint
  • ๐Ÿ‘€ We changed the behavior of our recipient preferences set endpoints to create empty recipient's when setting preferences for new recipients instead of 404-ing
  • ๐Ÿ‘€ We increased the limit on all of our bulk operation endpoints from 100 to 1000 items at a time
  • ๐Ÿ‘€ We added support for the Mailtrap email testing API
  • ๐Ÿ‘€ We added an email field to our docs feedback component
  • ๐Ÿ‘€ We now expose subscription information under a recipient when triggering a workflow from a subscription
  • ๐Ÿ› We fixed an issue where you could not manage subscriptions under a tenant object
  • ๐Ÿ› We fixed an issue where some email clients would not report tracking information correctly
  • ๐Ÿ› We fixed an issue with our batch steps where in certain cases, using a sliding batch window could extend to the maximum batch duration
  • ๐Ÿ› We fixed an issue where using the CLI to push translations with no changes would result in uncommitted changes being generated
  • ๐Ÿ› We fixed an issue where webhooks were not being properly created via the Dashboard
  • ๐Ÿ› We fixed an issue where long variable names would break the layout in the variable pane