➜︎ Retour - Menu API & Make
Webhooks
Cette page décrit la vue "Webhooks" de la fenêtre "API & Make", accessible via le menu
Réglages → API & Make.
Un webhook est une adresse (une URL) que Melkal appelle automatiquement, en lui envoyant les données,
dès qu'un élément est créé ou modifié dans Melkal. Un service comme Make ou une application à vous peut ainsi réagir
aussitôt, sans avoir à interroger Melkal. Chaque ligne de la liste correspond à un événement de Melkal.
Réglages → API & Make.
La liste
La liste est une grille comme celles de la fiche client : les titres de colonne se cliquent pour trier, les trois points ouvrent le menu de la colonne (filtre, colonnes affichées, export), et la case de recherche d'une colonne filtre la liste. Les cases à fond jaune pâle sont celles où vous tapez : double-cliquez dessus, modifiez, puis validez avec Entrée ou en cliquant ailleurs. La case modifiée s'éclaire en vert quand Melkal l'a prise en compte, et en rouge s'il l'a refusée (elle reprend alors son ancienne valeur).| Colonne | Explications |
|---|---|
| Nom | L'événement de Melkal concerné (par exemple la création d'un client). Cette colonne ne se modifie pas. |
| URL | L'adresse à laquelle Melkal envoie les données. Elle doit commencer par https://, sinon Melkal la refuse. Pour désactiver un webhook, supprimez son URL. |
| Clé | Facultative. Si vous voulez ne répondre qu'aux requêtes qui viennent bien de Melkal, indiquez une clé : Melkal l'envoie dans l'en-tête HTTP cleApi de chaque requête, et votre application peut la vérifier. Sans clé, l'en-tête cleApi contient simplement « Melkal ». |
Ne gardez que des URL valides, dont vous vous servez réellement : une application devra répondre à chaque envoi de données. L'interrupteur général « Webhooks activés » est dans Clé et adresse de l'API. Pour envoyer des données par un clic plutôt qu'automatiquement, voir les webhooks manuels. Le fonctionnement des envois (délai, relances, doublons) est expliqué dans Webhooks et mailhooks : fonctionnement. Le contenu des webhooks Vente : validation et Article : stock mis à jour est détaillé propriété par propriété.