Coexistência: WhatsApp Business no celular e API oficial no mesmo número
Coexistência é o modo da Meta em que o mesmo número funciona ao mesmo tempo no app WhatsApp Business do celular e na API oficial. Para conectar, o número precisa ter pelo menos 7 dias de uso no app, versão 2.24.17 ou mais nova, e o app deve ser aberto no celular pelo menos uma vez a cada 13 dias. Grupos, visualização única e localização ao vivo continuam só no celular, e a API fica em 20 mensagens por segundo.
Atualizado em
Como funciona a coexistência?
Você conecta pela FlashConnect o número que já usa no app WhatsApp Business. Depois da conexão, ele passa a existir nos dois lugares: no celular, como sempre, e na API oficial, onde a equipe, o agente de IA e o seu sistema também atendem.
- Mensagens dos clientes aparecem no celular e no painel.
- Respostas enviadas pelo painel ou pela IA saem pela API.
- Respostas que você manda pelo app do celular também aparecem no painel, marcadas como enviadas pelo celular.
A regra vem da Meta, e está descrita na documentação oficial de coexistência. Se ainda não sabe o que é a API, comece por o que é a API oficial do WhatsApp.
Quais são os requisitos da coexistência?
- App WhatsApp Business versão 2.24.17 ou mais nova no celular.
- 7 dias de uso: o número precisa estar em uso no app há pelo menos 7 dias antes de conectar.
- Abrir o app a cada 13 dias: se o app ficar cerca de duas semanas sem ser aberto no celular, a Meta desliga a conexão. Abrir antes de 13 dias dá margem.
- Acesso de administrador ao Facebook da empresa, para autorizar a conexão na janela da Meta.
O painel mostra há quantos dias o app não é aberto em cada número. A partir de 10 dias aparece um aviso amarelo; a partir de 12, um aviso vermelho para abrir o app no mesmo dia.
Quais são as limitações da coexistência?
| Item | Como fica |
|---|---|
| Grupos | Não passam pela API. Continuam só no celular. |
| Visualização única, mensagens temporárias e localização ao vivo | Não suportadas pela API. Continuam só no celular. |
| Selo azul (conta oficial) | Não disponível em coexistência. |
| Velocidade de envio | Fixa em 20 mensagens por segundo (1.200 por minuto). |
| Países | Indisponível para números da Nigéria e da África do Sul. |
| Mensagem editada ou apagada no celular | Fica registrada, mas não altera a conversa no painel. |
A velocidade de 20 mensagens por segundo raramente é o limite real. O que restringe campanhas é o messaging limit, explicado em messaging limit da API oficial.
O que sincroniza do celular?
Logo depois da conexão, a FlashConnect pede à Meta os dados do app. A Meta só aceita esse pedido nas primeiras 24 horas.
- Contatos do app WhatsApp Business, com nome e telefone. Quem você adicionar ou editar depois também é atualizado.
- Histórico de conversas de até cerca de 6 meses, enviado pela Meta em três etapas (último dia, até 90 dias e de 90 a 180 dias). O painel mostra o progresso.
O histórico importado entra nas conversas, mas não dispara automações e não conta nas métricas do dia. O dono do número pode recusar o compartilhamento do histórico no app; nesse caso o painel mostra a importação como recusada. Se o prazo de 24 horas passar, só é possível importar desconectando e conectando o número de novo.
As mensagens enviadas pelo celular aparecem no painel?
Sim. Cada mensagem que você manda pelo app chega à FlashConnect como um eco, inclusive áudios e fotos, e entra na conversa marcada como enviada pelo celular. Para quem integra por sistema, ela também sai no evento message.echo dos webhooks da FlashConnect.
Se a conversa estava com o agente de IA, uma resposta sua pelo celular passa a conversa para atendimento humano, para a IA não responder por cima de você. Atenção: as mensagens automáticas do próprio app (saudação e ausência) também chegam como eco e têm o mesmo efeito. Se usa agente de IA, vale desligá-las no app.
Qual a diferença entre conexão padrão e coexistência?
| Padrão (número só na API) | Coexistência | |
|---|---|---|
| App no celular | Deixa de funcionar nesse número | Continua funcionando |
| Mensagens enviadas pelo celular | Não se aplica | Sem cobrança da Meta e sem janela de 24h |
| Mensagens enviadas pela API | Janela de 24h; fora dela, só template | Janela de 24h; fora dela, só template |
| Manutenção | Nenhuma | Abrir o app a cada 13 dias |
| Contatos e histórico | Começa do zero | Importados do app nas primeiras 24h |
| Limitações | Sem grupos pela API | Sem grupos, visualização única e selo azul; 20 mensagens por segundo |
Na FlashConnect, a escolha aparece na hora de conectar: "Junto com o app" (coexistência) ou "API oficial" (número novo). O passo a passo está em como conectar o número.
Quanto custa usar a coexistência?
Mensagens enviadas pelo app do celular não são cobradas pela Meta. Mensagens enviadas pela API (painel, IA ou sistema) seguem a tabela da Meta por categoria. A assinatura da FlashConnect é por número conectado; veja os valores em planos e preços.
Perguntas frequentes
Posso continuar usando o WhatsApp Business no celular depois de conectar?
Sim. Em coexistência o app continua funcionando normalmente. Só é preciso abrir o app no celular pelo menos uma vez a cada 13 dias.
Meu número é novo. Posso usar coexistência?
Ainda não. A Meta exige que o número esteja em uso no app WhatsApp Business há pelo menos 7 dias antes da conexão.
O que acontece se eu ficar 13 dias sem abrir o app?
Por volta de duas semanas sem o app aberto, a Meta desliga a conexão do número com a API. O painel da FlashConnect avisa a partir de 10 dias sem atividade do app.
Os grupos do WhatsApp aparecem no painel?
Não. A API oficial não acessa grupos, mensagens de visualização única, mensagens temporárias nem localização ao vivo. Eles continuam funcionando no celular.
Meu histórico de conversas vem para o painel?
Sim, se for pedido nas primeiras 24 horas depois da conexão e o dono aceitar o compartilhamento no app. A Meta envia até cerca de 6 meses de conversas, e os contatos do app também são importados.
Mensagens enviadas pelo celular são cobradas?
Não. A Meta não cobra mensagens enviadas pelo app WhatsApp Business no celular. Só as mensagens enviadas pela API seguem a tabela de preços da Meta.
Em coexistência eu tenho o selo azul?
Não. O selo azul de conta oficial não está disponível para números em coexistência.
Quer usar a FlashConnect?
O acesso está sendo liberado por convite. Fale com a gente no WhatsApp.
Pedir convite no WhatsApp