# Datoka Hooks pour n8n autohébergé Le paquet `n8n-nodes-datoka-hooks-0.1.1.tgz` ajoute **Send Event** et **Get Delivery** à n8n. Il utilise un hook existant déjà vérifié. Aucun abonnement, compte ou achat de crédits n'est créé par ce connecteur. ## Installer Télécharger le paquet depuis la page [Exemples Hooks](https://datoka-hooks.bhazarstudio.workers.dev/examples). Dans le répertoire des nœuds de votre instance, avec le compte qui exécute n8n : ```sh mkdir -p ~/.n8n/nodes cd ~/.n8n/nodes npm install /chemin/n8n-nodes-datoka-hooks-0.1.1.tgz ``` Redémarrer n8n selon votre installation. Dans un conteneur, le paquet doit être accessible à l'intérieur et le répertoire des nœuds conservé dans son stockage persistant. Le paquet est distribué ici pour installation locale ; aucune publication npm ou certification n8n n'est revendiquée. ## Configurer le workflow Importer `workflow.json`. Il est inactif, ne contient aucun secret et n'a pas de déclencheur public. L'identifiant d'événement vide empêche un envoi accidentel. 1. Créer les credentials **Datoka Hooks API** avec le `hookId` et le jeton d'envoi `token` du fichier d'accès privé. Ne pas utiliser le jeton de gestion ou opérateur. 2. Sélectionner ces credentials dans **Send Saved Event** et **Get Delivery**. 3. En amont, sauvegarder l'identifiant métier et le texte JSON exact de l'événement. Renseigner ces valeurs dans **Send Saved Event**, ou brancher votre source métier. Ne pas utiliser un UUID neuf, l'heure ou l'identifiant d'exécution n8n pour une reprise. 4. Exécuter le workflow : il envoie une fois, attend cinq secondes, puis consulte le `deliveryId` retourné. La dernière étape est une seule consultation. Si l'état est encore `queued`, `sending`, `accepting` ou `recording`, conserver le `deliveryId` et effectuer un autre **Get Delivery** plus tard. Un état `delivered` est une observation HTTP du relais, pas une preuve de succès métier chez le destinataire. `failed` exige d'examiner la livraison. ## Reprendre sans dupliquer - Réponse d'envoi perdue : rejouer l'identifiant **et les octets JSON d'origine**. Ne pas recréer l'événement. - Acceptation connue : suivre par GET avec le `deliveryId`. Le connecteur ne sauvegarde pas lui-même une boîte d'envoi persistante. - Conflit 409 : examiner les données sauvegardées ; ne pas changer l'identifiant pour contourner le conflit. - Quota 429 : attendre le délai indiqué avant de reprendre. **Retry On Fail** est désactivé dans le workflow fourni. Aucun achat automatique n'est effectué. - Les étapes d'envoi et de suivi s'arrêtent sur une erreur. Une reprise en boucle, une planification ou une stratégie de stockage durable doivent être configurées explicitement dans votre propre workflow. Les sorties ne recopient pas les credentials ni le payload. n8n peut conserver les données d'entrée dans ses exécutions ; régler la rétention et les accès selon votre usage. ## English Self-hosted n8n node package. Install the local TGZ in the instance's nodes directory, restart, import the inactive workflow, then select your hook credentials on both Datoka nodes. Persist a stable business-event ID and the exact JSON string before submitting. The workflow sends once, waits five seconds and retrieves status once. Continue polling with the saved delivery ID if pending. Disable automatic retries, respect quota delays and never change an uncertain event's ID or bytes. No credits are purchased. This package is not n8n-certified or published to npm. ## Qualification Workflow exécuté via la CLI n8n 2.41.7 sous Node 24.19.0 : import des credentials et du workflow, envoi/attente/suivi, quota, conflit et blocage avant réseau de l'identifiant vide. Les échanges HTTP de cette qualification sont simulés et les credentials fictifs. Le connecteur possède aussi un scénario validé contre le Worker Hooks local. L'interface web n8n n'a pas été testée ; aucune certification n'est revendiquée.