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

# Estado do Cliente

> A maneira mais rápida de integrar cobrança no seu aplicativo

Estado do Cliente é um conceito que permite consultar o estado atual de um cliente, incluindo suas assinaturas ativas e [benefícios](/features/benefits/introduction),concedidos, em uma única [chamada de API](/api-reference/customers/state-external) ou único [evento de webhook](/api-reference/webhooks/customer.state_changed).

Combinado com o recurso de [ID Externo](/features/customer-management#external-id), você pode começar em poucos minutos.

## O objeto de estado do cliente

O objeto de estado do cliente contém:

* Todos os dados sobre o cliente.
* A lista de suas assinaturas **ativas**.
* A lista de seus benefícios **concedidos**.
* A lista de seus medidores ativos, com o saldo atual.

Assim, com esse único objeto, você tem todas as informações necessárias para verificar se deve ou não provisionar acesso ao seu serviço.

<Card title="Get Customer State by External ID" icon="ring" iconType="duotone" href="/api-reference/customers/state-external" horizontal>
  Um único endpoint para controlar tudo, usando o seu próprio ID de cliente.
</Card>

<Card title="Get Customer State " icon="ring" iconType="duotone" href="/api-reference/customers/state" horizontal>
  O mesmo endpoint, mas com o ID interno do cliente da Norbaas.
</Card>

## O webhook `customer.state_changed`

Para ser notificado sobre mudanças no estado do cliente, você pode escutar o evento de webhook `customer.state_changed`. Ele é acionado quando:

* Um cliente é criado, atualizado ou excluído.
* Uma assinatura é criada ou atualizada.
* Um benefício é concedido ou revogado.

Ao assinar esse evento de webhook, você mantém seu sistema atualizado e ajusta o acesso do seu cliente conforme necessário.

<Card title="customer.state_changed" icon="ring" iconType="duotone" href="/api-reference/webhooks/customer.state_changed" horizontal>
  Um único webhook para controlar tudo.
</Card>