Chaque webhook reçoit une enveloppe { id, name, occurredAt, storeId, actor, payload } (voir
Ce que KiwiDesk envoie ). Cette page décrit
le payload de chaque événement. Les noms suivent la forme <domaine>.<objet>.<verbe au passé>.
Conventions des champs : les identifiants sont des UUID, les montants des entiers en centimes
(...Cents), les dates des chaînes ISO 8601 en UTC. Un champ | null peut valoir null.
"id" : " 01a1f6a2-3c4d-7e5f-8a9b-0c1d2e3f4a5b " ,
"name" : " repair.ticket.status_changed " ,
"occurredAt" : " 2026-11-20T08:20:00.000Z " ,
"storeId" : " 01a1bafb-6510-738f-98da-85c97912cce8 " ,
"actor" : { "userId" : " 01a1bafb-5d70-76d8-9d73-7b5aa8a4e504 " , "apiKeyId" : null , "ipAddress" : " 192.0.2.10 " },
"ticketId" : " 01a1f66e-8ee0-71d2-92fb-a88b1629ab6a " ,
"ticketNumber" : " REP-2026-0215 " ,
"customerId" : " 01a1f66d-f0ce-7051-8be1-2b9967d3e9b2 " ,
"fromStatus" : " IN_REPAIR " ,
"toStatus" : " READY_FOR_PICKUP " ,
Événement
Libellé
Payload
core.store.created
Une boutique a été créée.
storeId, code, name
core.store.updated
Une boutique a été modifiée.
storeId, changedFields (noms des champs modifiés)
core.customer.created
Un client a été créé.
customerId, type (INDIVIDUAL ou BUSINESS), displayName
core.customer.updated
Un client a été modifié.
customerId, changedFields
core.customer.anonymized
Les données personnelles d’un client ont été purgées (droit à l’oubli RGPD).
customerId
core.customer.deleted
Un client sans pièce comptable a été supprimé définitivement.
customerId
core.device.created
Un appareil client a été enregistré.
deviceId, customerId, imei | null, serialNumber | null
core.device.transferred
Un appareil a été transféré à un autre client.
deviceId, fromCustomerId, toCustomerId
Quand vous recevez core.customer.anonymized ou core.customer.deleted, effacez de votre côté
les données personnelles de ce client : c’est votre part du droit à l’oubli.
Événement
Libellé
Payload
repair.ticket.created
Un ticket de réparation a été créé.
ticketId, ticketNumber, customerId, deviceId, status, priority, assignedTechnicianId | null
repair.ticket.status_changed
Le statut d’un ticket de réparation a changé.
ticketId, ticketNumber, customerId, fromStatus | null, toStatus, comment | null
repair.ticket.assigned
Un ticket a été (ré)attribué à un technicien.
ticketId, ticketNumber, previousTechnicianId | null, assignedTechnicianId | null
repair.ticket.ready_for_pickup
Un appareil réparé est prêt à être récupéré.
ticketId, ticketNumber, customerId, totalCents, depositCents, currency
repair.ticket.completed
Un appareil a été restitué à son propriétaire.
ticketId, ticketNumber, customerId, deviceId, outcome, netCents, taxCents, totalCents, depositCents, currency, completedAt
repair.ticket.cancelled
Un ticket de réparation a été annulé.
ticketId, ticketNumber, customerId, reason | null
repair.appointment.booked
Un rendez-vous a été pris (en ligne ou au comptoir).
Voir Rendez-vous
repair.appointment.reminder_due
Le rappel d’un rendez-vous est à envoyer.
Voir Rendez-vous
status, fromStatus, toStatus : WAITING_DEVICE_DROP_OFF, RECEIVED, DIAGNOSING,
WAITING_CUSTOMER_APPROVAL, WAITING_PARTS, IN_REPAIR, TESTING_QA, READY_FOR_PICKUP,
COMPLETED, UNREPAIRABLE, CANCELLED (voir Statuts ).
priority : LOW, NORMAL, HIGH, URGENT.
outcome de completed : REPAIRED (réparé), UNREPAIRABLE (déclaré irréparable),
NOT_REPAIRED (rendu sans réparation, devis refusé).
Un passage à « Prêt à récupérer » envoie deux événements : status_changed et
ready_for_pickup (qui porte les montants). Abonnez-vous à celui qui vous sert.
Les deux événements de rendez-vous portent le même payload, avec des données personnelles :
Champ
Contenu
appointmentId, reference
Identifiant et référence lisible du rendez-vous
source
ONLINE (page de prise de rendez-vous) ou STAFF
status
REQUESTED ou CONFIRMED
startsAt
Début (ISO 8601)
firstName, lastName, phone, email | null
Coordonnées saisies
storeName, dateLabel, timeLabel
Libellés prêts à afficher ("vendredi 13 novembre", "14:30"), dans le fuseau de la boutique
cancelUrl | null
Lien privé d’annulation pour le client
customerId | null, ticketId | null
Fiche client et ticket liés, s’il y en a
Événement
Libellé
Payload
billing.quote.sent
Un devis a été numéroté et envoyé au client.
quoteId, quoteNumber, customerId, repairTicketId | null, totalCents, currency
billing.quote.accepted
Un devis a été accepté par le client.
idem quote.sent
billing.invoice.issued
Une facture ou un ticket de caisse a été émis (numéroté et scellé).
invoiceId, invoiceNumber, type, customerId | null, repairTicketId | null, netCents, taxCents, totalCents, depositsDeductedCents, ticketDepositDeltaCents, currency, issuedAt
billing.invoice.paid
Une facture a été entièrement réglée.
invoiceId, invoiceNumber, type, customerId | null, repairTicketId | null, totalCents, currency
billing.invoice.reminder_due
Une relance de facture impayée est à envoyer.
invoiceId, invoiceNumber, customerId, amountDueCents, dueDate (YYYY-MM-DD), level (1 pour la première), manual, currency
billing.payment.recorded
Un règlement a été encaissé ou un remboursement versé.
paymentId, direction (IN encaissé, OUT remboursé), invoiceId | null, creditNoteId | null, customerId | null, method, amountCents, currency
billing.credit_note.issued
Un avoir a été émis sur une facture.
creditNoteId, creditNoteNumber, invoiceId, invoiceNumber, invoiceType, customerId | null, repairTicketId | null, totalCents, isFullCancellation, ticketDepositDeltaCents, currency
billing.cash_session.closed
Une caisse a été clôturée (Z).
sessionId, cashRegisterId, cashRegisterCode, zNumber, grandTotalCents, cashDifferenceCents, currency
type et invoiceType : STANDARD, DEPOSIT (facture d’acompte), FINAL (facture de solde
d’une réparation), POS_RECEIPT (ticket de caisse).
method : CASH, CARD_TPE, BANK_TRANSFER, CHECK, CUSTOMER_CREDIT, GIFT_CARD,
REPAIR_BONUS (part payée par le bonus réparation), OTHER.
ticketDepositDeltaCents : variation de l’acompte détenu sur le ticket (montant d’une facture
d’acompte, négatif pour un avoir qui l’annule, 0 sinon).
Événement
Libellé
Payload
communications.message.received
Un client a envoyé un message (SMS, e-mail ou discussion).
messageId, threadId, channel, customerId | null, contextType | null, contextId | null, preview (début du message)
communications.message.status_changed
Le statut d’envoi d’un message a changé (envoyé, distribué, en échec).
messageId, threadId, channel, status, errorMessage | null
channel : SMS, EMAIL, LIVE_CHAT.
status : QUEUED, PROPOSED, WAITING_PHONE_PICKUP, SENDING, SENT, DELIVERED, READ,
FAILED, CANCELLED.
contextType vaut REPAIR_TICKET quand le message est rattaché à un ticket (contextId).
Événement
Libellé
Payload
inventory.item.created
Article créé
itemId, sku, name, kind (PART, ACCESSORY, CONSUMABLE, PRODUCT), isSellable
inventory.item.updated
Article modifié
itemId, changedFields
inventory.item.archived
Article archivé
itemId, sku
inventory.stock.changed
Quantité modifiée
storeId, itemId, sku, movementId, movementType, quantity (signée), onHand, reserved, available, status
inventory.stock.low
Seuil d’alerte atteint ou rupture
storeId, itemId, sku, name, available, reorderPoint, status
inventory.purchase_order.ordered
Commande fournisseur envoyée
purchaseOrderId, number, storeId, supplierId, lineCount, totalCents
inventory.purchase_order.received
Commande fournisseur réceptionnée
purchaseOrderId, number, storeId, supplierId, quantity (unités de cette réception), status
inventory.transfer.sent
Transfert envoyé
transferId, number, fromStoreId, toStoreId, quantity
inventory.transfer.received
Transfert réceptionné
idem transfer.sent
inventory.count.completed
Inventaire terminé
countId, number, storeId, countedLines, varianceUnits, varianceValueCents (écarts signés)
status du stock : IN_STOCK, LOW, OUT.
movementType : INITIAL, PURCHASE_RECEIPT, MANUAL_IN, MANUAL_OUT, ADJUSTMENT, LOSS,
SALE, SALE_RETURN, REPAIR_CONSUMPTION, REPAIR_RETURN, REFURB_CONSUMPTION,
TRANSFER_OUT, TRANSFER_IN, HARVEST_IN, RELOCATION.
Commande fournisseur, status : DRAFT, ORDERED, PARTIALLY_RECEIVED, RECEIVED, CLOSED,
CANCELLED.
inventory.stock.changed est fréquent (une vente, une pièce posée…) : pour synchroniser un site
marchand, préférez-le à une lecture complète du stock, et gardez available comme quantité
vendable.
Événement
Libellé
Payload
refurbishing.unit.created
Appareil reconditionné enregistré
unitId, number, storeId, acquisitionType, deviceLabel
refurbishing.unit.status_changed
Statut d’un appareil reconditionné modifié
unitId, number, storeId, fromStatus, toStatus, comment | null
refurbishing.buyback.completed
Appareil racheté à un particulier
buybackId, number, storeId, unitId, customerId, type (BUYBACK ou TRADE_IN), priceCents, paymentMethod
refurbishing.warranty.claim_opened
Retour SAV ouvert sur un appareil reconditionné
claimId, number, unitId, unitNumber, customerId | null
refurbishing.warranty.claim_resolved
Retour SAV clôturé
claimId, number, unitId, resolution (REPAIR, EXCHANGE, REFUND, REJECTED)
acquisitionType : BUYBACK, SUPPLIER, TRADE_IN, ABANDONED, OTHER.
Statuts d’un appareil : RECEIVED, DIAGNOSING, WAITING_PARTS, IN_REFURBISHMENT,
QUALITY_CHECK, READY_FOR_SALE, RESERVED, SOLD, PARTS_DONOR, SCRAPPED,
RETURNED_TO_SUPPLIER, QUARANTINE, LOST.
paymentMethod du rachat : CASH, BANK_TRANSFER, CHECK, STORE_VOUCHER.
Ces événements existent dans KiwiDesk (temps réel de l’interface, enchaînements internes) mais ne
peuvent pas être souscrits : core.settings.updated, core.user.created,
core.user.deactivated, repair.ticket.public_updated, repair.parts.changed,
refurbishing.parts.changed, inventory.parts.available, inventory.parts.consumed,
billing.items.sold, billing.cash_session.opened, communications.message.proposed,
communications.conversation.updated.
Un événement n’arrive pas : vérifiez qu’il est coché sur le webhook et que le webhook vise
la boutique de l’événement ; consultez son Historique des envois .
Un champ attendu manque : le payload reste court par choix ; lisez l’objet complet par l’API
avec l’identifiant reçu.