Configurer le webhook Sinao

Les webhooks de Sinao permettent de recevoir en temps réel des notifications lorsqu’un événement spécifique se produit (par exemple : création d’une facture, ajout d’un paiement). Cela permet à votre logiciel ou service de réagir instantanément aux changements effectués dans Sinao.

Pour la configuration du webhook, vous devez utiliser l'endpoint /apps/:appId/settings.

var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer <token>");
myHeaders.append("Accept", "application/json");

var formdata = new FormData();
formdata.append("settings[services.webhook.url]", "https://api.logiciel.com/webhook/sinao");

// Ajout des événements à écouter
formdata.append("settings[services.webhook.events][0]", "invoice.created");
formdata.append("settings[services.webhook.events][1]", "invoice.updated");
formdata.append("settings[services.webhook.events][2]", "purchase.deleted");
formdata.append("settings[services.webhook.events][3]", "payments.created");

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: formdata,
  redirect: 'follow'
};

fetch("https://api.sinao.app/v1/apps/:appId/settings", requestOptions)
  .then(response => response.json())
  .then(result => console.log("Webhook configuré :", result))
  .catch(error => console.log("Erreur lors de la configuration :", error));

Une fois que vous commencez à recevoir les événements, vous pouvez consulter un historique des notifications reçues sur les 30 derniers jours depuis votre interface d’administration ou via votre propre système de logs.

Liste des événements disponibles

Documents (9 événements)

invoice.created
invoice.updated
invoice.deleted
quote.created
quote.updated
quote.deleted
purchase.created
purchase.updated
purchase.deleted

Contacts (15 événements)

contactorganization.created
contactorganization.updated
contactorganization.deleted
contactperson.created
contactperson.updated
contactperson.deleted
relationship.created
relationship.updated
relationship.deleted
contactestablishment.created
contactestablishment.updated
contactestablishment.deleted
contactplace.created
contactplace.updated
contactplace.deleted

Catalogue (9 événements)

product.created
product.updated
product.deleted
productstock.created
productstock.updated
productstock.deleted
productstockmovement.created
productstockmovement.updated
productstockmovement.deleted

Paiements (3 événements)

payment.created
payment.updated
payment.deleted