TenkaTenka
Se connecter

Centre d’aide Tenka › Plateforme et sécurité › Webhooks (intégrations sortantes)

Webhooks (intégrations sortantes)

Avertissez VOS systèmes quand quelque chose se produit ici : facture payée, proposition acceptée, affaire gagnée, demande créée et lead créé — livrés par HTTP avec signature.

🕒 Mis à jour le 30 sept. 2026📖 ~2 min de lecture

Ce que vous trouvez sur cet écran

Un portrait de l’écran, lu depuis l’écran lui-même — il change quand l’écran change.

Actions disponibles

Envoyer un événement test

La liste affiche

ÉvénementStatutTentativeQuand

Champs du formulaire

DescriçãoPara você reconhecer a integração (ex.: ERP do cliente).
URL de destino*Endpoint HTTPS que receberá o POST com o corpo em JSON.
Ativo

Commencez ici

À quoi ça sert
Intégration en temps réel sans polling : enregistrez une URL à vous et choisissez les événements. Quand l'événement se produit, nous envoyons un POST avec le JSON de ce qui s'est passé.
Les webhooks en liste, les livraisons en haut
La liste montre chaque webhook avec la description, l’URL, les événements, le secret masqué et s’il est actif. En haut, les dernières livraisons — événement, statut, code HTTP, tentative et date — et le bouton Envoyer un test, qui met en file un ping vers tous les abonnements actifs.

Règles

Sécurité (signature HMAC)
Chaque abonnement a un secret (whsec_...). Chaque envoi part avec l'en-tête X-Tenka-Signature (HMAC-SHA256 du corps) — validez-le sur votre serveur avant de faire confiance au contenu.
Livraison et renvoi
Ça a échoué (timeout/5xx) ? La file d'attente renvoie avec un délai progressif. Les dernières livraisons apparaissent à l'écran avec leur statut — utilisez le bouton Tester pour valider votre URL.
Événements disponibles
fatura.paga, proposta.aceita, negocio.ganho, demanda.criada et lead.criado. Le catalogue montre seulement ce qui se déclenche réellement — sans promesse vide.
Secret et événements sur la fiche
Sur la fiche, le secret signe le corps de chaque livraison (en-tête X-Tenka-Signature, HMAC) : validez-le de votre côté pour garantir l’origine. Vide, Tenka en génère un ; le bouton à côté en génère un autre. Dans Événements, laissez « Tous » ou choisissez lesquels déclenchent — au moins un.
Supprimer retire l’abonnement
Un webhook ne va pas à la corbeille : la suppression retire l’abonnement et votre système cesse aussitôt de recevoir les événements. Pour mettre en pause sans perdre la configuration, décochez Actif.

Questions fréquentes

Bonnes pratiques
Répondez 2xx rapidement (traitez de façon asynchrone de votre côté) ; gérez les doublons par l'id de l'événement (les livraisons peuvent se répéter lors d'un nouvel essai).
Cet article vous a-t-il été utile ?

Dans le même module: Plateforme et sécurité38

Académie Tenka

Des parcours d'apprentissage pour votre secteur, pas à pas, dans la plateforme.

Découvrir l'Academia