O que é uma instância de WhatsApp?
Instância de WhatsApp é um número de WhatsApp conectado a uma API. Cada instância tem a sua sessão ativa, o seu identificador (ID), as suas credenciais e as suas configurações, e funciona separada das outras. Se você tem três números, são três instâncias. É a unidade com a qual você cria, conecta, monitora e cobra qualquer operação por API.
Publicado em · 2 min de leitura
Como uma instância funciona
Você cria a instância no painel, e ela gera um ID. Em seguida pareia o número lendo um QR code com o celular, do mesmo jeito que se conecta o WhatsApp Web. A partir daí a instância fica conectada em um servidor e pode enviar mensagens, receber mensagens por webhook e informar o seu status.
No ZapZap, o ID da instância faz parte do endereço de cada chamada e a autenticação usa uma chave e um segredo da conta. O passo a passo está em início rápido e em autenticação.
O que fica dentro de uma instância
Cada instância guarda o número conectado, o estado da conexão (conectada ou desconectada), a URL de webhook que recebe os eventos e as configurações próprias, como a automação ligada a esse número. Cada instância tem sessão própria, então uma desconexão em um número não desconecta os outros.
O que muda entre contas é o modelo de cobrança: no ZapZap cada número ativo custa R$15 por mês, pré-pago, sem cobrança por mensagem. Consulte preços para o valor vigente.
Quantas instâncias eu preciso
Uma por número de WhatsApp que você quer operar. Uma clínica com recepção e financeiro em números diferentes usa duas. Uma agência que atende dez clientes, cada um com o seu número, usa dez.
Separar por função, como atendimento, vendas e cobrança, também ajuda: se um número tiver problema, os outros continuam rodando. E vale ter um número reserva, porque nenhum número é insubstituível. Veja o glossário para os demais termos, ou o guia API não oficial do WhatsApp para entender o contexto.
Resumo rápido
- Instância é um número de WhatsApp conectado a uma API, com sessão, ID, credenciais e webhook próprios.
- Você cria a instância no painel e pareia o número por QR code, como no WhatsApp Web.
- Uma instância por número. Separar por função isola problemas e mantém o resto da operação no ar.
Continue lendo
Perguntas frequentes
Instância é a mesma coisa que conta de WhatsApp?
Não exatamente. A conta é o seu número no WhatsApp. A instância é a conexão desse número com a API: a sessão ativa no servidor, com ID, credenciais e webhook. Um número conectado a uma API vira uma instância.
Preciso do celular ligado para a instância funcionar?
Você usa o celular para ler o QR code e parear o número. Depois disso a sessão roda no servidor. Se o WhatsApp pedir para reconectar, será preciso ler o QR code de novo.
O que acontece quando uma instância desconecta?
As mensagens deixam de ser enviadas e recebidas por essa instância até que o número seja reconectado, normalmente lendo o QR code novamente. As outras instâncias não são afetadas.
Posso ter mais de uma instância na mesma conta?
Sim. Cada número ativo é uma instância, e a mesma conta pode ter várias, cada uma com o seu ID e o seu webhook.
Crie sua primeira instância e conecte por QR code
Crie a conta, verifique o telefone e receba o crédito de boas-vindas, sem depositar (um por telefone, sujeito à campanha vigente). Em poucos minutos você tem uma instância conectada.