Lo stesso modo di gestire i messaggi
Interfacce e adattatori normalizzano messaggi, template, risposte ed errori. Il provider esistente resta disponibile; il nuovo si attiva esplicitamente.
Progetti / Aimage · integrazione WhatsApp per un SaaS
Twilio e Spoki, nello stesso sistema WhatsApp.
Per Aimage ho sviluppato il backend che affianca Twilio al provider Spoki già presente. La piattaforma continua a gestire messaggi e stati di consegna nello stesso modo, mentre il nuovo provider si attiva per il singolo cliente.
Progetto realeBackend consegnato · integrazione del cliente da completare
Il progetto e il mio contributo
Un nuovo provider, senza rifare la piattaforma.
Il cliente disponeva già di una piattaforma SaaS. Il mio incarico era aggiungere un provider e il percorso di attivazione dei clienti: dai messaggi agli stati di consegna, fino alla documentazione per collegare il nuovo backend.
Callback che rispettano lo stato
Deduplicazione e precedenza degli stati impediscono a un callback ripetuto o in ritardo di corrompere la cronologia del messaggio.
Dall’onboarding al numero pronto
Sessioni di attivazione, provisioning, code e controlli di stato accompagnano l’integrazione. La consegna include i punti di integrazione e le istruzioni per collegarli al prodotto del cliente.
Dal consenso Meta
al numero pronto.
Il collegamento di un provider comprende anche l’attivazione del cliente. Ho implementato il percorso Meta Embedded Signup, la preparazione delle risorse e i controlli fino allo stato del mittente.
- AttivazioneMeta Embedded Signup raccoglie le autorizzazioni previste dal percorso.
- ProvisioningIl backend prepara le risorse e segue lo stato dell’attivazione.
- Numero prontoI controlli distinguono un mittente utilizzabile da un passaggio ancora incompleto.
- Messaggio e callbackIl backend salva il messaggio e aggiorna lo stato di consegna nel formato già usato dalla piattaforma.
12 agosto 2026: prova live Twilio con invio, persistenza e callback «delivered». 16 settembre: consegna di backend e documentazione. Al 20 settembre resta al cliente l’integrazione nella propria applicazione.
Laboratorio / esempio locale
Un callback arriva in ritardo. Che cosa cambia?
Il messaggio M-01 è già consegnato. Un evento precedente arriva dopo: la cronologia lo registra, ma lo stato non torna indietro. Cambia provider e prova duplicati, lettura e recupero.
Esempio locale: i controlli non modificano dati o servizi del progetto originale.
Consegnato
E-03 è arrivato dopo la conferma di consegna. Lo stato resta Consegnato.
Ispeziona stato ed eventi
Strutture del solo campione, senza dati del cliente.
Evidenze e stato del progetto
La consegna comprende codice e passaggio operativo.
Il backend e la documentazione sono stati consegnati il 16 settembre 2026. La prova live del 12 agosto documenta invio, persistenza e callback di consegna con Twilio; il percorso Spoki resta disponibile.
Stato confermato al 20 settembre 2026: resta al cliente il collegamento nella propria applicazione. Questo non equivale a un rollout già completato su tutti i clienti o a ogni possibile migrazione di numero.
Il tuo prossimo progetto
Devi collegare un nuovo servizio?
Indica il provider che usi, quello da aggiungere e come attivi oggi i clienti. Partiamo dai messaggi e dagli stati che la piattaforma deve conservare.
Bastano nome ed email. Ti risponderò personalmente.