➜︎ Retour - Menu API, webhooks et mailhooks

Les webhooks Client

Menu de la documentation

API

Démarrer Rechercher un client Lister les clients Créer un client Modifier un client La fiche client en JSON Les erreurs OpenAPI et Postman

Webhooks et mailhooks

Fonctionnement Vente : validation Article : stock mis à jour Les webhooks Client

Cette page décrit les webhooks Client, qui se règlent dans le menu
Réglages → API & Make, vue Webhooks.

Ces webhooks préviennent votre application quand une fiche client est créée ou modifiée dans Melkal. Pour les activer, saisissez une URL sur la ligne de l'événement (voir Webhooks et mailhooks : fonctionnement pour l'URL, la clé et les en-têtes).

Ils ne passent pas par la file d'attente des webhooks « Vente » et « Stock » : l'envoi est fait directement, en une seule tentative, sans relance. Si votre application ne répond pas à ce moment-là, l'événement est perdu. Pour ne rien manquer, complétez-les avec une extraction régulière par l'API (Lister les clients, filtrés par date de modification).

Les événements#

Événement (colonne « Nom »)	Quand il part	Ce qui est envoyé
Client : création	Quand on quitte la fiche d'un client qui vient d'être créé, ou tout de suite pour une création rapide (email seul) ou une vente sans afficher la fiche.	La fiche complète
Client : modification de tout élément de la fiche	Quand on quitte la fiche d'un client dont un élément a été modifié.	La fiche complète
Client : modification ou ajout d'un lien social (Email, Mobile/WhatsApp, Instagram, TikTok, Facebook)	À chaque modification, ajout ou suppression d'un de ces contacts.	Le contact, avec l'ancienne valeur
Client : modification du descriptif, des notes 1 à 6	À chaque modification de ce texte.	Le nouveau et l'ancien texte

Rien n'est envoyé pendant qu'une création de fiche est en cours : le webhook de création part à la fin.

La fiche complète (création, modification)#

Le JSON est la fiche client, avec les mêmes propriétés que celles décrites dans La fiche client en JSON, plus les propriétés ean (le code-barre interne), facebook, x, insta et tiktok (les identifiants sur ces réseaux).

Un contact (email, mobile, Instagram, TikTok, Facebook)#

{
  "nouveau": "achats@dupont-sarl.fr",
  "type": "EMAIL",
  "id": 9001,
  "optIn": true,
  "prenomMembre": "MARTIN",
  "remarques": "",
  "ancien": "m.dupont@ancienne-adresse.fr",
  "statut": "modifie",
  "client": {
    "nom": "DUPONT",
    "prenom": "MARTIN",
    "code": "312",
    "id": 312,
    "ean": "80003128",
    "uuid": "38D13BD6-4836-4115-B829-B55AC2537B09",
    "entreprise": "Dupont Services"
  }
}

Propriété	Type	Explications
statut	string	"cree", "modifie", "supprime" ou "cree/modifie".
nouveau	string	Le contact après la modification. Absente si le contact est supprimé.
ancien	string	Le contact avant la modification, vide pour un ajout.
id	integer	L'identifiant du contact.
type	string	Le type de contact. Absente si le contact est supprimé.
optIn	boolean	true si le client accepte la publicité par ce contact. Absente si le contact est supprimé.
prenomMembre	string	Le prénom du membre de la fiche concerné. Absente si le contact est supprimé.
remarques	string	Les remarques sur le contact. Absente si le contact est supprimé.
client	object	Le client concerné : voir ci-dessous.

Le descriptif et les notes#

{
  "nouveau": "Préfère être appelé le matin.",
  "ancien": "",
  "client": {
    "nom": "DUPONT",
    "prenom": "MARTIN",
    "code": "312",
    "id": 312,
    "ean": "80003128",
    "uuid": "38D13BD6-4836-4115-B829-B55AC2537B09",
    "entreprise": "Dupont Services"
  }
}

Propriété	Type	Explications
nouveau	string	Le texte après la modification.
ancien	string	Le texte avant la modification.
client	object	Le client concerné : voir ci-dessous.

client : le client concerné#

Présent dans les envois d'un contact et d'un texte.

Propriété	Type	Explications
id	integer	L'identifiant du client dans Melkal.
code	string	Le numéro (code) du client.
uuid	string	L'UUID du client.
ean	string	Le code-barre interne du client.
nom prenom	string	Le nom et le prénom.
entreprise	string	L'entreprise.

← PrécédentArticle : stock mis à jour

Dernière mise à jour : 13 octobre 2026

Retour - Sommaire - Centre d'aide - Assistance