Pular para o conteúdo principal
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

RecursoComportamento após a integração à coexistência
Listas de transmissãoDesativadas. 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 únicaDesativada. 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 mensagensDesativada. 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

RecursoComportamento após a integração à coexistência
Chats em grupoContinuam 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ídeoContinuam 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 aplicativoContinuam 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ênciaContinuam funcionando no aplicativo. As alterações não sincronizam com a Cloud API.
Respostas rápidasContinuam funcionando no aplicativo. Não sincronizam.
EtiquetasContinuam 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.