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 à Odoo | Réponse |
|---|---|
| Signature valide | 200, avec l'événement noté dans la file |
| Pas de signature ou une signature fausse | 401 |
| Un token d'adresse inconnu ou un webhook désactivé dans Odoo | 404 |
| Un corps de plus de 1 Mo | 413 |
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 Deel | Ce que le connecteur relit |
|---|---|
payment.statement.initiated, payment.statement.mark-paid | Les paiements |
invoice-adjustment.created, invoice-adjustment.reviewed, eor.payslips.available | Les factures |
gp.payslips.available | La paie Global Payroll |
contract.created, contract.status.updated, contract.terminated, worker.v2.created, worker.v2.updated, worker.v2.deleted | Les 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.

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.

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
Vérifié dans le code du connecteur (version 20.0) et dans les sources citées
Sources
- developer.deel.com/api/webhooks/introduction
- developer.deel.com/api/webhooks/quickstart
- help.letsdeel.com/hc/en-gb/articles/10660690287761-How-To-Create-And-Manage-Webhooks-Notif
- developer.deel.com/api/webhooks/no-code
- developer.deel.com/api/endpoints/webhooks/create-webhook
- developer.deel.com/api/endpoints/webhooks/delete-webhook
- developer.deel.com/api/webhooks/events
- developer.deel.com/api/stable/llms.txt
- developer.deel.com/api/endpoints/webhooks/get-webhook-events
- Code du module : flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Code du module : flexigo_deel_connector 20.0 (18442307): controllers/main.py
- Code du module : flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- Code du module : flexigo_deel_connector 20.0 (18442307): static/description/index.html
- Code du module : flexigo_deel_connector 20.0 (18442307): tests/test_webhook.py
- developer.deel.com/api/authentication
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
- Code du module : flexigo_deel_connector 20.0 (18442307): views/deel_account_views.xml
