Se hai un gestionale personalizzato o un software di nicchia, le integrazioni standard potrebbero non bastare. Le API (Application Programming Interface) sono la soluzione: permettono a qualsiasi software di comunicare con RecallAI in modo diretto e flessibile. Con le API, il tuo gestionale e RecallAI parlano la stessa lingua.
Cosa Sono le API in Parole Semplici
Immagina le API come un cameriere in un ristorante: prendi l'ordine (richiesta) dal tavolo (il tuo gestionale), lo porti in cucina (RecallAI) e riporti il piatto (la risposta) al tavolo. Il tuo gestionale non deve sapere come funziona la cucina: deve solo saper parlare con il cameriere.
Endpoint Principali delle API RecallAI
Gestione Contatti:
- POST /contacts - Crea un nuovo contatto
- PUT /contacts/{id} - Aggiorna un contatto
- GET /contacts/{id} - Recupera i dati di un contatto
- DELETE /contacts/{id} - Elimina un contatto (diritto all'oblio)
Gestione Recall:
- POST /recalls - Crea un nuovo recall per un contatto
- GET /recalls/{id}/status - Verifica lo stato di un recall
- GET /recalls/report - Report aggregato dei recall
Gestione Appuntamenti:
- POST /appointments - Crea un appuntamento fissato tramite recall
- GET /appointments/available - Slot disponibili
Esempio Pratico di Integrazione
Scenario: hai un gestionale per studi medici che registra le visite. Vuoi che, 5 mesi dopo l'ultima visita, parta automaticamente un recall.
Il flusso:
- Il gestionale, quando registra una visita completata, invia una richiesta API a RecallAI con i dati del paziente e la data della visita
- RecallAI calcola la data del recall (5 mesi dopo) e lo programma
- Quando il recall viene eseguito, il Motore AI Proprietario RecallAI genera il messaggio personalizzato
- L'esito viene comunicato al gestionale tramite webhook: appuntamento fissato, paziente non raggiungibile, etc.
Autenticazione e Sicurezza
Le API RecallAI utilizzano:
- API Key: generata dalla dashboard, da includere in ogni richiesta
- HTTPS: tutte le comunicazioni sono crittografate
- Rate limiting: protezione contro l'abuso (1.000 richieste/minuto)
- Webhook con firma: ogni webhook inviato da RecallAI e firmato digitalmente per garantire l'autenticita
Documentazione e Supporto
La documentazione API e disponibile nella sezione Integrazioni, con:
- Riferimento completo di tutti gli endpoint
- Esempi di codice in PHP, Python, JavaScript e cURL
- Ambiente sandbox per i test
- Supporto tecnico dedicato per l'integrazione
Inizia l'Integrazione
Con le API di RecallAI, qualsiasi gestionale diventa un sistema di recall intelligente. Scopri i piani con accesso API incluso.