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

# WhatsApp Business API

> Entenda o que é a WhatsApp Business API, seus benefícios e como o Invenio potencializa seu uso para atendimento, automações e campanhas em escala.

O **WhatsApp Business API** é uma solução desenvolvida especialmente para **empresas de médio e grande porte** que desejam ampliar sua comunicação com clientes de forma automatizada, segura e escalável.

Com ela, é possível integrar o canal mais utilizado pelos consumidores diretamente ao **Invenio** — a plataforma de atendimento digital da Robbu.

***

## O que é uma API?

**API (Application Programming Interface)** é uma **ponte de comunicação** entre sistemas diferentes.

No caso do WhatsApp, a API permite que **ferramentas externas** se conectem ao aplicativo, viabilizando o envio e recebimento de mensagens por meio de plataformas próprias — sem precisar do aplicativo no celular.

<Note>
  **Analogia:** Pense na API como uma tomada universal. O WhatsApp é a energia, e o Invenio é o aparelho que se conecta a essa energia para funcionar.
</Note>

***

## WhatsApp App vs. Business API vs. Invenio

<Tabs>
  <Tab title="WhatsApp Comum" icon="mobile">
    ### WhatsApp Pessoal / Business App

    O aplicativo tradicional, usado por pessoas físicas ou pequenas empresas.

    **Características:**

    * 📱 Interface visual (celular ou WhatsApp Web)
    * 👤 1 usuário por número
    * 💬 Mensagens livres (sem aprovação)
    * ❌ Sem automação
    * ❌ Sem múltiplos atendentes
    * ❌ Sem integração com sistemas
    * ❌ Sem envio em massa estruturado

    **Ideal para:** Uso pessoal ou negócios muito pequenos
  </Tab>

  <Tab title="WhatsApp Business API" icon="server">
    ### WhatsApp Business API

    Solução técnica para empresas que precisam de escala e automação.

    **Características:**

    * 🖥️ **Sem interface própria** (precisa de plataforma)
    * 👥 **Múltiplos atendentes** no mesmo número
    * 🤖 **Automações** via chatbot/IDR
    * 📣 **Envio em massa** de templates HSM aprovados
    * 🔒 **Criptografia** ponta a ponta
    * 📊 **Métricas** de entrega e leitura
    * ✅ **Conformidade** com políticas da Meta

    **Ideal para:** Empresas de médio/grande porte

    <Warning>
      A API **não funciona sozinha** — precisa estar conectada a uma plataforma homologada (como o Invenio) ou a uma integração técnica própria.
    </Warning>
  </Tab>

  <Tab title="Invenio + API" icon="rocket">
    ### Invenio com WhatsApp Business API

    A combinação que potencializa ao máximo a API do WhatsApp.

    **O que o Invenio agrega:**

    * 🎛️ **Painel visual completo** — sem precisar de equipe técnica
    * 👥 **Múltiplos atendentes** com filas e distribuição
    * 🤖 **IDR/Chatbot** integrado com fluxos avançados
    * 📣 **Campanhas em massa** com segmentação
    * 📊 **Dashboards e relatórios** em tempo real
    * 🔗 **Integração** com CRM e sistemas externos
    * 📋 **Templates HSM** gerenciados direto no painel
    * 🏷️ **Tags e histórico** de conversas

    **Ideal para:** Empresas que querem profissionalizar o atendimento sem complexidade técnica

    <Check>
      O Invenio é **homologado pela Meta** como parceiro oficial da WhatsApp Business API.
    </Check>
  </Tab>
</Tabs>

***

## Benefícios da WhatsApp Business API

<Columns>
  <Column>
    **🚀 Escala**

    * Múltiplos atendentes simultâneos
    * Milhares de mensagens por dia
    * Crescimento automático de limites

    **🤖 Automação**

    * Chatbot com IDR
    * Fluxos inteligentes
    * Respostas automáticas
  </Column>

  <Column>
    **🔒 Segurança**

    * Criptografia ponta a ponta
    * Conformidade com LGPD
    * Controle de acesso por perfil

    **📊 Inteligência**

    * Métricas de entrega e leitura
    * Relatórios de campanha
    * Histórico de conversas
  </Column>
</Columns>

***

## Como Usar a API na Prática

Há dois caminhos para utilizar a WhatsApp Business API:

| Opção                         | Descrição                       | Para quem                               |
| ----------------------------- | ------------------------------- | --------------------------------------- |
| 🔧 **Integração direta**      | Desenvolvimento próprio via API | Empresas com equipe técnica dedicada    |
| 🎛️ **Plataforma homologada** | Usar o Invenio (sem código)     | Empresas que querem agilidade e suporte |

<Tip>
  **Recomendação:** O Invenio elimina a complexidade técnica, oferecendo toda a estrutura visual e de atendimento pronta para operação imediata.
</Tip>

***

## Links Relacionados

<CardGroup cols={2}>
  <Card title="Canal WhatsApp" icon="whatsapp" href="https://docs.robbu.global/docs/center/canal-whatsapp">
    Linhas, WABA e qualidade
  </Card>

  <Card title="Templates de WhatsApp" icon="file-lines" href="https://docs.robbu.global/docs/center/como-criar-templates-whatsapp">
    Criar e gerenciar HSM
  </Card>

  <Card title="Campanhas de WhatsApp" icon="bullhorn" href="https://docs.robbu.global/docs/center/campanhas-de-whatsapp">
    Envio em massa com templates
  </Card>

  <Card title="Canais de Atendimento" icon="comments" href="https://docs.robbu.global/docs/center/canais-atendimento">
    Todos os canais disponíveis
  </Card>

  <Card title="Alterar Imagem da Linha" icon="image" href="https://docs.robbu.global/docs/center/como-alterar-imagem-da-linha-whatsapp">
    Personalizar linha WhatsApp
  </Card>

  <Card title="Sessão de 24 Horas" icon="clock" href="https://docs.robbu.global/docs/live/sessao-de-24horas-no-whatsapp">
    Janela de mensagens WhatsApp
  </Card>
</CardGroup>

***

## ⁉️ Perguntas Frequentes (FAQ)

<AccordionGroup>
  <Accordion title="📱 Qual a diferença entre o WhatsApp comum e o WhatsApp Business API?">
    | Característica          | WhatsApp Comum | Business API          |
    | ----------------------- | -------------- | --------------------- |
    | Interface               | App visual     | Sem interface própria |
    | Usuários                | 1 por número   | Múltiplos atendentes  |
    | Automação               | Não            | Sim (chatbot/IDR)     |
    | Envio em massa          | Não            | Sim (templates HSM)   |
    | Integração com sistemas | Não            | Sim                   |
    | Relatórios              | Básico         | Detalhado             |

    **Resumo:** O WhatsApp comum é para uso pessoal. A API é para operações empresariais em escala.
  </Accordion>

  <Accordion title="🎛️ Posso usar a API com o Invenio sem equipe técnica?">
    **Sim!** O Invenio já é homologado para operar com a WhatsApp Business API.

    **O que você não precisa fazer:**

    * ❌ Configurar servidores
    * ❌ Programar integrações
    * ❌ Gerenciar webhooks

    **O que o Invenio já faz por você:**

    * ✅ Interface visual completa
    * ✅ Gerenciamento de templates
    * ✅ Filas de atendimento
    * ✅ Relatórios e dashboards

    **Caminho para começar:** Entre em contato com a equipe Robbu pelo **[suporte@robbu.global](mailto:suporte@robbu.global)**
  </Accordion>

  <Accordion title="🤖 É possível usar chatbot com a WhatsApp Business API?">
    **Sim.** O chatbot (IDR — Interactive Digital Response) é um dos principais benefícios da integração com o Invenio.

    **O que o chatbot pode fazer:**

    * 🔀 **Triagem automática:** Direciona o cliente para o setor correto
    * ❓ **Respostas automáticas:** FAQs, horários, informações básicas
    * 🕐 **Atendimento 24/7:** Mesmo fora do horário comercial
    * 📋 **Coleta de dados:** Nome, CPF, motivo do contato

    **Caminho:** Invenio Center > Maestro (configuração de fluxos IDR)
  </Accordion>

  <Accordion title="📣 O que são mensagens estruturadas (HSM)?">
    **HSM (Highly Structured Messages)** são templates de mensagens **pré-aprovados pela Meta** para envio ativo.

    **Por que são necessários:**

    * 🛡️ Evitam spam e abuso
    * ✅ Garantem conformidade
    * 📤 Permitem iniciar conversas fora da janela de 24h

    **Exemplos de uso:**

    * 💰 "Seu boleto vence amanhã. Valor: R\$ 150,00. \[Link]"
    * 📦 "Seu pedido #1234 foi enviado. Rastreamento: \[Link]"
    * 🔐 "Seu código de acesso é: 4829. Válido por 10 minutos."

    Consulte: [Como Criar Templates de WhatsApp](https://docs.robbu.global/docs/center/como-criar-templates-whatsapp)
  </Accordion>

  <Accordion title="👥 Posso ter vários operadores no mesmo número?">
    **Sim.** Essa é uma das principais vantagens da API sobre o app comum.

    **Com o Invenio:**

    * ✅ **Ilimitado de atendentes** conectados ao mesmo número
    * ✅ **Filas de atendimento** com distribuição automática
    * ✅ **Histórico centralizado** de todas as conversas
    * ✅ **Controle por perfil:** Supervisor vê tudo; atendente vê seu setor

    Não importa se são 5 ou 500 operadores — todos usam o mesmo número WhatsApp.
  </Accordion>

  <Accordion title="🔒 Como funciona o controle de qualidade do número?">
    A Meta avalia continuamente a **reputação da linha** com base em:

    * 🚫 **Bloqueios:** Quantos usuários bloquearam o número
    * 🚨 **Denúncias:** Relatos de spam
    * 💬 **Engajamento:** Taxa de resposta dos clientes

    **Classificação:**

    * 🟢 **Green:** Saudável, sem restrições
    * 🟡 **Yellow:** Em alerta, pode ter limites reduzidos
    * 🔴 **Red:** Alto risco, pode levar a bloqueio

    **Caminho para monitorar:** Invenio Center > Recursos > Canais > WhatsApp > Coluna "Qualidade"

    Consulte: [Canal WhatsApp](https://docs.robbu.global/docs/center/canal-whatsapp)
  </Accordion>

  <Accordion title="⏰ O que acontece se a janela de 24 horas expirar?">
    Quando o cliente **não responde em 24 horas**, o envio de mensagens livres é bloqueado pela Meta.

    **Para retomar a conversa:**

    * ✅ Envie um **template HSM aprovado**
    * ✅ Após o cliente responder, a janela de 24h é **reaberta automaticamente**
    * ✅ Mensagens normais podem ser enviadas pela janela reaberta

    **Estratégia recomendada:**
    Tenha templates de "reativação" aprovados para retomar contatos inativos.

    Consulte: [Sessão de 24 Horas](https://docs.robbu.global/docs/live/sessao-de-24horas-no-whatsapp)
  </Accordion>

  <Accordion title="🛡️ O uso da API é seguro e regulamentado?">
    **Sim.** A WhatsApp Business API possui múltiplas camadas de segurança:

    * 🔐 **Criptografia:** Ponta a ponta em todas as mensagens
    * 📜 **Conformidade:** Segue diretrizes da Meta e LGPD
    * 🏢 **Homologação:** Somente parceiros autorizados podem usar
    * 🔑 **Controle de acesso:** Perfis e permissões por usuário
    * 📊 **Auditoria:** Histórico completo de mensagens

    O Invenio é um **parceiro homologado pela Meta**, garantindo uso ético e profissional da plataforma.
  </Accordion>

  <Accordion title="✏️ Como atualizar informações da minha linha de WhatsApp?">
    **Caminho:** Invenio Center > Recursos > Canais > WhatsApp > Selecionar linha > Editar

    **O que pode ser alterado:**

    * 🖼️ **Imagem de perfil** da linha
    * 📝 **Nome de exibição** (sujeito a aprovação da Meta)
    * 🔗 **Templates vinculados**
    * ⚙️ **Configurações de segmento**

    Consulte: [Como Alterar a Imagem da Linha de WhatsApp](https://docs.robbu.global/docs/center/como-alterar-imagem-da-linha-whatsapp)
  </Accordion>

  <Accordion title="📈 Como aumentar o limite de mensagens por dia?">
    O limite começa em **1.000 mensagens/dia** e é aumentado automaticamente pela Meta:

    **Critérios:**

    * ✅ Status: Conectado
    * ✅ Qualidade: Green ou Yellow
    * ✅ Uso: 50%+ do limite nos últimos 7 dias

    **Progressão:**

    * Nível 1: 1.000 mensagens/dia
    * Nível 2: 10.000 mensagens/dia
    * Nível 3: 100.000 mensagens/dia
    * Nível 4: Ilimitado (casos especiais)

    **Tempo entre níveis:** 7-14 dias de uso consistente.
  </Accordion>
</AccordionGroup>