Vai al contenuto
All articles
Setup

Trascrizione delle chiamate (speech-to-text)

Genera trascrizioni testuali delle registrazioni delle tue chiamate usando un provider speech-to-text (STT) sul tuo account (modello BYO).

Quando una chiamata ha una registrazione, il CRM può generare una TRASCRIZIONE testuale dell'audio usando un provider speech-to-text (STT). Il modello è BYO ("porta il tuo account"): scegli il provider (OpenAI Whisper, Deepgram, AssemblyAI o un endpoint REST generico) e inserisci LA SUA API key. La trascrizione viene eseguita e fatturata sul tuo account del provider, senza alcun costo, margine o intermediazione da parte nostra.

La funzione è inerte: senza uno STT configurato e abilitato, non succede nulla e il flusso delle chiamate resta esattamente lo stesso. L'API key è trattata come un segreto: viene cifrata sul server e non viene mai mostrata di nuovo.

Prerequisiti

  • Telefonia funzionante con registrazione (Twilio Voice), poiché la trascrizione parte dalla registrazione della chiamata.
  • Un account presso un provider STT (OpenAI, Deepgram, AssemblyAI) OPPURE un tuo endpoint REST.
  • L'API key di quel provider.
  • In Sellio, accesso da amministratore per configurare l'integrazione.

Provider supportati

  • OpenAI Whisper: il CRM scarica la registrazione (usando il tuo Auth Token Twilio quando la registrazione è un URL Twilio) e la carica per trascriverla.
  • Deepgram: recupera la registrazione tramite URL, che deve essere raggiungibile da loro.
  • AssemblyAI: funziona in modo asincrono. Il CRM invia l'URL e controlla periodicamente fino al completamento, e la registrazione deve essere raggiungibile da loro.
  • Generico (REST): qualsiasi servizio che accetti una POST con { audio_url } e restituisca il testo. Fornisci l'endpoint.

Come configurare

  1. Apri Impostazioni → Integrazioni e trova la scheda "Trascrizione delle chiamate (speech-to-text)".
  2. Scegli il provider STT.
  3. Incolla l'API key del provider. Facoltativamente imposta il modello (es. whisper-1, nova-2) e, per il provider generico, l'endpoint che riceve l'audio.
  4. Facoltativo: seleziona "Trascrivi automaticamente quando arriva la registrazione" per trascrivere senza cliccare.
  5. Clicca su "Salva" e poi su "Abilita".

Come trascrivere una chiamata

  1. Apri un Contatto/Lead e vai al pannello "Telefonia (chiamate)".
  2. Su una chiamata con registrazione, clicca su "Trascrivi".
  3. Attendi: lo stato mostra "Trascrizione in corso…" e, una volta completata, la trascrizione appare e può essere espansa.
💡 Se preferisci l'automazione, abilita "Trascrivi automaticamente": non appena arriva la registrazione, il CRM prova a trascrivere da solo (best-effort). Il pulsante "Trascrivi" rimane disponibile come percorso manuale affidabile.

Come testare

  1. Effettua una chiamata di prova e lasciala registrare.
  2. Nella cronologia, conferma il link "Riproduci registrazione" e clicca su "Trascrivi".
  3. Conferma che la trascrizione appaia e rifletta l'audio.

Risoluzione dei problemi

  • Il pulsante "Trascrivi" non appare: lo STT non è abilitato. Configura e abilita l'integrazione di trascrizione.
  • La trascrizione fallisce (stato "Trascrizione fallita"): verifica l'API key e, per Deepgram/AssemblyAI, se l'URL della registrazione è raggiungibile dal provider. Con Whisper, il CRM scarica la registrazione usando il tuo Auth Token Twilio.
  • Non succede nulla al flusso della chiamata: corretto. La trascrizione è best-effort e non interrompe mai la chiamata. In caso di fallimento, viene contrassegnato come fallito solo lo stato della trascrizione.
  • Costo: nel modello BYO, l'utilizzo va sul TUO account del provider STT; il CRM non fa da intermediario né addebita costi.

Open this article inside the system

Read it and want to see it working?

The account is free and the whole manual is available inside the system, with an assistant that answers from this very content.

Crea un account gratuito
Trascrizione delle chiamate (speech-to-text) · Sellio