Aller au contenu principal
Deel

Deel webhooks avec Odoo : signature, événements, nouvelles tentatives et rôle du connecteur

Deel peut envoyer un webhook quand un paiement, une fiche de paie ou un contrat change, et il signe chaque avis avec HMAC-SHA256. Le connecteur Deel de FlexigoTech se sert de ces avis comme d'une sonnette : il vérifie la signature, note ce qui a sonné et relit la donnée par l'API. Il repasse aussi sur tout toutes les 30 minutes : la liste d'événements de Deel du 18-11-2026, par exemple, n'en a aucun pour une facture émise.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 18 novembre 2026

L'essentiel

Module
Deel
Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du connecteur, version 20.0 · dans les sources citées à la fin
Lecture
7 min

Comment Deel prévient

Quand quelque chose se passe dans le compte, Deel envoie un POST à l'adresse du webhook avec un JSON qui porte le type d'événement dans data.meta.event_type, l'organisation, la ressource modifiée et l'heure. Chaque livraison a trois en-têtes : x-deel-signature, avec la signature ; x-deel-hmac-label, qui indique quelle clé de signature a servi ; et x-deel-webhook-version. Les webhooks se créent par l'API, avec POST /webhooks, ou dans l'onglet Webhooks du Developer Center, et il faut pour cela être Org Admin ou IT Developer Admin dans Deel. Un webhook créé dans le sandbox ne reçoit que les événements du sandbox.

Comment la signature est vérifiée

Deel calcule un HMAC-SHA256 du mot POST suivi du corps tel qu'il arrive, avec la clé de signature du webhook, et demande de le vérifier avant tout traitement. Cette clé (signing_key), Deel la renvoie à la création du webhook, et il la génère lui-même si on ne lui en donne pas. Ses exemples de code produisent la signature en hexadécimal.

Le contrôleur du connecteur fait le même calcul avec la clé enregistrée sur la connexion, le compare à x-deel-signature en temps constant et répond ainsi :

Ce qui arrive à OdooRéponse
Signature valide200, avec l'événement noté dans la file
Pas de signature ou une signature fausse401
Un token d'adresse inconnu ou un webhook désactivé dans Odoo404
Un corps de plus de 1 Mo413

Contrairement au token de l'API, que conserve FlexigoTech Cloud, la clé de signature reste dans Odoo, sur la connexion, dans un champ réservé aux administrateurs. Les tests du module vérifient la signature avec le calcul de l'exemple Python de Deel, et la création et la suppression du webhook ont été testées contre l'organisation de démonstration de Deel.

Quels événements existent

La page des événements de Deel parle de plus de 100 (« 100+ Events ») et renvoie, pour la liste complète, à GET /webhooks/events/types, qui demande la permission webhooks:read. L'index de sa référence de l'API, copié le 18-11-2026, compte 56 événements avec leur propre page. Cette liste n'a aucun événement de facture émise ni de rapport brut-net : pour les factures, il n'y a que les ajustements (Invoice Adjustment Created, Pending For Approval et Reviewed) ; pour la paie, ceux des fiches de paie disponibles de Global Payroll et d'EOR et celui d'un document de paie supprimé ; et pour les paiements, le relevé lancé et le relevé marqué comme payé.

Le connecteur s'abonne à 12 de ces événements, et chacun lui indique seulement quelle partie de la synchronisation lancer :

Événements de DeelCe que le connecteur relit
payment.statement.initiated, payment.statement.mark-paidLes paiements
invoice-adjustment.created, invoice-adjustment.reviewed, eor.payslips.availableLes factures
gp.payslips.availableLa paie Global Payroll
contract.created, contract.status.updated, contract.terminated, worker.v2.created, worker.v2.updated, worker.v2.deletedLes personnes et les contrats

Un événement que le connecteur ne connaît pas est noté et marqué comme traité sans rien lancer.

Nouvelles tentatives et désactivation, selon Deel

Si l'adresse ne répond pas avec un 2xx, ou met plus de 30 secondes, Deel compte un échec et réessaie après des attentes de 1, 2, 4, 8, 16 et 32 minutes, puis de 1, 2 et 4 heures, et une dixième fois après 16 heures. Après 10 échecs d'affilée, il désactive l'abonnement, qu'il faut alors réactiver à la main, par l'API ou dans le Developer Center. Deel demande de répondre 200 en moins de 30 secondes, idéalement en moins de 5, et prévient qu'un même événement peut arriver plus d'une fois.

Le connecteur répond dès qu'il a noté l'événement ; la synchronisation vient après, dans la file. Dans Odoo, Webhook actif ne se décoche qu'avec Supprimer le webhook ou avec Déconnecter, et le connecteur ne demande pas à Deel dans quel état est le webhook. Si Deel le désactive après 10 échecs, par exemple parce qu'Odoo était en panne, Odoo continuera de le voir actif : on le réactive dans le Developer Center de Deel, ou on le supprime et on l'enregistre de nouveau depuis Odoo. En attendant, la synchronisation toutes les 30 minutes continue d'apporter les mêmes données. Pour savoir ce qu'est devenue chaque livraison, chaque webhook a dans le Developer Center un onglet Logs avec le code renvoyé par votre Odoo ; un 401 à cet endroit renvoie à la signature.

Ce que fait le connecteur quand ça sonne

Deel appelle directement votre Odoo, à une adresse https qui porte un token aléatoire propre à chaque connexion, si bien que FlexigoTech Cloud n'est pas au milieu de la livraison. Passent par FlexigoTech Cloud la création et la suppression du webhook et les lectures qui suivent. Avec une signature valide, Odoo note dans la file le type d'événement, sans prendre le contenu pour une donnée, et réveille la tâche Deel : file d’attente des webhooks, qui tourne aussi toute seule toutes les heures. Cette tâche regarde quelles parties ont sonné pour chaque connexion et lance chacune une seule fois, même si plusieurs avis sont arrivés, en relisant les données chez Deel par l'API.

Fiche de la connexion Deel dans Odoo avec les boutons Tester la connexion, Synchroniser maintenant et Déconnecter, l'environnement Production et le texte de FlexigoTech Cloud, qui cite les webhooks parmi les appels à Deel
La connexion Deel dans Odoo, avec le texte de FlexigoTech Cloud qui cite les webhooks parmi les appels à Deel (organisation inventée, données de démonstration).

Comment le créer depuis Odoo

Dans l'onglet Webhooks de la connexion, un administrateur clique sur Enregistrer le webhook. Le bouton n'apparaît que si la connexion n'est plus à Non connecté (le token est déjà enregistré) et que le webhook n'est pas actif, et il faut en plus :

  • qu'Odoo soit en https, sinon le connecteur s'arrête et rappelle que « La synchronisation planifiée continue de fonctionner sans webhooks. » ;
  • que le token ait webhooks:write, la permission que Deel demande pour créer et pour supprimer un webhook ; avec un token en lecture seule, Deel répond 403 ou 401, selon son guide d'authentification. Avec un 403, le connecteur affiche le motif donné par Deel ; avec un 401, il indique que Deel a refusé le token et demande d'en enregistrer un nouveau, même s'il ne manque au token que cette permission.

Le connecteur envoie à Deel un nom qui commence par Odoo, l'adresse, les 12 événements du tableau et la version v2 de l'API, et enregistre l'identifiant et la clé de signature que Deel renvoie. Si tout va bien, il affiche : « Deel appellera Odoo lorsqu’un paiement, une fiche de paie ou un contrat changera. » Supprimer le webhook le supprime chez Deel, et Déconnecter aussi, si le service FlexigoTech Cloud est actif.

Paramètres de FlexigoTech Cloud dans Odoo avec la carte du connecteur Deel en essai, avec son prix et le texte qui dit qu'il maintient la connexion avec la plateforme via FlexigoTech Cloud
Le connecteur Deel dans les paramètres de FlexigoTech Cloud, en essai (données de démonstration).

Pourquoi il repasse aussi toutes les 30 minutes

Deel recommande de ne pas compter uniquement sur les webhooks et de faire des rapprochements réguliers. Le connecteur le fait avec la tâche Deel : synchroniser les contrats, factures, paiements, paies et centres de coût, qui tourne toutes les 30 minutes, avec ou sans webhooks. Et il y a des raisons, du côté de Deel, de la garder : sa liste n'a pas d'événement de facture émise, donc les nouvelles factures arrivent avec ce passage ; un webhook que Deel désactive ne prévient pas Odoo ; et un Odoo sans https ne peut pas en recevoir. Avec les webhooks, un paiement, une fiche de paie ou un contrat arrive dès que Deel prévient ; sans eux, au passage suivant.

Ce qui a été testé

Contre l'organisation de démonstration de Deel (demo.deel.com), via FlexigoTech Cloud, ont été testés la connexion, les entités légales, un contrat avec sa personne et son fournisseur, les webhooks et un second passage sans doublons. Factures, paiements et cycles de paie ont été testés avec des réponses construites d'après la référence de l'API Deel, car cette organisation n'en avait pas encore. Le connecteur fonctionne sur Odoo 17, 18, 19 et 20, sur votre serveur ou sur Odoo.sh, et pas sur Odoo Online. Le token et ses permissions sont dans le guide du Deel API token, et ce qui arrive en facture fournisseur, dans Deel invoice. Le connecteur est expliqué en entier sur sa page et publié sur Odoo Apps.

À lire aussi

Deel API token pour Odoo : le créer, lui donner ses droits et le collerComment créer le token d'organisation Deel, quelle permission Deel demande pour chaque appel du connecteur, où le coller dans Odoo et où il part ensuite.Deel invoice dans Odoo : de la facture Deel à la facture fournisseurCe que contient une Deel invoice de prestataire, d'EOR ou de frais Deel, et comment elle arrive dans Odoo en facture fournisseur, avec sa TVA et son PDF.
Vérifié dans le code du connecteur (version 20.0) et dans les sources citées

Sources