Integrazioni & API

I sistemi di pagamento sono la categoria più ricorrente, sia su e-commerce sia su applicazioni di altro tipo che devono incassare. Subito dopo vengono i CRM e gli ERP, che sono il punto in cui l'integrazione smette di essere un problema tecnico e diventa un problema di allineamento dei dati fra reparti diversi.

La terza categoria è quella dei sistemi di newsletter e mail sending, dove la parte delicata raramente è l'API in sé: sono la gestione del consenso, la deliverability e la coerenza fra la lista che l'azienda crede di avere e quella che ha davvero.

L'integrazione più impegnativa che ho affrontato è quella con Meta per le API WhatsApp Business, sviluppata all'interno della piattaforma Messagent, oggi in esercizio sulle insegne Basko e Despar Nord Ovest.

La complessità non sta nella singola chiamata, ma nel fatto che il canale impone regole proprie su cosa si può inviare, quando e in che forma, con finestre temporali e modelli di messaggio che devono essere approvati preventivamente. A questo si aggiunge la natura conversazionale: il sistema non risponde a una richiesta isolata, deve mantenere lo stato di una conversazione per ogni utente, riconoscerlo, sapere a quale insegna e a quale punto vendita appartiene, e reagire di conseguenza.

In Messagent questo convive con la multi-tenancy, dove ogni insegna ha numeri, credenziali e keyword propri, e con la consegna programmata dei messaggi, che deve restare garantita anche in caso di riavvio dei servizi. Sono esattamente i requisiti che distinguono un'integrazione dimostrativa da una che regge in esercizio.

La parte che richiede più attenzione non è il percorso in cui tutto funziona, ma tutto il resto: cosa succede quando il servizio remoto risponde lentamente, quando risponde con un errore recuperabile, quando non risponde affatto, e come si evita di duplicare un'operazione già andata a buon fine dopo un tentativo ripetuto.

Per questo un'integrazione consegnata include sempre la gestione degli errori, la logica di ripetizione, il monitoring delle chiamate e la documentazione dell'interfaccia in formato OpenAPI, così che chi verrà dopo non debba dedurla dal codice.