# O que é uma instância?

Uma instância representa uma sessão do WhatsApp dentro do servidor da API. Um servidor pode hospedar várias instâncias. Cada instância possui token, configurações e dados associados à sua sessão.

## Servidor, instância e número

- **Servidor:** o ambiente acessado pela Server URL.
- **Instância:** o recurso que guarda e controla a sessão.
- **Número:** a conta do WhatsApp conectada à sessão.
- **Token:** a credencial usada nas operações daquela instância.

Criar uma instância não conclui o pareamento. É preciso iniciar a conexão e seguir o fluxo de QR Code ou código de pareamento.

## Estados

| Estado | Significado |
|---|---|
| disconnected | Sem conexão ativa |
| connecting | Conexão ou pareamento em andamento |
| connected | Sessão conectada |
| hibernated | Sessão pausada com credenciais preservadas |

Consulte a resposta de `/instance/status` antes de enviar. Uma sessão conectada não garante que toda operação será aceita pelo WhatsApp; trate a resposta específica da operação.

## Integração com vários clientes

No backend da sua aplicação, associe o usuário/cliente somente às instâncias que ele pode controlar. Nunca escolha um token apenas com base em um ID enviado pelo navegador. O `admintoken` possui alcance administrativo e não substitui essa autorização da aplicação.

Siga o [início rápido](/docs/getting-started). Para erros e reconexão, consulte [confiabilidade](/docs/errors-and-retries).