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

# Saldo de dados baixo

> Evento emitido quando o saldo de dados de uma linha cai para 20% ou para 0% do plano

export const v_0 = "v3"

<Warning>Para utilizar nossas APIs e Webhooks de linhas virtuais, é necessário aderir ao nosso <a href={"/api-reference/" + v_0 + "/branding"}>manual de branding</a></Warning>

Emitido quando o saldo de dados de uma linha da sua empresa cai para **20%** ou para **0%** dos dados do plano. O campo `threshold` diz qual nível foi atingido:

* `20`: a linha está perto de ficar sem dados;
* `0`: os dados do plano acabaram.

O payload traz o `phoneAccountId` e o `threshold`. Para ver o saldo da linha, consulte [Consultar saldo](/api-reference/v3/phone-accounts/balance); ele mostra a mesma leitura que disparou o evento.

* **Um evento por leitura de saldo.** Se o saldo cair de uma vez abaixo dos dois níveis, por exemplo de 30% para 0%, você recebe só o mais grave: `0`.
* **Os níveis se renovam.** Quando o saldo sobe, por uma recarga ou pela virada do ciclo, cada nível volta a disparar na próxima vez que for atingido.

<Note>
  O evento reflete o saldo da linha na última leitura feita junto à operadora, que pode levar algum tempo para acompanhar o consumo real.
</Note>

<Note>
  Os eventos podem chegar fora de ordem ou mais de uma vez. Trate o mesmo `phoneAccountId` e `threshold` recebidos em sequência como um único aviso.
</Note>


## OpenAPI

````yaml api-reference/v3/openapi.json webhook phone-account.data-balance-low
openapi: 3.1.0
info:
  version: v3
  title: Salvy API
  x-logo:
    url: web/logo.png
servers:
  - url: https://api.salvy.com.br
    description: Salvy API URL
security:
  - bearerAuth: []
tags:
  - name: Public API
  - name: Outgoing Webhooks
paths: {}
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: key

````

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