Embedding Gianna

An organisation contributor, manager, or owner can create a website entry point under Settings → Organisation → Project → Entry points. Give it a clear source name, choose Website embed, and set the opening question. Gianna returns an iframe snippet once. Copy it into the parish website.

Each embed belongs to one project and may also belong to one parish. Its visitor, message, recommendation, contact, sign-up, and feedback totals appear under that entry point in the project report. Visitors do not become members of the organisation.

Host page

The generated code is ready to use:

<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>

Treat the full src value as private configuration. It contains the entry-point token. If it is copied somewhere it should not be used, disable the entry point and create another one.

Gianna sends versioned messages to the exact origin recorded by the browser as the parent page:

• gianna:ready, with the initial height;
• gianna:resize, with the current height; and
• gianna:close when the visitor closes the conversation.

The host may send gianna:focus or gianna:theme with version: 1. A theme value must be light or dark. Both sides reject messages from other origins. The fixed-height snippet works without message handling. A host can use resize messages later if it wants the iframe to follow its content.

Before launch

Send the exact production origins to Gianna's operator. Each origin includes the scheme and hostname, for example https://parish.example.org; it does not include a path. Gianna rejects framing from every origin that is not on this list. Test the final desktop and mobile pages after the origin is added.

The embedded session is pseudonymous and does not require a name or contact details. The organisation receives aggregate project reporting, not the conversation. If the visitor asks to contact a person, Gianna shows who will receive the request and the details to be sent before asking for agreement.