Ir para o conteúdo
Gestor › Canais de atendimento

O que é uma instância

O conceito que aparece o tempo todo na plataforma, explicado em dois minutos.

Cada canal conectado à plataforma é uma instância.

Um número de WhatsApp conectado é uma instância. Um segundo número é outra instância. Um perfil do Instagram é mais uma. O chat do seu site é mais uma.

É por isso que a palavra aparece em tantos lugares: no seu plano, na tela inicial, nas campanhas, nos relatórios.

Por que isso importa

Seu plano define quantas instâncias você pode ter. Esse é o limite prático de quantos canais a sua operação consegue manter conectados ao mesmo tempo. Se você precisa de mais um número, precisa de mais uma instância.

Cada instância tem sua própria conexão. Uma pode estar no ar e outra fora. Quando alguém diz que “o WhatsApp caiu”, o que caiu é uma instância específica — as demais seguem funcionando.

As conversas sabem de onde vieram. Cada conversa registra por qual instância entrou, e isso aparece nos relatórios. Dá para saber quanto do atendimento veio de cada número ou canal.

Onde elas ficam

Na tela inicial do painel, na parte de baixo. Ali você vê cada instância, o estado da conexão dela e, se estiver desconectada, o caminho para reconectar.

O ícone de lápis ao lado permite renomear a instância. Vale a pena: “Vendas” e “Suporte” são mais úteis que dois números parecidos quando a equipe precisa escolher de qual número enviar.

Tipos de instância

TipoO que é
WhatsApp API OficialNúmero homologado junto à Meta
InstagramMensagens diretas de uma conta comercial
TelegramConversas do Telegram
WebchatO chat instalado no site da sua empresa

O tipo é escolhido ao criar a instância e pode ser alterado depois.

O nome não pode se repetir na mesma conta.

Reinicializar uma instância

Quando uma instância fica num estado estranho — conectada no painel mas sem receber mensagens, ou travada num “conectando” que não termina —, existe a ação de reinicializar.

Ela devolve a instância ao estado de recém-criada: derruba a sessão no provedor e apaga token, número, credenciais e vínculos. A instância continua existindo, com o mesmo nome, e você reconecta em seguida.

O que ela apaga e o que não toca

ApagaMantém
A conexão com o provedorAs conversas e o histórico
Token, número e credenciaisOs contatos
O vínculo com a conta da MetaO nome da instância

Nenhuma conversa é perdida. O que se perde é a conexão — que é justamente o que você quer refazer.

O que acontece em cada canal

WhatsApp API Oficial — a plataforma encerra a sessão junto ao provedor antes de limpar qualquer coisa. Se esse encerramento falhar, ela aborta e não reinicializa nada, devolvendo “Não foi possível encerrar a sessão no provedor. A instância não foi reinicializada — tente novamente.”

Isso é proposital: limpar localmente deixando a sessão viva no provedor significaria continuar sendo cobrado por uma conexão que você não enxerga mais.

Instagram — a autorização dada à Meta é desfeita. Reconectar exige passar pelo consentimento de novo.

Telegram — o webhook é removido e a sessão encerrada.

Reinicializar é o último recurso, não o primeiro

Antes de reinicializar, confira o óbvio: a assinatura está em dia, e a instância aparece mesmo como desconectada?

Depois de reinicializar, você precisa refazer a conexão inteira — no caso da API Oficial e do Instagram, isso significa passar de novo pelo fluxo da Meta. Não é um botão de “atualizar”.

Perguntas frequentes

Preciso de um número novo para usar a plataforma?
Não. Você pode registrar junto à Meta o número que a empresa já usa.
Posso conectar mais de um número?
Pode, desde que seu plano permita. Cada número é uma instância, e o plano define quantas você tem direito.
Preciso deixar o celular ligado?
Não. Na API Oficial a conexão é direto entre a plataforma e os servidores da Meta, sem depender de nenhum aparelho ligado.
Uma instância desconectada perde as mensagens?
As conversas e o histórico continuam guardados na plataforma. Mas enquanto ela estiver fora do ar, mensagens novas não entram nem saem por aquele canal.

Próximo passo

Atualizado em