IOSOR Guide
Integrazione dell'API rispetto a un portale partner white-label
I prodotti SaaS che integrano la messaggistica rimangono sulla superficie ISV. I portali partner white-label rimangono sotto Partner: non mescolare brand, chiavi e proprietà delle operazioni.
Quando un prodotto SaaS integra direttamente la messaggistica, gli utenti finali non aprono mai una console IOSOR. Fanno clic su Invia all'interno dell'interfaccia dell'ISV; l'ISV possiede le chiavi API, i webhook e il wallet prepagato. Questo percorso è l'integrazione diretta (embed). Un portale partner white-label funziona in modo diverso: l'amministratore del partner opera sulle interfacce Partner — con un'interfaccia protetta dal punto di vista del brand, isolamento dei tenant e controlli che non rivelano mai i nomi delle infrastrutture sottostanti.
I team spesso sovrappongono i due modelli: includendo screenshot del portale partner in una presentazione ISV, o mostrando messaggi di errore nello stile di IOSOR all'interno dell'applicazione SaaS.
L'integrazione mantiene la messaggistica all'interno del prodotto SaaS
L'architettura integrata assegna le chiavi API, le chiavi di idempotenza e i ricevitori di webhook all'organizzazione di ingegneria dell'ISV. Le azioni dell'utente finale corrispondono a invii lato server gestiti tramite il wallet prepagato dell'ISV.
Il portale partner rimane una superficie white-label separata
I portali partner sono dedicati agli amministratori dei rivenditori che gestiscono sub-tenant, ripartizioni di margine ed esportazioni in marca bianca. Le schermate rispettano i controlli dell'interfaccia Partner: nessun nome di brand sottostante nelle notifiche, negli errori API, nei webhook o nelle colonne dei file CSV.
Proprietà divisa: interfaccia prodotto rispetto all'interfaccia partner
| Decisione | Integrazione diretta | Portale partner |
|---|---|---|
| Pubblico dell'interfaccia | Utenti finali ISV | Amministratori partner |
| Custodia delle chiavi | Segreti dell'ISV | Vault operativo |
| Linguaggio del brand | Testi nativi SaaS | Testi in marca b. |
Rifiutare le demo ibride che mescolano percorsi di brand
Mostrare un pulsante di invio SaaS e uno screenshot del portale partner nella stessa diapositiva crea aspettative errate nell'acquirente relativamente all'interfaccia utilizzata. Se l'acquirente integra codici OTP all'interno della.
Percorsi operativi correlati
- Gate della superficie partner: nessuna perdita di brand
- webhook e chiavi al lancio
- Raggruppamento di SKU di comunicazione multicanale in offerte di catalogo uni…
Inizia con IOSOR
Configura i ricevitori dei webhook del tuo prodotto nella console all interno del caveau dei segreti ISV, mantenendo le chiavi API rigorosamente sul tuo server di back-end. Applica il filtro della superficie partner prima di concedere l accesso amministrativo ai rivenditori, per evitare perdite di marchi a monte nei payload DLR o nelle esportazioni CSV. Mantieni isolate la schermata del prodotto e quella del partner sia negli ambienti di staging che in produzione.
Sintesi IOSOR
Integrare la messaggistica tramite un API mantiene il traffico degli utenti finali e gli stati interamente all interno dell interfaccia utente del tuo prodotto SaaS, gestiti dalle chiavi lato server del tuo team di ingegneria. Al contempo, i portali partner white-label esistono esclusivamente affinché gli amministratori dei rivenditori gestiscano strutture di subtenant, distribuzioni di tariffe ed esportazioni con marchio isolato, senza esporre i dettagli dell infrastruttura a monte.
Isola le chiavi API, i ricevitori dei webhook e il rendering dello stato all interno della codebase del tuo prodotto principale. Non presentare demo di vendita ibride né mescolare la schermata amministrativa dei partner con i flussi di messaggistica nativi del prodotto, poiché sfumare questi confini genera fughe di marchi e disallinea la governance dei tenant.
Questa guida ti è stata utile?
Guide correlate
- L'invio dell'utente finale addebita comunque un unico mastro prepagato
L'invio integrato addebita comunque il wallet prepagato dell'ISV. Non inventare un secondo mastro non finanziato dal prodotto: blocchi, retry e idempotenza rimangono onesti.
- Quando il limite di un tenant integrato deve interrompere l'invio
I limiti di equità all'interno di un prodotto ISV devono bloccare rigidamente l'invio per quel tenant senza restituire un falso API 200.