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

# Coexistência

> Conecte o mesmo número do WhatsApp Business App e Cloud API (Jelou) ao mesmo tempo.

Este guia explica como funciona a **Coexistência**: a opção que permite usar o mesmo número do WhatsApp no app do celular e na Cloud API (Jelou) ao mesmo tempo.

## O que é Coexistência?

A Coexistência permite que o mesmo número funcione ao mesmo tempo em:

📱 **WhatsApp Business App** (celular)

☁️ **WhatsApp Cloud API** (Jelou)

**Isso significa que você pode:**

* Enviar campanhas e automações pela Jelou
* Continuar usando o app para atendimento manual 1 a 1
* Manter o histórico sincronizado entre os dois ambientes

***

## Como funciona?

Durante a conexão do canal:

1. O negócio informa seu número atual do WhatsApp Business App.
2. A Meta envia um código de verificação.
3. O usuário confirma a conexão pelo app.
4. Pode autorizar (opcionalmente) compartilhar:
   * Histórico de mensagens
   * Contatos

Uma vez finalizado:

* O número fica conectado à **Cloud API**
* A Jelou pode enviar mensagens em massa e automatizadas
* O app continua funcionando normalmente para atendimento manual

***

## Requisitos

Antes de ativar a Coexistência, certifique-se de cumprir o seguinte:

✅ WhatsApp Business App versão 2.24.17 ou superior

✅ Número com código de país compatível

✅ Negócio verificado no Facebook Business Manager

✅ Jelou configurada com webhooks ativos e Cloud API habilitada

***

## Capacidades e limitações

### API (Jelou)

* Limite fixo de 20 mensagens por segundo (mps)

Pela API não estão disponíveis (use o WhatsApp Business App no celular, se for o caso):

* Grupos (chats em grupo)
* Mensagens temporárias
* Mensagens de visualização única
* Localização em tempo real
* Listas de transmissão
* Chamadas de voz e vídeo
* Catálogo, pedidos e status
* Respostas rápidas, etiquetas e outras ferramentas de negócio
* Perfil do negócio (a administração do perfil comercial fica no app; a API não oferece um equivalente completo em coexistência)
* Limitação da Meta: mensagens vindas de anúncios ou de origem paga para o WhatsApp não são entregues como mensagens dentro do chat do WhatsApp da mesma forma que templates aprovados ou conversas orgânicas; consulte as políticas vigentes da Meta para Click to WhatsApp e campanhas

***

### Pelo WhatsApp Business App (celular)

Você pode continuar usando normalmente:

* Chamadas e videochamadas
* Listas de transmissão
* Status
* Participação em grupos
* Catálogo, pedidos e status (conforme o que sua conta oferece no app)
* Respostas rápidas, etiquetas e ferramentas de negócio
* Perfil do negócio
* Atendimento manual 1 a 1

<Note>
  Essas ações são feitas diretamente no app; não passam pela automação nem pela API da Jelou.
</Note>

***

## Janela de 24 horas ⏱️

A janela de atendimento abre quando:

* O usuário escreve após o número já estar registrado na API.

Se o usuário escreveu antes do registro:

* Só é possível responder usando templates aprovados.

***

## O que é sincronizado com a Jelou?

### Chats individuais (1:1)

* É possível sincronizar até 6 meses (180 dias) de histórico.
* As mensagens são refletidas entre:
  * App
  * Jelou

### Contatos

* São sincronizados os contatos que possuem número do WhatsApp.

***

## O que acontece durante a sincronização

Uma vez registrado o número:

Você tem 24 horas para:

* Sincronizar contatos
* Sincronizar histórico de mensagens

O app deve:

* Permanecer aberto
* Ter conexão estável

📌 O processo pode levar vários minutos dependendo do volume de mensagens.

***

## Estados do histórico

O negócio pode decidir:

✅ **Compartilhar histórico**\
Mensagens de até 180 dias são sincronizadas.

❌ **Não compartilhar histórico**\
A Jelou recebe o evento, mas não as mensagens anteriores.

***

## Eventos recebidos pela Jelou (webhooks)

Para manter a sincronização, a Jelou escuta eventos como:

`account_update`\
Alterações na conta ou desconexão.

`messages`\
Edição ou exclusão de mensagens.

`history`\
Sincronização de mensagens históricas.

`smb_app_state_sync`\
Alterações de contatos.

`smb_message_echoes`\
Mensagens enviadas pelo app.

***

## Como remover a conexão?

⚠️ Não é possível desconectar pela API.

<Note>
  O negócio deve fazer pelo app:

  WhatsApp Business App → Configurações → Conta → Plataforma WhatsApp Business → Desconectar
</Note>

Isso enviará automaticamente o evento de desconexão para a Jelou.