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. Para erros e reconexão, consulte confiabilidade.