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

# Eventos de webhooks

> phone_number.activated, past_due, suspended e released, ciclo de vida do número contratado.

<Tip>
  Eventos **`phone_number.*`** avisam sobre **billing e status do número**, não confunda com **`voice.call.*`** (chamadas em andamento).
</Tip>

## Em poucas palavras

* Disparados quando o **ciclo de vida** de um número contratado muda (pagamento, suspensão, devolução).
* `instanceId` vem **vazio** (números não usam instância de canal).
* Configure em **Integrações → Webhooks**, veja [Webhooks](/guides/webhooks/index).

Para eventos de **chamada** (`voice.call.*`), use [Eventos de webhooks, Voz](/voice-api/como-funciona/eventos-do-webhooks).

***

## Eventos

| Evento                   | Quando dispara               | Uso típico              |
| ------------------------ | ---------------------------- | ----------------------- |
| `phone_number.activated` | Número ativo após pagamento  | Liberar discagem no app |
| `phone_number.past_due`  | Renovação em atraso          | Alertar financeiro      |
| `phone_number.suspended` | Suspenso por inadimplência   | Bloquear origem         |
| `phone_number.released`  | Número devolvido ao catálogo | Limpar configuração     |

***

## Exemplos de payload

<AccordionGroup>
  <Accordion title="phone_number.activated">
    ```json theme={null}
    {
      "event": "phone_number.activated",
      "workspaceId": "clxx123...",
      "instanceId": "",
      "timestamp": "2026-06-01T10:00:00.000Z",
      "data": {
        "phoneNumberId": "clxx_pn_1",
        "phoneE164": "+5511987654321",
        "status": "ACTIVE"
      }
    }
    ```
  </Accordion>

  <Accordion title="phone_number.past_due">
    ```json theme={null}
    {
      "event": "phone_number.past_due",
      "workspaceId": "clxx123...",
      "instanceId": "",
      "timestamp": "2026-06-15T10:00:00.000Z",
      "data": {
        "phoneNumberId": "clxx_pn_1",
        "phoneE164": "+5511987654321",
        "status": "PAST_DUE"
      }
    }
    ```
  </Accordion>

  <Accordion title="phone_number.suspended">
    ```json theme={null}
    {
      "event": "phone_number.suspended",
      "workspaceId": "clxx123...",
      "instanceId": "",
      "timestamp": "2026-06-20T10:00:00.000Z",
      "data": {
        "phoneNumberId": "clxx_pn_1",
        "phoneE164": "+5511987654321",
        "status": "SUSPENDED"
      }
    }
    ```
  </Accordion>

  <Accordion title="phone_number.released">
    ```json theme={null}
    {
      "event": "phone_number.released",
      "workspaceId": "clxx123...",
      "instanceId": "",
      "timestamp": "2026-07-01T10:00:00.000Z",
      "data": {
        "phoneNumberId": "clxx_pn_1",
        "phoneE164": "+5511987654321",
        "status": "RELEASED"
      }
    }
    ```
  </Accordion>
</AccordionGroup>

***

## Próximos passos

* [Quick Start](/phone-numbers-api/como-funciona/quick-start)
* [Introdução](/phone-numbers-api/como-funciona/introducao)
* [Eventos de webhooks, Voz](/voice-api/como-funciona/eventos-do-webhooks)