> 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 partire nel modo più rapido possibile. Queste versioni predefinite includono immagini e messaggi generici per trasmettere l'essenza dell'email. Ti consigliamo di adattare le email del tuo programma per assicurarti che le informazioni siano pertinenti al tuo programma e al tuo prodotto.

Consulta la nostra documentazione su [i 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 nelle tue email dettagli specifici dei partecipanti.

#### Crea o modifica un modello di email

Avrai creato almeno un'email del programma quando configurerai 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] → Contenuti**.
2. Nel *Email* scheda, seleziona **Crea nuovo** o **Modifica 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 del modello di email (ad es., Acme Advocates) per identificare l'email. Usa questo ID per identificare l'email quando configuri le 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 *Informazioni di contatto* obbligatori nella parte superiore dello schermo.
   * Inserisci il **Nome mittente** aggiungendo un nome statico visualizzato nell'email, ad es. Acme Advocates.
   * Inserisci un **Indirizzo mittente** da cui ha origine il dominio personalizzato dell'email.
     * Se vuoi modificare l'indirizzo email *Da* di posta elettronica, dovrai modificare le impostazioni per garantire che il nostro sistema invii email autentiche per tuo conto. Per utilizzare un dominio di tua proprietà per l' *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) da *Impostazioni* pagina.
   * Inserisci un **BCC** per inviare una copia dell'email.
   * Inserisci un **Oggetto** per l'email.
   * Seleziona **Fatto** per salvare queste informazioni.
5. Successivamente, procedi all'uso dell'editor.

#### Uso dell'editor

Potrebbe essere necessario aggiornare il tuo editor di email alla versione più recente prima di poter redigere la tua email con facilità. Per farlo, cerca il banner blu nella parte superiore della 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 i mattoni 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:** Consulta il [*Riferimento ai componenti dell'email*](#component-reference-0-2) sezione qui sotto per comprendere meglio il funzionamento delle icone dell'editor.
{% endhint %}

<details>

<summary>Opzioni di anteprima</summary>

* **Menu a discesa Azioni** - Questa opzione ti consente di scegliere se visualizzare l'anteprima dell'email nel suo insieme o inviare un'email di test. Puoi anche passare dalla visualizzazione su desktop a quella su mobile.
* **Mostra struttura** - Questa opzione applica una griglia al canvas così puoi controllare l'allineamento dei vari componenti.
* **Mostra tag di unione** - Questa opzione ti consente di attivare la visualizzazione di ciò che verrà mostrato ai destinatari dai tuoi valori dinamici. Ad esempio, invece di vedere il testo segnaposto, come *Nome azienda*, vedrai il nome reale dell'azienda, ad es. Stark Industries.
* **Importa modello di email** - Questa opzione ti consente di importare eventuali 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 per alcune edizioni di Advocate. [Contatta l'assistenza](https://app.impact.com/support/portal.ihtml) per aggiornare il tuo account e accedere a questa funzionalità.

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 compaia. Nell'email apparirà una barra verde per aiutarti a posizionare il nuovo componente.
3. Facoltativamente, regola 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** nell'angolo 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 testi e immagini già presenti. Di solito è più facile apportare modifiche ai componenti esistenti aggiornando un'immagine già presente o aggiungendo testo al contenuto esistente.
{% 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%2Fe3GCJYT1vVzaTSMmeCgp%2Ftrash-alt-solid.svg?alt=media\&token=b5b84aa2-055e-49a1-910c-4b9a88bc2c9d) **\[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 font, il colore, il peso o la spaziatura del testo sulla sinistra, sotto il *contenuto* sezione.
4. Dopo aver completato 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 test** per inviarti un'email di test.
5. Se l'email di test ha un buon aspetto, **Salva** le tue modifiche.

</details>

<details>

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

**Limitato:** L'aggiunta di un ulteriore componente immagine personalizzata a un'email Advocate è disponibile solo per alcune edizioni di Advocate. [Contatta l'assistenza](https://app.impact.com/support/portal.ihtml) per aggiornare il tuo account e accedere a questa funzionalità.

1. Aggiungi un nuovo componente immagine o 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 che l'immagine è stata caricata 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. Dopo aver completato 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 test** per inviarti un'email di test.
5. Se l'email di test ha un buon aspetto, **Salva** le tue modifiche.

</details>

<details>

<summary>Aggiungi contenuto dinamico</summary>

I tag di unione ti consentono di aggiungere contenuti dinamici, come il nome del partecipante o l'importo premiato, 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 ci sono 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 verrà visualizzata come *"Ciao . Come stai?"*.
{% endhint %}

1. Nell'area del canvas, 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 test inviata dall'interno dell'editor non includerà alcun valore nei punti in cui sono stati inseriti i tag di unione.
{% endhint %}

</details>

#### Riferimento ai 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 accessibili nell'editor email.

<details>

<summary>Icone dei contenuti</summary>

Questa scheda è dove puoi inserire componenti e modificare l'aspetto di ciascun componente una volta selezionato e inserito nel canvas:

| 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 per Advocate]** | Inserisci un componente codice premio in denaro Advocate nel canvas 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 un componente codice premio Advocate nel canvas 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 per l'amico]**                                                                | Inserisci un componente codice premio per l'amico nel canvas 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 un componente di testo per il titolo nel canvas.                                                                                                                                             |
| ![](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 un componente di testo per il paragrafo nel canvas.                                                                                                                                          |
| ![](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 un componente elenco puntato nel canvas.                                                                                                                                                     |
| ![](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 un componente immagine nel canvas.                                                                                                                                                           |
| ![](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 un componente pulsante interattivo nel canvas.                                                                                                                                               |
| ![](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) **\[Separatore]**                                                                 | Inserisci un componente separatore nel canvas.                                                                                                                                                         |
| ![](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 un componente spaziatore nel canvas.                                                                                                                                                         |
| ![](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) **\[Contenuto dinamico]**                                                 | Inserisci componenti di contenuto dinamico per inserire informazioni che vuoi vengano compilate dinamicamente al momento dell'invio delle email, così che l'email possa avere 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 componenti con codice HTML nel canvas. Puoi inserire il codice sulla destra e verrà formattato all'interno del canvas.                                                                       |
| ![](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 un componente icona nel canvas.                                                                                                                                                              |

</details>

<details>

<summary>Righe</summary>

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

* **Predefinito** - blocchi di contenuto predefiniti.
* **Vuoto** - inserisci uno spazio riservato al 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>

Questa scheda è dove puoi modificare e cambiare le impostazioni di progettazione. Queste impostazioni si applicano all'intera email.

* **Larghezza dell'area contenuti** - Cambia la larghezza dell'area del canvas 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 del canvas.
* **Colore di sfondo** - Seleziona il riquadro del colore per scegliere una tonalità dalla sfumatura di colori 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 del colore per scegliere una tonalità dalla sfumatura di colori 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.
* **Font predefinito** - Seleziona il font che desideri per i tuoi componenti di testo. L'elenco a discesa mostra un'anteprima di come apparirà ciascuna opzione di font.
* **Colore link** - Seleziona il riquadro del colore per scegliere una tonalità dalla sfumatura di colori che apparirà, oppure inserisci il codice esadecimale per un colore preciso dei link. Per sfondi trasparenti, digita semplicemente “transparent” come codice esadecimale.
* **HTML intestazione personalizzato** - 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
