> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymorfa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Uso e créditos

> Acompanhe as cobranças do serviço de números, o uso medido, os limites de gastos e a prioridade de financiamento.

O serviço de números usa **janelas pagas de 24 horas**, e não uma cobrança por
mensagem. Uma cobrança inicia uma janela paga; parar ou desconectar um número
preserva o tempo pago restante. O Uso atribui a janela e os créditos dela à data
UTC da cobrança.

## Explorar o consumo

Abra **Uso** para o projeto selecionado ou escolha **Todos os projetos** para ver os
totais da equipe. O período padrão é o mês civil atual em UTC. Escolha os últimos
7 ou 30 dias, ou defina um intervalo de datas personalizado de até 366 dias.

O resumo mostra os créditos cobrados e as cobranças medidas de serviço de números, chamadas e armazenamento no período selecionado. As cobranças em créditos mantêm até seis casas decimais, então uma cobrança pequena diferente de zero continua visível. Um traço significa que a cobrança está indisponível. Os limites e as reservas do mês atual continuam em Controles de financiamento e no painel de limite do recurso selecionado.

* Selecione uma legenda colorida abaixo do gráfico para ver o uso de um serviço.
  Selecione **Créditos cobrados** para voltar ao total das cobranças. Números mostra
  apenas os planos cobrados no período selecionado.
* Relacione cada série do gráfico à mesma cor no detalhamento. **Créditos cobrados** empilha as cobranças medidas por produto faturável, incluindo os planos do serviço de números. O gráfico de quantidade de cada serviço
  usa as próprias unidades; dias, chamadas, GB-mês e invocações não são somados.
* Alterne entre pontos diários, semanais e mensais no gráfico de área. As comparações entre projetos usam barras. **Acumulado** soma o uso ao longo
  do período selecionado.
* Abra a linha de um produto para ver o gráfico detalhado dele. Em Todos os
  projetos, **Projetos** compara os totais disponíveis dos projetos, com uma tabela
  ordenada e um gráfico de rosca mostrando a participação de cada um.

Em **Todos os projetos**, proprietários e administradores no Pay-As-You-Go veem o
progresso do limite mensal de créditos de cada projeto ao lado do uso dele.
Selecione a linha de um projeto para abrir todo o consumo desse projeto.

A barra superior mostra **Uso / Todos os números**. Abra **Todos os números** e
pesquise por nome, telefone ou ID do número. Role para ver mais resultados.
Pressione **Esc** para fechar o seletor. Em
**Todos os projetos**, escolher um número abre o projeto ao qual ele pertence. Escolha **Todos os números**
para voltar aos totais do projeto selecionado. Os gráficos de produto mantêm o número selecionado.

Você também chega ao Uso de um número por **Números → Ver uso**, nas ações da linha
dele. O link abre o Uso no projeto desse número.

O serviço de números mostra os créditos cobrados. O detalhamento inclui produtos
faturáveis; medições operacionais sem preço não aparecem. Todo o consumo usa o
intervalo UTC selecionado. Medições ausentes mostram **Dados indisponíveis**; isso
não significa que um serviço com preço deixou de ser medido. Dados diários ausentes
mostram **Dados diários indisponíveis**; carregamentos em andamento e leituras com
falha não aparecem como uso zero. As assinaturas mensais de add-ons e os pagamentos
delas em moeda continuam em **Cobrança**.

O consumo é somente leitura. **Controles de financiamento** aparece abaixo dele para
proprietários e administradores da equipe. Edite ali os limites e a ordem de
financiamento dos projetos; os limites e a prioridade de números e clientes abrem
nos painéis próprios de cada um.

O seletor de tempo lista **Últimas 24 horas** primeiro. Selecione essa opção para ver as 24 horas anteriores, ou escolha um intervalo predefinido maior ou um intervalo personalizado.

## Calcular o uso por dia de sessão

Use:

```text theme={null}
números conectados × dias conectados × tarifa do plano × multiplicador de país
```

Para uma equipe Pay-As-You-Go, dois números Standard conectados por 30 dias usam:

```text theme={null}
2 × 30 × 25 = 1.500 créditos
```

Isso equivale a USD 15 ou BRL 75 pelo valor de compra de créditos.

Para números `+55`, aplique o multiplicador de país de 85%:

```text theme={null}
1.500 × 0,85 = 1.275 créditos
```

## Valores por plano

Cada plano tem um único valor por dia de sessão. A quantidade de números que a sua
equipe conecta não altera esse valor.

| Plano | Valor por dia de sessão |
| - | -: |
| Free | 0 créditos/dia |
| Standard | 25 créditos/dia |
| Pro | 36 créditos/dia |

O multiplicador `+55` se aplica ao valor do plano. Para ganhar créditos extras
conforme o seu uso cresce, consulte [Bônus mensal de compras](/pt-br/console/billing#monthly-bonus).

Somente equipes Pay-As-You-Go compram e usam créditos. O único número real gratuito
de uma equipe Free usa 0 créditos. Consulte
[Free e Pay-As-You-Go](/pt-br/console/billing#free-and-pay-as-you-go).

## Uso medido e gastos

As chamadas de saída têm contagem, franquia incluída e valor de excedente próprios. Os limites mensais de gastos
contam o serviço de números cobrado e as reservas de pareamento ativas. Eles não
precificam medições operacionais nem limitam cobranças pagas diretamente à Meta.

A [página de preços](https://www.polymorfa.com/pricing) lista estes excedentes por número:

| Serviço | Incluído no Free | Incluído no Standard | Incluído no Pro | Excedente |
| - | - | - | - | - |
| Dados do WhatsApp, incluindo mídia e armazenamento hospedado de mensagens | 1 GB | 25 GB | 100 GB | Standard e Pro: 10 créditos por GB-mês |
| Chamadas de saída | 5 por mês | 50 por mês | Ilimitado | Standard: 20 créditos por chamada; o Free não tem excedente de chamadas |
| Invocações serverless | 1.000 por mês | 250.000 por mês | 1.000.000 por mês | Standard e Pro: 100 créditos por milhão de invocações |

O detalhamento mostra o uso medido e os créditos efetivamente cobrados. Um traço na
coluna de cobrança significa que o valor da cobrança está indisponível. Ele não
significa zero. Medições ausentes mostram **Dados indisponíveis**.

Para um número selecionado, o progresso de chamadas de saída compara as chamadas de
saída concluídas neste mês UTC com a franquia mensal incluída. O Pro mostra
**Ilimitado**. Proprietários e administradores da equipe no Pay-As-You-Go também
veem o progresso do limite mensal de créditos do projeto ou do número selecionado,
incluindo as reservas ativas. Essas barras de progresso usam o mês UTC atual mesmo
quando o gráfico mostra outro intervalo. Um limite de créditos não definido mostra
**Sem limite**.

O armazenamento do WhatsApp usa GB-mês para o uso faturado; a franquia de
armazenamento incluída é em GB. As franquias pertencem a cada número. Os totais do
projeto não somam franquias não usadas de números diferentes. A visualização de um
número não atribui a esse número as invocações serverless de todo o projeto.

Números de teste usam 0 créditos por dia de sessão. Um contrato Enterprise pode
definir um valor negociado de Standard ou Pro sem criar outro plano de número.

## Limites mensais de gastos

Abra **Uso** com **Todos os projetos** selecionado para configurar os limites e a ordem de financiamento dos projetos na tabela **Controles de financiamento**. Selecione um projeto para ver o limite e a prioridade dele acima de uma única tabela de Controles de financiamento para clientes e números. No projeto selecionado, **Editar limite** altera o teto mensal ali mesmo. **Editar prioridade** abre **Todos os projetos → Uso** para classificá-lo em relação aos outros projetos da equipe.
Proprietários e administradores da equipe podem ler os controles financeiros; equipes Pay-As-You-Go podem editá-los.
Os cartões de visão geral do projeto continuam somente leitura e levam aos Controles de financiamento no Uso.

Para um número, abra os detalhes dele em **Números** e selecione **Editar limites e prioridade**.
A ação de linha **Orçamento** abre o mesmo painel. Para um cliente, abra a página de
detalhes do cliente e selecione **Editar limites e prioridade**. Informe o limite mensal
em créditos e a prioridade numérica, depois selecione **Salvar alterações**. Um limite vazio remove
o teto; zero bloqueia novas cobranças. A criação de números reais também aceita valores iniciais.

Os limites são zerados à meia-noite UTC do primeiro dia de cada mês. O serviço
cobrado e as reservas de pareamento ativas contam para o teto. Os números atribuídos
a um cliente compartilham o teto dele. Um número precisa caber nos limites do
projeto, do cliente e no próprio limite. O serviço já pago continua até o fim da
janela paga. Transferir um número deixa as cobranças anteriores com o cliente que
era dono dele no momento da cobrança.

## Prioridade de financiamento

Em **Uso**, arraste as linhas para a ordem da maior para a menor prioridade e
selecione **Salvar ordem**. A tabela de Controles de financiamento de todos os
projetos classifica os projetos. Um projeto selecionado tem uma única tabela de
Controles de financiamento para clientes e números. Arraste um número para cima de
um cliente para dar a ele uma prioridade maior. Informe uma posição e pressione
**Enter** para mover qualquer linha diretamente.

Pesquise por nome ou ID do recurso. Filtre clientes e números por tipo de recurso,
ou filtre projetos pelo status do limite. Ordene por nome, ordem de financiamento
ou menor prioridade; as visualizações de projetos também ordenam por valor do
limite e por uso comprometido. Escolha **Ordem de financiamento** para arrastar
linhas. **Redefinir visualização** limpa a pesquisa, os filtros e a ordenação sem
descartar as mudanças de posição. A pesquisa, a ordenação e a paginação preservam a
ordem completa, incluindo recursos fora da página visível. Selecione
**Salvar ordem** para aplicar as mudanças de posição.

Defina a prioridade de clientes e números nos painéis de detalhes de cada um.
Valores numéricos maiores recebem prioridade. A prioridade do projeto vem primeiro. Dentro de um projeto, os números herdam a
prioridade do cliente. Uma prioridade de número maior substitui essa posição
herdada. Em seguida, a prioridade do número desempata antes do vencimento da renovação e da identidade do número. A prioridade protege a próxima renovação
e ordena a recuperação; ela nunca encurta uma janela de serviço paga.

Os salvamentos verificam as revisões observadas. Se outra pessoa ou uma requisição
da API alterar uma configuração, recarregue antes de salvar. O formulário nativo de
número e de cliente salva o limite e a prioridade de forma atômica; um conflito
deixa as duas configurações inalteradas.

As chaves da organização usam `billing:read` para leituras e `billing:manage` para alterações.
Credenciais de projeto e credenciais de cliente para navegador não podem acessar os controles financeiros. As chaves existentes
precisam desses escopos. [Leia um recurso](/api-reference/platform/billing/get-resource-billing-controls)
sem carregar o diretório da equipe, ou [salve os controles dele](/api-reference/platform/billing/set-resource-billing-controls)
com `expectedBudgetRevision` e `expectedPriorityRevision` vindos dessa leitura.
As leituras do diretório aceitam `scope=project` para trazer apenas projetos. Requisições completas de reordenação de
clientes ou números exigem `projectId`; alterações individuais não exigem uma lista.
As leituras de prioridade também aceitam `projectId` para retornar os controles de financiamento de um projeto.
Para reordenar clientes e números juntos, envie `scope: "resource"`, `projectId`,
`expectedRevision` e um array `resources` completo, da maior para a menor prioridade. Cada entrada é
`{ "scope": "customer" | "number", "resourceId": "UUID" }`. Uma lista incompleta, duplicada,
com recursos de fora do escopo ou desatualizada é rejeitada sem alterações parciais.

## Acompanhar o saldo

A tela de Cobrança mostra:

* **Números ativos**: a quantidade de números de WhatsApp ativos na sua equipe.
* **Créditos usados**: o total de créditos de uso de números cobrados da sua equipe.
* **Saldo de créditos**: os créditos que continuam disponíveis para a sua equipe.

Avisos para toda a equipe aparecem um dia e duas horas antes da falta de créditos
prevista. Ative **Alertas de saldo** em **Minhas notificações** para receber
alertas por e-mail. A recarga automática usa um limite de créditos separado e cobra
o cartão salvo na assinatura Pay-As-You-Go da sua equipe. A janela de checkout
seguro mostra as formas de pagamento, as moedas e o valor final antes de você
confirmar uma compra.

> **[Cobrança](/pt-br/console/billing)**
>
> Modos de cobrança, planos de número, créditos e add-ons.

> **[Sessões](/pt-br/console/sessions)**
>
> Veja quais números estão conectados.

## Selecionar o período do relatório

Use o botão de calendário para um intervalo de datas personalizado ou o menu
suspenso ao lado dele para um período recente. Clique no mês ou no ano para navegar
pelo calendário, selecione uma data inicial e uma data final e aplique. As opções
de fuso horário são Local e UTC. O intervalo selecionado define o uso mostrado no
relatório.

Consulte a [visão geral do produto](https://www.polymorfa.com/usage) para uma introdução visual.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.