Knock est une couche entre ton code et les fournisseurs d'envoi : un seul appel workflows.trigger devient un e-mail, un SMS, un push, une entrée dans un feed in-app ou un message Slack, selon les préférences du destinataire. Le paquet serveur @knocklabs/node est en version 1.34.0, publiée le 16 juillet 2026, et le paquet navigateur @knocklabs/react en version 0.13.1, publiée le 4 août 2026.
Ce que Knock fait au-delà de l'envoi d'un e-mail
Resend et Postmark acceptent une requête HTTP et envoient un e-mail. Knock se place un étage au-dessus et n'envoie rien lui-même. Les canaux se configurent dans le dashboard avec tes propres identifiants de fournisseur : pour l'e-mail, la liste couvre Postmark, Resend, SendGrid, Amazon SES, Mailgun, Mailjet, Mandrill, MailerSend, SparkPost et le SMTP simple ; pour le SMS, elle inclut Twilio, Vonage, Plivo, Telnyx, Sinch et MessageBird ; pour le push, APNS, Firebase, Expo, OneSignal et Amazon SNS ; pour le chat, Slack, Microsoft Teams, Discord et WhatsApp. Knock ne remplace donc pas la facture du fournisseur, il s'y ajoute.
Alors, pour quoi paies-tu ? D'abord, pour décider par quels canaux un événement donné doit atteindre un destinataire donné, ce qui signifie un ensemble de préférences stocké du côté de Knock. Ensuite, pour des étapes qu'un fournisseur d'e-mail n'a pas : regrouper de nombreux événements en un seul message, limiter les envois trop fréquents et annuler un envoi en file d'attente quand il n'est plus nécessaire. Enfin, pour le canal in-app : @knocklabs/client maintient une connexion websocket, et ses dépendances listent phoenix en 1.8.5, donc le feed se met à jour sans polling.
Knock accepte aussi des événements de sources externes et pas seulement de ton code. La liste des intégrations comprend Clerk, Stripe, PostHog, Segment, RudderStack, Hightouch, Census et Supabase. Pour certaines équipes, c'est la seule raison d'adopter Knock : les notifications peuvent être branchées sans ajouter d'appels dans l'application.
La famille de paquets et la scission des licences
La famille @knocklabs porte deux licences, et ce n'est pas une erreur de lecture. Vérifier trois sources donne une image cohérente mais bifurquée.
Les paquets serveur sont sous Apache 2.0. @knocklabs/node 1.34.0 déclare Apache-2.0 dans le registre npm, le dépôt knocklabs/knock-node contient un fichier LICENSE avec le texte complet de l'Apache License Version 2.0, et le tarball publié contient package/LICENSE avec le même texte. Il en va de même pour @knocklabs/mgmt 0.33.0 du 16 juillet 2026 et pour le paquet Python knockapi 1.29.0, envoyé sur PyPI le même jour.
Les paquets navigateur et la CLI sont sous MIT. @knocklabs/client 0.22.1, @knocklabs/react-core 0.15.1, @knocklabs/react 0.13.1, @knocklabs/react-native 0.11.1 et @knocklabs/expo 0.8.1 sont sortis le 4 août 2026, et @knocklabs/cli 1.2.3 le 13 août. Tous déclarent MIT dans le registre, et la racine du monorepo knocklabs/javascript contient un fichier LICENSE avec le texte MIT et la mention « Copyright (c) 2021 Knock Labs, Inc. ».
La troisième source, le contenu des paquets, révèle un écart. @knocklabs/client livre un fichier LICENSE avec le texte MIT. Mais @knocklabs/react, @knocklabs/react-core, @knocklabs/react-native et @knocklabs/expo ne contiennent aucun fichier de licence, car le champ files de leur package.json vaut ["dist", "README.md"]. Dans le monorepo, seul packages/client/LICENSE existe ; packages/react/LICENSE et les autres renvoient 404. Pour ces quatre paquets, la seule preuve de licence est le champ de métadonnées npm plus le fichier à la racine du dépôt. Un outil qui analyse le contenu des paquets n'y trouvera rien.
La scission est-elle délibérée ? Elle suit exactement la frontière des dépôts : knock-node, knock-python et knock-mgmt-node sont sous Apache 2.0, tandis que javascript et knock-cli sont sous MIT. Le motif est trop régulier pour être un accident, donc je le lis comme une distinction délibérée entre serveur et client, mais Knock ne l'énonce nulle part où je pourrais le vérifier, et je l'étiquette en conséquence : c'est une inférence, pas une déclaration de l'éditeur.
Plusieurs conséquences pour un audit. Un inventaire des licences de dépendances listera deux entrées pour un même éditeur, toutes deux permissives, donc il n'y a pas de conflit. Apache 2.0 comporte bien une concession de brevets explicite et une obligation de conserver les mentions, ce que MIT n'a pas, donc une règle disant « toute la famille X est sous MIT » sera fausse. De plus, @knocklabs/node embarque src/internal/qs/LICENSE.md avec une licence BSD 3-Clause pour un fork de la bibliothèque neoqs, et cette licence est invisible dans le champ license de npm.
Deux constats plus mineurs du même passage. @knocklabs/cli 1.2.3 fige @knocklabs/mgmt exactement à 0.33.0, pas sur une plage, donc un paquet MIT traîne derrière lui un paquet Apache 2.0. Et le tag latest de @knocklabs/types pointe vers la release candidate 0.1.5-rc-5.0 du 24 janvier 2025, alors que la version stable 0.1.5 date du 13 novembre 2024. @knocklabs/client demande ^0.1.5, et cette plage exclut les préversions, donc le build stable atterrit dans ton arbre. Quiconque installe @knocklabs/types par son nom obtient la candidate.
Déclencher un workflow depuis le code
L'installation et l'appel minimal ressemblent à ceci.
npm install @knocklabs/node
npm install @knocklabs/react @knocklabs/client
npm install --global @knocklabs/cliLe client serveur a une seule dépendance d'exécution, jose dans la plage ^6.0.11, utilisée pour signer les tokens d'utilisateur.
import Knock from '@knocklabs/node'
const knock = new Knock({
apiKey: process.env.KNOCK_API_KEY,
timeout: 30_000,
maxRetries: 2
})
const { workflow_run_id } = await knock.workflows.trigger('new-comment', {
recipients: ['user_123', 'user_456'],
actor: 'user_789',
cancellation_key: 'comment_5521',
tenant: 'acme',
data: {
comment_id: '5521',
document_title: 'Third quarter plan',
body: 'Take a look at the risks section'
},
settings: { sandbox_mode: false, skip_delay: false }
})
await knock.workflows.cancel('new-comment', {
cancellation_key: 'comment_5521',
recipients: ['user_123']
})Les valeurs par défaut valent la peine d'être connues, car elles figurent rarement dans les exemples de la documentation. apiKey vient de la variable KNOCK_API_KEY, baseURL de KNOCK_BASE_URL avec un repli sur https://api.knock.app, timeout est d'une minute, maxRetries vaut deux, et logLevel est lu depuis KNOCK_LOG et vaut warn par défaut. Comme les timeouts sont aussi relancés, l'attente réelle peut dépasser la valeur de timeout.
Les limites sont inscrites dans les types du paquet. La liste recipients contient au plus mille entrées par déclenchement. Le payload data a un plafond de 10 Mo, et toute valeur de chaîne unique de plus de 1024 octets est tronquée dans les logs. Les exécutions sont asynchrones, et la réponse ne contient que workflow_run_id. Le champ cancellation_key doit être fourni au moment du déclenchement, sinon l'annulation ultérieure est impossible, et il doit être unique, car une clé partagée entre plusieurs requêtes les annule en bloc.
Préférences des destinataires
C'est la partie la plus coûteuse à reconstruire soi-même : une matrice de consentements par canal, par catégorie et par workflow individuel, avec une interface pour la modifier.
await knock.users.setPreferences('user_123', 'default', {
channel_types: {
email: true,
sms: false,
push: true,
in_app_feed: true,
chat: false,
http: true
},
categories: {
marketing: false,
'product-updates': { channel_types: { email: true, push: false } }
},
workflows: {
'new-comment': { channel_types: { email: false, in_app_feed: true } }
}
})
const set = await knock.users.getPreferences('user_123', 'default')
const all = await knock.users.listPreferences('user_123')
await knock.users.unsetPreferences('user_123', 'marketing-only')Il existe six types de canaux : chat, email, http, in_app_feed, push et sms. Chacun des trois niveaux accepte soit un booléen, soit un objet avec ses propres channel_types, et la résolution part du plus spécifique, donc un réglage au niveau du workflow l'emporte sur une catégorie, et une catégorie sur un type de canal. Le second argument est l'identifiant de l'ensemble de préférences ; default est le choix habituel, mais un destinataire peut détenir plusieurs ensembles, ce qui aide pour des ensembles séparés par tenant. Côté React, @knocklabs/react-core expose un hook usePreferences, donc un écran de réglages n'a pas besoin de son propre client HTTP.
Batching et throttling
L'exemple le plus simple qui montre pourquoi cette couche supplémentaire existe. Dix personnes commentent le même document en une minute. Sans couche, dix événements produisent dix e-mails et l'utilisateur désactive les notifications. Avec une étape batch, dix déclenchements se fondent en une seule fenêtre, le template reçoit toute la liste d'activité, et un seul e-mail part en disant qu'il y a dix nouveaux commentaires.
Les types d'étapes disponibles dans un workflow sont channel, batch, delay, http_fetch, branch et throttle. L'étape batch a les réglages batch_order, batch_window_type et batch_window ; les valeurs que le générateur met en place sont asc, sliding et une fenêtre de trente secondes. Une fenêtre glissante s'étend à chaque nouvel événement, donc une série de commentaires arrivant toutes les vingt secondes garde le lot ouvert. L'étape delay prend delay_for avec une unité et une valeur, http_fetch a method et url et récupère des données supplémentaires en cours d'exécution, throttle limite la fréquence à laquelle un destinataire donné reçoit quoi que ce soit de ce workflow, et branch divise le workflow de façon conditionnelle.
Le batching change aussi la facture, car Knock compte les messages envoyés. Dix déclenchements regroupés en un lot font une seule ligne, pas dix.
Parlons maintenant honnêtement de l'autre côté. Si tu envoies des réinitialisations de mot de passe, des confirmations de commande et des factures, chacune sur un seul canal et chacune immédiatement, alors le batching, le throttling et les préférences n'ont rien à faire. Le fournisseur d'e-mail seul suffit, et Knock ajoute un autre service sur le chemin de livraison, un autre dashboard et une autre facture. Le seuil de rentabilité se situe à peu près au moment où apparaît un second canal, ou le premier flux d'événements répétitifs comme les commentaires, les mentions ou les changements de statut.
Où vit la logique des workflows
Les workflows s'éditent dans le dashboard de Knock, donc par défaut la décision de qui reçoit quoi vit en dehors de ton dépôt. La CLI est une réponse partielle.
knock login
knock init
knock workflow pull new-comment
knock pull --knock-dir ./knock
knock push --knock-dir ./knock --commit -m "batch window of five minutes"
knock commit --resource-type workflow --resource-id new-comment -m "template fix"
knock commit promote --to production
knock branch create feature-digestLa commande knock workflow pull écrit un répertoire par workflow contenant workflow.json plus des fichiers de template. Les clés qui se terminent par le caractère @ sont des pointeurs vers des fichiers sur le disque, donc le corps de l'e-mail reste un fichier .html séparé qui produit un diff lisible dans une pull request.
{
"name": "New comment",
"key": "new-comment",
"steps": [
{
"ref": "batch_1",
"type": "batch",
"settings": {
"batch_order": "asc",
"batch_window_type": "sliding",
"batch_window": { "unit": "seconds", "value": 30 }
}
},
{
"ref": "email_1",
"type": "channel",
"channel_key": "postmark-transactional",
"template": {
"settings": { "layout_key": "default" },
"subject": "New comments on {{ data.document_title }}",
"html_body@": "email_1/html_body.html"
}
}
]
}Au-delà des workflows, la CLI gère les layouts, les template partials, les traductions, les types de messages, les guides in-app, les audiences et knock schema pull. La configuration du projet vit dans knock.json, créé par knock init, et knock workflow generate-types produit des types pour le payload data.
Les limites comptent avant de l'écrire dans un processus de release. Les options --environment de knock push et knock commit n'ont qu'une seule valeur autorisée, development, donc il n'y a pas de push direct vers la production ; tu passes par knock commit promote --to. De plus, Knock a ses propres branches, gérées par knock branch create, switch, merge, rebase, list, delete et exit, ce qui est un second modèle de branches que tu dois garder à la main en phase avec celui de git. Au final, les workflows peuvent être versionnés et relus en JSON, mais la boucle complète est pull, édition, push, commit, promote, et non un déploiement ordinaire depuis ton serveur de build.
Une comparaison qui cadre le choix : dans Inngest, le workflow est une fonction TypeScript dans ton dépôt et passe par une revue de code ordinaire. Knock te donne à la place un éditeur et des aperçus de templates pour les personnes extérieures à l'équipe d'ingénierie. C'est un compromis, pas un avantage pour l'un ou l'autre.
Tarifs et exemple chiffré
L'unité de facturation est un message, défini sur la page des tarifs comme un message envoyé avec succès à un seul utilisateur sur un seul canal. Les destinataires, les workflows, les canaux et les membres de l'équipe sont illimités sur tous les plans, donc seul le trafic compte.
Le plan Developer coûte 0 USD et couvre 10 000 messages, 500 utilisateurs actifs de guides et 500 crédits d'agent IA, après quoi le tarif est de 0,01 USD par crédit. Les logs sont conservés 30 jours et l'authentification unique ne fonctionne que via Google. Le plan Starter coûte 250 USD par mois pour 50 000 messages, chaque message supplémentaire à 0,005 USD, plus 2 500 utilisateurs actifs de guides à 0,05 USD chacun au-delà et 2 000 crédits d'agent à 0,01 USD. Starter retire aussi la marque Knock des composants. Enterprise est chiffré individuellement, conserve les logs 90 jours et propose un autre modèle facturé selon le nombre d'utilisateurs uniques notifiés par mois.
Pour le plan gratuit, aucun tarif de dépassement n'est publié. Le tableau ne mentionne que le passage au plan supérieur, donc tant que Knock ne publie pas de prix, considère la limite de 10 000 comme ferme.
Faisons le calcul. Dix mille utilisateurs, cinq notifications chacun par mois, sur deux canaux en moyenne. Cela fait 50 000 notifications et 100 000 messages. Starter en couvre 50 000, les 50 000 restants coûtent 50 000 fois 0,005 USD, soit 250 USD. Ensemble 250 plus 250, donc 500 USD par mois pour Knock seul. La moitié e-mail de ce trafic, 50 000 messages, doit encore partir via un fournisseur : le plan Pro de Resend coûte 20 USD pour 50 000 e-mails. Environ 520 USD au total, dont 500 USD pour Knock.
La forme moins chère pour comparer. Les mêmes utilisateurs, trois notifications par mois, un canal, donc 30 000 messages. Cela tient dans l'allocation Starter, donc 250 USD plus 20 USD pour l'e-mail. Envoyer ces mêmes 30 000 e-mails directement via Resend coûte 20 USD. L'écart de 250 USD par mois est le prix des préférences, du batching et du feed in-app, et c'est le chiffre auquel confronter ton propre cas. Avec dix mille utilisateurs et une notification par mois, tu tombes exactement sur l'allocation gratuite de 10 000 messages, c'est-à-dire à sa limite.
Knock, fournisseurs d'e-mail et Novu
| Outil | Couche | Unité de facturation | Plan gratuit | Premier niveau payant |
|---|---|---|---|---|
| Knock | orchestration au-dessus des fournisseurs | message à un utilisateur sur un canal | 10 000 messages | 250 USD pour 50 000 messages |
| Novu | orchestration, auto-hébergement possible | exécution de workflow | 10 000 exécutions, 20 workflows | à partir de 30 USD pour 30 000 exécutions |
| Resend | fournisseur d'e-mail | e-mail envoyé | 3 000 e-mails, plafond de 100 par jour | 20 USD pour 50 000 e-mails |
| Postmark | fournisseur d'e-mail | e-mail envoyé | 100 e-mails par mois | 15 USD à partir de 10 000 e-mails |
La différence d'unité compte plus que la différence de prix. Knock compte les messages, donc une notification envoyée sur trois canaux fait trois lignes. Novu compte les exécutions de workflow, donc la même notification sur trois canaux fait une seule ligne, mais son plan gratuit plafonne les workflows à vingt, les environnements à deux, les membres de l'équipe à trois et l'historique d'activité à vingt-quatre heures. Novu propose aussi une option auto-hébergée : la racine du dépôt novuhq/novu contient un fichier LICENSE avec le texte MIT. Knock n'offre rien de tel ; la page des tarifs n'a pas de niveau auto-hébergé, et les dépôts publiés sont des bibliothèques clientes, des SDK et une CLI, pas un serveur.
Resend et Postmark appartiennent à une autre catégorie et ne font pas concurrence à Knock, ils travaillent en dessous. Twilio en est de même côté SMS : il figure sur la liste des fournisseurs de SMS de Knock, donc envoyer un SMS via Knock aboutit quand même sur un compte Twilio, Knock ajoutant la résolution des préférences et le batching. Si tu te retrouves avec un seul canal et des notifications transactionnelles simples, le fournisseur seul est le bon choix.
Côté interface, Knock livre des composants prêts à l'emploi, ce que les fournisseurs d'e-mail n'ont pas par définition.
'use client'
import {
KnockProvider,
KnockFeedProvider,
NotificationIconButton,
NotificationFeedPopover
} from '@knocklabs/react'
import '@knocklabs/react/dist/index.css'
import { useRef, useState } from 'react'
export function NotificationBell({ userId, userToken }) {
const [isOpen, setIsOpen] = useState(false)
const buttonRef = useRef(null)
return (
<KnockProvider
apiKey={process.env.NEXT_PUBLIC_KNOCK_PUBLIC_API_KEY}
user={{ id: userId }}
userToken={userToken}
enabled={Boolean(userId && userToken)}
>
<KnockFeedProvider feedId={process.env.NEXT_PUBLIC_KNOCK_FEED_ID}>
<NotificationIconButton
ref={buttonRef}
onClick={() => setIsOpen(!isOpen)}
/>
<NotificationFeedPopover
buttonRef={buttonRef}
isVisible={isOpen}
onClose={() => setIsOpen(false)}
/>
</KnockFeedProvider>
</KnockProvider>
)
}KnockProvider accepte, entre autres, apiKey, user, userToken, onUserTokenExpiring, timeBeforeExpirationInMs, host, i18n, logLevel, branch et enabled, qui vaut true par défaut. L'ancienne propriété userId est marquée obsolète au profit de user. Les peer dependencies du paquet sont React 17, 18 et 19 avec react-dom, tandis que Next.js dans la plage 13 à 16 et @tanstack/react-router version 1 sont marqués comme optionnels dans peerDependenciesMeta. Ses dépendances ordinaires incluent le design system de Knock lui-même, les paquets @telegraph/*, dans des plages ouvertes comme >=0.8.0, plus lucide-react en ^0.544.0. Des plages ouvertes sur une bibliothèque de composants signifient qu'une nouvelle version peut entrer dans ton build sans aucun changement de ta part, donc un lockfile cesse d'être une formalité.
Erreurs fréquentes
Traiter Knock comme un fournisseur d'envoi. Knock donne des instructions, il n'envoie pas. Un compte chez Postmark, Resend ou Twilio reste nécessaire et tu paies deux factures, ce que les estimations de coût ont tendance à oublier.
Budgéter en notifications plutôt qu'en messages. Une notification livrée par e-mail, push et feed fait trois lignes sur la facture, pas une.
Déclencher sans cancellation_key. La clé ne peut pas être ajoutée plus tard, et sans elle workflows.cancel n'a rien à annuler, donc le scénario courant « ne pas envoyer le rappel si l'utilisateur est déjà revenu » n'est plus disponible.
Confondre settings.sandbox_mode avec le réglage du canal. Le champ du déclenchement remplace le mode sandbox pour tous les canaux de cette seule exécution et ne modifie pas la configuration propre du canal.
Éditer dans le dashboard sans knock pull. Quelqu'un corrige un template dans le navigateur, le dépôt prend du retard, et reconstruire l'environnement restaure la version d'avant la correction. Si tu décides de garder les workflows dans le dépôt, le sens doit être unique.
Installer sans lockfile alors que les dépendances @telegraph/* sont dans des plages ouvertes. Et une entrée disant « toute la famille @knocklabs est sous MIT » dans un inventaire de licences sera tout simplement fausse pour les paquets serveur.
FAQ
Knock remplace-t-il Resend ou Postmark ?
Non. Knock est une couche au-dessus des fournisseurs et exige ton propre compte de fournisseur branché dans une configuration de canal. Postmark et Resend figurent tous deux sur sa liste de fournisseurs d'e-mail pris en charge, donc il y a deux factures : les messages chez Knock et les e-mails chez le fournisseur.
Les workflows peuvent-ils être gardés dans le dépôt ?
En partie. @knocklabs/cli récupère les workflows avec knock workflow pull dans des répertoires contenant workflow.json et des templates, et knock push les renvoie. La limitation est que push et commit ne fonctionnent que dans l'environnement development, et tout ce qui va au-delà passe par knock commit promote --to.
Pourquoi deux paquets Knock portent-ils deux licences différentes ?
Parce qu'ils viennent de dépôts différents. @knocklabs/node, du dépôt knock-node, est sous Apache 2.0, confirmé dans le champ npm, dans le fichier LICENSE et dans le tarball publié. @knocklabs/react, du monorepo javascript, est sous MIT, sauf que le tarball ne contient aucun fichier de licence, car son champ files ne couvre que dist et README.md.
Combien coûte le service de dix mille utilisateurs ?
À cinq notifications par utilisateur et par mois sur deux canaux, tu atteins 100 000 messages : 250 USD pour le plan Starter plus 250 USD pour les 50 000 messages au-delà de l'allocation, soit 500 USD, plus la facture du fournisseur d'e-mail. À trois notifications sur un seul canal, tu restes dans l'allocation Starter et tu paies 250 USD.
Quand Knock est-il excessif ?
Quand tu as un seul canal, des notifications transactionnelles envoyées immédiatement et aucune préférence côté utilisateur. Le batching, le throttling et la résolution des préférences n'ont alors aucune application, tandis que la couche ajoute du coût, de la latence et de la logique qui vit hors du dépôt.
Sources : tarifs de Knock, liste des intégrations, le monorepo javascript.