build_deck
ChatGPTRecebe o plano de audiências (plan: brand, campaign, objective, where/who/how, layers com audiences, solutions, measurement_mode, overlap, next_steps; mesmo esquema do deck.md do plugin HYPR Audiences) e gera o deck no padrão do HYPR Design System (Urbanist, cards, 14 slides: capa, sumário, contexto, camadas, cards de audiência, ranking, alcance único, plataforma, mensuração, próximos passos). Operação aditiva e segura: só cria um arquivo novo, não altera nem apaga o plano guardado nem nenhum dado existente; pode ser chamada quantas vezes quiser. Devolve um link de download do .pptx válido por alguns dias. O mesmo plano pode ser enviado por POST para https://hypr-audiencias.netlify.app/deck para receber o arquivo direto.
catalog_status
ChatGPTCompatibilidade com a primeira versão do conector. Devolve o status do catálogo: total de audiências, volume somado, categorias e subcategorias. Prefira list_categories.
compose_plan
ChatGPTFaz em uma chamada o que o método pede: ranqueia, infere vertical, monta as camadas Core / Conquista / Afinidade / Expansão com regras fixas, recomenda plataforma e mensuração, estima sobreposição e devolve o plano.json completo do deck, já guardado sob plan_id. O modelo só refina os campos de texto listados em text_todo (sem alterar números) e chama build_deck com plan_id + overrides. Mesmos campos de briefing do rank_audiences.
estimate_overlap
ChatGPTRecebe os segment_name das audiências de um plano e devolve soma bruta, alcance único estimado, fator de unicidade e os pares com maior sobreposição (com alerta para quase-duplicatas). Estimativa por composição das audiências (redes, subcategoria, descrição), não medição de devices. Use depois de fechar as camadas do plano.
get_evidence
ChatGPTFicha de uma ou mais audiências (segment_name ou nome): descrição, casos de uso, keywords e volume. Com region (ou state/uf/city), devolve recorte_praca.volume_estimado para a praça (rateio por população da UF). Use para confirmar a volumetria de uma audiência específica num estado.
get_method
ChatGPTDevolve o método vigente para montar um plano de audiências HYPR com deck: A) fluxo do plano (briefing, ranking, camadas, overlap, entrega, deck, avaliação), B) esquema do plano.json do deck, C) regras de marca. Chame antes de montar qualquer plano e siga-o; é a fonte única, mantida no servidor. section opcional: fluxo | deck | marca.
list_audiences
ChatGPTLista as audiências de uma categoria ou subcategoria do catálogo (nomes, IDs, volumes), sem busca semântica. Ex.: category='Health & Fitness', sub_category='Gym' devolve os segmentos de academias. Aceita region (UF, cidade ou região) para o rateio do volume pela população. Use list_categories para ver os nomes válidos.
list_categories
ChatGPTLista as categorias e subcategorias disponíveis, com número de audiências e volume somado de cada uma.
rank_audiences
ChatGPTRecebe o briefing de uma marca/campanha (inclusive praça e período) e devolve as audiências HYPR ranqueadas por relevância, cada uma com brand_affinity (0 a 100%, afinidade ESTIMADA a partir do cruzamento do briefing com o catálogo) e faixa Alta/Média/Complementar. A affinity é calibrada pela HYPR Library (histórico de centenas de planos reais): audiências já usadas em planos da mesma vertical sobem e vêm com library_evidence (nº de planos, clientes). Devolve também expansion: audiências que o time de planejamento costuma combinar com as rankeadas (co-ocorrência em planos reais), para a camada Expansão. Também recomenda a plataforma HYPR para o caso, calibrada pela vertical do anunciante: quais IQs (geoIQ, revIQ, adsIQ, askIQ) e se o Demandshift se aplicam, com prioridade e justificativa (revIQ, por exemplo, só onde a venda passa por nota fiscal de varejo físico), e devolve measurement_plan com o modo de prova adequado (vendas, visitas ou marca). Use para planos de audiência e propostas.
rate_plan
ChatGPTRegistra se o plano serviu: nota de 1 a 5, comentário livre e ajustes que o usuário precisou fazer (audiência que faltou, pilar errado, volume estranho). Use ao final do fluxo de plano, depois de perguntar ao usuário em uma linha. Alimenta a calibração do ranking.
recommend_audiences
ChatGPTRecomenda audiências HYPR. Com brand ou category, equivale a rank_audiences (ranking por Brand Affinity com plataforma e mensuração); só com query, equivale a search_audiences. RECORTE POR ESTADO DISPONÍVEL: passe region (ou state/uf/city) com a praça pedida, ex. region='Minas Gerais'; cada audiência volta com recorte_praca.volume_estimado (volume nacional rateado pela população da UF, IBGE 2022). Use esse número como volume da praça e cite o nacional ao lado.
review_text
ChatGPTCheca um texto (plano, deck, e-mail) contra as regras de marca: grafia HYPR e dos pilares, Groundflow/Max Attention/Places Graph, termos proibidos (programático, bidIQ, data provider, sistemas de IA), travessão, exclamação, emoji, clientes citáveis. Corrige automaticamente o que é seguro e lista o resto. Chame antes de entregar qualquer texto ao usuário.
search_audiences
ChatGPTBusca audiências da HYPR e retorna a volumetria (audience_volume = pessoas únicas; addresses_count = endereços/locais usados). Busca por palavras no nome, categoria, subcategoria e descrição (ex: 'banco', 'pet', 'posto', 'luxo'). Aceita filtros por categoria, subcategoria, tipo e volume mínimo. Sem query, lista as audiências ordenadas por volume.
