Skip to main content

​
O que é uma Instância?

Uma Instância é um conceito fundamental dentro das APIs para WhatsApp, representando uma unidade individual de conexão ao serviço do WhatsApp. Essencialmente, uma instância é como um “cliente” que se comunica com a API do WhatsApp, permitindo que você envie e receba mensagens, gerencie contatos, e realize outras operações relacionadas.

​
O que uma Instância faz?

A Instância é responsável por gerenciar a comunicação entre a sua aplicação e o WhatsApp. Algumas das principais funcionalidades de uma instância incluem:
  • Envio e Recebimento de Mensagens: Uma instância pode enviar e receber mensagens de texto, imagens, áudios, e outros tipos de mídia através da API.
  • Webhooks: A instância também pode ser configurada para disparar webhooks, notificando a sua aplicação sobre eventos como o recebimento de novas mensagens ou mudanças de status.

​
Como as Instâncias Funcionam?

Cada instância é autenticada com um número de telefone único e, uma vez conectada, ela mantém uma sessão ativa com os servidores do WhatsApp. Esta sessão é essencial para garantir que a instância possa enviar e receber mensagens em tempo real.
  1. Autenticação: Para iniciar, a instância precisa ser autenticada com o WhatsApp. Isso geralmente envolve o escaneamento de um código QR ou o uso de credenciais específicas.
  2. Manutenção da Conexão: Após a autenticação, a instância estabelece uma conexão persistente com o WhatsApp. Essa conexão deve ser mantida ativa para que a instância continue a funcionar corretamente.
  3. Interação com a API: Uma vez conectada, a instância pode interagir com a API do WhatsApp para executar diversas operações, como o envio de mensagens, verificação do status dos contatos, e muito mais.
  4. Webhooks e Eventos: A instância pode ser configurada para enviar notificações para a sua aplicação via webhooks quando certos eventos ocorrem, como a chegada de uma nova mensagem ou a mudança no status de um contato.

​
Conclusão

Instâncias são essenciais para qualquer aplicação que precisa interagir com o WhatsApp através de uma API. Elas não só facilitam a comunicação bidirecional em tempo real, mas também oferecem ferramentas para gerenciar eventos de forma eficaz. Compreender como configurar e manter uma instância é crucial para o sucesso na integração com o WhatsApp.

​
Tipos de conexão

Na Zapster, uma instância pode se conectar ao WhatsApp de duas formas: via QR code (não oficial) ou via API oficial da Meta (WABA). Ambas usam os mesmos endpoints para enviar e receber mensagens.

​
Não oficial (QR code)

É o modo padrão. Você cria a instância, escaneia o QR code (ou usa o código de pareamento) e o número fica conectado. Por trás, a Zapster mantém uma conexão persistente com os servidores do WhatsApp. Funciona bem para a maioria dos casos: automações, chatbots, envio de notificações. O risco é que, por não ser a API oficial, envios em volume muito alto ou práticas inadequadas podem gerar restrições no número.

​
Oficial (WABA)

Usa a Cloud API da Meta, o canal oficial do WhatsApp para empresas. A conexão é feita via OAuth (Embedded Signup) ou token manual. Não precisa de QR code nem de dispositivo conectado. As vantagens: estabilidade garantida pela Meta, sem risco de banimento por uso da API, suporte a templates de mensagem, e status de entrega/leitura confiáveis. As limitações: a Meta cobra por conversa (o preço varia por categoria e país), não suporta envio para grupos, e o setup inicial é mais envolvido.

​
Comparativo

​
Sobre migração

Atualmente não é possível converter uma instância não oficial para WABA (ou vice-versa). Esse recurso está em desenvolvimento. Quando disponível, a migração será transparente: seus webhooks e integrações continuarão funcionando sem alterações. Para saber qual tipo escolher e como conectar uma instância WABA, veja o guia de conexão WABA e o comparativo detalhado.