For the complete documentation index, see llms.txt. This page is also available as Markdown.

📊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

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.


🧭 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

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.


🚀 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.

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.

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.

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.

Os itens Outros e Não informado não podem ser detalhados, porque juntam vários valores diferentes.

🔹 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.

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.


🖥️ 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).

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.

📌 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 Mais

O que mostra

Plano

O plano contratado de cada app.

Canal

O número ou a conta específica usada, como um número de WhatsApp. Diferente de Tipo de canal, que agrupa por categoria.

Agente

O agente do Hyperflow Conversas ligado à cobrança.

Template

O modelo de mensagem usado, pelo nome com que foi cobrado.

Rota

A 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.

Tool

A ferramenta acionada por meio do MCP, escrita no formato servidor, ponto e ferramenta. Só aparece para quem usa o MCP.

Origem

De onde vem a cobrança: Planos, WhatsApp (cobrada pela Meta, em dólar) ou Legado.

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.

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.

Os itens Outros e Não informado não podem ser detalhados, porque juntam vários valores diferentes.

📌 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.

📌 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.

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.

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.

🥇 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.

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.

✏️ 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

🚫 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.

O botão Exportar CSV fica desabilitado enquanto os dados carregam, quando houve erro ou quando não há dados para exportar.

📌 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.

Outros

A soma dos itens menores, que não couberam entre os 8 maiores do gráfico.

Não informado

Cobranças que não têm aquela informação, como um departamento que não foi identificado.

Sem tag

Cobranç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 aplica

Nos 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 caracteres

O 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.

Last updated

Was this helpful?