Kasar
Kasar

Webhooks et API : Kasar se branche à vos outils

Une adresse reçoit les appels de vos formulaires et de vos logiciels, et Kasar écrit la fiche ou lance un scénario. Dans l’autre sens, chaque évènement du CRM part vers votre système, signé, et l’API REST lit et écrit vos objets.

01

Ce qui rentre : une porte par système

Dans les paramètres de l’espace de travail, la section « Ce qui rentre » crée des portes d’entrée. Chacune accepte un POST en JSON ou en formulaire, jusqu’à 256 Ko, et fait l’une de deux choses. « Écrire un enregistrement » crée ou met à jour une fiche de l’objet cible, en reconnaissant l’existant par sa règle d’identité. « Publier un évènement » ne touche à aucune donnée : il réveille les automatisations abonnées.

02

Ce qui sort : vos évènements, signés

La section « Ce qui sort » déclare les systèmes que Kasar appelle. Vous cochez les évènements voulus, et chacun part dès qu’il se produit, sans workflow à écrire. En « Signature HMAC », la livraison suit la spécification Standard Webhooks : en-têtes webhook-id, webhook-timestamp et webhook-signature, vérifiables par toute bibliothèque conforme. Chaque livraison compte jusqu’à cinq tentatives au total, à intervalles croissants.

03

L’API REST pour votre propre code

Une clé d’intégration, préfixée ksr_svc_, ouvre l’API v1 avec des droits cochés objet par objet : Lire, Écrire, Supprimer. Les mêmes routes servent tous vos objets, personnalisés compris. PUT crée ou met à jour selon l’identité, et l’en-tête X-Idempotency-Key rend un nouvel essai inoffensif pendant vingt-quatre heures.

Quand ça sert

Le formulaire du site lance la séquence

Le formulaire de contact poste vers une porte. Un scénario au déclencheur « Webhook entrant » enchaîne « Créer ou mettre à jour » sur le contact, puis « Ajouter à une liste ». La séquence liée à cette liste lui écrit : une personne ajoutée après son démarrage y entre aussi.

Le contrat signé décrémente le stock

Quand l’affaire passe en gagnée, le bloc « Requête HTTP » appelle votre ERP en POST, avec un corps JSON qui reprend les lignes de la commande. L’ERP retire les quantités vendues. Son statut et sa réponse restent lisibles par les blocs suivants du scénario.

Un entrepôt de données toujours à jour

L’outil de reporting charge l’existant une fois par GET sur /api/v1, puis s’abonne aux créations, modifications et suppressions. Il dédoublonne sur webhook-id, qui reste identique quand Kasar relivre, et relit une fiche par l’API quand il lui faut ses relations.

La mise en place, pas à pas

  1. 1

    Ouvrez Paramètres, groupe « Espace de travail », onglet « API et webhooks ». Il s’ouvre aux administrateurs et aux rôles dotés de la capacité « Gérer les webhooks ».

  2. 2

    Pour recevoir, cliquez sur « Nouvelle porte », choisissez « Écrire un enregistrement » ou « Publier un évènement », puis copiez l’adresse : elle ne s’affiche qu’une seule fois.

  3. 3

    Faites partir un vrai appel depuis votre outil, ouvrez la porte et cliquez sur « Capturer » pour relever chaque chemin reçu, avec son type et un exemple.

  4. 4

    Dans « Le mapping », cliquez sur « Ajouter une association » pour relier un champ CRM à un chemin reçu, puis sur « Enregistrer le mapping ».

  5. 5

    Pour émettre, cliquez sur « Nouvelle destination », renseignez l’« URL de base » et l’authentification, puis utilisez « Choisir les évènements » et « Envoyer un appel de test ».

  6. 6

    Pour l’API, créez une clé avec « Nouvelle intégration », cochez ses droits et copiez-la au moment où s’affiche « Copiez la clé maintenant ». La section des clés est réservée aux administrateurs.

Ce que Kasar capte, et où ça se range

  • Les fiches écrites par une porte, dans l’objet choisi, sans doublon grâce à la règle d’identité de cet objet.

  • Le corps de chaque appel entrant, disponible dans le scénario qui écoute la porte et filtrable par « Contenu reçu ».

  • Un journal par porte et par destination : heure, code de réponse, durée en millisecondes, et le corps reçu côté porte.

  • Les évènements sortants au format type, timestamp, data, avec la fiche dans la forme exacte que sert l’API.

  • La réponse de vos API, code HTTP et corps, reprise par les blocs placés après une « Requête HTTP ».

Les automatisations qui vont avec

Webhook entrant

Ce que fait le scénario
« Créer ou mettre à jour » le contact à partir du corps reçu, puis « Distribuer / assigner » pour lui donner un responsable dans l’équipe commerciale.

Opportunité gagnée

Ce que fait le scénario
« Requête HTTP » en POST vers la destination de votre ERP, qui ouvre le projet de production et réserve les quantités vendues.

Enregistrement créé

Ce que fait le scénario
« Condition » sur le type de compte, puis « Requête HTTP » vers votre outil de support pour y ouvrir l’espace du nouveau client.

Les déclencheurs et les blocs portent ici leur nom exact dans l’éditeur d’automatisations de Kasar.

Questions fréquentes

La porte convient à un outil qui sait pousser un webhook, formulaire ou logiciel métier : vous associez ses champs aux vôtres sans écrire de code. L’API convient à un programme que vous développez : il reçoit l’identifiant créé, ou une erreur qui nomme le champ en cause.

Choisissez « Signature HMAC » sur la destination. Kasar génère le secret de signature et ne le montre qu’une fois. L’en-tête webhook-signature contient v1, puis le HMAC SHA-256 de l’identifiant, de l’horodatage et du corps, encodé en base64. Rejetez tout horodatage trop ancien.

Kasar attend la réponse vingt secondes, puis réessaie jusqu’à quatre fois à intervalles croissants. Les erreurs réseau et les réponses 5xx, 408 ou 429 sont rejouées ; les autres 4xx sont définitives. La destination affiche « En échec » et continue pourtant de recevoir.

Une porte « Écrire un enregistrement » répond 200 même quand son mapping n’est pas réglé, pour que l’outil émetteur ne désactive pas son webhook. La raison figure dans le journal de la porte, à côté du corps reçu. Le plus souvent, la structure n’a pas été capturée ou le mapping pas enregistré.

Oui, grâce au serveur MCP : Claude ou ChatGPT assemble l’automatisation avec crm_manage_automations, l’essaie sans rien écrire, puis la publie quand vous avez confirmé. Léo, de son côté, propose un mapping à partir des chemins qu’une porte a réellement reçus.

Sources

Branchez vos outils, gardez vos habitudes

Connectez votre messagerie et votre agenda en deux minutes, l’historique remonte tout seul.

Essayer gratuitement