> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-conta/centro-de-custos.md). # Centro de custos Gerencie seus custos na Hyperflow. ## 📊 Centro de custos O **Centro de custos** mostra, em um só lugar, quanto a sua organização consumiu e quanto isso custou em um período. Você vê o total do período, a evolução ao longo do tempo e a divisão por **app**, **canal**, **produto**, **departamento**, **agente** e outros recortes. Assim fica fácil responder perguntas como "qual app mais gastou neste mês?" ou "quanto custou a campanha de outubro?". Na tela você encontra: * **Cabeçalho:** período, granularidade (como o período é dividido: por dia, semana ou mês) e botão para exportar. * **Gráfico:** barras empilhadas com o consumo ao longo do tempo e os totais do período. * **Tabela de detalhamento:** os mesmos números em linhas, com a opção de abrir um segundo nível de detalhe. * **Filtros:** painel ao lado para escolher exatamente o que entra na conta.

Imagem 1 - Tela inteira do Centro de custos com o cabeçalho, o gráfico, a tabela e o painel de filtros à direita

{% hint style="info" %} **Disponibilidade dos dados:** o Centro de custos traz os dados a partir de **01/10/2026**. Períodos anteriores a essa data não aparecem na tela, mesmo que você escolha, por exemplo, **Últimos 12 meses**. {% endhint %} *** ### 🧭 Como acessar 1. No menu lateral, clique em **Centro de custos**. Ele fica logo abaixo de **Cobranças e Assinaturas**. 2. Caso clique em 'Ver métricas' na tela 'Cobranças e assinaturas' ou clique diretamente na tela no menu lateral esquerdo, você será direcionado para a tela, que abre com o período **Este mês**, agrupado por **Produto**.

Imagem 2 - Menu lateral com o item "Centro de custos" destacado

{% hint style="info" %} O item **Centro de custos** aparece para quem é proprietário da organização e para os perfis com permissão financeira. Se você não o encontrar no menu, peça ao administrador da sua organização para liberar o seu acesso. Se o acesso já estiver liberado e o item continuar sem aparecer, o recurso pode ainda não ter sido ativado para a sua organização. Nesse caso, fale com o suporte. {% endhint %} *** ### 🚀 Como usar na prática: passo a passo A tela foi pensada para você ir do geral para o específico. A ordem mais comum de uso é esta: 1. Escolher o **período**. 2. Escolher o **agrupamento** (por que critério dividir o total). 3. Escolher se quer ver por **Valor** ou por **Unidades**. 4. Abrir o **detalhamento** e, se quiser, escolher um **sub-agrupamento**. 5. **Clicar** em um item para aprofundar. A tela filtra sozinha. 6. Refinar com **filtros**, se precisar. 7. **Exportar** ou compartilhar. {% hint style="info" %} A tela já abre com o período **Este mês**, agrupada por **Produto** e em **Valor**. Se for isso que você quer, pode começar direto pelo passo 4. {% endhint %}

Imagem 3 - Tela do Centro de custos recém-aberta, com as indicações numeradas de 1 a 4 sobre o período, as abas de agrupamento, o seletor Valor/Unidades e o campo "E por"

#### 🔹 Passo 1: escolha o período No cabeçalho, abra a lista **Período** e escolha, por exemplo, **Este mês** ou **Últimos 3 meses**. Para datas específicas, escolha **Personalizado** e preencha **Início** e **Fim**. Se quiser, ajuste a **Granularidade** (**Dia**, **Semana** ou **Mês**). O período vale para tudo o que você fizer a seguir. Ele não muda quando você filtra ou detalha. #### 🔹 Passo 2: escolha um agrupamento Nas abas de **Agrupar por**, clique no critério pelo qual você quer dividir o total, como **Produto**, **App**, **Departamento** ou **Tag**. Use **Mais** para ver outras opções. O gráfico passa a mostrar uma cor para cada item do critério escolhido, e a legenda mostra o total de cada um. #### 🔹 Passo 3: escolha Valor ou Unidades No seletor **Métrica**, à direita das abas, escolha: * **Valor**, para ver quanto foi gasto em dinheiro; * **Unidades**, para ver quanto foi consumido, como quantidade de mensagens ou minutos. O gráfico, os números do topo e a tabela mudam juntos. As escolhas do agrupamento e do período continuam como estavam. #### 🔹 Passo 4: abra o detalhamento e escolha um sub-agrupamento Role até o cartão **Detalhamento por**, logo abaixo do gráfico. Ele mostra os mesmos itens em linhas, com uma coluna para cada dia, semana ou mês. Se quiser cruzar o agrupamento com um segundo critério, abra o campo **E por** e escolha o sub-agrupamento. Por exemplo, com o agrupamento **Produto** e o sub-agrupamento **Departamento**, a tabela passa a mostrar cada produto com os departamentos dentro dele. * A tabela deixa de ter colunas de datas e passa a ter **Nome**, **Eventos**, o **Valor** (ou as **Unidades**) e **% do total**. * Clique na setinha de uma linha para abrir os departamentos daquele produto, ou use **Expandir tudo**. * O gráfico continua dividido pelo agrupamento principal. #### 🔹 Passo 5: clique em um item para aprofundar Clique em uma **barra** do gráfico ou no **nome de uma linha** da tabela. A tela faz três coisas ao mesmo tempo, sem você precisar configurar nada: 1. **Filtra** apenas o item em que você clicou. Ele aparece como uma etiqueta no painel **Filtros**. 2. **Muda o agrupamento** para o próximo critério. Se você escolheu um sub-agrupamento no campo **E por**, é ele que vira o novo agrupamento. Se não, a tela segue uma ordem: **Produto**, **Tipo de produto**, **App**, **Tipo de canal**, **Canal**, **Departamento**, **Agente**, **Template**, **Tag**, **Rota** e **Tool**. Critérios que você já filtrou são pulados. 3. **Mostra o caminho** que você percorreu acima do gráfico, por exemplo **Tudo > Produto: Mensagens > por Departamento**. A métrica (**Valor** ou **Unidades**) e o período continuam os mesmos. Você pode clicar de novo, quantas vezes quiser, para descer mais um nível. Para voltar, clique em **Tudo** ou em qualquer passo do caminho. Os filtros criados depois daquele passo são removidos. {% hint style="info" %} Na tabela de dois níveis, o clique funciona nos nomes da primeira coluna, os do agrupamento principal. Os itens do sub-agrupamento, que aparecem ao expandir a linha, servem apenas para leitura. {% endhint %} {% hint style="info" %} Os itens **Outros** e **Não informado** não podem ser detalhados, porque juntam vários valores diferentes. {% endhint %} #### 🔹 Passo 6: refine com filtros, se precisar No painel **Filtros**, ao lado, você pode incluir ou tirar itens manualmente. Os cliques do passo anterior já criam filtros por você, e você pode remover qualquer um deles clicando no **x** da etiqueta. Em **Opções avançadas**, escolha se quer ver tudo, só o que está incluso no plano ou só o que foi cobrado a mais. #### 🔹 Passo 7: exporte ou compartilhe Clique em **Exportar CSV** para levar a tabela para uma planilha. Para mostrar a mesma visão a um colega, copie o endereço da página no navegador e envie. Tudo o que você escolheu fica guardado no endereço. #### 💼 Cenários de uso **Cenário 1: quanto cada departamento gastou com mensagens neste mês?** 1. Deixe o período em **Este mês**. 2. Em **Agrupar por**, clique em **Produto**. 3. Em **Métrica**, escolha **Valor**. 4. No cartão de detalhamento, abra **E por** e escolha **Departamento**. 5. Na tabela, clique no nome **Mensagens**. 6. A tela filtra **Produto: Mensagens** e passa a agrupar por **Departamento**. O gráfico mostra a evolução de cada departamento ao longo do mês, e o caminho no topo fica **Tudo > Produto: Mensagens > por Departamento**. 7. Clique no departamento que mais gastou para ver, em seguida, do que ele é feito, por **Tipo de produto**, como **Mensagem enviada** e **Mensagem recebida**. 8. Clique em **Exportar CSV** para levar o resultado ao financeiro.

Imagem 4 - Tela do Cenário 1 com o caminho "Tudo > Produto: Mensagens > por Departamento" no topo e a etiqueta "Produto: Mensagens" no painel de filtros

**Cenário 2: qual app mais gasta e em quê?** 1. Em **Agrupar por**, clique em **App** e escolha a métrica **Valor**. 2. Clique na barra do app que mais gasta. 3. A tela filtra aquele app e agrupa por **Produto**, mostrando se o custo é de mensagens, disparos, inteligência artificial e assim por diante. 4. Clique em **Mensagens** (ou no produto de maior valor). A tela filtra o produto e passa a agrupar por **Tipo de produto**. 5. O caminho no topo mostra todo o trajeto, por exemplo **Tudo > App: Loja Online > Produto: Mensagens > por Tipo de produto**. Clique em **App: Loja Online** se quiser voltar um passo. **Cenário 3: quanto foi consumido, e não gasto?** 1. Em **Agrupar por**, escolha **Tipo de canal**. 2. Em **Métrica**, troque para **Unidades**. 3. O gráfico e a tabela passam a mostrar a quantidade consumida por canal, como WhatsApp e SMS, sem converter em dinheiro. **Cenário 4: como acompanhar as mensagens de serviço do WhatsApp?** Desde 1º de outubro de 2026, as mensagens de serviço do WhatsApp são cobradas por mensagem entregue, depois das primeiras **1.000 de cada número, por mês**. As primeiras 1.000 não têm custo. Por isso, para esse tipo de mensagem, **Unidades** costuma ser mais útil do que **Valor**: * Em **Valor**, só aparecem as mensagens cobradas, a partir da 1.001ª de cada número no mês. Um mês com menos de 1.000 mensagens por número aparece zerado, mesmo com muitas mensagens enviadas. * Em **Unidades**, as mensagens aparecem desde a primeira, inclusive as gratuitas. Para acompanhar: 1. Em **Agrupar por**, clique em **Mais** e escolha **Tipo de produto**. 2. No painel **Filtros**, clique em **Incluir todos** na linha **Tipo de produto**, marque **Mensagem de serviço (nível gratuito)** e **Mensagem de serviço** e clique em **Aplicar**. O nome pode vir com um complemento ao lado, como **Tarifa WhatsApp**. 3. Em **Métrica**, escolha **Unidades**. 4. O gráfico mostra as duas linhas empilhadas: a gratuita, desde a primeira mensagem do mês, e a cobrada, que só surge depois da faixa gratuita. 5. Para ver número por número, abra **E por** no cartão de detalhamento e escolha **Canal**. Cada número aparece com a quantidade de mensagens de serviço que enviou. 6. Troque a métrica para **Valor** se quiser ver quanto custou a parte cobrada. {% hint style="info" %} A faixa gratuita é contada por número e reinicia a cada mês. Por isso a linha cobrada pode voltar a ficar zerada no começo de cada mês. Para entender como essas mensagens aparecem no plano, veja a doc **Cobranças e Assinaturas**, na seção sobre cobrança das mensagens de serviço. {% endhint %} *** ### 🖥️ Conhecendo a tela As seções abaixo explicam cada área da tela em detalhe. Use-as como consulta quando quiser entender um botão, um campo ou um texto específico. #### 1️⃣ Cabeçalho: período, granularidade e exportação **🎯 Propósito** Escolher o intervalo de tempo que você quer analisar e como ele será dividido no gráfico e na tabela. **✅ Como fazer na tela** No topo da tela você vê o título **Centro de custos**, uma frase explicando a tela e, à direita, três controles: 1. **Período:** abra a lista e escolha uma das opções. * **Este mês** * **Mês passado** * **Últimos 3 meses** * **Últimos 6 meses** * **Últimos 12 meses** * **Personalizado** 2. Se escolher **Personalizado**, aparecem dois campos de data, **Início** e **Fim**. Clique em cada um e escolha a data no calendário. O período máximo é de **13 meses**. Se você passar disso, a tela ajusta o início automaticamente. 3. **Granularidade:** escolha **Dia**, **Semana** ou **Mês**. Ela define quantas barras o gráfico mostra e quantas colunas a tabela tem. 4. **Exportar CSV:** baixa em uma planilha o que está na tabela naquele momento (veja a seção **Exportando para planilha**, mais abaixo). {% hint style="info" %} A opção **Dia** só fica disponível para períodos de até 3 meses. Ao passar o mouse sobre ela, a tela mostra o aviso **Diário disponível até 3 meses**. Quando você amplia o período além disso, a tela troca a granularidade automaticamente para **Semana** ou **Mês**. {% endhint %} **📌 Resultado esperado** O gráfico, os totais e a tabela são recarregados para o novo período. Durante o carregamento você verá um esboço cinza no lugar dos números. *** #### 2️⃣ Gráfico e totais do período **🎯 Propósito** Ver quanto foi gasto (ou consumido) no período, como isso evoluiu ao longo do tempo e quem mais contribuiu para o total. **✅ Como fazer na tela** O cartão principal tem quatro partes, de cima para baixo. **Agrupar por** Uma fileira de abas define como o gráfico divide o total. As abas em destaque são: | Aba | O que mostra | | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Produto** | O tipo de serviço: Mensagens, Disparos, Ligações, Inteligência artificial, Integrações, Plataforma, Carteira e Outros. | | **Tipo de produto** | O item cobrado em detalhe, por exemplo Mensagem recebida, Disparo de marketing ou Ligação ativa. | | **App** | Cada app da organização. | | **Tipo de canal** | O canal usado, como WhatsApp, SMS ou RCS. | | **Departamento** | Cada departamento do Hyperflow Conversas. | | **Tag** | As tags de custo que você e o seu time digitaram nos fluxos, módulos, transmissões e rotas. Cada texto diferente vira um grupo. Veja a seção **Tags de custo**, mais abaixo. | Clique em **Mais** para abrir outras opções. A opção escolhida vira uma aba enquanto estiver ativa.
Opção em MaisO que mostra
PlanoO plano contratado de cada app.
CanalO número ou a conta específica usada, como um número de WhatsApp. Diferente de Tipo de canal, que agrupa por categoria.
AgenteO agente do Hyperflow Conversas ligado à cobrança.
TemplateO modelo de mensagem usado, pelo nome com que foi cobrado.
RotaA rota do API Gateway que gerou a cobrança, escrita como foi cadastrada (por exemplo, POST /pedidos/{id}). Chamadas à mesma rota ficam juntas, mesmo com números diferentes no endereço.
ToolA ferramenta acionada por meio do MCP, escrita no formato servidor, ponto e ferramenta. Só aparece para quem usa o MCP.
OrigemDe onde vem a cobrança: Planos, WhatsApp (cobrada pela Meta, em dólar) ou Legado.
{% hint style="info" %} As opções **Rota** e **Tool** só trazem valores quando existem cobranças ligadas a elas. Nos demais casos, o valor aparece como **Não se aplica**. {% endhint %} **Valor ou Unidades** À direita das abas, o seletor **Métrica** alterna entre: * **Valor:** quanto foi gasto, em dinheiro. * **Unidades:** quanto foi consumido (por exemplo, quantidade de mensagens ou minutos), sem converter em dinheiro. **Números do período** Logo abaixo você vê o número grande do período. O texto acima dele muda conforme os filtros: **Custo total no período**, **Incluso no plano**, **Custo cobrado no período** ou **Créditos no período**. Ao lado ficam três indicadores menores: | Indicador | O que significa | | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | | **Unidades** (ou **Valor**, quando você está vendo Unidades) | O outro lado da métrica escolhida. | | **Eventos** | Quantas ocorrências cobráveis aconteceram no período, como mensagens enviadas ou chamadas. | | **Excedente** | A porcentagem de eventos que passou do que está incluso no plano. Passe o mouse para ver a explicação. | **Gráfico de barras** Cada barra é um dia, uma semana ou um mês, conforme a granularidade. Cada cor é um item do agrupamento escolhido. O gráfico mostra os **8 maiores** itens e junta o restante em **Outros**. Acima de cada barra aparece o total daquele momento. Passe o mouse sobre uma barra para abrir uma caixinha com o total e a participação de cada item, do maior para o menor. **Legenda** Abaixo do gráfico fica a legenda, com o total e a porcentagem de cada item. Você pode: 1. Passar o mouse sobre um item para destacá-lo no gráfico. 2. Clicar em um item para escondê-lo. Clique de novo para mostrá-lo. O último item visível não pode ser escondido, para o gráfico nunca ficar vazio. **📌 Resultado esperado** Quando você esconde itens na legenda, o número grande e os indicadores passam a somar **só o que está desenhado**. O texto passa a indicar **séries visíveis** e mostra, embaixo, o total completo do período como referência. A tabela de detalhamento também acompanha o que está visível. *** #### 3️⃣ Detalhando um item do gráfico **🎯 Propósito** Descobrir de onde vem um custo, descendo passo a passo: do produto até o agente, por exemplo. **✅ Como fazer na tela** 1. Clique em uma **barra** do gráfico ou no **nome de uma linha** da tabela. Ao passar o mouse, a tela mostra a dica **Clique numa barra para detalhar por** seguido do próximo recorte. 2. A tela filtra apenas aquele item e agrupa o resultado pelo próximo recorte, seguindo esta ordem: **Produto**, **Tipo de produto**, **App**, **Tipo de canal**, **Canal**, **Departamento**, **Agente**, **Template**, **Tag**, **Rota** e **Tool**. Recortes que você já filtrou são pulados. 3. Acima dos totais aparece o **caminho do detalhamento**, por exemplo: **Tudo > Produto: Mensagens > por Tipo de produto**. 4. Para voltar, clique em **Tudo** ou em qualquer passo do caminho. Os filtros criados depois daquele passo são removidos. {% hint style="info" %} Os itens **Outros** e **Não informado** não podem ser detalhados, porque juntam vários valores diferentes. {% endhint %} **📌 Resultado esperado** O gráfico e a tabela passam a mostrar só o item que você abriu, dividido pelo próximo recorte. Um filtro novo aparece no painel lateral, e o caminho no topo permite voltar quando quiser.

Imagem 5 - Caminho do detalhamento no topo do gráfico, por exemplo "Tudo > Produto: Mensagens > por Tipo de produto"

*** #### 4️⃣ Tabela de detalhamento **🎯 Propósito** Ver em números exatos o que o gráfico mostra, com a opção de abrir um segundo nível de detalhe. **✅ Como fazer na tela** Abaixo do gráfico fica o cartão **Detalhamento por** seguido do recorte escolhido (por exemplo, **Detalhamento por produto**). A linha de baixo informa a unidade, como **Valores em BRL por dia**. **Tabela por período (padrão)** * Cada linha é um item do agrupamento, com a mesma cor da legenda. * Cada coluna é um dia, semana ou mês do período. * No fim da linha ficam as colunas **Total** e **% do total**. * A primeira linha, **Total**, soma todos os itens. * Clique no nome de uma linha para detalhá-la (veja a seção anterior). **Tabela com dois níveis** 1. No campo **E por**, escolha um segundo recorte. A opção **Nenhum (por período)** volta à tabela comum. 2. O título passa a ser, por exemplo, **Detalhamento por produto e por departamento**. 3. A tabela deixa de ter colunas de datas e passa a ter **Nome**, **Eventos**, **Valor** (ou **Unidades**) e **% do total**. 4. Clique na setinha ao lado de uma linha para abrir os itens do segundo nível. Use **Expandir tudo** ou **Recolher tudo** para abrir ou fechar todas de uma vez. {% hint style="warning" %} Na tabela de dois níveis, a tela mostra no máximo as **500 combinações de maior valor**. Se houver mais do que isso, aparece o aviso **Mostrando as 500 combinações de maior valor** e as demais ficam de fora dos totais dessa tabela. Para ver tudo, use filtros e analise por partes. {% endhint %} **📌 Resultado esperado** Você tem os valores exatos de cada item, a participação dele no total e, se quiser, o desdobramento por um segundo recorte.

Imagem 6 - Tabela com dois níveis, com uma linha expandida mostrando o segundo nível

*** #### 5️⃣ Painel de filtros **🎯 Propósito** Limitar a análise a apenas o que interessa, como um app, um departamento ou uma campanha. **✅ Como fazer na tela** No lado direito da tela fica o painel **Filtros**. Cada linha tem um recorte e o botão **Incluir todos** (nenhum filtro aplicado). 1. Clique em **Incluir todos** na linha do recorte que você quer filtrar. Abre uma janela com a lista de valores. 2. Use o campo de busca para encontrar um valor pelo nome. 3. Marque as caixinhas dos valores que devem entrar. À direita de cada valor aparece quanto ele custou no período (ou a quantidade de eventos, quando não há custo). 4. Clique em **Aplicar**. Para desmarcar tudo, clique em **Limpar**. O rodapé informa quantos valores estão selecionados. 5. A linha passa a mostrar **Incluir apenas** e os valores escolhidos aparecem como etiquetas. Clique no **x** de uma etiqueta para remover só aquele valor. 6. Para remover todos os filtros de uma vez, clique em **Limpar tudo**, no topo do painel. Os filtros em destaque são **App**, **Plano**, **Produto**, **Tipo de produto**, **Canal**, **Tipo de canal**, **Departamento**, **Agente**, **Template** e **Tag**. Clique em **Mais filtros** para ver também **Rota** e **Tool**. **📌 Resultado esperado** Todos os números, o gráfico e a tabela passam a considerar somente os valores marcados. O endereço da página também muda, então você pode copiá-lo e enviar para um colega (veja a seção **Dicas úteis**, no fim da página).

Imagem 7 - Painel de filtros com uma linha em "Incluir apenas" e as etiquetas dos valores escolhidos

*** #### 6️⃣ Opções avançadas **🎯 Propósito** Separar o que está dentro do plano do que foi cobrado a mais, olhar créditos da carteira e escolher a moeda. **✅ Como fazer na tela** Na parte de baixo do painel de filtros ficam as **Opções avançadas**. **Consumo** Escolha uma opção na lista: | Opção | O que mostra | | -------------------- | --------------------------------------------------------------------------------------------------------------------- | | **Todos** | Tudo o que foi consumido, dentro ou fora da franquia do plano. A franquia é a quantidade que já vem inclusa no plano. | | **Incluso no plano** | Só o que saiu da franquia do plano, sem custo. Tarifas do WhatsApp e cobranças avulsas não têm franquia. | | **Cobrado** | Só o que gerou cobrança: o excedente da franquia, as tarifas do WhatsApp e as cobranças avulsas. | {% hint style="info" %} O que está incluso no plano não tem valor em dinheiro. Por isso, ao escolher **Incluso no plano**, a métrica muda para **Unidades** e a opção **Valor** fica bloqueada. Ao passar o mouse sobre ela, a tela explica: **O consumo incluso no plano não tem valor. Veja em unidades.** {% endhint %} **Lançamentos** Alterne entre: * **Custos:** os débitos de consumo. * **Créditos:** recargas, cashback e cupons da carteira. Esses créditos não são abatidos dos custos mostrados na tela. **Moeda** Esse campo só aparece quando existem cobranças em mais de uma moeda (**BRL** e **USD**). Moedas diferentes nunca são somadas. A tela mostra uma moeda por vez, e você alterna entre elas clicando na opção desejada. Por fim, uma nota no fim do painel lembra que os **dados são atualizados a cada hora**. **📌 Resultado esperado** O gráfico, os números e a tabela passam a refletir a combinação escolhida. O texto acima do número grande muda para deixar claro o que você está vendo, por exemplo **Custo cobrado no período**. *** ### 🏷️ Tags de custo A **tag de custo** é um texto que você mesmo escreve para identificar a quem pertence uma cobrança, como **Black Friday**, **Cobrança** ou **Agente de vendas**. Tudo o que você digitar no campo **Tag de custo** aparece no Centro de custos, na aba **Tag** e no filtro **Tag**. É com ela que você responde perguntas como "quanto essa campanha custou?" ou "quanto o atendimento de cobrança gasta por mês?", principalmente quando o mesmo app atende várias frentes ao mesmo tempo. #### 💬 Como a tag funciona * **Não existe cadastro.** Você digita o texto no campo **Tag de custo** e pronto. O texto digitado é o próprio grupo. * **O mesmo texto agrupa tudo.** Se **Campanha Outubro** foi escrito em dez lugares diferentes, o Centro de custos mostra uma única linha com a soma dos dez. * **Maiúsculas e minúsculas contam.** **Campanha** e **campanha** viram dois grupos separados. Já os espaços sobrando no começo, no fim ou repetidos no meio são ajustados automaticamente. * **Um erro de digitação cria um grupo novo.** Como ninguém valida o que é digitado, vale combinar com o seu time um padrão de nomes antes de começar. * **O limite é de 60 caracteres.** O campo não deixa digitar além disso. * **Campo vazio, sem tag.** As cobranças sem tag aparecem como **Sem tag**. #### 📍 Onde preencher a tag de custo O campo **Tag de custo** existe em seis lugares. Cada um marca um tipo de cobrança: | Onde | O que a tag marca | | ------------------------- | ------------------------------------------------------------------------------------------------- | | **Fluxo** | É a tag padrão do fluxo. Vale para as cobranças dos módulos do fluxo que não têm uma tag própria. | | **Módulo Chat** | As mensagens enviadas por esse módulo. | | **Módulo Agente IA** | O consumo de inteligência artificial desse módulo. | | **Módulo Ativar Usuário** | As execuções que esse módulo inicia, incluindo as mensagens enviadas por elas. | | **Transmissão** | O envio da transmissão e o fluxo que ela dispara. Funciona também em transmissões de SMS. | | **Rota do API Gateway** | A cobrança da chamada à rota e do fluxo que ela dispara. | O módulo **Evento** não tem campo próprio. Ele usa a tag que vier de quem disparou a execução ou, se não houver, a tag do fluxo. {% hint style="warning" %} **Não confunda os campos.** No formulário do fluxo existem dois campos parecidos. O campo **Tags** serve apenas para você encontrar o fluxo na lista e **não** aparece no Centro de custos. Só o campo **Tag de custo** alimenta a aba **Tag**. {% endhint %} #### 🥇 Qual tag vale quando há mais de uma A mesma cobrança pode ter mais de uma tag possível. Nesse caso, vale a mais específica, nesta ordem: 1. **A tag do módulo.** É a escolha mais deliberada e vence sempre. 2. **A tag de quem disparou a execução.** Pode ser a tag da transmissão, a tag da rota do API Gateway ou a tag do módulo **Ativar Usuário** que iniciou a execução. 3. **A tag do fluxo.** Entra apenas quando nenhuma das anteriores existe. Essa ordem existe porque o mesmo fluxo costuma ser reaproveitado. Um fluxo de **Cobrança** disparado por duas campanhas diferentes cobra cada execução na tag da campanha que o disparou, e só cai na tag do fluxo quando ninguém definiu outra. {% hint style="info" %} Ao montar um fluxo que será reaproveitado, prefira colocar a tag no **fluxo** e deixar a transmissão ou a rota sobrescrever. Coloque tag em um módulo apenas quando aquele módulo precisar ser contado à parte, como o agente de inteligência artificial cujo custo você quer ver separado. {% endhint %} #### ✏️ Como preencher a tag de custo **🎯 Propósito** Marcar as cobranças com o nome da campanha, da área ou da frente de atendimento que você quer acompanhar. **✅ Como fazer na tela** **No fluxo** 1. Acesse **Gerenciamento de aplicativos > Fluxos**. 2. Crie um fluxo novo ou abra a edição de um fluxo existente, onde ficam o nome, as tags e a descrição. 3. Preencha o campo **Tag de custo**, logo abaixo de **Descrição**. A mensagem de ajuda explica que essa é a tag padrão das cobranças do fluxo. 4. Salve e **publique o fluxo**. **Em um módulo (Chat, Agente IA ou Ativar Usuário)** 1. Dentro do fluxo, abra o módulo. 2. Preencha o campo **Tag de custo**. Na maioria dos módulos ele fica no topo do menu, logo abaixo do nome do módulo. Em alguns menus ele fica no rodapé, ao lado dos botões. 3. Salve o módulo e **publique o fluxo**. **Em uma transmissão** 1. Acesse **Gerenciamento de aplicativos > Transmissões**. 2. Crie uma transmissão ou edite uma existente. 3. Preencha o campo **Tag de custo**, logo abaixo de **Descrição**. 4. Salve. O campo só pode ser alterado enquanto a transmissão ainda é um rascunho. Depois que ela é agendada ou enviada, o campo fica bloqueado, então preencha a tag antes. **Em uma rota do API Gateway** 1. Acesse **Gerenciamento de aplicativos > API Gateway**. 2. Abra a rota que você quer marcar. 3. Preencha o campo **Tag de custo**, logo abaixo de **Descrição**, e salve. **📌 Resultado esperado** As próximas cobranças geradas passam a carregar a tag. Depois da atualização dos dados (até 1 hora), ela aparece no Centro de custos.

Imagem 8 - Campo Tag de custo no menu de um módulo

Imagem 9 - Formulário do fluxo mostrando os campos Tags e Tag de custo, um embaixo do outro

Imagem 10 - Campo Tag de custo no formulário de uma transmissão

Imagem 11 - Campo Tag de custo no editor de uma rota do API Gateway

#### ⏱️ Quando a tag passa a aparecer {% hint style="warning" %} **Antes de esperar ver a tag no Centro de custos, confira:** * **Publique o fluxo.** A tag do fluxo, e também a tag de um módulo, só passam a valer nas cobranças depois que você publica o fluxo. Se você salvar e não publicar, nada muda no Centro de custos. * **Não é retroativo.** As cobranças que já aconteceram continuam com a tag (ou a falta dela) que tinham quando foram geradas. Mudar a tag hoje não reorganiza o que já foi cobrado. * **Aguarde a atualização.** Os dados do Centro de custos são atualizados a cada hora. Depois de publicar, aguarde a próxima atualização e volte à tela. * **Como voltar:** abra o **Centro de custos**, clique na aba **Tag** e escolha o período que inclui as novas cobranças. {% endhint %} #### 🚫 O que não recebe tag de custo Algumas cobranças não passam por nenhum campo de tag e, por isso, sempre aparecem como **Sem tag**: * Mensagens recebidas dos contatos. * Requisições HTTP feitas pelos fluxos. * Cobranças anteriores à criação da tag. Os módulos **GPT Question** e **Google Gemini** também não têm o campo, porque não geram cobrança no Hyperflow Integrações. #### 🔎 Como as tags aparecem no Centro de custos * **Aba Tag em Agrupar por:** cada texto diferente vira uma cor no gráfico, uma linha na legenda e uma linha na tabela de detalhamento. O gráfico mostra as **8 tags** de maior valor e junta as demais em **Outros**. * **Filtro Tag:** no painel de filtros, clique em **Incluir todos** na linha **Tag**. Abre a lista com todas as tags que tiveram cobrança no período, com o valor de cada uma. Use a busca, marque as que quiser e clique em **Aplicar**. * **Tag combinada com outro recorte:** na tabela de detalhamento, escolha **E por** e o segundo recorte, como **Produto**. Você descobre, por exemplo, quanto da tag **Black Friday** foi mensagem e quanto foi inteligência artificial. * **Detalhar uma tag:** clique em uma barra ou no nome de uma tag para filtrar só ela e ver de onde vem o custo, passo a passo. * **Sem tag:** reúne tudo o que não recebeu nenhuma tag. Um volume grande aqui é sinal de que ainda falta marcar fluxos, módulos ou transmissões. #### 💼 Exemplos práticos **Quanto custou a campanha Black Friday?** 1. Na transmissão da campanha, preencha **Tag de custo** com `Black Friday`. 2. Dispare a transmissão. 3. No Centro de custos, aguarde a atualização, abra a aba **Tag** e escolha a métrica **Valor**. 4. A linha **Black Friday** mostra o custo da campanha, incluindo as mensagens do fluxo que ela disparou, desde que os módulos desse fluxo não tenham tag própria. **O mesmo fluxo atendendo duas campanhas** 1. Coloque a tag padrão `Cobrança` no fluxo. 2. Nas transmissões de cada campanha, use tags diferentes, como `Campanha A` e `Campanha B`. 3. Cada execução do fluxo é contada na tag da transmissão que a disparou. Execuções iniciadas por outros caminhos caem em `Cobrança`. **Quanto custa o agente de inteligência artificial?** 1. No módulo **Agente IA**, preencha **Tag de custo** com `Agente de vendas`. 2. Publique o fluxo. 3. No Centro de custos, abra a aba **Tag**. O consumo de inteligência artificial desse módulo aparece separado do restante do fluxo. **Quanto custa uma integração chamada por API?** 1. Na rota do API Gateway, preencha **Tag de custo** com `Pedidos`. 2. No Centro de custos, use o recorte **Rota** para ver o custo por rota e a aba **Tag** para ver o total da tag. *** ### 📥 Exportando para planilha **🎯 Propósito** Levar os números para o Excel ou outra ferramenta, para compartilhar com o financeiro ou fazer suas próprias contas. **✅ Como fazer na tela** 1. Escolha o período, o agrupamento e os filtros que você quer. 2. Clique em **Exportar CSV**, no cabeçalho, ou no botão com o mesmo nome no cartão de detalhamento. 3. O arquivo é baixado pelo navegador com o nome **centro-de-custos** seguido das datas de início e fim. O arquivo segue a tabela que está na tela. Se a tabela está por período, ele traz uma coluna por período. Se a tabela está com dois níveis, ele traz o primeiro e o segundo nível, os eventos, o valor e a porcentagem do total. Itens escondidos na legenda ficam de fora. {% hint style="info" %} O botão **Exportar CSV** fica desabilitado enquanto os dados carregam, quando houve erro ou quando não há dados para exportar. {% endhint %} **📌 Resultado esperado** Um arquivo CSV (que o Excel abre normalmente) com os mesmos números que você vê na tabela. *** ### 🧩 Como os nomes aparecem Alguns nomes na tela merecem uma explicação:
O que você vêO que significa
Plataforma, Tarifa WhatsApp, WhatsApp, WhatsApp por entrega, Telefonia, SMS, RCS, Legado (ao lado do nome de um item)Indica quem origina a cobrança. Por exemplo, Mensagem recebida Plataforma é o valor cobrado pela Hyperflow e Mensagem recebida Tarifa WhatsApp é a tarifa do WhatsApp para o mesmo tipo de mensagem.
OutrosA soma dos itens menores, que não couberam entre os 8 maiores do gráfico.
Não informadoCobranças que não têm aquela informação, como um departamento que não foi identificado.
Sem tagCobranças que não receberam nenhuma tag de custo, por não terem sido marcadas ou por não passarem por nenhum campo de tag. Veja a seção Tags de custo.
Não se aplicaNos recortes Rota e Tool, cobranças que não vêm de uma rota do API Gateway nem de uma ferramenta do MCP.
Não encontrado seguido de quatro caracteresO item existia quando a cobrança foi feita, mas foi apagado depois (por exemplo, um departamento excluído). Os caracteres ajudam a diferenciar itens apagados.
Origem (em Mais)De onde vem a cobrança: Planos, WhatsApp (cobrada pela Meta, em dólar) ou Legado.
*** ### 💡 Dicas úteis * **Compartilhe o que você está vendo.** Todas as escolhas da tela (período, agrupamento, filtros e opções avançadas) ficam no endereço da página. Copie o endereço do navegador e envie para um colega: ele verá a mesma visão, desde que tenha acesso ao Centro de custos. O botão voltar do navegador também desfaz os passos do detalhamento. * **Quando a tela não mostra nada.** Se não houver dados, a tela avisa, por exemplo, **Nenhum custo no período**. Clique em **Ampliar período** para tentar um período maior ou em **Limpar filtros** para remover os filtros. * **Quando algo dá erro.** Se aparecer **Não foi possível carregar os dados**, clique em **Tentar novamente**. * **Atraso nos dados.** Os números são atualizados a cada hora. Os valores dos dias mais recentes podem sofrer pequenos ajustes nos dias seguintes. * **Quanto custou uma campanha?** Dê uma tag de custo à campanha (na transmissão ou no fluxo), publique o fluxo, abra a aba **Tag** e escolha a métrica **Valor**. * **Combine um padrão de nomes para as tags.** Como cada texto digitado vira um grupo, **Black Friday** e **black friday** aparecem separados. Defina com o seu time como escrever as tags antes de começar. * **Muitas cobranças em Sem tag?** Marque os fluxos, os módulos e as transmissões que ainda não têm **Tag de custo** e lembre de publicar os fluxos. * **Qual app mais gasta?** Agrupe por **App**, com o período **Este mês**, e clique na maior barra para descobrir em quê ele gasta. * **O que realmente foi cobrado a mais?** Em **Opções avançadas**, escolha **Cobrado** em **Consumo**. * **Mensagens de serviço do WhatsApp:** As primeiras 1.000 de cada número, por mês, não têm custo e valem zero em **Valor**. Em **Unidades** você vê todas, desde a primeira. Veja o Cenário 4, na seção **Como usar na prática**. * **Para uma visão geral rápida do ano.** Escolha **Últimos 12 meses** com a granularidade **Mês**. *** ### 📝 Resumo * O **Centro de custos** mostra quanto a organização consumiu e gastou, por período, com gráfico, tabela e totais. * Os dados estão disponíveis **a partir de 01/10/2026**. Períodos anteriores a essa data não aparecem na tela. * A ordem de uso é: escolher o **período**, o **agrupamento** e **Valor ou Unidades**, abrir o **detalhamento** com um sub-agrupamento em **E por** e **clicar** em um item para aprofundar. O clique filtra e muda o agrupamento sozinho, e o caminho no topo permite voltar. * O painel de **Filtros** e as **Opções avançadas** permitem separar o que está incluso no plano do que foi cobrado, ver créditos da carteira e escolher a moeda. * A aba **Tag** mostra exatamente o que você e o seu time digitaram no campo **Tag de custo** de fluxos, módulos, transmissões e rotas do API Gateway. O mesmo texto agrupa tudo, e maiúsculas e minúsculas contam. * Quando há mais de uma tag possível, vale a do módulo, depois a de quem disparou a execução e, por último, a do fluxo. Lembre de **publicar o fluxo** para a tag valer, e saiba que ela não é retroativa. * Os dados são atualizados a cada hora, e você pode exportar a tabela em **CSV** ou compartilhar a visão copiando o endereço da página.