Vai al contenuto
Integra / Prosopo Developers

Embed

Una persona sul tuo sito, con due righe di HTML. La configurazione si gestisce dallo Studio e il widget vive in un iframe isolato.

Aggiungi lo script

Abilita l’embed pubblico della persona e copia il codice dalla sua scheda Embed. Sostituisci l’host con l’URL pubblico del frontend Prosopo e l’ID con quello della persona. Non serve una chiave API.

HTML
<script async src="https://prosopo.example/prosopo.js"
  data-persona="ID_PERSONA_32_CARATTERI_HEX"
  data-layout="floating"
  data-position="right"
  data-initial-state="minimized">
</script>

Player inline

Inserisci lo script nel punto della pagina in cui vuoi mostrare il player. Il widget segue la larghezza del contenitore e il rapporto scelto.

HTML
<div style="max-width: 720px">
  <script async src="https://prosopo.example/prosopo.js"
    data-persona="ID_PERSONA_32_CARATTERI_HEX"
    data-layout="inline" data-aspect="16:9"
    data-initial-state="expanded"></script>
</div>

Attributi dello script

Gli attributi sovrascrivono il posizionamento salvato. Aspetto, testi, colori e controlli si configurano nella scheda Embed.

AttributoValori
data-personaID persona, obbligatorio
data-layoutinline | floating
data-positionleft | right
data-initial-stateexpanded | minimized
data-aspect16:9 | 9:16 | 1:1

Ricevi le azioni

Le azioni di tipo event configurate sulla persona arrivano al sito ospitante. Il loader verifica origine, iframe sorgente e ID prima di inoltrarle.

JavaScript
document.addEventListener("prosopo:action", ({ detail }) => {
  console.log(detail.persona, detail.name);
});

Microfono e pubblicazione

Servi il sito via HTTPS (localhost è ammesso in sviluppo). Consenti l’uso del microfono negli iframe nella Permissions-Policy del sito ospitante. La conversazione parte con un gesto dell’utente. Una persona privata non viene resa pubblica dagli attributi dello script.