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

# Modos de conexão

> Entenda a diferença entre conexão oficial e não oficial no WhatsApp: quando usar cada uma, preços e o que cada modo permite.

<Tip>
  Escolher o modo é como escolher **estrada ou atalho**: a oficial segue as regras da Meta com mais previsibilidade; a não oficial é mais rápida para testar, mas com mais risco.
</Tip>

## Oficial ou não oficial?

Cada número conectado no Notifique usa **um** dos dois modos. Não dá para alternar na mesma instância: se precisar mudar, **crie uma nova**.

|                  | **Oficial**                                        | **Não oficial**                                                           |
| ---------------- | -------------------------------------------------- | ------------------------------------------------------------------------- |
| O que é          | Conexão **aprovada pela Meta**                     | Conexão **fora do contrato oficial**, parecida com WhatsApp no computador |
| Indicado para    | **Produção**, OTP, campanhas com template aprovado | **MVP**, testes, desenvolvimento da integração                            |
| Risco no número  | Menor, seguindo as regras da Meta                  | **Maior** (bloqueio ou instabilidade)                                     |
| Custo extra Meta | Sim: conversas cobradas no gerenciador do WhatsApp | Não                                                                       |

### Quando usar a oficial

* Produto no ar atendendo clientes de verdade
* Códigos de verificação, confirmação de pedido, marketing com template aprovado
* Botões, listas e carrossel dentro das regras da Meta

### Quando usar a não oficial

* Validar ideia, montar protótipo ou integrar pela primeira vez
* Precisar de grupos, editar/apagar mensagem ou baixar mídia recebida
* Ainda não está pronto para a burocracia da conta Meta

<Warning>
  A conexão **não oficial** não substitui a oficial em produção. Use para aprender e testar; para clientes reais em escala, migre para a **oficial**.
</Warning>

Em ambos os modos, você precisa de **opt-in** do destinatário, conteúdo permitido e respeito às [políticas da Meta](https://www.whatsapp.com/legal/business-policy) e aos [Termos](https://app.notifique.dev/terms) da Notifique.

***

## Templates em vários números

Os dois modos permitem **reutilizar templates em mais de um número**, mas de formas diferentes:

|                                | **Oficial**                                               | **Não oficial**                                                      |
| ------------------------------ | --------------------------------------------------------- | -------------------------------------------------------------------- |
| De onde vêm os templates       | Aprovados pela **Meta** na sua conta Business             | Criados no **workspace** da Notifique                                |
| Compartilhamento               | Números na **mesma conta Business** veem o mesmo catálogo | Qualquer número **não oficial** do workspace usa os mesmos templates |
| Botões e carrossel no template | Sim (com aprovação Meta)                                  | Não (templates internos são texto/imagem simples)                    |

Mais sobre templates oficiais: [Templates oficiais Meta](/whatsapp-api/como-funciona/templates-oficiais-meta).

***

## Cobrança

|                            | **Oficial**                                           | **Não oficial** |
| -------------------------- | ----------------------------------------------------- | --------------- |
| Créditos (plano)           | 1 por mensagem                                        | 1 por mensagem  |
| Pague pelo uso (Notifique) | R\$ 0,01 / msg                                        | R\$ 0,05 / msg  |
| Cobrança da Meta           | **Você paga** as conversas no gerenciador do WhatsApp | Não se aplica   |

Na **oficial**, a Meta cobra as conversas e a Notifique cobra só a **taxa da plataforma**. É obrigatório ter **cartão cadastrado** no gerenciador do WhatsApp antes de enviar em produção.

Detalhes gerais: [Cobrança](/guides/introducao/cobranca-e-pague-pelo-uso).

***

## Comparativo completo

| Funcionalidade                             | Oficial | Não oficial |
| ------------------------------------------ | :-----: | :---------: |
| Mensagens de texto simples                 |    ✅    |      ✅      |
| Mensagens com imagem                       |    ✅    |      ✅      |
| Mensagens com áudio                        |    ✅    |      ✅      |
| Mensagens com vídeo                        |    ✅    |      ✅      |
| Mensagens com documento (PDF, etc.)        |    ✅    |      ✅      |
| Mensagens com localização                  |    ✅    |      ✅      |
| Mensagens com contato (cartão)             |    ⚠️   |      ✅      |
| Mensagens com botões                       |    ✅    |      ❌      |
| Mensagens com lista de opções              |    ✅    |      ❌      |
| Carrossel (vários cards)                   |    ✅    |      ❌      |
| Templates aprovados pela Meta              |    ✅    |      ❌      |
| Templates prontos da Notifique (workspace) |    ❌    |      ✅      |
| Vários números usando os mesmos templates  |    ✅    |      ✅      |
| Enviar para quem nunca falou com você\*    |  ✅\*\*  |      ✅      |
| Agendar e cancelar envio                   |    ✅    |      ✅      |
| Editar mensagem já enviada                 |    ❌    |      ✅      |
| Apagar mensagem para todos                 |    ❌    |      ✅      |
| Mostrar "digitando..." ou "gravando áudio" |    ❌    |      ✅      |
| Enviar mensagem para grupos                |    ❌    |      ✅      |
| Gerenciar grupos (participantes, convites) |    ❌    |      ✅      |
| Receber respostas dos clientes             |    ✅    |      ✅      |
| Saber se entregou e se leu                 |    ✅    |      ✅      |
| Baixar mídia que o cliente enviou          |    ❌    |      ✅      |
| Testar no sandbox (sem envio real)         |    ✅    |      ✅      |
| Aquecimento de número novo                 |    ❌    |      ✅      |
| Sincronizar agenda do WhatsApp             |    ❌    |      ✅      |
| Conectar escaneando código no celular      |    ❌    |      ✅      |
| Conectar com login Meta no painel          |    ✅    |      ❌      |

\* Na **oficial**, fora da conversa recente, use **template aprovado**. Na **não oficial**, mensagem livre sem essa janela.

\*\* Com template aprovado pela Meta.

⚠️ = funciona com formato ou regra específica.

<Note>
  Não dá para converter uma instância de um modo para o outro. Crie outra instância no modo certo.
</Note>

<Info>
  Integrando só pela API (sem browser no servidor)? Use `mode: "OFFICIAL"` (ou `mode: "UNOFFICIAL"`) com `generateShareableLink: true` em `POST /v1/whatsapp/instances` para receber um link que o cliente abre e conclui a conexão (QR ou login Meta). Detalhes no [Quick Start](/whatsapp-api/como-funciona/quick-start).
</Info>

***

## Resumo: qual escolher?

| Situação                                     | Prefira                                                 |
| -------------------------------------------- | ------------------------------------------------------- |
| Produção com clientes reais                  | **Oficial**                                             |
| OTP e avisos transacionais                   | **Oficial**                                             |
| MVP, teste ou integração em desenvolvimento  | **Não oficial**                                         |
| Grupos, editar/apagar, baixar mídia recebida | **Não oficial**                                         |
| Vários números com os mesmos templates       | **Ambos** (oficial: conta Meta; não oficial: workspace) |

## Próximos passos

* [Introdução](/whatsapp-api/como-funciona/introducao): visão geral do canal
* [Quick Start oficial](/whatsapp-api/como-funciona/quick-start): conectar e enviar na oficial
* [Quick Start (não oficial)](/whatsapp-api/como-funciona/quick-start): testar a não oficial
* [Templates oficiais Meta](/whatsapp-api/como-funciona/templates-oficiais-meta)
* [Grupos](/whatsapp-api/grupos/introducao): só na não oficial
* [Política anti-banimento](/whatsapp-api/como-funciona/politica-anti-banimento)