> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/it/zoom-workplace/zoom-phone/zoom-phone-sms-field-guide/10dlc-compliance.md).

# Conformità 10DLC

10DLC (codice lungo a 10 cifre) è un quadro di conformità che consente agli operatori mobili di sapere chi invia messaggi di testo dai Numeri telefonici aziendali e per quale scopo. Gli operatori mobili negli Stati Uniti e in Canada (AT\&T, Verizon Wireless, T-Mobile, US Cellular e altri) richiedono ora la conformità 10DLC prima di consentire l'invio di messaggi tramite servizi basati su applicazioni come Zoom Phone e il centro di contatto Zoom. Questo requisito contribuisce a creare fiducia tra aziende e consumatori, riducendo lo spam e garantendo che i messaggi provengano da aziende registrate.

L'iscrizione 10DLC si compone di tre passaggi principali: creazione e approvazione del brand, creazione e approvazione della campagna e assegnazione dei Numeri telefonici alla campagna. Le sezioni seguenti ti guideranno attraverso l'iscrizione 10DLC per la revisione da parte dell'operatore mobile.

### Creare un brand

Per utilizzare gli SMS con Zoom Phone, devi prima creare un brand 10DLC per registrare le informazioni aziendali presso gli operatori di Zoom Phone. La creazione e la Verifica dell'identità del brand assicurano agli operatori che il mittente degli SMS sia legittimo. Il brand deve essere creato e approvato prima di creare una campagna SMS. Per impostazione predefinita, puoi creare un solo brand nello Zoom web portal. Se devi crearne più di uno, contatta il responsabile del tuo account Zoom per maggiori informazioni. Tieni presente che ogni brand aggiuntivo registrato comporta un costo mensile.

{% hint style="danger" %}
**Importante**

Per completare l'iscrizione del brand è necessario un codice fiscale valido. Se non ne possiedi uno valido, dovrai procurartelo. I numeri di previdenza sociale non sono accettati.
{% endhint %}

1. Accedi a Zoom web portal come admin con il Privilegio di modificare le Impostazioni dell'account.
2. Nel menu di navigazione, seleziona Gestione numeri, quindi clicca su Campagne SMS.
3. Ti verrà mostrato un link per consultare l'elenco di controllo per la creazione di brand e campagne 10DLC.

<div align="left"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcFeU8OOMHECvbzYAcF3GLjatdu4GgShsGpgX1Zas6yRIJV_TqpiVAdOetF0OluQDgvZSCzKx6JdmPeDMuMcSPfo_hpYXBxZg51jvKI77YgaFaE0q1STLuqecIl9kzmiSd1W7bkaw?key=To-2GraI1RDR5ElDN9QyTg" alt="" width="563"><figcaption></figcaption></figure></div>

4. Seleziona la seguente casella di conferma: Confermo di aver letto e compreso l'elenco di controllo per la creazione di campagne 10DLC.
5. Clicca su Crea brand 10DLC per iniziare a creare il brand.

#### <mark style="color:blu;">Passaggio 1: riepilogo del brand</mark>

Nella pagina Riepilogo del brand, inserisci quanto segue:

* Ragione sociale
* Nome commerciale/nome del brand (se applicabile). Questo nome verrà utilizzato nei messaggi di consenso, revoca del consenso e assistenza inviati ai destinatari degli SMS.
* Forma giuridica della tua azienda. Scegli tra le seguenti opzioni nel menu a discesa: società privata a scopo di lucro, società quotata a scopo di lucro, organizzazione senza scopo di lucro, Pubblica amministrazione.

{% hint style="info" %}
**Nota**

Se la tua forma giuridica è una società quotata a scopo di lucro, devi completare un'ulteriore Verifica basata sull'autenticazione a più fattori prima che il brand venga approvato.
{% endhint %}

* Paese/regione di iscrizione. Sono supportati i seguenti Paesi: Stati Uniti, Canada, Australia, Bielorussia, Cile, Croazia, Ungheria, Islanda, Irlanda, Italia, Lettonia, Lituania, Lussemburgo, Malaysia, Malta, Paesi Bassi, Nuova Zelanda, Norvegia, Polonia, Portogallo, Romania, Arabia Saudita, Singapore, Slovacchia, Slovenia, Svezia, Taiwan ed Emirati Arabi Uniti.
* Stato/provincia
* Codice fiscale, numero di partita IVA o EIN (numero di identificazione del datore di lavoro). Questo requisito si applica solo agli Stati Uniti e al Canada. Le aziende canadesi devono utilizzare il proprio numero di identificazione aziendale (BIN).
* Indirizzo della sede aziendale

{% hint style="info" %}
**Nota**

Se non trovi la città nel menu a discesa, puoi digitarla nel campo.
{% endhint %}

* Una volta completato, clicca su Continua.

#### <mark style="color:blu;">Passaggio 2: dettagli del brand e contatto</mark>

Nella sezione Dettagli del brand, compila i dettagli del brand e le informazioni di contatto, inserendo quanto segue:

* Sito web: inserisci l'indirizzo del tuo sito web, includendo https\://

{% hint style="info" %}
**Nota**

Per i brand delle società quotate a scopo di lucro verrà mostrato un campo aggiuntivo denominato E-mail di contatto per la Verifica. Inserisci i recapiti della persona che riceverà il passcode per l'autenticazione a due fattori (2FA) via e-mail e completerà la Verifica.
{% endhint %}

* Tipo di settore: il tipo di settore è il settore di attività della tua azienda.
* Borsa valori (se applicabile)
* Simbolo azionario (se applicabile)
* Una volta completato, clicca su Continua.

#### <mark style="color:blu;">Passaggio 3: conferma</mark>

Controlla i dati del brand e assicurati che tutte le informazioni siano corrette.

{% hint style="danger" %}
**Importante**

Dopo l'invio, non potrai modificare il brand. Apporta tutte le modifiche necessarie prima dell'invio. Se devi apportare modifiche dopo l'invio, devi eliminare il brand e inviarlo nuovamente a causa di restrizioni legali e della visibilità da parte degli operatori.\\

Selezionando “Invia”, apponi la tua firma elettronica per creare il tuo account presso i nostri operatori e creare un nuovo brand da utilizzare per gli SMS.
{% endhint %}

* Quando è tutto pronto, clicca su Invia. Nella maggior parte dei casi, l'approvazione del brand richiede 1–2 ore.

Puoi controllare lo stato del brand accedendo a Campagne SMS nello Zoom web portal. In Il mio brand, consulta lo stato nella colonna Stato del brand. Lo stato del brand sarà In sospeso, Rifiutato o Attiva (se approvato). La persona che ha inviato il brand 10DLC riceverà una notifica via e-mail quando il brand viene rifiutato o approvato.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-44a67c31c207a076322b4d5061ce7f8c0f32cfce%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Creare una campagna

Una volta approvato il brand 10DLC, puoi creare la campagna SMS che verrà utilizzata per assegnare i Numeri telefonici aziendali e abilitare gli SMS. Per impostazione predefinita, puoi creare una sola campagna per Zoom Phone. Tuttavia, se sei anche cliente del centro di contatto Zoom o di Zoom Meetings, puoi creare due campagne: una per Zoom Phone e una per il centro di contatto Zoom o Zoom Meetings. Se devi creare più di una campagna per Zoom Phone, contatta il responsabile del tuo account per maggiori dettagli. Ogni campagna Zoom Phone aggiuntiva registrata comporterà un costo mensile.

#### <mark style="color:blu;">Passaggio 1: dettagli della campagna</mark>

I passaggi seguenti descrivono la procedura per completare la sezione Dettagli della campagna.

**Requisito dell'elenco di controllo**

Esegui i seguenti passaggi:

1. Accedi a Campagne SMS nello Zoom web portal, quindi clicca su Crea campagna SMS. Verrai indirizzato alla pagina Requisito dell'elenco di controllo, dove troverai un link per consultare l'elenco di controllo per la creazione di brand e campagne 10 DLC.
2. Clicca sul [link all'elenco di controllo per la creazione di campagne 10DLC](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0010208). Devi aprire e consultare il link prima di continuare.

<div align="left"><figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-4fe9b222d6a58d71a0e8b2e5f3a0497610066fb9%2Fimage.png?alt=media" alt="" width="555"><figcaption></figcaption></figure></div>

3. Dopo aver aperto e consultato il link, seleziona la casella Confermo di aver letto e compreso l'elenco di controllo per la creazione di campagne 10DLC. Una volta fatto, verrà visualizzata la sezione dei dettagli della campagna. In questa pagina compilerai i requisiti e i dettagli.
4. Configura la tua campagna SMS nelle sezioni seguenti.

**Dettagli della campagna**

Nella sezione Dettagli della campagna, inserisci le seguenti informazioni:

* Nome della campagna: inserisci un nome per la campagna.
* Descrizione: descrivi come la tua Organizzazione utilizza gli SMS. Specifica chi invierà i messaggi, chi li riceverà, quali tipi di contenuti saranno inviati, quali non saranno inviati e con quale frequenza verranno inviati i messaggi.

{% hint style="info" %}
**Nota**

Quando compili questi campi, fornisci il maggior numero di dettagli possibile. Informazioni insufficienti o poco chiare comporteranno il rifiuto.
{% endhint %}

* Tipo di campagna: scegli il prodotto per cui stai creando una campagna. Assicurati di scegliere il tipo di campagna corretto in base al prodotto con cui intendi usare SMS. Fai clic sul menu a discesa e seleziona l'applicazione.

{% hint style="info" %}
**Nota**

Le campagne non possono essere condivise tra applicazioni.
{% endhint %}

**Consenso alla messaggistica SMS**

Nella sezione Consenso alla messaggistica SMS, fornisci dettagli su come raccogli il consenso dei destinatari degli SMS.

* In Come raccogli il consenso per inviare SMS/MMS?, seleziona le opzioni seguenti applicabili alla tua campagna.

{% hint style="info" %}
**Nota**

Devi selezionare almeno una di queste opzioni. Quando ne selezioni una, vedrai alcuni esempi relativi a tale opzione.
{% endhint %}

* Completa la descrizione di ogni opzione e spiega con parole tue come raccogli il consenso. Puoi inviare messaggi solo ai consumatori che ti hanno fornito il consenso. Fornisci il maggior numero di dettagli possibile. Se raccogli numeri telefonici dal tuo sito web, devi selezionare l'opzione relativa al sito web e fornire dettagli su come raccogli il consenso. In caso contrario, la campagna verrà rifiutata.

<div align="left"><figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-7ffcbe018a698cd173d013fb5492731e1d56abe3%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

**Requisiti del sito web**

Nella sezione Requisiti del sito web, completa le seguenti informazioni:

* Informativa sulla privacy: inserisci nel campo URL un link alla sezione dell'informativa sulla privacy del sito web del tuo brand. Il sito web del tuo brand deve includere un'informativa sulla privacy di terze parti con un'informativa sui messaggi di testo, per dimostrare all'operatore che i dati dei consumatori e il consenso vengono gestiti correttamente.
* Seleziona la seguente casella di controllo: Confermo di aver aggiunto l'informativa sulla privacy richiesta al sito web del mio brand e comprendo che la mia campagna verrà rifiutata se non effettuo questo aggiornamento.
* Sito web/modulo cartaceo: scegli l'opzione che descrive meglio il modo in cui usi i moduli web o cartacei per raccogliere numeri telefonici:
  * Uso un modulo web o cartaceo per raccogliere numeri telefonici per questa campagna. Confermo inoltre di aver aggiunto questa informativa sugli SMS sotto il modulo web o cartaceo.
  * Non uso moduli web o cartacei per raccogliere numeri telefonici per questa campagna.

{% hint style="info" %}
**Nota**

Se selezioni la prima opzione, devi allegare una prova caricando immagini dei moduli web che mostrino l'informativa sugli SMS. Se usi il consenso scritto, allega una copia del modulo di adesione scritto.
{% endhint %}

**Autorizzazioni utente**

Nella sezione Autorizzazioni utente, seleziona come vuoi applicare le procedure di adesione e rinuncia per i numeri associati alla campagna:

* In Messaggi in uscita verso numeri sconosciuti, scegli un'opzione per i messaggi in uscita verso numeri sconosciuti, ovvero numeri a cui invii un messaggio per la prima volta:
  * Consenti ai miei utenti di inviare qualsiasi messaggio: questa è l'opzione predefinita. Se selezionata, gli utenti possono inviare qualsiasi messaggio a qualsiasi numero. Prima di inviare il messaggio, nell'app Zoom Workplace riceveranno un avviso con il seguente testo: Non sappiamo se hai ottenuto il consenso da questo numero. Assicurati di avere il consenso per inviare messaggi a questo numero. Tieni presente che questo avviso non bloccherà l'invio del messaggio.
  * Richiedi ai miei utenti di inviare il messaggio di adesione e attendere la risposta di adesione: con questa opzione, l'utente dovrà inviare un messaggio per richiedere l'adesione prima di poter inviare qualsiasi altro messaggio. Il destinatario deve rispondere al messaggio di adesione con la parola chiave di adesione. Solo allora sarà possibile inviare altri messaggi.
  * Impedisci ai miei utenti di inviare messaggi in uscita: questa opzione impedisce agli utenti di inviare qualsiasi messaggio in uscita.

{% hint style="info" %}
**Nota**

Poiché Zoom non può verificare se una persona ha fornito il consenso tramite metodi diversi dagli SMS, seleziona la prima o la seconda opzione riportata di seguito solo se puoi verificare che il consenso viene raccolto tramite altri metodi, ad esempio verbalmente, via e-mail o con un modulo cartaceo.
{% endhint %}

* In Messaggi in entrata da numeri sconosciuti, stabilisci cosa possono fare i tuoi utenti quando un nuovo numero avvia una conversazione:

  * Consenti ai miei utenti di inviare qualsiasi messaggio: questa opzione predefinita consente di rispondere a un messaggio in entrata non appena viene ricevuto. Gli SMS in entrata sono considerati consenso da parte del mittente.
  * Invia automaticamente un messaggio per richiedere l'adesione e attendere la risposta: dopo aver ricevuto un messaggio in entrata, viene inviato un messaggio automatico per richiedere l'adesione e il destinatario deve rispondere con la parola chiave di adesione prima che l'utente possa inviargli altri messaggi. Questa opzione offre un ulteriore livello di conformità per i messaggi in entrata.

  **Messaggistica di adesione**

  Nella sezione Messaggistica di adesione, configura i modelli di messaggio.

  * Messaggio di adesione: è il primo messaggio inviato al destinatario per richiedere il consenso all'adesione. Viene compilato automaticamente un messaggio approvato dall'operatore. Fai clic su Modifica per personalizzare il messaggio di adesione, quindi fai clic su Salva.
    * Anteprima del messaggio: fai clic su Modifica per visualizzare l'anteprima del messaggio di adesione. Questo messaggio non può essere modificato, tranne che per le aggiunte.
    * Aggiunte: inserisci il messaggio aggiuntivo o le personalizzazioni per l'anteprima del messaggio di adesione o per l'allegato. Questo contenuto verrà aggiunto all'anteprima del messaggio e comparirà dopo la frase che termina con il nome del tuo brand.
    * Testo iniziale: inserisci il testo iniziale per la messaggistica di adesione. Questa parola chiave verrà aggiunta al messaggio precedente e comparirà all'inizio del messaggio, dopo la parola Text.
  * Messaggio aggiunto automaticamente: questo contenuto è un testo aggiuntivo incluso alla fine dei messaggi inviati al destinatario. Viene aggiunto per contribuire a garantire la conformità dei messaggi ai requisiti degli operatori. Fai clic su Modifica per modificare il messaggio aggiunto automaticamente, quindi fai clic su Salva.
    * Anteprima del messaggio: visualizza l'anteprima del messaggio aggiunto automaticamente. Questo messaggio non può essere modificato, tranne che per le aggiunte.
    * Aggiungi personalizzazioni al messaggio aggiunto automaticamente: aggiungi testo personalizzato al messaggio aggiunto automaticamente. Questo contenuto verrà inserito all'inizio dell'anteprima del messaggio.
    * Frequenza: seleziona questa opzione per includere questo testo finale nei messaggi in uscita. Per impostazione predefinita, per un nuovo numero il testo del messaggio aggiunto automaticamente viene inviato solo nel primo messaggio in uscita. Seleziona una delle seguenti opzioni per la frequenza dei messaggi, quindi fai clic su Salva:
      * Sempre, in ogni messaggio: includi questo contenuto in tutti i messaggi in uscita. È l'opzione consigliata.
      * Solo nei primi messaggi in uscita: includi questo contenuto solo nel primo messaggio in uscita inviato dopo il messaggio iniziale di adesione.
  * Visualizza il contenuto della risposta all'adesione, che verrà inviato quando il destinatario risponde al tuo messaggio con il testo di adesione. Puoi anche visualizzare le parole chiave della risposta.
  * Visualizza il contenuto della risposta alla rinuncia, che verrà inviato quando il destinatario risponde al tuo messaggio con il testo di rinuncia. Puoi anche visualizzare le parole chiave della risposta. Solo il numero telefonico che riceve la parola chiave Stop viene escluso dall'invio di messaggi.
  * Risposta alla richiesta di aiuto: è il contenuto che verrà inviato quando il destinatario risponde al tuo messaggio con HELP. Fai clic su Modifica per modificare la risposta alla richiesta di aiuto, quindi fai clic su Salva. Puoi anche visualizzare le parole chiave della risposta.
    * Tipo di contatto: fai clic sul menu a discesa e seleziona il tipo di contatto. La tua azienda deve offrire ulteriore assistenza ai Clienti tramite un sito web, un'e-mail o un numero telefonico. Gli URL e gli indirizzi e-mail inseriti correttamente diventeranno collegamenti ipertestuali dopo il salvataggio delle modifiche.
    * Informazioni di contatto: inserisci le informazioni di contatto per la sezione di assistenza del tuo brand. Questi dati di contatto verranno aggiunti al modello di messaggio approvato dall'operatore.

**Ti serviranno gli SMS per più di 49 numeri?**

In corrispondenza dell'opzione Ti serviranno gli SMS per più di 49 numeri?, seleziona Sì o No. Se selezioni Sì, fornisci una motivazione. La procedura di approvazione può richiedere fino a due settimane.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc4wJJ9iOxGItK5J5XmscEHRgjNzPdH4hMwL8ajh1GriHJ4O-1N-Eeph2p2u41rgq-OezuIuuHrOrUnWpqhh47a5vmejD35iYN2TOXBYJ5aphZvgaGHMeVX0lqyQ8e12YhbOOlkMQ?key=To-2GraI1RDR5ElDN9QyTg" alt=""><figcaption></figcaption></figure>

Al termine, fai clic su Continua. Verrai indirizzato alla sezione Domande per l'operatore.

#### <mark style="color:blu;">Passaggio 2: domande per l'operatore</mark>

Nella sezione Domande sulle campagne dell'operatore, fornisci informazioni sulle categorie di messaggi SMS della tua azienda e sui relativi dettagli. Completa le seguenti informazioni:

* I messaggi includeranno:
  * Link URL?: seleziona Sì o No.
  * Numeri telefonici?: Seleziona Sì o No.
  * Contenuti soggetti a limiti di età?: Seleziona Sì o No.
  * Prestiti o accordi di finanziamento?: Seleziona Sì o No.

{% hint style="info" %}
**Nota**

Se la tua attività è in qualsiasi modo correlata a prestiti o finanziamenti, devi selezionare Sì per questa opzione. In caso contrario, la tua campagna verrà rifiutata.
{% endhint %}

* Nella sezione Messaggi di esempio, inserisci quanto segue:
  * Nella casella Messaggio di esempio 1, digita il primo messaggio di esempio. Assicurati di includere il nome della tua attività/del tuo brand. In caso contrario, la tua campagna verrà rifiutata.
  * Nella casella Messaggio di esempio 2, digita il secondo messaggio di esempio. Assicurati di includere il nome della tua attività/del tuo brand. In caso contrario, la tua campagna verrà rifiutata.
  * (Facoltativo) Fai clic su + Aggiungi un altro messaggio di esempio per aggiungere altri messaggi di esempio
  * Fai clic su Continua. Verrai indirizzato alla sezione Conferma.

{% hint style="info" %}
**Nota**

Puoi fornire fino a cinque messaggi di esempio del tipo che prevedi di inviare ai tuoi clienti. In ogni messaggio di esempio che crei, devi aggiungere «Rispondi STOP per annullare» alla fine. Se non lo includi alla fine del messaggio, la tua campagna verrà rifiutata. Zoom invierà STOP per tuo conto per interrompere la ricezione dei messaggi. Inoltre, assicurati di includere il nome della tua attività/del tuo brand.
{% endhint %}

#### <mark style="color:blu;">Passaggio 3: conferma</mark>

Esegui i seguenti passaggi:

1. Nella pagina Conferma, esamina le sezioni Requisiti e dettagli e Domande degli operatori.
2. Fai clic su Modifica per apportare eventuali modifiche, quindi fai clic su Salva se hai apportato modifiche.
3. Al termine della verifica, fai clic su Invia. Gli operatori potrebbero impiegare fino a 4 settimane per esaminare e approvare la richiesta.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfS8msZxlENicgH8QseuVpy4BQy4RS3oYgjria9HCCIAJWNoBFNwxjHoS9QRNYNA-PReKd18EP3c7YcjostmgrfcggD2i9hkUMKzm9RMNxipnn9epLk8ElD3nWFsOXd3G8jPABHpw?key=To-2GraI1RDR5ElDN9QyTg" alt=""><figcaption></figcaption></figure>

4. Puoi verificare lo stato della tua campagna accedendo a Campagne SMS nel Zoom web portal. In Campagne SMS, visualizza lo stato attuale del tuo brand nella colonna Stato della campagna. Una volta approvata, lo stato sarà Attiva.

### Assegnare numeri Zoom Phone alla campagna SMS

Una volta approvata la campagna e abilitato 10DLC, puoi assegnare numeri telefonici alla campagna.

1. Nel Zoom web portal, seleziona Gestione numeri, quindi fai clic su Numeri telefonici.
2. A sinistra dei numeri telefonici, seleziona la casella di controllo del numero che desideri assegnare.
3. Seleziona la scheda Campagne SMS nella parte superiore della pagina. Nel menu a discesa, seleziona Assegna.
4. Nel menu a discesa Scegli campagna, seleziona la campagna a cui desideri assegnare il numero telefonico.
5. Fai clic su Continua.
6. Ti verrà chiesto di compilare una LOA. Seleziona Continua alla LOA per visualizzare e compilare il modulo. Dopo l'invio della LOA, l'attivazione di SMS/MMS potrebbe richiedere fino a tre giorni lavorativi.

Una volta completata l'attivazione, SMS è pronto per essere utilizzato. Assicurati che agli utenti che necessitano delle funzionalità SMS sia stato assegnato un piano di chiamate Zoom Phone compatibile e un numero telefonico a 10 cifre (anch'esso assegnato a una campagna). Consulta la seguente sezione Controlli amministratore per assicurarti che SMS sia abilitato per gli utenti o i gruppi corretti.


---

# 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://library.zoom.com/technical-library/it/zoom-workplace/zoom-phone/zoom-phone-sms-field-guide/10dlc-compliance.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.
