> 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 criado para fornecer aos leitores um entendimento abrangente de como a proteção contra chamadas de spam funciona no Zoom Phone. 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 corrigir chamadas de spam em toda a sua Organização.

Entender a proteção contra spam é essencial para manter a qualidade da comunicação e garantir que chamadas legítimas cheguem aos seus usuários, enquanto chamadas indesejadas são filtradas. Este guia aborda como a detecção de spam funciona, opções de configuração para administradores, controles no nível do usuário, recursos de monitoramento e soluções para quando suas chamadas realizadas forem sinalizadas incorretamente como spam por outras operadoras.

### Como Usar este Documento

Este documento foi organizado para fornecer informações em um fluxo lógico que torna mais fácil entender a proteção contra spam. Ao longo deste documento, estruturamos o conteúdo de várias maneiras:

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

**Seções baseadas em tarefas:** O conteúdo é organizado de acordo com o que você precisa realizar: Entender a proteção contra Spam, Configurar a proteção, Gerenciar Configurações do usuário, Monitorar a atividade e Solução de problemas.

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

Por exemplo, quando você vê "*Minhas chamadas realizadas estão sendo sinalizadas como spam pelos destinatários*", você sabe imediatamente que esta seção aborda sua situação, e a resposta fornece as etapas exatas para resolver o problema. Incluímos opções detalhadas de configuração, procedimentos passo a passo e orientações abrangentes de solução de problemas para lhe dar as informações mais completas disponíveis.

Links para artigos de suporte relevantes são fornecidos ao longo do texto para lhe dar acesso às instruções mais atuais para cada processo.

### O que Você Precisa 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 desktop 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-chave da Proteção contra Spam</mark>

**Marcação automática como Spam**

O Zoom Phone pode analisar automaticamente chamadas Recebidas e marcar possíveis chamadas de spam com base em padrões globais do setor. Este recurso é ativado por padrão para contas empresariais e usa análises de chamadas para identificar padrões de spam sem exigir intervenção manual.

**Marcação manual como Spam**

Os administradores podem definir limites nos quais o sistema marca automaticamente Números de telefone como spam com base em quantos usuários os relataram. Isso cria um sistema colaborativo de detecção de spam, no qual os relatórios dos usuários contribuem para a proteção em toda a Organização.

**Níveis de Sensibilidade ao Spam**

O Zoom oferece três níveis de sensibilidade para a detecção automática de spam:\
**Baixa Sensibilidade**: Marca as chamadas como spam com certeza definitiva\
**Sensibilidade Média**: Marca as chamadas como spam com certeza moderada\
**Alta Sensibilidade**: Marca as 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 quanto para SMS, os administradores podem bloquear o número completamente ou marcar sem bloquear, o que permite que a chamada ou SMS passe e a rotule como spam. Há ações específicas para chamadas e SMS listadas abaixo:

* Chamadas:
  * Encaminhar para correio de voz/videocorreio
* SMS:
  * Desabilitar o envio ou recebimento de anexos
  * Desabilitar hiperlinks
  * Links de phishing de triagem

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

**Proteção contra spam Recebidas**

Protege os seus usuários de receber chamadas indesejadas, identificando e bloqueando chamadores de spam. Isso inclui a deteção automática e o spam relatado pelos usuários.

**Remediação de spam Realizadas**

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

**inscrição empresarial de spam**

Permite que as Organizações registem as suas informações da empresa e Números de telefone com as principais operadoras dos EUA para melhorar a reputação do 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 o spam do Zoom Phone](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057965)
* [Guia do usuário para o spam do Zoom Phone](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 etiqueta 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 perguntas 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 na [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 no **Telefone** aba.
   1. **Nota**: Se a aba Phone não estiver visível, clique no **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. Selecionar o intervalo de datas que deseja ver.
6. Clique no menu suspenso e selecione o **Sensibilidade de marcação automática de spam** nível.

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

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

**Chave** **Métricas** (exibidas na parte superior da página):

* **Spam**: Número de chamadas diretas para usuários marcadas como **Spam** pelos 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
* **Únicos** **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;">Analisando o gráfico de chamadas Recebidas</mark>

A seção de chamadas Recebidas exibe 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 pela marcação automática, mas marcadas como Não é spam pelos utilizadores)

Passe o cursor sobre o gráfico para ver datas e percentagens específicas para 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 na sua Organização que receberam mais chamadas spam e chamadas possivelmente spam.

**Informações** **apresentado**:

* Número de telefone
* Total de chamadas recebidas
* Chamadas spam recebidas
* Chamadas possivelmente spam recebidas
* Usuário ou ramal atribuído ao número

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

#### <mark style="color:azul;">Analisando os 100 principais chamadores de spam</mark>

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

**Informações** **apresentado**:

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

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

#### <mark style="color:azul;">Por que as suas chamadas Realizadas podem ser marcadas como spam</mark>

Quando você faz chamadas Realizadas do Zoom Phone, as suas chamadas podem ser bloqueadas ou marcadas como spam pelo serviço telefônico ou pela operadora da parte receptora. Isso acontece porque as operadoras estão implementando cada vez mais programas de bloqueio de chamadas para proteger os consumidores contra robocalls abusivas. Se a sua conta tiver uma marcação de spam incorreta, consulte a nossa seção sobre Remediação da 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 robocall
* **Serviços de banco de dados de terceiros**: A parte receptora pode usar serviços como o Nomorobo que têm o seu número sinalizado
* **Filtros de serviços telefônicos de terceiros**: O receptor pode ter filtros que bloqueiam determinados prefixos de número
* **Falta de inscrição do ID do chamador**: Suas informações corporativas não estão registradas com as operadoras e provedores de análises

#### <mark style="color:azul;">Autorizando proativamente os seus números com as operadoras dos EUA</mark>

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

**Operadoras dos EUA para contato**:

* Hiya
* TNS
* Sprint
* T-Mobile

**Serviços de banco de dados de robocalls para contato**:

* Nomorobo
* YouMail

**Fornecedores de análises**:

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

Entre em contato com 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 da marcação 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 licença Zoom Phone com add-on do Zoom Auto Dialer
* SKU de Monitoramento e Remediação de Spam (a menos que esteja usando o Discador Realizadas da central de contato)
* Conclusão e aprovação do formulário de inscrição do Spam Tag Remediation
* Suporta números nativos e BYOC

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

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

Assim que os números forem inscritos, eles exibirão um indicador de status de spam atualizado no portal de administração. Quando um número for detectado como spam:

1. Você verá alertas inline em vários locais no portal de administração
2. O processo automático de remediação começa imediatamente
3. O processo normalmente leva 1-2 dias (pode demorar mais em disputas regulatórias)
4. Nenhuma ação manual é necessária da sua parte
5. Se for bem-sucedido, o rótulo de spam é removido automaticamente

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

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

#### <mark style="color:azul;">Minhas chamadas efetuadas estão sendo bloqueadas ou marcadas como spam pelos destinatários</mark>

Comece identificando qual operadora ou serviço está bloqueando suas chamadas; depois, entre em contato diretamente com eles para solicitar a inclusão em lista de permissões. Forneça documentação do seu uso empresarial legítimo para dar suporte à sua solicitação. Para soluções de longo prazo, conclua **Inscrição empresarial para rotulagem de spam** para registrar sua empresa com as principais operadoras e habilitar **Remediação da marcação de spam** para monitorar e remover automaticamente etiquetas de spam. Siga as melhores práticas para chamadas efetuadas evitando padrões de chamadas de alto volume e curta duração.

#### <mark style="color:azul;">Chamadas de spam demais estão chegando aos meus usuários</mark>

Verifique se a Proteção contra Spam está habilitada no nível da conta e ajuste o **Nível do Filtro de Spam** para uma sensibilidade mais alta. Incentive os usuários a marcar chamadas de spam, o que ajuda a melhorar a precisão do sistema ao longo do tempo. Revise o **Top 100 Chamadores de Spam** no Painel para identificar reincidentes e considerar alterar o tratamento da chamada para **Bloquear este número** ou **Encaminhar para o correio de voz**. Para usuários fortemente impactados, habilite **Triagem de chamadas**, que exige que chamadores externos pressionem um botão para conectar.

#### <mark style="color:azul;">Chamadas legítimas estão sendo marcadas incorretamente como spam</mark>

Peça aos usuários que marquem os números como **Não é spam** a partir do histórico de chamadas ou do correio de voz e ajuste o **Limite de marcação manual de NÃO SPAM** para um número mais baixo. Reduza a **Nível do Filtro de Spam** sensibilidade para reduzir falsos positivos. Adicione os números aos contatos do usuário ou da empresa e depois habilite **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 para um período específico</mark>

Acesse o Painel de Spam navegando até **Painel > Telefone > Spam** no seu portal de administração. No topo da página, selecione 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 ligando apesar de estar bloqueado</mark>

Verifique se o número está na lista de números de spam consultando **Configurações da conta > Proteção contra Spam > Gerenciar Lista de Números**. Confirme se o tratamento da chamada está definido para **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 todo o código de área ou prefixo, se apropriado, e denunciar chamadores de spam persistentes às autoridades locais se estiverem assediando ou ameaçando.

#### <mark style="color:azul;">As etiquetas de spam não estão aparecendo nas minhas ligações</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 os seus Números de telefone são dos EUA ou do Canadá, já que 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 padrões de spam.

#### <mark style="color:azul;">Meus números de chamadas Realizadas podem ter etiquetas de spam aplicadas a eles</mark>

Aceda a **Gerenciamento de Números > Números de telefone > Recursos relacionados > Remediação de etiquetas de spam** para verificar o status dos seus números. Revise o indicador de status de spam de cada número inscrito e procure alertas no texto indicando detecção de spam. Monitore o status do processo de remediação automática para ver se o Zoom está trabalhando ativamente para remover etiquetas. Sem a Remediação de etiquetas de spam, talvez você não saiba que seus números estão marcados, a menos que os destinatários o informem.

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

A marcação automática de spam usa análises de chamadas e padrões globais do setor para identificar spam automaticamente sem entrada do usuário. Ela 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 marcação manual de spam é baseada em denúncias de usuários e limites definidos, exigindo que os usuários marquem ativamente os números como spam. Ela cria listas de spam específicas da Organização e substitui as configurações de marcação automática quando os limites são atingidos.

#### <mark style="color:azul;">Quero usar tanto a marcação automática quanto a marcação manual de spam juntas</mark>

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

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

O processo de correção automática normalmente leva 1–2 dias para ser concluído. Pode demorar mais se houver disputas regulatórias com as operadoras ou se a tag de spam tiver sido aplicada por várias operadoras. Nenhuma ação manual é necessária da sua parte durante este processo. Se a correçã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 entendo o que acontece durante a remediação da etiqueta de spam</mark>

Para 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 tag é removida, o número volta a ficar elegível para correspondência. Para o Zoom Phone normal, o sistema trabalha automaticamente com as operadoras para remover a tag e você verá atualizações de status no portal de administração. Se não tiver êxito após a tentativa inicial, talvez seja necessário abrir um protocolo do suporte.

#### <mark style="color:azul;">Eu 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 o SMS completamente para que os usuários não possam ver mensagens de spam. Marcar sem rótulos Block marca o SMS como spam, mas permite a entrega. Configurar isto em **Configurações da conta > Zoom Phone > Proteção contra spam > Opções de tratamento da chamada e SMS > SMS SPAM recebido**.

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

Habilitar a exclusão dos contatos do usuário e da empresa da Proteção contra Spam para Permitir automaticamente que todos os contatos salvos passem. Faça com que os usuários salvem os números dos clientes nos seus contatos para que sejam reconhecidos como ligadores legítimos. Ajuste adequadamente os níveis de sensibilidade, 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 chamada de spam e preciso saber o que fazer (ligar).</mark>

Não atenda se a ligação já estiver marcada como spam, a menos que reconheça o número. Marque o ligar como spam no seu histórico de chamadas ou correio de voz se não tiver sido detetado automaticamente. Selecionar **Chamadas de spam (ligar)** 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 chamadas de spam (ligar).

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

Permitir bloquear números e prefixos específicos é um recurso do Zoom Phone, mas bloquear códigos de área inteiros deve ser abordado com cautela, pois pode bloquear ligadores legítimos. Se estiver a enfrentar spam de prefixos específicos, pode Adicionar esses prefixos à sua lista de números bloqueados. No entanto, considere o impacto Corporativo (for plan)/Corporativa (for licence) antes de implementar regras amplas de bloqueio. Muitas vezes, uma abordagem melhor é usar níveis mais altos de sensibilidade ao spam e incentivar os usuários a denunciar.

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

A precisão depende do nível de sensibilidade que você Escolher, da qualidade das bases de dados globais de spam, do 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 de spam marcada incorretamente no Painel para avaliar a precisão da sua Organização. Se você vir números altos de spam marcado incorretamente, considere diminuir 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>

Estas funcionalidades servem propósitos diferentes e funcionam em conjunto para uma proteção abrangente. A Proteção contra spam protege os seus utilizadores 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 de serem marcadas como spam por outras operadoras. Além disso, a inscrição de spam funciona para números internacionais, enquanto a remediação de spam só está Disponível para números dos EUA. Ambas são recomendadas para uma gestão abrangente de spam, especialmente se a sua Organização faz chamadas Realizadas frequentes.

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

O Zoom partilha o nome legal da sua empresa e o nome público, o setor e o porte da empresa, as informações de contato e o 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 status 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.