Configurazione Assieasy Connector

Guida completa per integrare Assieasy con AI4CALL: consulta anagrafiche clienti, polizze, documenti e invia certificati automaticamente

AI4CALL - MCP Assieasy Connector Configurazione

Vai in MARKET → Marketplace Plugin e clicca su Acquista di Assieasy Connector → FREE. Vai in MARKET → I Miei Plugin e clicca su Configura di Assieasy Connector

Navigazione rapida:

⚠️ Servizi di terze parti

Le integrazioni descritte fanno riferimento a servizi di terze parti.
Rate limit, modalità di autenticazione, configurazioni tecniche, costi e policy sono definiti esclusivamente dai rispettivi provider e possono variare nel tempo.

I costi dei servizi esterni sono sostenuti direttamente dall’utente finale a favore dei fornitori dei servizi stessi e non sono in alcun modo gestiti o intermediati dal nostro portale (es. Meta o altri fornitori per WhatsApp, Zapier, Calendly, ecc.).

⚠️ IMPORTANTE - Integrazione SOLA LETTURA + Invio
L'assistente può CONSULTARE dati Assieasy e INVIARE documenti, ma NON può modificarli. Operazioni permesse: cercare clienti per numero telefono, leggere polizze attive e scadenze, elencare documenti disponibili, inviare documenti via email. Operazioni NON permesse: creare/modificare anagrafiche clienti, emettere nuove polizze, modificare premi o coperture, cancellare polizze o documenti, registrare pagamenti, gestire sinistri. Per operazioni critiche: l'assistente trasferisce chiamata ad agente umano.
1

Cos'è Assieasy e come si integra con AI4CALL

Assieasy è un gestionale cloud completo per agenzie assicurative che centralizza anagrafiche clienti, portfolio polizze, scadenzari, documenti e comunicazioni con compagnie.

🏢 funzionalità Assieasy:
Gestione anagrafiche: database clienti con dati personali, contatti, documenti identità, storico interazioni, preferenze, note agente. Portfolio polizze: tutte polizze cliente (auto, casa, vita, infortuni, RC, etc.), dettagli compagnia, numero polizza, premio, scadenza, coperture, scadenzario automatico con alert rinnovi. Archivio documenti: polizze PDF, quietanze, preventivi, certificati, card verde, comunicazioni compagnie, documenti sinistri, archiviazione cloud sicura e ricercabile. Multi-compagnia: integrato con tutte principali compagnie, preventivazione comparativa.
💡 Come AI4CALL usa Assieasy
Workflow tipico: cliente chiama, assistente risponde, cerca cliente per telefono, ottiene dati, cliente chiede info polizza, assistente recupera polizze, comunica scadenze, su richiesta invia documenti via email. Vantaggio: cliente ottiene info e documenti istantaneamente senza attendere agente umano.
🔒 Privacy e GDPR
Dati assicurativi sono sensibili - rispetta privacy. Best practice: verifica identità cliente PRIMA di comunicare dati polizza, non comunicare premi/coperture a terzi non autorizzati, log accessi Assieasy per audit trail, istruisci AI a non registrare dati sensibili in transcript pubblici, documenti inviati solo a email configurata in Assieasy. GDPR compliance: Assieasy è GDPR-compliant, integrazione eredita compliance se usata correttamente.
2

Ottieni credenziali API Assieasy

Per integrare AI4CALL con Assieasy necessiti di 3 credenziali: Username API, Password API e Secret.

🎯 come ottenere credenziali:
Contatta supporto Assieasy, richiedi attivazione API e generazione credenziali, supporto fornisce credenziali e istruzioni.
✅ Credenziali ottenute!
Dovresti avere: Username Assieasy (es. api_user@agenzia.com), Password Assieasy (alfanumerica), Secret (chiave lunga). Conserva sicuramente - sono le chiavi di accesso all'intero database clienti e polizze!
🔐 Sicurezza credenziali API
Credenziali API Assieasy garantiscono accesso completo a dati sensibili clienti. Protezione obbligatoria: NON condividere con personale non autorizzato, NON committare in repository Git o documenti pubblici, conserva in password manager enterprise, accesso solo a admin/tecnici autorizzati, rigenera periodicamente. Se credenziali compromesse: contatta immediatamente amministratore Assieasy per revoca e rigenerazione.
3

Configura Assieasy in AI4CALL

Inserisci le credenziali Assieasy in AI4CALL per abilitare l'integrazione.

⚙️ procedura configurazione:
Seleziona Assieasy Connector dall'elenco Plugin, inserisci Username, Password e Secret, verifica nessuno spazio extra, clicca TEST CONNESSIONE, se OK salva configurazione.
✅ Test connessione riuscito
Se test connessione restituisce successo: credenziali corrette, API Assieasy raggiungibile, autenticazione funzionante, tool pronti per uso. Procedi con selezione tool da abilitare!
❌ Troubleshooting test connessione fallito
Errore 401 Unauthorized: verifica credenziali, nessuno spazio extra, credenziali non scadute. Errore Timeout: verifica server online, firewall, URL API. Errore API disabilitata: contatta supporto Assieasy per attivare API.
AI4CALL - MCP Assieasy Connector Configurazione
Pannello "Configurazione Assieasy Connector": inserimento Username, Password, Secret e selezione Tools Disponibili
4

Seleziona tool disponibili per l'assistente

Scegli quali operazioni Assieasy abilitare per l'assistente AI tramite checkbox.

🛠️ tool Assieasy configurabili:
1. Ricerca Anagrafica tramite Telefono: cerca cliente per telefono, restituisce customer_id e dati. FONDAMENTALE - prerequisito per altri tool. 2. Recupero Documenti Cliente: elenca documenti archiviati. 3. Invio Documento a Cliente: invia documento via email. Richiede Recupero Documenti. 4. Recupero Polizze Cliente: elenca tutte polizze con dettagli.
💡 Configurazioni consigliate
Setup COMPLETO: abilita tutti 4 tool per esperienza completa. Setup CONSULTAZIONE ONLY: disabilita Invio Documento. Setup INFO POLIZZE: solo Ricerca + Recupero Polizze.
⚙️ Dipendenze tool
Ricerca Anagrafica: prerequisito per TUTTI altri tool (serve customer_id). Invio Documento: richiede Recupero Documenti abilitato. Best practice: abilita tutti 4, disabilita solo per motivi policy/sicurezza specifici.
5

Istruisci l'assistente per workflow Assieasy

Configura il prompt dell'assistente per utilizzare correttamente i tool Assieasy nei workflow assicurativi.

📝 Workflow consigliati da inserire nel prompt
1. Verifica scadenza polizza + invio certificato: cerca cliente, recupera polizze, identifica polizza, comunica scadenza, su richiesta recupera e invia certificato. 2. Riepilogo portfolio: cerca cliente, recupera polizze, elenca per tipo, identifica prossime scadenze. 3. Invio documenti: cerca cliente, recupera documenti, filtra per tipo, invia documento specifico. 4. Verifica identità: sempre verifica con data nascita o CF prima di comunicare dettagli polizza.
🧪 Test workflow completo
Test 1 - Ricerca cliente: chiama da numero registrato, verifica riconoscimento. Test 2 - Info polizza: chiedi scadenza, verifica risposta corretta. Test 3 - Invio documento: chiedi certificato, verifica email ricevuta. Test 4 - Cliente non trovato: chiama da numero non registrato, verifica gestione elegante.

🛠️ Tool Reference Assieasy

Specifiche tecniche dei 4 tool MCP Assieasy.

🔍 search_customer
Cerca cliente in database Assieasy tramite numero telefono. Parametri: phone_number (obbligatorio). Response: customer_id, nome, cognome, email, telefono, indirizzo.
🛡️ get_policies
Recupera tutte polizze associate al cliente. Parametri: customer_id (obbligatorio). Response: array polizze con policy_id, tipo, compagnia, numero_polizza, premio_annuo, data_scadenza, status.
📂 get_documents
Elenca documenti archiviati per cliente. Parametri: customer_id (obbligatorio). Response: array documenti con document_id, nome_file, tipo, polizza_associata, data_upload.
✉️ send_document
Invia documento specifico via email al cliente. Parametri: customer_id, document_id (obbligatori). Invia email a indirizzo configurato in anagrafica cliente con PDF allegato.

❓ Domande Frequenti

Risposte alle domande più comuni su Assieasy Connector

Assieasy è un gestionale cloud per agenzie assicurative che consente di gestire clienti, polizze e documenti. L'integrazione permette all'assistente AI telefonico di consultare dati e documenti assicurativi esclusivamente dopo l'autenticazione del cliente tramite PIN, secondo le regole definite nel caso d'uso.

Le credenziali API (es. username, password, secret o token) devono essere richieste direttamente al supporto tecnico Assieasy. La disponibilità e le modalità di attivazione dipendono dal contratto sottoscritto con il fornitore.

L'identificazione avviene tramite il numero di telefono del chiamante, mentre l'accesso ai dati avviene solo dopo la verifica del PIN personale a 6 cifre. Senza un PIN valido e associato al numero chiamante, l'assistente non può fornire informazioni personali o contrattuali.

Dopo autenticazione valida, l'assistente può: consultare polizze attive e scadenze, recuperare documenti associati al cliente, inviare documenti via email all'indirizzo registrato. L'integrazione è in sola lettura e non consente modifiche ai dati.

No. L'assistente non può creare, modificare o cancellare polizze, né aggiornare dati anagrafici o registrare pagamenti. Per queste operazioni è necessario l'intervento di un operatore umano o l'uso dei canali ufficiali del broker o della compagnia.

I documenti vengono inviati via email utilizzando l'indirizzo registrato in Assieasy. La configurazione dell'email, i template e il mittente sono gestiti dal sistema Assieasy o dal provider di posta configurato.

Se il numero non è presente in anagrafica o non è associato a un PIN valido, l'assistente non fornisce informazioni personali e può limitarsi a fornire indicazioni generiche o indirizzare il cliente a un operatore.

No. La gestione dei sinistri e i rinnovi di polizza richiedono processi complessi e validazioni formali. L'assistente può solo fornire informazioni generales o indirizzare il cliente ai canali ufficiali competenti.

Eventuali limiti di utilizzo, costi, policy API e condizioni contrattuali sono definiti esclusivamente da Assieasy. I costi dei servizi di terze parti sono a carico dell'utente finale e non sono gestiti dal nostro portale.


Alcuni degli utilizzatori di ai4call