Registra i customer dal tuo sito web, dal tuo modulo o dal tuo backend con una chiamata HTTP, e ricevi ogni modifica sul tuo server firmata con HMAC-SHA256.
Il tuo CRM smette di essere un luogo in cui dover entrare per scrivere: diventa un endpoint che i tuoi sistemi chiamano.
AiCrm, l'app CRM di AIsToHire, espone un'API REST pubblica sui tuoi customer. Con una API key nell'HTTP header `X-Api-Key` puoi creare, elencare, consultare, aggiornare ed eliminare customer, e aggiungere attività a ciascuno di essi, dal modulo del tuo sito web, dal tuo chatbot, da uno Zap, da uno script Python o dal tuo backend. Le risposte sono JSON nella forma `{ success, data }`, e il limite è di 100 richieste al minuto per API key.
La registrazione tramite API non duplica: se l'email che invii esiste già nel tuo database, AiCrm aggiorna la scheda esistente (completa il telefono, il nome o l'azienda mancanti, unisce i tag/label) e registra un nuovo invio nella sua timeline, restituendo HTTP 200; se è nuovo, lo crea e restituisce 201. Ogni customer che entra tramite API viene automaticamente etichettato come `api-lead`, conserva i tag/label che invii e salva il `subId` di origine, oltre al paese, all'IP e al browser da cui è arrivato.
Puoi avere fino a 20 API key con un nome proprio, oltre all'internal key dell'app. In questo modo, assegni una API key diversa a ogni integrazione —il sito web, il modulo della campagna di maggio, lo stagista, il fornitore— e la revochi singolarmente quando l'integrazione termina, senza intaccare le altre. Il valore completo di una API key viene mostrato una sola volta, al momento della creazione; in seguito, è visibile solo mascherato nell'elenco.
Nella direzione opposta, i webhook avvisano i tuoi sistemi. Configuri fino a 10 destinazioni, scegli a quali eventi si iscrive ciascuna (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`) e AiCrm effettua un POST alla tua URL con gli HTTP header `X-AiCrm-Event` e `X-AiCrm-Signature: sha256=…`, la signature HMAC-SHA256 del corpo con il segreto di quel webhook, affinché tu possa verificare che la consegna sia legittima. Al salvataggio dell'URL, una protezione anti-SSRF rifiuta localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0 e i domini `.local` e `.internal`.
Registrazione di customer con una sola chiamata
un POST a `/api/apps/public/crm/customers` con l'email e i tag/label che desideri, e il lead è già classificato nel tuo CRM.
Nessun duplicato per design
se l'email esiste già, la scheda viene aggiornata e il nuovo invio viene annotato nella sua timeline invece di creare una seconda scheda.
Fino a 20 API key nominate
una per integrazione, revocabile separatamente. Se una chiave viene compromessa, elimini quella e nient'altro smette di funzionare.
Webhook firmati con HMAC-SHA256
verifichi l'intestazione `X-AiCrm-Signature` con il tuo segreto e sai che la notifica proviene dal tuo CRM e non da una terza parte.
Protezione anti-SSRF inclusa
l'app si rifiuta di consegnare webhook a localhost o a intervalli di rete privati, così il tuo CRM non può essere usato per sondare una rete interna.
CRUD completo, non solo aggiunte
elencare con paginazione e filtri (ricerca, stato del ciclo di vita, tag/etichette, paese), consultare un cliente con la sua attività, aggiornarlo, eliminarlo e registrarvi attività.
Origine tracciata automaticamente
ogni aggiunta tramite API salva il `subId` che invii più il paese, l'IP e il browser, e viene etichettata come `api-lead` per filtrarla successivamente nell'app.
Test senza congetture
l'app include la documentazione degli endpoint con un esempio `curl` copiabile e un pulsante per inviare una consegna di prova a ogni webhook, con lo stato e l'ora dell'ultimo tentativo.

AiCrm è lo strumento CRM di AIsToHire che riceve i tuoi contatti tramite API REST e avvisa i tuoi sistemi con webhook firmati. Crea il tuo account, genera una chiave ed effettua la prima chiamata.