Integrazioni

Finn funziona al meglio quando è collegato ai sistemi che già usi: il tuo CRM, il tuo calendario, il tuo operatore telefonico, la chat del tuo team. Questa pagina illustra ciascuno di essi partendo dal presupposto che tu non abbia mai configurato un'integrazione in vita tua.

Non ti servono tutte. La maggior parte degli utenti inizia solo con un calendario (così il Finn può fissare appuntamenti) ed eventualmente un CRM. Aggiungi le altre quando hai un'esigenza specifica.

Tutti i collegamenti sono reversibili. Puoi scollegare qualsiasi cosa in qualsiasi momento dalla stessa schermata che hai usato per collegarla. La piattaforma non trattiene mai i tuoi dati in ostaggio.

Dove trovare le integrazioni

Barra laterale → Impostazioni → Integrazioni.

Vedrai un riquadro per ogni integrazione disponibile con un'etichetta che ne indica lo stato: Non collegata, Collegata o Richiede attenzione. Clicca su un riquadro per configurarla o gestirla.

CRM

Un CRM è il luogo in cui conservi le schede dei clienti e dei contatti. Collegare il tuo CRM ti permette di:

1. Importare i contatti senza dover caricare manualmente file CSV.
2. Restituire gli esiti delle chiamate così il tuo team commerciale vede cosa è successo in ogni chiamata senza uscire dal CRM.

HubSpot

La configurazione è quasi tutta con pochi clic. Prevedi 10 minuti.

1. Impostazioni → Integrazioni → HubSpot → Collega.
2. Verrai reindirizzato a HubSpot. Accedi (se non l'hai già fatto) e clicca su Autorizza.
3. Tornerai su Finn con un badge verde "Collegato".
4. Ora decidi cosa vuoi importare. Clicca su Scegli elenchi. Seleziona gli elenchi HubSpot che vuoi usare come pubblici.
5. Imposta una pianificazione di sincronizzazione: ogni 15 minuti è un buon valore predefinito per le campagne attive; ogni giorno va bene per gli elenchi che cambiano più lentamente.
6. Mappa i campi: indica a Finn quale proprietà HubSpot è il nome, quale il telefono, quale il prefisso internazionale. Facoltativo: mappa altre proprietà su campi personalizzati così il Finn può usarle durante la chiamata.

Tutto qui. I tuoi elenchi HubSpot ora compaiono come pubblici in Finn.

Per far sì che gli esiti delle chiamate vengano scritti anche su HubSpot, attiva Sincronizzazione esiti durante la configurazione (o in qualsiasi momento successivo nella stessa schermata). Ogni chiamata completata diventa un'attività HubSpot; i campi dell'analisi post-chiamata diventano aggiornamenti delle proprietà.

Salesforce

Flusso generale identico a HubSpot. Alcune note specifiche per Salesforce:

• Puoi collegare Production o Sandbox. La procedura di configurazione ti chiede quale.
• Requisiti di permessi: ti serve un utente con "API Enabled" e "Read/Write" su Lead, Contatti e (se li usi) Oggetti personalizzati. La maggior parte degli amministratori CRM può farlo.
• Oggetti personalizzati supportati. Se il tuo processo di vendita usa un oggetto personalizzato (es. "Opportunity Owner Calls"), puoi mappare su quello invece che sugli standard Lead/Contatto.

Pipedrive

Pipedrive usa un token API invece di OAuth.

1. In Pipedrive: Settings → Personal preferences → API → Generate token.
2. Incolla il token in Finn → Impostazioni → Integrazioni → Pipedrive.
3. Prosegui con il resto della configurazione come per HubSpot.

"Il mio CRM non è in elenco"

Usa l'integrazione Webhook (più avanti in questa pagina) per inviare gli esiti delle chiamate ovunque tu possa ricevere richieste HTTP. Oppure usa uno strumento come Zapier/Make come ponte: vedi la sezione Zapier più sotto.

Calendario — per fissare appuntamenti

Se vuoi che il tuo Finn fissi appuntamenti, devi collegare un calendario.

Google Calendar

1. Impostazioni → Integrazioni → Google Calendar → Collega.
2. Accedi a Google e concedi i permessi per il calendario.
3. Scegli quale calendario usare per le prenotazioni. Molti ne hanno diversi: scegli quello giusto.
4. Imposta le regole di disponibilità:
   • Orario di lavoro — quando sono consentite le prenotazioni
   • Intervallo tra eventi — pausa minima tra appuntamenti consecutivi (es. 10 min)
   • Numero massimo di eventi al giorno — limite di sicurezza opzionale
5. Salva.

Ora in qualsiasi Finn puoi aggiungere un'attività o un'azione di workflow "Book Calendar" e verrà usato questo calendario.

Microsoft Outlook / Microsoft 365

Come per Google. Autorizza tramite Microsoft, scegli un calendario, imposta la disponibilità.

Calendly / Cal.com

Funzionano in modo diverso: non consentono la prenotazione diretta via API come Google/Outlook. Il Finn dice invece "Ti invio un link per la prenotazione" e viene inviato un SMS o un'email con l'URL.

Funziona, ma risulta meno naturale della prenotazione diretta. Se puoi scegliere, collega direttamente Google o Outlook.

Provider telefonici — se usi un tuo numero

Se hai già un numero di telefono presso un altro provider (Twilio, Vonage, il PBX del tuo ufficio), puoi continuare a usarlo tramite Finn.

Vedi Numeri di telefono → Usare il proprio numero per la guida completa.

Provider supportati: Twilio, Plivo, Bandwidth, Vonage e operatori generici conformi a SIP.

Webhook — per inviare dati ai tuoi sistemi

Un webhook è un URL sul tuo sistema a cui Finn invia dati quando accade qualcosa (una chiamata è terminata, un deployment si è concluso, ecc.).

Utile quando:

• Vuoi che ogni chiamata completata confluisca nel tuo data warehouse per analisi personalizzate
• Vuoi attivare un messaggio Slack o un'email quando accade qualcosa di specifico
• Il tuo CRM o applicativo aziendale non è supportato nativamente, ma può ricevere richieste HTTP
• Vuoi usare Zapier/Make/n8n per automatizzare azioni a valle

Configurare un webhook

1. Impostazioni → Integrazioni → Webhook → Aggiungi endpoint.
2. Inserisci l'URL a cui Finn deve inviare i dati.
3. Scegli a quali eventi iscriverti:
   • Chiamata iniziata — si attiva nel momento in cui inizia una chiamata
   • Chiamata completata — si attiva al termine di una chiamata (trascrizione pronta ma non ancora analizzata)
   • Chiamata analizzata — si attiva al termine dell'analisi post-chiamata (la più utile per l'automazione a valle)
   • Deployment avviato — si attiva quando un deployment va in produzione
   • Deployment completato — si attiva quando un deployment termina, con le metriche aggregate
4. Salva. Finn mostra un signing secret: copialo in un luogo sicuro (lo vedrai una sola volta).
5. Verifica il signing secret sul tuo endpoint per confermare che le richieste provengano davvero da Finn.

Come sono fatti i dati

Ogni evento invia JSON al tuo URL. Un evento call.analyzed ha all'incirca questo aspetto:

{
  "event": "call.analyzed",
  "call": {
    "id": "call_abc123",
    "deployment_id": "deploy_xyz",
    "started_at": "2026-06-15T10:30:00Z",
    "duration_seconds": 142,
    "contact": { "name": "Alice Chen", "phone_number": "+15551234567" },
    "transcript": [ ...turn-by-turn... ],
    "post_call_analysis": {
      "appointment_booked": true,
      "appointment_time": "2026-06-22 14:00"
    },
    "sentiment": "positive"
  }
}

Lo schema completo è nel nostro riferimento per sviluppatori su api.hirefinn.ai/docs.

Quando i webhook non funzionano

Se Finn non riesce a raggiungere il tuo endpoint (errore DNS, timeout, risposta 5xx), riprova con backoff fino a 24 ore. Ogni consegna fallita compare in Impostazioni → Integrazioni → Webhook → Registro consegne con il messaggio di errore, utile per il debug.

Webhook durante una chiamata (ricerca di dati in tempo reale)

Esiste un altro tipo di webhook: quello che il tuo Finn chiama durante una conversazione per recuperare dati in tempo reale.

Esempio: un cliente chiama per il suo ordine. Il Finn deve conoscere lo stato dell'ordine, ma quel dato risiede nel tuo sistema, non in Finn. Il Finn chiama il tuo endpoint /lookup con il numero di telefono del cliente, il tuo endpoint restituisce { "order_status": "shipped", "tracking": "1Z..."} e il Finn lo usa nella risposta: "Il tuo ordine è stato spedito ieri: il numero di tracciamento termina con..."

Per configurarlo: nel Workflow del tuo Finn, aggiungi un nodo Azione → Webhook. Configura l'URL e i dati da inviare. La risposta diventa disponibile come variabili del workflow.

API REST — per il controllo programmatico

Alcuni team vogliono controllare Finn dal proprio codice: avviare deployment a livello programmatico, importare i dati delle chiamate in dashboard personalizzate e così via.

Impostazioni → Integrazioni → Chiavi API → Genera nuova chiave. Copia e conserva la chiave in modo sicuro.

Poi usa l'API:

POST https://api.hirefinn.ai/v1/deployments
Authorization: Bearer your_api_key

{
  "finn_id": "finn_abc",
  "audience_id": "aud_xyz",
  "from_number": "+15551234567"
}

Abbiamo SDK ufficiali per Node, Python, Go e Ruby. Riferimento completo su api.hirefinn.ai/docs.

Se non sei uno sviluppatore e questa sezione ti sembra ostica: non ti serve. La dashboard fa tutto ciò che fa l'API. L'API serve solo ai team che vogliono automatizzare via script.

Slack — ricevi notifiche nella chat del team

Utile per la consapevolezza operativa — "il deployment X è terminato, ecco i numeri" — senza costringere tutti ad accedere a Finn.

1. Impostazioni → Integrazioni → Slack → Aggiungi allo spazio di lavoro.
2. Autorizza in Slack.
3. Scegli un canale per le notifiche.
4. Scegli gli eventi da notificare:
   • Deployment avviato
   • Deployment completato (con statistiche di riepilogo)
   • Deployment fallito
   • Riepilogo giornaliero del mattino
   • Avvisi di soglia (es. "tasso di successo sceso sotto X")

Puoi collegare più canali: team diversi potrebbero volere tipi di notifica diversi.

Zapier / Make / n8n

Per l'automazione no-code, usa l'integrazione Webhook descritta sopra come sorgente trigger nel tuo strumento di automazione preferito.

Stiamo inoltre sviluppando un'app Zapier nativa: richiedi l'accesso anticipato da Impostazioni → Integrazioni → Zapier.

SSO (Enterprise)

Il Single Sign-On consente al tuo team di accedere con l'identità aziendale esistente (Okta, Azure AD, Google Workspace, ecc.) invece che con password Finn separate.

Disponibile sui piani Enterprise.

• SAML 2.0 — funziona con tutti i principali provider di identità.
• SCIM — provisioning automatico degli utenti. Quando aggiungi qualcuno al gruppo giusto nel tuo IdP, ottiene automaticamente un account Finn. Quando lo rimuovi, perde l'accesso.

La configurazione si trova in Impostazioni → Sicurezza → SSO. I reparti IT della maggior parte delle aziende l'hanno già fatto: il flusso è standard.

Conformità e residenza dei dati

Non è propriamente un'integrazione, ma vale la pena saperlo:

• GDPR — pienamente supportato. Diritto alla cancellazione, esportazione, residenza dei dati nell'UE.
• HIPAA — Solo Enterprise, con BAA firmato.
• SOC 2 Type II — attuale. Report di audit disponibili sotto NDA.
• Residenza dei dati — scegli la regione US, EU o India al momento della creazione dell'account. (Non può essere spostata in seguito senza migrazione manuale: scegli con attenzione alla registrazione.)

Altre informazioni su hirefinn.ai/platform/security.

Domande frequenti

D: Posso sincronizzare più CRM contemporaneamente? R: Sì. Ogni connessione CRM è indipendente. Audience diverse possono sincronizzarsi da CRM diversi.

D: Il mio webhook viene attivato ma il mio sistema non riceve i dati. R: Controlla Impostazioni → Integrazioni → Webhook → Registro consegne per l'errore. I più comuni: problema con il certificato SSL, blocco IP o endpoint che restituisce un codice diverso da 200.

D: Ho disconnesso il mio CRM per errore. Ho perso dei dati? R: No. La disconnessione interrompe solo le sincronizzazioni future. Tutti i dati audience esistenti, la cronologia chiamate ecc. rimangono. Riconnetti quando vuoi.

D: Posso usare l'API e la dashboard per lo stesso account? R: Sì. Molti team usano l'API per l'automazione e la dashboard per le operazioni manuali. Entrambe riflettono lo stesso stato sottostante.

Avanti

• Workflow → — usare le integrazioni come nodi Action all'interno di un Finn.
• Fatturazione → — quote API e webhook per piano.
• Conformità → — a cosa devono essere conformi le tue integrazioni.