> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/email-experiences/create-and-customize-advocate-program-emails.md).

# Crea e personalizza le email del programma Advocate

<a href="https://pxa.impact.com/student/activity/2356725-micro-create-and-customize-transactional-emails-on-impact-com-advocate?utm_source=help.impact.com&#x26;utm_medium=featured-link&#x26;utm_content=adv-250-1&#x26;utm_campaign=help-center" class="button primary">Segui il corso PXA</a>

Il tuo programma è inizialmente configurato con versioni predefinite delle email del programma per consentirti di essere operativo il più rapidamente possibile. Queste versioni predefinite sono caricate con immagini e messaggi generici per trasmettere l’essenza dell’email. Ti consigliamo di personalizzare le email del tuo programma per assicurarti che le informazioni siano pertinenti al tuo programma e al tuo prodotto.

Consulta la nostra documentazione su [tag di unione](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/email-experiences/merge-tags-for-program-emails.md) per informazioni su come includere nei tuoi messaggi i dettagli specifici del partecipante.

#### Crea o modifica un modello di email

Avrai creato almeno un'email del programma quando configuri le regole del tuo programma. Ti consigliamo di modificare le email del programma esistenti e di crearne una nuova solo se necessario.

1. Dal menu di navigazione a sinistra, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Contenuto**.
2. Nel *Email* scheda, seleziona **Crea nuovo** o **Modifica le email** per modificare i modelli esistenti.
3. Se stai creando un nuovo modello, seleziona **Crea un nuovo modello di email** e inserisci un ID breve e descrittivo per il modello di email (ad es. Acme Advocates) per identificare l'email. Usa questo ID per identificare l'email durante la configurazione delle regole del tuo programma.

<div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FIR5QSAin40X9EQ22qwp1%2FScreenshot%202026-05-15%20at%2017.28.52.png?alt=media&amp;token=9f1f9dd6-f1a7-455c-8c05-cd2d69d2ae06" alt="" width="375"><figcaption></figcaption></figure></div>

* Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FPORUgP0qyEEctyFkbw08%2Factions.svg?alt=media\&token=2d406300-0455-4291-8028-aed6300b6e3c) **\[Altro]** per eliminare un modello.
* Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FYaEYpaDDip5FxDbF8lnO%2Fclose.svg?alt=media\&token=da6580c0-a38f-4bf9-a34a-619921f19e9e) **\[Icona di uscita]** per ridurre a icona il menu laterale.

<div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FLx78unF9aeRdAvth73yD%2FScreenshot%202026-05-15%20at%2017.34.49.png?alt=media&amp;token=1404451f-8581-4a74-a7b5-db7091f5ca6e" alt="" width="295"><figcaption></figcaption></figure></div>

4. Prima di usare l'editor, seleziona **Modifica** per compilare i campi obbligatori *Informazioni di contatto* in alto sullo schermo.
   * Inserisci il **Nome mittente** aggiungendo un nome statico che viene visualizzato nell'email, ad es. Acme Advocates.
   * Inserisci un **Indirizzo mittente** da cui ha origine il dominio personalizzato dell'email.
     * Se desideri modificare il *Da* indirizzo email, dovrai modificare le impostazioni per assicurarti che il nostro sistema invii email autentiche per tuo conto. Per utilizzare un dominio di tua proprietà per il *Indirizzo mittente*, devi [configurare un dominio](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/set-up-a-domain-for-advocate.md) dalla *Impostazioni* pagina.
   * Inserisci un **CCN** per inviare una copia dell'email.
   * Inserisci un **Oggetto** per l'email.
   * Seleziona **Fatto** per salvare queste informazioni.
5. Quindi, procedi all'uso dell'editor.

#### Utilizzo dell'editor

Potrebbe essere necessario aggiornare il tuo editor email alla versione più recente prima di poter redigere facilmente la tua email. Per farlo, cerca il banner blu in cima alla pagina e seleziona **Aggiorna ora**.

<div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FQ5ZsiTHdZm8wMCrohDLA%2Fimage1.jpg?alt=media&amp;token=2ab3560f-9b6e-476c-9b28-b501845ac694" alt=""><figcaption></figcaption></figure></div>

Tutte le immagini, il testo e i link nell'email sono suddivisi in singoli componenti che compongono la struttura dell'email. Questi componenti sono gli elementi base dell'email.

<div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FNBD7LwnNfuR7328rjMtx%2FPreview%20options.png?alt=media&amp;token=ed9fcbda-7043-42b7-9bfc-2cafbca4836c" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="success" icon="memo-circle-check" %}
**Nota:** Fai riferimento al [*Riferimento dei componenti dell'email*](#component-reference-0-2) sezione seguente per capire meglio come funzionano le icone dell'editor.
{% endhint %}

<details>

<summary>Opzioni di anteprima</summary>

* **Menu a discesa Azioni** - Questa opzione ti consente di scegliere tra l'anteprima dell'email nel suo insieme o l'invio di un'email di prova. Puoi anche passare dalla visualizzazione della tela per desktop a quella per dispositivi mobili.
* **Mostra struttura** - Questa opzione applica una griglia alla tela, così puoi verificare l'allineamento dei vari componenti.
* **Mostra i tag di unione** - Questa opzione ti consente di attivare la visualizzazione di come i valori dinamici appariranno ai destinatari. Ad esempio, invece di vedere il testo segnaposto, come *Nome azienda*, vedrai il nome effettivo dell'azienda, ad es. Stark Industries.
* **Importa modello di email** - Questa opzione ti consente di importare tutti i modelli di email esistenti che hai creato.
* **Esporta modello di email** - Una volta redatta l'email, puoi usare questa opzione per esportare il modello di email.

</details>

<details>

<summary>Aggiungi un componente email</summary>

**Limitato:** L'aggiunta di componenti extra a un'email Advocate è disponibile solo in specifiche edizioni Advocate. [Contatta il supporto](https://app.impact.com/support/portal.ihtml) per aggiornare il tuo account e accedere a questa funzione.

1. Seleziona ![content-advocate.svg](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-29f7728451e63f195300b790407cfb1c.svg) **\[Contenuto]** per scegliere un nuovo componente.
2. **Seleziona e trascina** il componente nell'area dell'email in cui desideri che appaia. Nell'email apparirà una barra verde per aiutarti a posizionare il nuovo componente.
3. Facoltativamente, modifica il contenuto o l'aspetto del componente:
   * **Seleziona** il componente che desideri modificare.
   * A destra, nella sezione contenuto, appariranno le opzioni di modifica per quel componente.
4. **Salva** le tue modifiche.
   * L'editor email non salva automaticamente le modifiche. Assicurati di selezionare **Salva** in alto a destra dello schermo. Se hai commesso un errore, puoi uscire dall'editor e le modifiche non verranno salvate.

{% hint style="success" icon="memo-circle-check" %}
**Nota:** I nuovi componenti interagiranno con i componenti esistenti nell'email, il che può causare lo spostamento di testo e immagini già presenti. Di solito è più semplice apportare modifiche ai componenti esistenti aggiornando un'immagine esistente o aggiungendo testo al contenuto già presente.
{% endhint %}

</details>

<details>

<summary>Elimina un componente</summary>

1. Nel *area di lavoro*, seleziona il componente che vuoi eliminare.
2. Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c5ab8423372b2c345ded634b7aa4cab16c87fe3a%2Fd17a259fe817ff10ea9fd87140a89bd62ece6fa9940e05902574dcf95bed5960.svg?alt=media) **\[Elimina]** per eliminare il componente dall'email.
3. **Salva** le tue modifiche.

</details>

<details>

<summary>Aggiorna il testo dell'email</summary>

Il testo dell'email è suddiviso in componenti di testo gestiti in diverse sezioni dell'email.

1. Aggiungi un nuovo componente di testo dalla ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fo2J9TnFAWAB5Q0TR5RVQ%2Fcontent.svg?alt=media\&token=06038792-1227-4dc9-94eb-938c1aef7dc4) **\[Contenuto]** sezione oppure seleziona un componente esistente.
2. Modifica il testo nel componente digitando direttamente nell'area.
3. Con il componente di testo evidenziato, puoi modificare il carattere, il colore, il peso o la spaziatura del testo a sinistra, sotto la *contenuto* sezione.
4. Una volta completati gli aggiornamenti, seleziona **Azioni** ![\[Drop-down menu\]](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-d6b35853a9aa1f1fe6bd66da29bd09fa.svg) **\[Menu a discesa] → Invia email di prova** per inviarti un'email di prova.
5. Se l'email di prova ti sembra buona, **Salva** le tue modifiche.

</details>

<details>

<summary>Aggiungi un'immagine personalizzata</summary>

**Limitato:** L'aggiunta di un componente immagine personalizzata extra a un'email Advocate è disponibile solo in specifiche edizioni Advocate. [Contatta il supporto](https://app.impact.com/support/portal.ihtml) per aggiornare il tuo account e accedere a questa funzione.

1. Aggiungi un nuovo componente immagine oppure evidenzia il componente immagine che desideri aggiornare.
2. Una volta selezionato, fai doppio clic per aprire la finestra *Seleziona immagine* . Seleziona la **Aggiungi immagini** per selezionare l'immagine che desideri usare. Una volta caricata l'immagine nella *Seleziona immagine* finestra, fai doppio clic per aggiungerla al nuovo componente.
3. Regola le dimensioni e la posizione dell'immagine usando i selettori nella *Area di lavoro*.
4. Una volta completati gli aggiornamenti, seleziona **Azioni** ![\[Drop-down menu\]](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-d6b35853a9aa1f1fe6bd66da29bd09fa.svg) **\[Menu a discesa]** → **Invia email di prova** per inviarti un'email di prova.
5. Se l'email di prova ti sembra buona, **Salva** le tue modifiche.

</details>

<details>

<summary>Aggiungi contenuti dinamici</summary>

I tag di unione ti consentono di aggiungere contenuti dinamici, come il nome del partecipante o l'importo del premio, al testo dell'email. Puoi aggiungere un tag di unione a qualsiasi componente di testo.

{% hint style="success" icon="memo-circle-check" %}
**Nota:** Se non esistono informazioni corrispondenti al tag di unione che stai usando, i partecipanti vedranno uno spazio aggiuntivo nel testo dell'email. Ad esempio, se usi *"Ciao `{{user.firstName}}`. Come stai?"* nella tua email ma l'utente non aveva dati nel campo firstName, l'email verrebbe visualizzata come *"Ciao . Come stai?"*.
{% endhint %}

1. Nell'area di lavoro, aggiungi o seleziona il componente di testo a cui desideri aggiungere un tag di unione.
2. Nella barra degli strumenti collegata al componente, posiziona il cursore nell'area in cui desideri inserire il tag di unione, quindi seleziona **Tag di unione**.

<figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FPCMuULUS7H42tUZ60QoQ%2Fimage23.jpg?alt=media&amp;token=53787980-a6e8-4baa-92d8-32092c6577a6" alt=""><figcaption></figcaption></figure>

3. **Salva** le tue modifiche.

{% hint style="danger" %}
**Importante:** Un'email di prova inviata all'interno dell'editor non includerà alcun valore nei punti in cui sono stati inseriti i tag di unione.
{% endhint %}

</details>

#### Riferimento dei componenti dell'email <a href="#component-reference-0-2" id="component-reference-0-2"></a>

Questa sezione ti guiderà attraverso le varie icone della barra degli strumenti disponibili nell'editor email.

<details>

<summary>Icone dei contenuti</summary>

In questa scheda puoi inserire componenti e modificare l'aspetto di ciascun componente una volta selezionato e inserito nell'area di lavoro:

| Elemento                                                                                                                                                                                                                                                                                            | Descrizione                                                                                                                                                                                           |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FYCXHiHVTWfJd9m5dSBm5%2Fcash-reward.png?alt=media&amp;token=d79b57ec-56db-449f-8168-6dc5bcd05ecf" alt="" data-size="line"> **\[Codice premio in denaro Advocate]** | Inserisci nell'area di lavoro un componente codice premio in denaro Advocate per visualizzare i codici premio in denaro disponibili.                                                                  |
| <img src="https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-39d957530748d07d955b2eb7c5bb7f8f.png" alt="advocate.png" data-size="line"> **\[Codice premio Advocate]**                                                                         | Inserisci nell'area di lavoro un componente codice premio Advocate per creare codici premio fueltank.                                                                                                 |
| <img src="https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-e4f78e511bd3efb78537bf2ed920d0ad.png" alt="friend-reward-code.png" data-size="line"> **\[Codice premio amico]**                                                                  | Inserisci nell'area di lavoro un componente codice premio amico per creare codici premio fueltank da condividere con gli amici.                                                                       |
| ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FuxynJEcbk4S5E8hkFEKw%2Ftitle.svg?alt=media\&token=605edbbe-f27f-45aa-80a2-cdc2c13b61e1) **\[Titolo]**                                                                   | Inserisci nell'area di lavoro un componente di testo titolo.                                                                                                                                          |
| ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FVrVgZll5usxxjDWf7L94%2Fparagraph.svg?alt=media\&token=be7ef73b-b97b-45e4-9b0d-43c764926c17) **\[Paragrafo]**                                                            | Inserisci nell'area di lavoro un componente di testo paragrafo.                                                                                                                                       |
| ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FeuUnjuYUumdohuopa6mU%2Flist.svg?alt=media\&token=505803bb-5464-4e30-a929-c951675df0bd) **\[Elenco]**                                                                    | Inserisci nell'area di lavoro un componente elenco puntato.                                                                                                                                           |
| ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Ftu6hqXxz6elysJo0ex1y%2Fimage-advocate.svg?alt=media\&token=7da0f11f-d9a0-4f71-ad80-092cba9b6349) **\[Immagine]**                                                        | Inserisci nell'area di lavoro un componente immagine.                                                                                                                                                 |
| ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FfXOb6an9lqPVapvuo6bs%2Fbutton.svg?alt=media\&token=47f38c07-1d81-4653-8601-da5bf502249e) **\[Pulsante]**                                                                | Inserisci nell'area di lavoro un componente pulsante interattivo.                                                                                                                                     |
| ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Frpc9Do20nUYt3yIKFxCS%2Fdivider.svg?alt=media\&token=839b1ff8-2462-4b01-b2b2-de821011962e) **\[Divisore]**                                                               | Inserisci nell'area di lavoro un componente divisore.                                                                                                                                                 |
| ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fk5pcvSl5XXluqCdD2dGy%2Fspacer.svg?alt=media\&token=7377a946-a270-4470-ba51-6741a5f2b5c7) **\[Spaziatore]**                                                              | Inserisci nell'area di lavoro un componente spaziatore.                                                                                                                                               |
| ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FdXmbTd1V5uFz1HGW7nB0%2Fsocial.svg?alt=media\&token=d29c6b2a-dd82-42cb-a1ae-9f157805fabe) **\[Social**                                                                   | Inserisci un componente social per aggiungere pulsanti dei social media che rimandino alle tue varie piattaforme social.                                                                              |
| ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FyPIYAGvIzQSugnllMaOT%2Fdynamic-content.svg?alt=media\&token=c11160f2-5d43-4e92-baf5-eacb073faaaa) **\[Contenuti dinamici]**                                             | Inserisci componenti di contenuti dinamici per aggiungere informazioni che vuoi vengano compilate dinamicamente al momento dell'invio delle email, in modo che l'email abbia un tocco personalizzato. |
| ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FeZW6r3IlS2r9SPQAoyla%2Fhtml.svg?alt=media\&token=af61fdaa-f037-418b-a5c5-cffbe0aff2f1) **\[HTML]**                                                                      | Inserisci nell'area di lavoro componenti con codice HTML. Puoi inserire il codice a destra e verrà formattato nell'area di lavoro.                                                                    |
| ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FuecEBimGmp1wl8op55lI%2Ficons.svg?alt=media\&token=632d4e0c-20c6-4b1a-b7aa-440a5b6a99d6) **\[Icone]**                                                                    | Inserisci nell'area di lavoro un componente icona.                                                                                                                                                    |

</details>

<details>

<summary>Righe</summary>

Qui puoi trovare altre sezioni email predefinite che possono essere aggiunte alle tue email semplicemente trascinandole nella posizione desiderata.

* **Predefinito** - blocchi di contenuto predefiniti.
* **Vuoto** - inserisci uno spazio riservato per il contenuto che potresti aggiungere in un secondo momento.
* **Personalizzato** - crea il tuo contenuto da inserire, particolarmente utile quando si tratta di riutilizzo dei contenuti.

</details>

<details>

<summary>Impostazioni</summary>

In questa scheda puoi modificare e cambiare le impostazioni di design. Queste impostazioni si applicano all'intera email.

* **Larghezza dell'area contenuti** - Modifica la larghezza dell'area di lavoro in cui viene aggiunto il contenuto.
* **Allineamento dell'area contenuti** - Seleziona se desideri che il contenuto dell'email sia allineato a sinistra o al centro dell'area di lavoro.
* **Colore di sfondo** - Seleziona il riquadro colore per scegliere una tonalità dal gradiente di colore che apparirà, oppure inserisci il codice esadecimale per un colore preciso dello sfondo dell'email. Per sfondi trasparenti, digita semplicemente “transparent” come codice esadecimale.
* **Colore di sfondo dell'area contenuti** - Seleziona il riquadro colore per scegliere una tonalità dal gradiente di colore che apparirà, oppure inserisci il codice esadecimale per un colore preciso dello sfondo dell'area contenuti. Per sfondi trasparenti, digita semplicemente “transparent” come codice esadecimale.
* **Carattere predefinito** - Seleziona il carattere che desideri per i tuoi componenti di testo. L'elenco a discesa mostra un'anteprima dell'aspetto di ciascuna opzione di carattere.
* **Colore dei link** - Seleziona il riquadro colore per scegliere una tonalità dal gradiente di colore che apparirà, oppure inserisci il codice esadecimale per un colore preciso dei link. Per sfondi trasparenti, digita semplicemente “transparent” come codice esadecimale.
* **HTML personalizzato dell'intestazione** - Seleziona questa opzione per inserire qualsiasi codice HTML personalizzato che desideri incorporare nel modello di email.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/email-experiences/create-and-customize-advocate-program-emails.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
