# API REST pour CRM avec webhooks signés | AiCrm

> CRM avec API REST publique : créez et consultez des contacts avec un en-tête X-Api-Key, jusqu'à 20 clés par intégration et des webhooks sortants signés avec HMAC-SHA256. Enregistrement de leads depuis votre site web sans doublons.

- **Source (source):** https://aistohire.com/fr/aicrm-crm-leger-avec-api-109/f/api-rest-crm-webhooks-signes
- **Plateforme (platform):** AIstoHire
- **Langue (language):** fr

## En résumé

- API REST publique avec plusieurs API keys et des webhooks signés
- Enregistrez des clients depuis votre site web, votre formulaire ou votre backend avec un appel HTTP, et recevez chaque modification sur votre serveur signée avec HMAC-SHA256.
- Enregistrement de clients avec un seul appel
- Pas de doublons par conception
- Jusqu’à 20 API keys nommées

## API REST publique avec plusieurs API keys et des webhooks signés

AiCrm, l’application CRM d’AIsToHire, expose une API REST publique sur vos propres clients. Avec une API key dans l’en-tête `X-Api-Key`, vous pouvez créer, lister, consulter, mettre à jour et supprimer des clients, et ajouter des activités à n’importe lequel d’entre eux, depuis le formulaire de votre site web, votre chatbot, un Zap, un script Python ou votre propre backend. Les réponses sont au format JSON `{ success, data }`, et la limite est de 100 requêtes par minute et par API key.

L’enregistrement via l’API ne crée pas de doublons : si l’e-mail que vous envoyez existe déjà dans votre base, AiCrm met à jour la fiche existante (complète le numéro de téléphone, le nom ou l’entreprise manquants, fusionne les étiquettes) et enregistre un nouvel envoi dans sa timeline, renvoyant HTTP 200 ; si c’est un nouveau client, il le crée et renvoie 201. Chaque client qui entre par l’API est automatiquement étiqueté comme `api-lead`, conserve les étiquettes que vous envoyez et enregistre le `subId` d’origine, en plus du pays, de l’IP et du navigateur d’où il provient.

Vous pouvez avoir jusqu’à 20 API keys avec un nom personnalisé, en plus de l’internal key de l’application. Ainsi, vous donnez une API key différente à chaque intégration —le site web, le formulaire de la campagne de mai, le stagiaire, le fournisseur— et vous la révoquez seule lorsque cette intégration se termine, sans affecter les autres. La valeur complète d’une API key n’est affichée qu’une seule fois, lors de sa création ; ensuite, elle n’apparaît que masquée dans la liste.

Dans l’autre sens, les webhooks informent vos systèmes. Vous configurez jusqu’à 10 destinations, choisissez à quels événements chacune s’abonne (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`) et AiCrm effectue un POST vers votre URL avec les en-têtes `X-AiCrm-Event` et `X-AiCrm-Signature: sha256=…`, la signature HMAC-SHA256 du corps avec le secret de ce webhook, afin que vous puissiez vérifier que la livraison est légitime. Lors de l’enregistrement de l’URL, une protection anti-SSRF rejette localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0 et les domaines `.local` et `.internal`.

## Ce qui est inclus

- **Enregistrement de clients avec un seul appel** — un POST vers `/api/apps/public/crm/customers` avec l’e-mail et les étiquettes que vous souhaitez, et le lead est déjà classé dans votre CRM.
- **Pas de doublons par conception** — si l’e-mail existe déjà, la fiche est mise à jour et le nouvel envoi est enregistré dans sa timeline au lieu de créer une deuxième fiche.
- **Jusqu’à 20 API keys nommées** — une par intégration, révocable séparément. Si une clé est compromise, vous supprimez celle-ci et rien d’autre ne cesse de fonctionner.
- **Webhooks signés avec HMAC-SHA256** — vous vérifiez l’en-tête `X-AiCrm-Signature` avec votre secret et vous savez que la notification provient de votre CRM et non d’un tiers.
- **Protection anti-SSRF incluse** — l’application refuse de livrer des webhooks à localhost ou à des plages de réseau privées, ainsi votre CRM ne peut pas être utilisé pour sonder un réseau interne.
- **CRUD complet, pas seulement des créations** — lister avec pagination et filtres (recherche, statut de cycle de vie, tags de contact, pays), consulter un customer avec son activité, le mettre à jour, le supprimer et lui enregistrer des activités.
- **Origine tracée automatiquement** — chaque création via API enregistre le `subId` que vous envoyez plus le pays, l’IP et le navigateur, et est étiquetée comme `api-lead` pour la filtrer ensuite dans l’application.
- **Tests intuitifs** — l’application inclut la documentation des endpoints avec un exemple `curl` copiable et un bouton pour envoyer une livraison de test à chaque webhook, avec le statut de cycle de vie et l’heure de la dernière tentative.

## Questions fréquentes

### Comment créer un contact dans le CRM depuis mon site web ?

Vous effectuez un POST vers `/api/apps/public/crm/customers` avec l'en-tête `X-Api-Key` et un JSON contenant au moins l'e-mail ou le numéro de téléphone. Vous pouvez également envoyer le nom, le numéro de téléphone, l'entreprise, le pays, le statut (lifecycle status), des notes, des étiquettes (tags/labels) et un `subId` pour identifier la campagne ou le formulaire d'origine. AiCrm renvoie 201 s'il le crée et 200 si ce contact existait déjà.

### Que se passe-t-il si le même e-mail est envoyé deux fois via l'API ?

Il n'est pas dupliqué. AiCrm recherche l'e-mail (ou le numéro de téléphone, si vous n'envoyez pas d'e-mail) et, s'il le trouve, met à jour la fiche existante en remplissant les champs vides, fusionne les nouvelles étiquettes avec celles qu'il possédait déjà et enregistre le nouvel envoi dans sa chronologie d'activité. La réponse indique que le contact existait déjà et vous renvoie son identifiant.

### Combien d'API keys puis-je avoir et puis-je en révoquer une seule ?

Vous pouvez créer jusqu'à 20 clés nommées, en plus de la clé interne de l'application, qui ne peut pas être supprimée. Chaque clé est supprimée indépendamment, vous pouvez donc en donner une différente à chaque intégration et la révoquer sans affecter les autres. La valeur complète n'est affichée qu'au moment de sa création ; elle apparaît ensuite masquée dans la liste. Toutes les clés partagent la limite de 100 requêtes par minute par clé.

### Comment vérifier qu'un webhook provient réellement de mon CRM ?

Chaque livraison contient l'en-tête `X-AiCrm-Signature: sha256=<signature>`, qui est le HMAC-SHA256 du corps exact de la requête, utilisant le secret que l'application vous montre lors de la création du webhook. Calculez ce HMAC sur votre serveur à partir du corps reçu et comparez-le. De plus, l'en-tête `X-AiCrm-Event` est envoyé avec le nom de l'événement : `customer.created`, `customer.updated`, `customer.deleted` ou `activity.created`.

### Que se passe-t-il si mon endpoint de webhook est hors service ?

La livraison est en mode « best-effort » : AiCrm attend jusqu'à 5 secondes et, en cas d'échec, réessaie après une seconde et demie. Il n'y a pas de file d'attente de réessais persistante, donc une longue panne de votre serveur peut vous faire perdre des notifications ; dans ce cas, réconciliez les données avec un appel GET à `/api/apps/public/crm/customers`. L'application vous montre le statut et l'heure de la dernière tentative de chaque webhook, et vous pouvez lancer une livraison de test à tout moment.

- [AiCrm — CRM léger avec API pour créer des clients depuis n'importe quel système](https://aistohire.com/fr/aicrm-crm-leger-avec-api-109)

## À propos de la plateforme

**AiCrm — CRM léger avec API pour créer des clients depuis n'importe quel système** — une application de AIstoHire. Disponible sur: https://aistohire.com/fr/aicrm-crm-leger-avec-api-109/f/api-rest-crm-webhooks-signes

### Autres langues

- `es`: https://aistohire.com/es/aicrm-crm-ligero-con-api-109/f/api-rest-crm-webhooks-firmados
- `en`: https://aistohire.com/aicrm-lightweight-crm-with-api-109/f/api-rest-crm-signed-webhooks
- `it`: https://aistohire.com/it/aicrm-crm-leggero-con-api-109/f/api-rest-crm-webhook-firmati
- `pt`: https://aistohire.com/pt/aicrm-crm-leve-com-api-109/f/api-rest-crm-webhooks-assinados
- `de`: https://aistohire.com/de/aicrm-leichtes-crm-mit-api-109/f/api-rest-crm-signierte-webhooks
- `bg`: https://aistohire.com/bg/aicrm-lesen-crm-s-api-za-upravlenie-na-klienti-i-liydove-109/f/rest-api-crm-podpisani-uebhukove
- `ja`: https://aistohire.com/ja/aicrm-lightweight-crm-with-api-109/f/crm-rest-api-signed-webhooks
- `nl`: https://aistohire.com/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109/f/rest-api-crm-ondertekende-webhooks
- `ko`: https://aistohire.com/ko/aicrm-api-gyeongnyang-crm-109/f/crm-rest-api-seomyeong-webhook
- `sv`: https://aistohire.com/sv/aicrm-enkelt-crm-med-api-for-att-hantera-kunder-och-leads-109/f/rest-api-crm-signerade-webhooks
- `da`: https://aistohire.com/da/aicrm-enkelt-crm-med-api-til-at-styre-kunder-og-leads-109/f/rest-api-crm-signerede-webhooks
- `ar`: https://aistohire.com/ar/aicrm-nzam-crm-bsit-ma-api-lidara-alamla-walamla-almhtmlin-109/f/crm-rest-api-webhooks
- `no`: https://aistohire.com/no/aicrm-enkelt-crm-med-api-for-a-styre-kunder-og-leads-109/f/rest-api-crm-signerte-webhooks
- `fi`: https://aistohire.com/fi/aicrm-yksinkertainen-crm-rajapinnalla-asiakkaille-ja-liideille-109/f/crm-rest-api-allekirjoitetut-webhookit
- `zh`: https://aistohire.com/zh/ai-crm-rest-api-webhooks-109/f/crm-rest-api-webhook
- `pl`: https://aistohire.com/pl/aicrm-prosty-crm-z-api-do-zarzadzania-klientami-i-leadami-109/f/api-rest-crm-podpisane-webhooki
- `he`: https://aistohire.com/he/aicrm-crm-pshot-am-api-lnihol-lkochot-vlidim-109/f/api-rest-crm-webhooks-chatumim
- `cs`: https://aistohire.com/cs/aicrm-jednoduche-crm-s-api-pro-spravu-klientu-a-leadu-109/f/rest-api-crm-podepsane-webhooky
- `id`: https://aistohire.com/id/aicrm-crm-sederhana-dengan-api-untuk-mengelola-pelanggan-dan-lead-109/f/api-rest-crm-webhook-bertanda-tangan
