> ## Documentation Index
> Fetch the complete documentation index at: https://developer.zapsterapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instâncias

> O que é, o que faz e como funcionam

### 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

| Característica     | Não oficial (QR code)               | Oficial (WABA)                               |
| ------------------ | ----------------------------------- | -------------------------------------------- |
| Conexão            | QR code ou código de pareamento     | OAuth com Meta ou token manual               |
| Estabilidade       | Boa                                 | Alta (garantida pela Meta)                   |
| Risco de banimento | Existe, se usar de forma inadequada | Baixo (uso aprovado pela Meta)               |
| Templates          | Não suporta                         | Suporta (marketing, utility, authentication) |
| Custo por mensagem | Sem custo adicional                 | Meta cobra por conversa                      |
| Grupos             | Suporta                             | Não suporta                                  |
| Setup              | Escanear QR code                    | Conectar conta Meta ou inserir token         |

### 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](/pt-BR/v1/guides/connect-waba-instance) e o [comparativo detalhado](/pt-BR/v1/guides/waba-vs-unofficial).