{
"type": "phone-account.data-balance-low",
"timestamp": "2025-09-03T00:00:00Z",
"data": {
"phoneAccountId": "0140a8c6-3815-45b7-9e60-8e137cad845c",
"threshold": 20
}
}Webhooks
Saldo de dados baixo
Evento emitido quando o saldo de dados de uma linha cai para 20% ou para 0% do plano
WEBHOOK
phone-account.data-balance-low
{
"type": "phone-account.data-balance-low",
"timestamp": "2025-09-03T00:00:00Z",
"data": {
"phoneAccountId": "0140a8c6-3815-45b7-9e60-8e137cad845c",
"threshold": 20
}
}Para utilizar nossas APIs e Webhooks de linhas virtuais, é necessário aderir ao nosso manual de branding
threshold diz qual nível foi atingido:
20: a linha está perto de ficar sem dados;0: os dados do plano acabaram.
phoneAccountId e o threshold. Para ver o saldo da linha, consulte Consultar saldo; 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.
O evento reflete o saldo da linha na última leitura feita junto à operadora, que pode levar algum tempo para acompanhar o consumo real.
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.Headers
Identificador único da mensagem. Se a mesma mensagem for reenviada, o valor se repete — use-o para descartar entregas duplicadas.
Example:
"msg_2KWPBgLlAfxdpx2AI54pPJ85f4W"
Momento do envio, em segundos desde a época Unix. Faz parte da assinatura; rejeite mensagens com horário muito distante do atual.
Example:
"1674087231"
Assinatura da mensagem, usada para confirmar que ela foi enviada pela Salvy. Veja a página de verificação de webhooks.
Example:
"v1,K5oZfzN95Z9UVu1EsfQmfVNQhnkZ2pj9o9NDN/H/pI4="
Body
application/json
Response
200 - application/json