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

# Introdução

> Envie confirmações de pedido, códigos de verificação, lembretes e atendimento no WhatsApp pelo painel ou API, com acompanhamento de entrega e respostas.

<Tip>
  WhatsApp é a **porta da loja no bolso do cliente**: avisos, códigos e conversas no app que ele já usa o dia inteiro.
</Tip>

## O que é WhatsApp na Notifique?

É o jeito de **falar com seus clientes no WhatsApp** sem montar tudo do zero. Você pode:

* **Avisar** sobre pedido, pagamento, entrega ou consulta
* **Enviar códigos** de verificação (OTP) e senhas de uso único
* **Atender** com texto, imagem, áudio, vídeo e botões
* **Saber** se a mensagem foi entregue, lida ou se o cliente respondeu
* **Automatizar** envios pelo painel ou pela API do seu sistema

Pense no balcão de atendimento digital: a pessoa já está no app; você só precisa chegar com a mensagem certa.

## Oficial ou não oficial?

Ao conectar um número, você escolhe um dos dois modos. **Não dá para trocar depois** na mesma instância: se mudar de ideia, crie uma nova.

### Conexão oficial (recomendada para produção)

É o caminho **aprovado pela Meta**. Ideal quando o produto já está no ar ou quando você precisa de **confiabilidade, templates e escala** com as regras do WhatsApp Business.

* Confirmações, OTP e campanhas com template aprovado
* Botões, listas e carrossel dentro das regras da Meta
* Mesma base usada por empresas grandes no WhatsApp

### Conexão não oficial

Funciona parecido com **conectar o WhatsApp no computador**: rápido de testar, mais liberdade em alguns recursos, mas **fora do contrato oficial** da Meta.

Boa para quem está **começando**, montando um **MVP**, **desenvolvendo** a integração ou testando fluxos antes de ir para a oficial.

<Warning>
  A conexão **não oficial** pode ter **risco maior** de bloqueio ou instabilidade no número. Use para testes e validação. Para clientes reais em produção, prefira a **oficial**.
</Warning>

## Comparativo: o que cada modo faz

| 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                    |    ❌    |      ✅      |
| 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                 |    ❌    |      ✅      |
| Vários números compartilhando os mesmos templates |    ✅    |      ✅      |
| Testar no sandbox (sem envio real)                |    ✅    |      ✅      |
| Aquecimento de número novo                        |    ❌    |      ✅      |
| Sincronizar agenda do WhatsApp                    |    ❌    |      ✅      |

\* Na **oficial**, fora da conversa recente, costuma ser preciso usar **template aprovado**. Na **não oficial**, a mensagem livre funciona sem essa janela.

\*\* Com template aprovado pela Meta.

† Templates compartilhados: na **oficial**, catálogo da Meta na mesma conta Business; na **não oficial**, templates do **workspace** para qualquer número não oficial dele.

⚠️ = funciona, mas com formato ou regra específica. Detalhes técnicos: [Modos de conexão](/whatsapp-api/como-funciona/modos-de-conexao).

## Como conectar seu número

Em três passos:

1. **Crie uma instância** (sua conexão WhatsApp) no painel ou pela API
2. **Escolha** oficial ou não oficial
3. **Complete a configuração** até o status ficar **ativo** e pronto para enviar

<AccordionGroup>
  <Accordion title="Como configurar a conexão oficial">
    1) No painel, crie uma instância e escolha **Oficial**
    2) Faça login com sua conta Meta e vincule o número
    3) Cadastre uma **forma de pagamento** no gerenciador do WhatsApp (a Meta cobra as conversas)
    4) Sincronize ou crie **templates** aprovados para o primeiro contato

    Guia passo a passo: [Quick Start](/whatsapp-api/como-funciona/quick-start) (aba **Conexão oficial**)
  </Accordion>

  <Accordion title="Como configurar a conexão não oficial">
    1. Crie uma instância (o padrão é não oficial)
    2. Abra o **código no celular** que aparece no painel ou na API
    3. Escaneie no app WhatsApp do número que vai enviar as mensagens
    4. Quando conectar, o status fica **ativo**

    Guia passo a passo: [Quick Start](/whatsapp-api/como-funciona/quick-start) (aba **Conexão não oficial**)

    <Note>
      Depois do primeiro pareamento, a instância fica **ligada àquele número**. Para trocar de chip, crie uma nova instância. Leia [Política anti-banimento](/whatsapp-api/como-funciona/politica-anti-banimento).
    </Note>
  </Accordion>
</AccordionGroup>

## Depois de conectar

* **Envie** pelo painel ou pela API para um ou vários números
* **Acompanhe** se foi entregue, lida ou se houve erro
* **Receba respostas** no seu sistema com [webhooks](/whatsapp-api/como-funciona/eventos-do-webhooks)
* **Escale** com vários números usando [Sending Pools](/whatsapp-api/como-funciona/sending-pools)

<Note>
  Número ou chip **novo**? Não dispare campanha no primeiro dia. Veja [Números e chips novos](/whatsapp-api/como-funciona/politica-anti-banimento#números-e-chips-novos).
</Note>

## Próximos passos

* [Quick Start](/whatsapp-api/como-funciona/quick-start): conectar e enviar (oficial ou não oficial)
* [Templates oficiais Meta](/template-api/como-funciona/templates-oficiais-meta): criar, sincronizar e aprovar na Meta
* [Modos de conexão](/whatsapp-api/como-funciona/modos-de-conexao): comparativo completo e cobrança
* [Escopos da API Key](/whatsapp-api/como-funciona/escopos-api-key): permissões para integrar