Vai al contenuto
Accedi
IT

Le integrazioni nel dettaglio Interfacce CRM ed ERP

«Abbiamo un’API aperta» non risponde alla domanda

In due giornate di settembre abbiamo esaminato quattordici produttori – assistenza, studi legali, trasporti, personale, immobili. Non contro testi pubblicitari, ma contro le descrizioni delle interfacce dei produttori.

Due di essi sanno fare ciò che ci serve. Sembra un bilancio del settore. È però soprattutto il bilancio di una domanda che quasi tutti pongono male.

2 su 14
Verificato il 5 e 6 settembre 2026 sulle descrizioni pubbliche delle interfacce. I restanti dodici non ne hanno una, oppure ne hanno una che non si può interrogare sui numeri di telefono.

La domanda che conta

Se un sistema abbia un’interfaccia è per noi la seconda informazione per importanza. La prima è:

Lo si può interrogare su un numero di telefono?

La differenza sembra un cavillo e non lo è. È lei a decidere se allo squillo compare un nome sullo schermo oppure no.

Tre modi in cui fallisce

Dopo quattordici produttori non è più un caso, ma uno schema. Dove non funziona, non funziona sempre in uno di tre modi.

Primo: l’interfaccia è costruita per altro

I software per i trasporti rispondono a «dov’è la spedizione?», «quanto costa il trasporto?», «quale slot è libero?». Gli indirizzi non vi compaiono – non perché qualcuno li abbia dimenticati, ma perché un’API di spedizioni non è una banca dati di indirizzi.

Lo stesso vale per le piattaforme di spedizione: il numero del destinatario è nella scheda, perché al corriere serve. L’elenco delle spedizioni si filtra comunque solo per periodo, stato e numero di pacco.

Secondo: i dati ci sono, solo non interrogabili

È il più pericoloso dei tre. Sembra un successo: documentazione presente, campi per i numeri presenti, tutto verde. Solo lo sguardo all’elenco dei filtri mostra che non si può chiedere.

  • Un noto software di contabilità filtra i contatti per nome, e-mail e numero cliente. Il numero di telefono compare in ogni risposta – come filtro non esiste.
  • Un diffuso software per il personale conosce esattamente cinque parametri sull’endpoint dei dipendenti. Nessuno è un numero di telefono.
  • Un secondo software per il personale ne conosce sette. Nemmeno uno.

Chi a questo punto tira a indovinare costruisce un collegamento che non segnala errori e non trova nulla.

Terzo: il settore ha uno standard – e non è un servizio web

Nello studio medico si chiama GDT, presso il broker assicurativo BiPRO e GDV. Chi sente «il settore ha degli standard» pensa a porte aperte. Si intendono invece forniture di dati in una sola direzione – un formato, non un servizio da interrogare.

Il caso che più ci ha irritati

Due grandi gestionali dello stesso produttore sanno filtrare – ma la loro documentazione dice espressamente che un OR non si può stendere su due campi diversi.

Una ricerca per numero può quindi interrogare lì o il fisso oppure il cellulare. Mai entrambi. Tecnicamente impeccabile, praticamente inutile – e il fallimento non si annuncia, dice semplicemente «contatto non trovato».

Che cosa dovrebbe cambiare un produttore

Quasi sempre: un parametro. Non un progetto, non un’architettura, non una migrazione. Un filtro in più sull’endpoint che esiste da tempo.

Per un sistema di prenotazione per club sportivi abbiamo fatto il conto: l’endpoint dei soci fornisce già il numero, manca soltanto la possibilità di filtrarvi sopra. Una riga di documentazione, un indice di database.

Perché comunque non parliamo male del settore

Chi vende il proprio software a servizi assistenziali, studi e amministrazioni non ha sviluppatori come clienti. Un’interfaccia pubblica costa manutenzione e a questo modello di business non porta inizialmente nulla. Non è trascuratezza, è un calcolo.

Proprio per questo la nostra offerta lì è interessante: siamo noi gli sviluppatori che questi produttori non hanno. Devono solo dirci come si interroga il loro software su un numero di telefono – il resto lo costruiamo noi.

E se la risposta è no, anche quella è un’informazione. Un no cancella un produttore dall’elenco, invece di lasciarlo lì come punto aperto. Vale più di un forse.

Domande frequenti

Perché un’API aperta non basta?

Perché un’interfaccia viene costruita per uno scopo preciso. Le API di contabilità restituiscono fatture, quelle dei trasporti le spedizioni, quelle del personale i dati anagrafici. La domanda «a chi appartiene questo numero?» non compare in nessuna di queste visioni del mondo – anche se il numero è nella scheda.

Da cosa capisco se il mio sistema ne è capace?

Dall’elenco dei filtri dell’endpoint dei contatti, non dall’elenco dei campi della risposta. Se vi compare un parametro per il numero di telefono, funziona. Se ci sono solo nome, e-mail e numero cliente, non funziona – per quanto completa sia la risposta.

Qual è l’errore più frequente?

Considerare una prova il numero presente nella risposta. Non lo è. Restituire e cercare sono due capacità diverse, e la maggior parte dei sistemi ha solo la prima.

E se nessuna ricerca è possibile?

Allora resta un’estrazione notturna – una copia dell’anagrafica clienti da noi. È la via d’uscita, non la via: l’informazione è fresca quanto l’ultimo passaggio, e dati personali altrui si trovano in un posto in più.

Come funziona il riquadro Tutti i connettori

Parli con noi

Non riceverà una soluzione standard, ma una valutazione chiara: se lo sforzo vale la pena per la sua azienda, che cosa deve saper fare il suo sistema – e quanto costa. Se non è adatto, glielo diciamo.