Incorporare Gianna

Un collaboratore, responsabile o proprietario dell’organizzazione può creare un punto di accesso web sotto Organizzazione (nell’intestazione) → Progetto → Punti di accesso. Assegna un nome di fonte chiaro, scegli Incorporamento nel sito web e imposta la domanda iniziale. Gianna restituisce uno snippet iframe una sola volta. Copialo nel sito parrocchiale.

Ogni incorporamento appartiene a un progetto e può appartenere anche a una parrocchia. I totali di visitatori, messaggi, suggerimenti, contatti, iscrizioni e riscontri compaiono sotto quel punto di accesso nel rapporto del progetto. I visitatori non diventano membri dell’organizzazione.

Pagina ospitante

Il codice generato è pronto all’uso:

<iframe
  src="https://gianna.chat/embed?c=ENTRY_POINT_TOKEN&amp;q=OPENING_QUESTION"
  title="Ask Gianna"
  loading="lazy"
  allow="autoplay; clipboard-write; fullscreen"
  style="width:100%;height:720px;border:0;border-radius:16px"
></iframe>

Tratta l’intero valore src come configurazione privata: contiene il token del punto di accesso. Se viene copiato dove non dovrebbe essere usato, disattiva quel punto e creane un altro.

Gianna invia messaggi versionati all’origine esatta che il browser registra per la pagina genitore:

• gianna:ready, con la height iniziale;
• gianna:resize, con la height attuale;
• gianna:close quando il visitatore chiude la conversazione.

La pagina ospitante può inviare gianna:focus o gianna:theme con version: 1. Il tema deve essere light o dark. Entrambe le parti rifiutano messaggi da altre origini. Lo snippet ad altezza fissa funziona senza gestione dei messaggi. In seguito la pagina può usare i messaggi di ridimensionamento per adattare l’iframe al contenuto.

Prima del lancio

Invia le origini esatte di produzione al gestore di Gianna. Ogni origine comprende schema e nome host, per esempio https://parish.example.org, senza percorso. Gianna rifiuta l’incorporamento da ogni origine non presente nell’elenco. Prova le pagine finali su desktop e mobile dopo l’aggiunta dell’origine.

La sessione incorporata è pseudonima e non richiede nome o recapiti. L’organizzazione riceve dati aggregati del progetto. Se il visitatore vuole contattare una persona, Gianna mostra il destinatario e i dati da inviare prima di chiedere il consenso.