> 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/pt/zoom-workplace/zoom-phone/zoom-phone-spam-field-guide.md).

# Guia de Campo de Spam do Zoom Phone

### Introdução

Este documento foi concebido para fornecer aos leitores uma compreensão abrangente de como funciona a proteção contra chamadas de spam no Zoom Phone. As chamadas de spam podem interromper as operações comerciais e reduzir a produtividade, mas o Zoom Phone oferece várias camadas de proteção para identificar, bloquear e remediar chamadas de spam em toda a sua Organização.

Compreender a proteção contra spam é essencial para manter a qualidade da comunicação e garantir que as chamadas legítimas cheguem aos seus usuários, enquanto as chamadas indesejadas são filtradas. Este guia aborda como funciona a deteção de spam, as opções de Configurar para administradores, os controlos ao nível do usuário, as capacidades de monitorização e as soluções para quando as suas chamadas Realizadas são incorretamente marcadas como spam por outras operadoras.

### Como usar este documento

Este documento está organizado para fornecer informações num fluxo lógico que facilita a compreensão da proteção contra spam. Ao longo deste documento, estruturámos o conteúdo de várias formas:

**Organização baseada na função:** Secções separadas para administradores que configuram configurações de toda a conta e para usuários que gerem as suas próprias preferências de bloqueio de spam.

**Secções baseadas em tarefas:** O conteúdo está organizado de acordo com o que precisa de realizar: Compreender a Proteção contra Spam, Configurar a Proteção, Gerir as Configurações do Usuário, Monitorizar a Atividade e Resolução de Problemas.

**Formato de afirmação-resposta:** As perguntas e problemas comuns são apresentados como afirmações que descrevem a sua situação, seguidas de respostas e soluções abrangentes.

Por exemplo, quando vê "*As minhas chamadas Realizadas estão a ser marcadas como spam pelos destinatários*", sabe imediatamente que esta secção aborda a sua situação, e a resposta fornece os passos exatos para resolver o problema. Incluímos opções de configuração detalhadas, procedimentos passo a passo e orientações abrangentes de resolução de problemas para lhe dar a informação mais completa disponível.

São fornecidas ligações para artigos de suporte relevantes ao longo de todo o documento para lhe dar acesso às instruções mais atuais para cada processo.

### O que Precisa de Saber Antes de Ativar a Proteção contra Spam

#### <mark style="color:azul;">Pré-requisitos</mark>

**Para Administradores:**

* Privilégios de proprietário da conta ou de administrador
* conta Pro, Corporativa ou empresarial
* Plano de tarifação de chamadas do Zoom Phone
* licenças do Zoom Phone

**Para Usuários:**

* conta Corporativa ou empresarial
* licença do Zoom Phone
* aplicativo de computador Zoom Workplace para Windows, macOS ou Linux (versão mínima global ou superior)
* aplicativo para dispositivo móvel Zoom Workplace para Android ou iOS (versão mínima global ou superior)
* Proteção contra Spam ativada pelo administrador

#### <mark style="color:azul;">Conceitos Principais de Proteção contra Spam</mark>

**Marcar Spam Automaticamente**

O Zoom Phone pode analisar automaticamente as chamadas Recebidas e marcar potenciais chamadas de spam com base em normas globais do setor. Esta funcionalidade está ativada por padrão para contas empresariais e utiliza análises de chamadas para identificar padrões de spam sem exigir intervenção manual.

**Marcar Spam Manualmente**

Os administradores podem definir limites em que o sistema marca automaticamente números de telefone como spam com base no número de usuários que os relataram. Isto cria um sistema colaborativo de deteção de spam em que os relatórios dos usuários contribuem para a proteção em toda a Organização.

**Níveis de Sensibilidade de Spam**

O Zoom oferece três níveis de sensibilidade para a deteção automática de spam:\
**Baixa Sensibilidade**: Marca chamadas como spam com certeza definitiva\
**Sensibilidade Média**: Marca chamadas como spam com certeza moderada\
**Alta Sensibilidade**: Marca chamadas como spam com forte certeza

**Spam vs. Talvez Spam**

O sistema distingue entre spam definitivo (marcado como "**SPAM**") e spam potencial (marcado como "**Talvez** **SPAM**") com base nos níveis de confiança e nos relatórios dos usuários.

**Opções de Tratamento**

Quando uma chamada ou SMS é identificado como spam, os administradores podem escolher como tratá-lo. Tanto para chamadas como para SMS, os administradores podem bloquear o número totalmente ou marcar sem bloquear, o que permite que a chamada ou SMS passe e a rotula como spam. Existem ações específicas para chamadas e SMS indicadas abaixo:

* Chamadas:
  * Encaminhar para correio de voz/videocorreio
* SMS:
  * Desabilitar o envio ou a receção de anexos
  * Desabilitar hyperlinks
  * Examinar links de phishing

#### <mark style="color:azul;">Diferentes tipos de proteção contra spam</mark>

**Proteção contra spam Recebidas**

Protege seus usuários de receber chamadas indesejadas, identificando e bloqueando chamadores de spam. Isso inclui tanto a detecção automática quanto o spam relatado pelo usuário.

**Remediação de spam Realizadas**

Protege a reputação da sua Organização monitorando seus Números de telefone em busca de tags de spam aplicadas por outras operadoras e trabalhando automaticamente para remover essas tags.

**inscrição de spam empresarial**

Permite que as organizações registrem as informações comerciais e os Números de telefone com as principais operadoras dos EUA para melhorar o ID do chamador e reduzir a probabilidade de chamadas legítimas serem marcadas como spam.

#### <mark style="color:azul;">Recursos adicionais e Como Configurar</mark>

* [Guia do administrador para Zoom Phone Spam](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057965)
* [Guia do usuário para Zoom Phone Spam](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057964)
* [Visualizando o Painel de spam do Zoom Phone](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0081913)
* [Chamadas Realizadas bloqueadas ou marcadas como spam](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0062095)
* [Ativando a remediação de tags de spam](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0080575)
* [Gerenciando a inscrição de rotulagem de spam empresarial](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0082998)

Para suporte adicional ou dúvidas não abordadas neste guia, entre em contato com o Suporte do Zoom Phone por meio do portal da web ou [visite nossa documentação de suporte](https://support.zoom.com/).

### Monitorando a atividade de spam

#### <mark style="color:azul;">Acessando o Painel de Spam</mark>

1. Iniciar sessão no [Portal web do Zoom](https://zoom.us/signin#/login) como administrador.
2. No menu de navegação, clique em **Painel**.
3. Na parte superior da página, clique na **Telefone** aba.
   1. **Nota**: Se a aba Telefone não estiver visível, clique em **reticências (...)**, depois clique em **Telefone** para acessar a aba.
4. Clique no **Spam** aba.
   1. (Opcional) Na parte superior da página, filtre o Painel.
5. Selecione o intervalo de datas que deseja visualizar.
6. Clique na lista suspensa e selecione o **Sensibilidade da marcação automática de spam** nível.

**Importante**: O filtro de sensibilidade na página do Painel não altera suas Configurações da conta. Ele apenas filtra os dados exibidos no Painel.

#### <mark style="color:azul;">Entendendo as métricas do Painel</mark>

**Principais** **métricas** (exibidas na parte superior da página):

* **Spam**Número de chamadas diretas para usuários marcadas como **Spam** por qualquer um dos Recursos de marcação automática ou manual, incluindo a porcentagem de chamadas Recebidas (exclui **Spam Marcado Incorretamente**)
* **Talvez** **Spam**Número de chamadas diretas marcadas como **Talvez Spam**, incluindo a porcentagem de chamadas Recebidas (exclui Spam Marcado Incorretamente)
* **Recebidas** **PSTN** **Chamadas**Total de chamadas PSTN diretas para usuários, com indicador de alteração do intervalo de datas
* **Únicas** **Chamadores**: Contagem única de Números de telefone Recebidas que fazem chamadas PSTN diretas para usuários, com indicador de alteração do intervalo de datas

#### <mark style="color:azul;">A Rever o Gráfico de Chamadas Recebidas</mark>

A secção Chamadas Recebidas apresenta um gráfico que mostra o volume de chamadas PSTN diretas categorizadas ao longo do tempo:

* **Spam**
* **Talvez Spam**
* **Não Spam**
* **Spam Marcado Incorretamente** (chamadas marcadas como spam por marcação automática, mas marcadas como Não Spam pelos usuários)

Passe o cursor sobre o gráfico para ver datas específicas e percentagens de cada categoria.

#### <mark style="color:azul;">A Analisar os 100 Principais Números de Telefone Afetados</mark>

Esta secção mostra os 100 principais números de telefone da sua Organização que receberam mais chamadas de spam e talvez spam.

**Informação** **apresentada**:

* Número de telefone
* Total de chamadas recebidas
* Chamadas de spam recebidas
* Chamadas talvez spam recebidas
* Usuário ou extensão atribuída ao número

Use estes dados para identificar quais usuários são mais afetados por chamadas de spam e podem precisar de medidas adicionais de proteção.

#### <mark style="color:azul;">A Analisar os 100 Principais Chamadores de Spam</mark>

Esta secção mostra os 100 principais chamadores que foram sinalizados como spam ou talvez spam.

**Informação** **apresentada**:

* Número de telefone do chamador
* Total de chamadas realizadas
* Estado da marcação automática de spam para chamadas
* Estado da marcação manual
* Número de chamadas realizadas

Use estes dados para identificar chamadores de spam persistentes e verificar se a sua deteção de spam está a funcionar corretamente.

### Proteção contra Spam de Saída

#### <mark style="color:azul;">Porque as Suas Chamadas Realizadas Podem Ser Marcadas como Spam</mark>

Quando faz chamadas Realizadas a partir do Zoom Phone, as suas chamadas podem ser bloqueadas ou marcadas como spam pelo serviço telefónico ou pela operadora da parte recetora. Isto acontece porque as operadoras estão a implementar cada vez mais programas de bloqueio de chamadas para proteger os consumidores contra robocalls abusivas. Se a sua conta tiver marcações de spam incorretas, consulte a nossa secção sobre Remediação de Marcação de Spam.

**Motivos comuns pelos quais as suas chamadas são marcadas como spam**:

* **Chamadas de alto volume e curta duração**: Operadoras dos EUA como AT\&T, Verizon e T-Mobile bloqueiam ou marcam chamadas que seguem padrões de robocalling
* **Serviços de bases de dados de terceiros**: A parte recetora pode usar serviços como o Nomorobo que têm o seu número assinalado
* **Filtros de serviço telefónico de terceiros**: O recetor pode ter filtros a bloquear determinados prefixos de números
* **Falta de inscrição do ID do chamador**: As informações da sua empresa não estão inscritas com operadoras e fornecedores de análises

#### <mark style="color:azul;">Permitir proativamente os Seus Números com Operadoras dos EUA</mark>

Se faz chamadas Realizadas frequentes e legítimas (como lembretes de compromissos), pode inscrever proativamente os seus números para impedir que sejam categorizados como spam.

**Operadoras dos EUA a Contatar**:

* Hiya
* TNS
* Sprint
* T-Mobile

**Serviços de Bases de Dados de Robocalls a Contatar**:

* Nomorobo
* YouMail

**Fornecedores de Análises**:

* Transparência de Chamadas
* Registo Gratuito de Chamadores (ajuda a alcançar fornecedores de análises que suportam as principais operadoras dos EUA)

Contate estas organizações diretamente para solicitar que o seu número de telefone seja permitido e forneça informações sobre o seu uso corporativo legítimo.

#### <mark style="color:azul;">Remediação de Etiqueta de Spam</mark> <a href="#spam-tag-remediation" id="spam-tag-remediation"></a>

Os Recursos de remediação de tags de spam monitoram automaticamente os seus Números de telefone em busca de tags de spam aplicadas por outras operadoras e trabalham para removê-las.

**Requisitos**:

* Zoom central de contato Premium ou Elite licença ou Zoom Phone licença com Zoom Auto Dialer add-on
* SKU de Monitoramento e Remediação de Spam do Zoom (a menos que esteja usando o Discador Realizadas da central de contato)
* Conclusão e aprovação do formulário de inscrição para correção da etiqueta de spam
* Suporta números nativos e BYOC

**Limitações**: Atualmente Disponível apenas nos Estados Unidos (Números de telefone com código de país +1)

#### <mark style="color:azul;">Compreender o Processo de Remediação</mark>

Assim que os números forem inscritos, apresentarão um indicador de estado de spam atualizado no portal de administração. Quando um número for detetado como spam:

1. Verá alertas inline em vários locais no portal de administração
2. O processo de correção automática começa imediatamente
3. O processo normalmente demora 1-2 dias (pode demorar mais para disputas regulatórias)
4. Não é necessária nenhuma ação manual da sua parte
5. Se tiver sucesso, a etiqueta de spam é automaticamente removida

Para **central de contato Zoom**: Com a correspondência automática de ID do chamador, os números assinalados como spam são ignorados durante o processo de correspondência de ID do chamador. Assim que a etiqueta de spam for removida, o número volta a ficar elegível. No entanto, se um número com etiqueta de spam estiver configurado como o ID do chamador padrão, não será ignorado pela regra de correspondência do ID do chamador padrão.

### Resolução de problemas e Perguntas frequentes

#### <mark style="color:azul;">As minhas chamadas Realizadas estão a ser bloqueadas ou marcadas como spam pelos destinatários</mark>

Comece por identificar qual operadora ou serviço está a bloquear as suas chamadas e, em seguida, contacte-os diretamente para solicitar a inclusão na lista de permissões. Forneça documentação do seu uso comercial legítimo para apoiar o seu pedido. Para soluções de longo prazo, conclua **Inscrição empresarial de rotulagem de spam** para inscrever a sua empresa nas principais operadoras e Habilitar **Remediação de Etiqueta de Spam** para monitorizar e remover automaticamente as etiquetas de spam. Siga as melhores práticas para chamada efetuada evitando padrões de chamada de grande volume e curta duração.

#### <mark style="color:azul;">Demasiadas chamadas de spam estão a chegar aos meus utilizadores</mark>

Verifique se a Proteção contra Spam está ativada ao nível da conta e ajuste o **Nível do Filtro de Spam** para uma sensibilidade mais elevada. Incentive os utilizadores a marcar chamadas de spam, o que ajuda a melhorar a precisão do sistema ao longo do tempo. Reveja os **100 principais chamadores de spam** no Painel para identificar infratores persistentes e considere alterar o tratamento da chamada para **Bloquear este número** ou **Encaminhar para correio de voz**. Para utilizadores fortemente afetados, Habilitar **Triagem de ligar**, que exige que os chamadores externos Imprensa um botão para se ligarem.

#### <mark style="color:azul;">As ligações legítimas estão a ser marcadas incorretamente como spam</mark>

Peça aos utilizadores que marquem os números como **Não Spam** do respetivo histórico de chamadas ou correio de voz e ajuste o **Limite de marcação manual como NÃO SPAM** para um número inferior. Reduza o **Nível do Filtro de Spam** sensibilidade para reduzir falsos positivos. Adicione os números aos contatos do usuário ou da empresa, então Habilitar **Excluir contatos do usuário e da empresa da Proteção contra Spam**. Revise a **Spam Marcado Incorretamente** métrica no painel regularmente para avaliar com que frequência isso ocorre.

#### <mark style="color:azul;">Preciso visualizar a atividade de spam por um período específico</mark>

Acessar o Painel de Spam navegando até **Painel > Telefone > Spam** no seu portal de administração. No topo da página, Selecionar o intervalo de datas desejado para filtrar os dados. Revise o **Chamadas Recebidas** gráfico para ver tendências ao longo do tempo e identificar padrões. Exporte os dados, se necessário, para fins de relatório.

#### <mark style="color:azul;">Um número de telefone específico continua a ligar apesar de estar bloqueado</mark>

Verifique se o número está na lista de números de spam verificando **Configurações da conta > Proteção contra spam > Gerenciar lista de números**. Confirme que o tratamento da chamada está definido como **Bloquear este número** em vez de apenas **Marcar sem bloquear**. Verifique se o chamador está usando falsificação de número ou alternando entre vários números. Considere bloquear o código de área ou prefixo inteiro, se apropriado, e denunciar chamadores de spam persistentes às autoridades locais se estiverem assediando ou ameaçando.

#### <mark style="color:azul;">As tags de spam não estão aparecendo nas minhas chamadas</mark>

Verifique se a Proteção contra spam está ativada em **Configurações da conta** e confirme que você tem uma conta Corporativa ou empresarial. Verifique se seus Números de telefone são dos EUA ou do Canadá, pois a marcação automática só funciona para números +1. Certifique-se de que os usuários tenham a versão mínima exigida do aplicativo Zoom Workplace e Permitir tempo para o sistema aprender os padrões de spam.

#### <mark style="color:azul;">Os meus números Realizadas podem ter etiquetas de spam aplicadas</mark>

Ir para **Gestão de Números > Números de telefone > Funcionalidades Relacionadas > Remediação da Etiqueta de Spam** para verificar o estado dos seus números. Reveja o indicador de estado de spam de cada número inscrito e procure alertas inline que indiquem deteção de spam. Monitorize o estado do processo de remediação automática para ver se o Zoom está a trabalhar ativamente para remover as etiquetas. Sem a Remediação da Etiqueta de Spam, poderá não saber que os seus números estão marcados, a menos que os destinatários o informem.

#### <mark style="color:azul;">Não percebo a diferença entre spam com marcação automática e marcação manual</mark>

A spam com marcação automática usa análises de chamadas e padrões globais do setor para identificar spam automaticamente, sem entrada do usuário. Está Disponível apenas para números dos EUA e do Canadá, oferece três níveis de sensibilidade e funciona imediatamente após a ativação. A spam com marcação manual baseia-se em relatos de usuários e em limites definidos, exigindo que os usuários marquem ativamente os números como spam. Cria listas de spam específicas da Organização e substitui as definições de marcação automática quando os limites são atingidos.

#### <mark style="color:azul;">Quero usar spam com marcação automática e manual em conjunto</mark>

Sim, e isso é recomendado para obter os melhores resultados. Os limites da marcação manual irão substituir as decisões da marcação automática, permitindo que a experiência coletiva da sua Organização ajuste o sistema de deteção automática. Esta combinação fornece proteção básica através da deteção de spam em padrão do setor, ao mesmo tempo que permite que os relatórios dos seus usuários adaptem o sistema aos seus padrões de chamada específicos.

#### <mark style="color:azul;">A remediação da minha etiqueta de spam está a demorar mais do que o esperado</mark>

O processo de remediação automática normalmente demora 1–2 dias a concluir. Pode demorar mais se houver litígios regulamentares com as operadoras ou se a etiqueta de spam tiver sido aplicada por várias operadoras. Não é necessária qualquer ação manual da sua parte durante este processo. Se a remediação não for bem-sucedida após vários dias, abra um protocolo do suporte para obter assistência adicional.

#### <mark style="color:azul;">Não compreendo o que acontece durante a correção da marcação de spam</mark>

Para o Zoom central de contato com correspondência automática de ID do chamador, os números sinalizados como spam são ignorados durante o processo de correspondência do ID do chamador. Assim que a etiqueta é removida, o número volta a ser elegível para correspondência. Para o Zoom Phone normal, o sistema trabalha automaticamente com as operadoras para remover a etiqueta e você verá atualizações de status no portal de administração. Se não tiver sucesso após a tentativa inicial, talvez seja necessário abrir um protocolo do suporte.

#### <mark style="color:azul;">Preciso Configurar a proteção contra spam para mensagens SMS</mark>

Você pode Configurar o tratamento de spam para SMS com duas opções. **Bloquear este número** bloqueia SMS totalmente, para que os utilizadores não possam ver mensagens de spam. Marcar sem rótulos Bloquear SMS como spam, mas permite a entrega. Configurar isto em **Configurações da conta > Zoom Phone > Proteção contra spam > tratamento da chamada e opções de SMS > SMS de SPAM recebidos**.

#### <mark style="color:azul;">A proteção contra spam está a bloquear chamadas dos meus Clientes/clientes legítimos</mark>

Habilitar Excluir contatos do usuário e da empresa da Proteção contra Spam para permitir automaticamente todos os contatos salvos. Faça com que os usuários salvem os números dos clientes em seus contatos para que sejam reconhecidos como chamadores legítimos. Ajuste os níveis de sensibilidade adequadamente, pois uma sensibilidade mais baixa reduz os falsos positivos, e treine os usuários para marcar números sinalizados incorretamente como Não é Spam. Revise regularmente a métrica de Spam Marcado Incorretamente no seu Painel para identificar padrões.

#### <mark style="color:azul;">Recebi uma ligar de spam e preciso saber o que fazer</mark>

Não atenda se o ligar já estiver marcado como spam, a menos que reconheça o número. Marque o ligar como spam no histórico de chamadas ou no correio de voz, se não tiver sido detetado automaticamente. Selecionar **Chamadas de spam** em vez de **Outros motivos** para ajudar a proteger toda a sua Organização. Denuncie o assédio persistente ao seu administrador e use o modo Não perturbe se estiver a sofrer um ataque de spam de ligar.

#### <mark style="color:azul;">Quero bloquear códigos de área ou prefixos inteiros</mark>

Embora o Zoom Phone permita bloquear números e prefixos específicos, bloquear códigos de área inteiros deve ser abordado com cautela, pois pode bloquear chamadas legítimas. Se estiver a receber spam de prefixos específicos, pode Adicionar esses prefixos à sua lista de números bloqueados. No entanto, considere o impacto Corporativo antes de implementar regras amplas de bloqueio. Muitas vezes, uma abordagem melhor é usar níveis mais elevados de sensibilidade ao spam e incentivar o relato do usuário.

#### <mark style="color:azul;">Estou preocupado com a precisão da detecção automática de spam</mark>

A precisão depende do nível de sensibilidade que você Escolher, da qualidade dos bancos de dados globais de spam, do Feedback/feedback do usuário por meio de marcação manual e de como os padrões típicos de spam correspondem às suas chamadas recebidas. Monitore a métrica Spam Marcado Incorretamente no Painel para avaliar a precisão da sua Organização. Se você vir números altos de spam marcado incorretamente, considere baixar seu nível de sensibilidade. Você também pode implementar a opção Excluir contatos de usuário e empresa para impedir que contatos conhecidos sejam bloqueados.

#### <mark style="color:azul;">Não entendo por que preciso de inscrição empresarial de spam quando já tenho proteção contra spam</mark>

Esses recursos servem a diferentes propósitos e funcionam em conjunto para uma proteção abrangente. A Proteção contra Spam protege seus usuários de receber chamadas Recebidas indesejadas, filtrando e bloqueando chamadores de spam. A inscrição empresarial de spam protege as chamadas Realizadas da sua Organização para que não sejam marcadas como spam por outras operadoras. Além disso, a inscrição de spam funciona para números internacionais, enquanto a correção de spam está Disponível apenas para números dos EUA. Ambos são recomendados para um gerenciamento abrangente de spam, especialmente se sua Organização faz chamadas Realizadas com frequência.

#### <mark style="color:azul;">Quero saber que informações são partilhadas durante a Inscrição para Spam empresarial</mark>

O Zoom partilha o seu nome legal corporativo e nome público, setor e tamanho da empresa, informações de contato e endereço comercial com as principais operadoras dos EUA e os seus parceiros de análises. O sistema também partilha os números DUNS e EIN e todos os Números de telefone na sua conta, independentemente do país, produto ou estado nativo. Estas informações ajudam as operadoras a verificar a sua legitimidade e a melhorar a reputação do seu ID do chamador. Reduz a probabilidade de que as suas chamadas Realizadas sejam bloqueadas ou marcadas como spam pelos destinatários.


---

# 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://library.zoom.com/technical-library/pt/zoom-workplace/zoom-phone/zoom-phone-spam-field-guide.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.
