API REST et webhooks

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.

Votre CRM cesse d’ĂȘtre un endroit oĂč il faut se connecter pour Ă©crire : il devient un endpoint que vos systĂšmes appellent.

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`.

Avantages de API REST et webhooks

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.

Claire Donovan

Connectez votre site web Ă  votre CRM dĂšs cet aprĂšs-midi

AiCrm est l'outil CRM d'AIsToHire qui reçoit vos contacts via une API REST et notifie vos systÚmes avec des webhooks signés. Créez votre compte, générez une clé et effectuez le premier appel.

API REST pour CRM avec webhooks signés | AiCrm