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

# Funcionalidade de Coexistência

> Requisitos, limitações e comportamento de recursos da Coexistência com WhatsApp

Esta página documenta os requisitos e as limitações conhecidas da coexistência com WhatsApp aplicáveis a números conectados ao Coral. Abrange elegibilidade, requisitos de dispositivo, capacidade de envio e os recursos do aplicativo WhatsApp Business que mudam de comportamento após a integração de um número à sua conta Coral em modo de coexistência.

Sempre confirme o comportamento atual com a documentação oficial da Plataforma WhatsApp Business da Meta antes de ir para produção. A Meta atualiza periodicamente a lista de regiões compatíveis e o comportamento dos recursos.

## Elegibilidade regional

A partir de 1º de fevereiro de 2026, números do WhatsApp Business com códigos de país registrados na Nigéria ou na África do Sul não podem ser integrados à coexistência. Todas as demais regiões onde a Plataforma WhatsApp Business está disponível, incluindo a UE, o Reino Unido, a Austrália e as Américas, são compatíveis. Consulte a lista de suporte regional da Meta para obter o status mais recente.

## Requisitos de dispositivo

* **Versão 2.24.17 ou posterior do aplicativo WhatsApp Business.** Versões anteriores não oferecem suporte ao fluxo de integração de coexistência.
* **O aplicativo deve estar usando o número de telefone por pelo menos 1 semana** antes da integração.
* **O aplicativo deve permanecer instalado** no dispositivo original. Desinstalar o aplicativo WhatsApp Business interrompe o vínculo de coexistência e o número precisará ser reintegrado.
* **O aplicativo deve ser aberto pelo menos uma vez a cada 13 dias.** Caso o aplicativo permaneça fechado além desse período, a conexão entre o aplicativo e a Cloud API poderá ser interrompida.
* **Os dispositivos complementares são desvinculados durante a integração.** O WhatsApp Web, o WhatsApp Desktop (macOS) e outras sessões vinculadas são desconectados como parte da etapa de integração. Os clientes complementares compatíveis podem ser revinculados posteriormente.
* **O WhatsApp para Windows e o Wear OS não são compatíveis** com o modo de coexistência e não funcionarão como clientes complementares após a integração.

## Capacidade de envio

Os números em coexistência têm uma **capacidade fixa da Cloud API de 20 mensagens por segundo** (TPS). Esse limite é definido pela Meta para manter o aplicativo WhatsApp Business e a Cloud API sincronizados, e se aplica independentemente do nível ou do limite de mensagens do número. Números que precisam de TPS mais elevado para campanhas de envio não devem ser integrados via coexistência.

## API Lite de Mensagens de Marketing

Números integrados via coexistência **não são elegíveis para a API Lite de Mensagens de Marketing**. A API Lite é a oferta da Meta para casos de uso exclusivamente voltados ao marketing e requer integração padrão à Cloud API em vez da integração via coexistência.

## Comportamento dos recursos no aplicativo WhatsApp Business

Após a ativação da coexistência, vários recursos do aplicativo WhatsApp Business mudam de comportamento. As duas tabelas abaixo os dividem em (A) recursos completamente desativados e (B) recursos que continuam funcionando no aplicativo, mas não sincronizam com a Cloud API nem aparecem no Coral.

### A. Recursos desativados no aplicativo WhatsApp Business

| Recurso                                                           | Comportamento após a integração à coexistência                                                |
| ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Listas de transmissão                                             | Desativadas. Novas listas não podem ser criadas. Listas existentes tornam-se somente leitura. |
| Mensagens temporárias (chats individuais)                         | Desativadas. A configuração não está disponível no modo de coexistência.                      |
| Mensagens temporárias (modo automático)                           | Desativadas forçadamente durante a integração.                                                |
| Mídia de visualização única                                       | Desativada. Fotos e vídeos de visualização única não podem mais ser enviados.                 |
| Compartilhamento de localização em tempo real (chats individuais) | Desativado.                                                                                   |
| Edição de mensagens                                               | Desativada. Mensagens enviadas não podem ser editadas.                                        |
| Apagar para todos (revogar mensagem / "Desfazer envio")           | Desativado. Mensagens enviadas não podem ser apagadas para o destinatário.                    |

### B. Recursos que continuam no aplicativo, mas não sincronizam com a Cloud API

| Recurso                                                       | Comportamento após a integração à coexistência                                                                                                                                                                                                                           |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Chats em grupo                                                | Continuam funcionando no aplicativo. Não são espelhados para a Cloud API e não ficam visíveis no Coral. (O Coral oferece uma opção separada de chat em grupo que permite visibilidade e automação em grupos; entre em contato com a equipe do Coral para mais detalhes.) |
| Chamadas de voz e chamadas de vídeo                           | Continuam funcionando no aplicativo. Não podem ser iniciadas, controladas ou registradas pela Cloud API.                                                                                                                                                                 |
| Ocultação de número (esconder o número de telefone comercial) | Continua funcionando no aplicativo. Não é exposta via Cloud API e a interface do lado da API exibe o número subjacente.                                                                                                                                                  |
| Catálogos, pedidos e ferramentas comerciais no aplicativo     | Continuam funcionando no aplicativo. Não sincronizam com a Cloud API. Gerencie no aplicativo, não em ambos os locais.                                                                                                                                                    |
| Mensagens de saudação e mensagens de ausência                 | Continuam funcionando no aplicativo. As alterações não sincronizam com a Cloud API.                                                                                                                                                                                      |
| Respostas rápidas                                             | Continuam funcionando no aplicativo. Não sincronizam.                                                                                                                                                                                                                    |
| Etiquetas                                                     | Continuam funcionando no aplicativo. Não sincronizam.                                                                                                                                                                                                                    |

## Importação do histórico de conversas

Quando um número é integrado à coexistência, a Meta importa uma parte do histórico existente do aplicativo WhatsApp Business para a conta da Cloud API. O Coral exibe o conteúdo importado na caixa de entrada e o grava no CRM conectado.

* **Histórico de chats individuais:** Até **6 meses** de mensagens individuais anteriores são importados.
* **Mídia (imagens, arquivos, notas de voz):** Aproximadamente **2 semanas** de mídia anterior são importadas.
* **Histórico de chats em grupo:** Não importado. As conversas em grupo existentes permanecem acessíveis somente no aplicativo WhatsApp Business.
* **Contatos:** Sincronizados imediatamente durante a integração.
* **Tempo de sincronização:** Mensagens recentes das últimas 24 horas sincronizam em tempo real. O histórico individual mais antigo é preenchido em segundo plano, geralmente em minutos a horas dependendo do volume.

A importação é executada uma única vez, durante a integração. Se a importação for ignorada durante o fluxo de integração, ela não poderá ser acionada posteriormente — o número deverá ser desintegrado e reintegrado para importar o histórico.

## Preços

* **As mensagens do aplicativo WhatsApp Business continuam sendo gratuitas**, incluindo após a integração à coexistência.
* **As mensagens enviadas pela API para o chat são cobradas pela Meta** com base nas tarifas padrão da Cloud API, por categoria de conversa e país.
* **As janelas de resposta de 24 horas** são abertas apenas por mensagens recebidas do cliente ou contato, não por mensagens enviadas pelo número de coexistência do funcionário, mesmo que enviadas pelo aplicativo Business.
