Sicurezza e troubleshooting
Pubblica l’integrazione con credenziali protette e un comportamento prevedibile.
Chiavi e origini
Conserva le API key nel server. Al browser passa solo token temporanei e persona pubblica. Usa origini esplicite (schema, host, porta); i token vincolati a un’origine richiedono lo stesso header Origin nel WebSocket. Revocare una chiave impedisce nuovi token e nuove connessioni.
Configurazione di produzione
Abilita gli account e configura PROSOPO_SESSION_SECRET (almeno 32 caratteri), HTTPS/WSS, credenziali voce e modello e origini ammesse. La modalità sviluppo con autenticazione disabilitata non separa i dati per account. Il controllo di accesso delle REST API usa il proprietario della chiave.
Risolvi i problemi comuni
Microfono assente: verifica HTTPS, permessi browser e Permissions-Policy. Token rifiutato: controlla scadenza, riuso e origine. Widget indisponibile: abilita l’embed pubblico e attendi la preparazione avatar. Nessun audio: verifica credenziali provider, crediti e gesto utente per AudioContext. Slot occupati: consulta la concorrenza e chiudi le sessioni inutilizzate.
Compatibilità e funzionalità disponibili
Prosopo usa un proprio contratto API e un renderer nel browser. Non è un sostituto compatibile a livello di protocollo con Anam. WebRTC con frame RGB Python, audio passthrough per BYO TTS, registrazioni, report persistenti, webhook tools, meeting e video asincroni richiedono ulteriori implementazioni. talk supporta già un modello esterno tramite testo; sendAudio è input utente STT, non passthrough TTS.