> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Interpretar Monitor > Visualize um monitor antes de criá-lo — transforme um pedido em linguagem natural (em qualquer idioma) em uma configuração de **rascunho** validada que você pode inspecionar, ajustar e depois enviar para [Create Monitor](/pt/api-reference/endpoint/monitors/create). É seguro chamar quantas vezes precisar: apenas gera o rascunho, e nunca persiste um monitor, envia alertas ou consome créditos. Use `intent` para escolher a ação; se omitido, é aplicada uma heurística de palavras-chave em inglês, e entradas não reconhecidas usam `create_monitor` por padrão. ## OpenAPI ````yaml pt-openapi POST /monitors/interpret openapi: 3.0.0 info: description: >- A API Pubrio entrega inteligência de expansão de mercado — sinais em tempo real que indicam quando uma empresa entra em um novo mercado — além dos dados de empresas e pessoas por trás desses sinais. Pesquise, consulte e enriqueça contas e contatos, e assine sinais de movimentação tipados e datados em mais de 200 mercados. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/pt-BR/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/pt-BR/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Informações do perfil da equipe e estatísticas de uso - name: Enrichment description: Enriqueça registros de pessoas e empresas com dados B2B detalhados - name: Lookalike description: Encontre empresas semelhantes a uma empresa específica - name: Search description: Pesquise pessoas, empresas, vagas, notícias e anúncios com filtros - name: Lookup description: >- Consulte informações detalhadas de pessoas, empresas, vagas, notícias, anúncios e tecnologias específicas - name: LinkedIn description: >- Consulte dados de pessoas e empresas por meio de URLs de perfil do LinkedIn - name: Redeem description: >- Resgate créditos para desbloquear detalhes de contato de pessoas (individual e em lote) - name: Channels description: >- Gerencie templates de canais de outreach (criar, atualizar, excluir, listar) - name: Monitor description: >- Crie e gerencie monitores de dados com webhooks, estatísticas e processamento - name: Filters description: >- Obtenha os valores de filtro disponíveis para os parâmetros de busca (tecnologias, localizações, verticais etc.) - name: API Keys description: >- Liste e inspecione logs de requisições da API e análises de uso das chaves de API - name: Insights description: Insights agregados de sinais para empresas (vagas, notícias, anúncios). - name: Export description: Exportações de dados em massa (consomem créditos). - name: Expansion description: >- Inteligência de expansão de mercado de empresas: sinais, estágios, mercados e exportações. externalDocs: description: >- A API Pubrio é usada para pesquisar, pré-visualizar e enriquecer contatos e contas. O banco de dados Pubrio oferece dados extensos de contatos B2B e inteligência de vendas. url: https://docs.pubrio.com paths: /monitors/interpret: post: tags: - Monitor summary: Interpretar um monitor a partir de linguagem natural description: >- Visualize um monitor antes de criá-lo — transforme um pedido em linguagem natural (em qualquer idioma) em uma configuração de **rascunho** validada que você pode inspecionar, ajustar e depois enviar para [Create Monitor](/pt/api-reference/endpoint/monitors/create). É seguro chamar quantas vezes precisar: apenas gera o rascunho, e nunca persiste um monitor, envia alertas ou consome créditos. Use `intent` para escolher a ação; se omitido, é aplicada uma heurística de palavras-chave em inglês, e entradas não reconhecidas usam `create_monitor` por padrão. operationId: interpretMonitor parameters: [] requestBody: required: true content: application/json: schema: type: object required: - query properties: query: type: string maxLength: 2000 description: >- O pedido em linguagem natural (em qualquer idioma), por exemplo "monitor companies expanding into Japan, get C-level people with their work email, and email alerts to me@company.com in real time". Limitado a 2000 caracteres. intent: type: string enum: - create_monitor - dry_test - execute - analyze description: >- Qual ação executar (independente de idioma). `create_monitor` (padrão): retorna uma configuração de rascunho. `dry_test`: rascunho mais uma contagem somente leitura dos sinais correspondentes no momento. `execute`: rascunho mais pré-visualização, sinalizado para confirmação (nunca ativa automaticamente). `analyze` (por exemplo, "which market, SG or JP?"): respondido pelo agente analítico de expansão em vez de criar um monitor. Se omitido, é usada uma heurística de palavras-chave em inglês; entradas não reconhecidas usam `create_monitor` por padrão. deep: type: boolean description: >- Executa a passagem de reflexão para maior precisão (padrão true; aproximadamente dobra a latência). Defina false para uma interpretação de passagem única mais rápida. example: query: >- monitor companies expanding into Japan, get C-level people with their work email, and email alerts to me@company.com in real time responses: '200': description: O rascunho interpretado. Nada é persistido. content: application/json: schema: type: object properties: data: type: object properties: intent: type: string enum: - create_monitor - dry_test - execute - analyze description: >- A ação resolvida (create_monitor / dry_test / execute / analyze). no_intent: type: boolean description: >- true quando o pedido não era uma configuração de monitor (uma saudação, algo fora do assunto ou sem sentido); `config` é então nulo. config: type: object nullable: true description: >- A configuração do monitor em rascunho, no mesmo formato do corpo da requisição de [Create Monitor](/pt/api-reference/endpoint/monitors/create) (detection_mode, signal_types, signal_filters, people_enrichment_configs, destination_type/destination_config, frequency_minute, status "draft", entre outros). Envie-a para Create Monitor para ativá-la. Também pode conter `domains`/`linkedin_urls`/`company_names`, que Create Monitor resolve para empresas. Nulo quando `no_intent` é true. missing_fields: type: array items: type: string description: >- Campos ainda necessários antes que o monitor possa ser ativado (por exemplo, "destination", "signal_types", "companies"). Colete-os em sua interface antes de enviar para Create Monitor. requires_confirmation: type: boolean description: >- true para a intenção `execute` — a configuração está pronta, mas o usuário precisa confirmar antes que você a ative. preview: type: object nullable: true description: >- Presente para `dry_test` e `execute`: uma estimativa somente leitura de quantos sinais correspondem no momento, por tipo de sinal, nos últimos 30 dias (amostrados). Nenhum crédito é consumido. interpretation: type: object description: >- Reflexo dos campos brutos extraídos da consulta, para exibição ou depuração. example: data: intent: create_monitor no_intent: false config: detection_mode: signal_first signal_types: - expansions signal_filters: - signal_type: expansions filters: tos: - JP stages: - exploring - committing company_filters: {} companies: [] is_company_enrichment: false is_people_enrichment: true people_enrichment_configs: - max_people_to_return: 5 filters: management_levels: - c_suite people_contact_types: - email-work name: Expansion signals → JP destination_type: email destination_config: emails: - me@company.com frequency_minute: 5 status: draft missing_fields: [] requires_confirmation: false preview: null interpretation: signal_types: - expansions tos: - JP management_levels: - c_suite people_contact_types: - email-work destination_email: me@company.com is_realtime: true '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: responses: general_error: description: >- Requisição inválida. A requisição estava malformada ou continha parâmetros inválidos. Verifique o código de erro e a mensagem para mais detalhes. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações. type: string details: type: object rate_limit_error: description: >- Limite de requisições excedido. Foram feitas requisições em excesso em um determinado período de tempo. Tente novamente após a janela do limite de requisições ser reiniciada. content: application/json: schema: required: - error type: object properties: error: example: >- Limite de requisições excedido. Aguarde e tente novamente mais tarde. type: string server_error: description: >- Erro interno do servidor. Ocorreu um erro inesperado no servidor. Entre em contato com o suporte caso o erro persista. content: application/json: schema: required: - error type: object properties: error: example: Ocorreu um erro inesperado no servidor. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Um token de API exclusivo que representa as ações que você realiza por meio da API e as permissões e operações correspondentes. Você pode criá-lo na seção [Configurações](https://dashboard.pubrio.com/#/settings/). in: header ````