Integrazioni
Collega Blu Pantheon a WhatsApp, email transazionali, identity provider aziendali, CRM, ERP e gestionali sanitari.
Blu Pantheon si integra con i sistemi che già usi: canali di contatto, posta elettronica, identità aziendale, CRM, ERP e gestionali verticali. Ogni integrazione è attivabile in autonomia dalla Console e può essere disattivata in qualsiasi momento senza perdere i dati già raccolti.
Attiva solo ciò che ti serve
Ogni integrazione comporta un flusso di dati verso un fornitore terzo. Se non l'attivi, nessun dato lascia la piattaforma. L'elenco dei fornitori coinvolti per ciascun canale è in Residenza dei dati.
Le integrazioni disponibili
WhatsApp Business
Porta l'assistente sul canale che i tuoi clienti usano già ogni giorno.
Email e SMTP
Invia email transazionali dal tuo dominio con SPF, DKIM e DMARC configurati.
Single Sign-On
Federa l'accesso alla Console con Entra ID, Google Workspace, Okta o Keycloak.
CRM ed ERP
Sincronizza clienti, opportunità e ordini con i tuoi sistemi gestionali.
Prenotazioni sanitarie
Agende, prestazioni, regime SSN e regime privato integrati con il gestionale di struttura.
Mappa delle integrazioni
| Sistema | Tipo di integrazione | Direzione | Pagina |
|---|---|---|---|
| WhatsApp Business (Meta) | Canale conversazionale nativo | Bidirezionale | |
| Server SMTP (qualsiasi fornitore) | Recapito email transazionali | In uscita | Email e SMTP |
| Microsoft Entra ID | SSO OIDC o SAML 2.0 | Autenticazione | SSO |
| Google Workspace | SSO OIDC | Autenticazione | SSO |
| Okta | SSO OIDC o SAML 2.0 | Autenticazione | SSO |
| Keycloak | SSO OIDC o SAML 2.0 | Autenticazione | SSO |
| Salesforce | Webhook e API REST | Bidirezionale | CRM ed ERP |
| HubSpot | Webhook e API REST | Bidirezionale | CRM ed ERP |
| Microsoft Dynamics 365 | Webhook e API REST | Bidirezionale | CRM ed ERP |
| SAP (S/4HANA, Business One) | Middleware, OData o file batch | Bidirezionale | CRM ed ERP |
| Gestionali italiani (TeamSystem, Zucchetti, Danea) | API del gestionale o scambio file | Bidirezionale | CRM ed ERP |
| IBM AS/400 e sistemi legacy | Scambio file su SFTP o middleware | Batch | CRM ed ERP |
| Gestionali sanitari e CUP | API dedicate o middleware | Bidirezionale | Prenotazioni sanitarie |
| UiPath, Power Automate, n8n, Make | Webhook e strumenti richiamabili | Bidirezionale | Automazioni |
| Sistemi personalizzati | API REST e webhook firmati | Bidirezionale | Riferimento API |
Come scegliere il pattern di integrazione
| Esigenza | Pattern consigliato | Perché |
|---|---|---|
| Reagire subito a un evento (nuovo lead, prenotazione confermata) | Webhook | Latenza minima, nessun polling, consegna garantita con ritentativi |
| Leggere dati su richiesta durante una conversazione | Strumento richiamabile dal modello | Il modello interroga il tuo sistema solo quando serve davvero |
| Allineare grandi volumi una volta al giorno | Batch su SFTP o esportazione programmata | Efficiente, indipendente dalla disponibilità istantanea |
| Sistema legacy che non espone API | Middleware o scambio file | Non richiede modifiche al sistema legacy |
| Sistema che non può ricevere chiamate in ingresso | Polling delle API di Blu Pantheon | Il tuo sistema mantiene l'iniziativa |
Il webhook è quasi sempre la scelta giusta
Il polling frequente consuma quota di frequenza e introduce ritardi. Usalo solo quando il tuo sistema non può esporre un endpoint pubblico. Vedi Limiti di frequenza.
Prerequisiti comuni
Prima di iniziare
- Ruolo Amministratore tenant oppure permesso config:integrations:write
- Credenziali o chiavi del sistema di destinazione, con permessi minimi necessari
- Endpoint pubblici in HTTPS con certificato valido, per le integrazioni via webhook
- Un ambiente di prova del sistema di destinazione, per validare prima di andare in produzione
Sicurezza delle integrazioni
- Ogni integrazione dispone di credenziali dedicate, revocabili singolarmente senza impatto sulle altre.
- I webhook in uscita sono firmati con HMAC SHA-256: verifica sempre la firma prima di elaborare il payload. Vedi Firma HMAC.
- Le chiamate in ingresso richiedono una chiave API con ambito limitato: non usare mai una chiave con permessi completi per un'integrazione che ha bisogno di leggere una sola risorsa.
- Ogni attivazione, modifica o disattivazione genera una voce nell' audit log.
- I segreti delle integrazioni sono custoditi cifrati e non sono più visibili dopo il salvataggio.
Dove trovare le integrazioni in Console
L'elenco mostra per ogni integrazione lo stato (attiva, in errore, non configurata), la data dell'ultima sincronizzazione riuscita e il numero di errori nelle ultime 24 ore.