coexistence | Referência de Coexistência

O que é

O modo oficial da Meta para rodar o app do WhatsApp Business e a Cloud API num mesmo número de telefone ao mesmo tempo. Não é uma API separada: é a mesma Cloud API, com um onboarding feito de forma que o app continue funcionando no número depois.

Por que as equipes usam

Quatro motivos respondem por quase toda conexão.

• Manter o número que já está impresso em veículos, recibos e num site.
• Acrescentar envio pela API, webhooks e templates sem mover ninguém para uma ferramenta nova.
• Manter as conversas fora da caixa de entrada compartilhada de um provedor.
• Permitir que uma agência mantenha muitos números de clientes, cada um no portfólio do próprio cliente.

Como a comunicação funciona

As duas superfícies veem o mesmo fio de conversa. O que a API envia aparece no app. O que a equipe digita no app chega ao software como um evento smb_message_echoes, que é o que impede a automação de responder por cima de uma pessoa.

Comportamento de preço

A Meta cobra por conversas, e não por mensagens, e lança a cobrança no meio de pagamento da sua própria Conta do WhatsApp Business. Respostas dentro da janela de atendimento de 24 horas são gratuitas. Abrir uma conversa fora dela exige um template e é cobrado.

Aparelhos vinculados

A Coexistência não é um aparelho vinculado e não usa nenhum. Um aparelho vinculado é o cliente comum logado em outro lugar, que é o que as ferramentas não oficiais automatizam e o que os termos do WhatsApp proíbem. Nada aqui usa esse mecanismo.

Limitações funcionais

Fixadas pela Meta, idênticas em todo provedor.

• Conversas em grupo não estão disponíveis pela API.
• Templates não podem ser enviados pelo app do celular, só pela API.
• O throughput de envio é fixo, em vez de crescer com qualidade e nível.
• O compartilhamento de histórico de conversas é decidido uma vez, durante o onboarding.

Elegibilidade

O número precisa satisfazer todas estas condições antes de conseguir conectar.

• Já estar ativo no app do WhatsApp Business, e não no app comum.
• Estar num Portfólio de Negócios ao qual você tenha acesso.
• Não estar já conectado ao app de outro provedor.

Notas operacionais

Coisas que são verdade depois de conectar e que é fácil passar batido.

• O app precisa ser aberto periodicamente, ou a Meta desconecta o lado da API.
• Uma desconexão desinstala o override de webhook junto com o app.
• A classificação de qualidade é consultada por polling, e não empurrada, então nada anuncia uma queda.
• Um token revogado parece idêntico a um número removido, se não houver uma segunda credencial.

Ressalva sobre a escolha da conta

Durante o Embedded Signup, o Portfólio de Negócios e a Conta do WhatsApp Business são escolhidos em passos separados. Escolher a conta errada vincula o número num lugar que você não pretendia, e movê-lo depois significa desconectar e rodar o fluxo inteiro de novo.

Decisões sem volta

Compartilhar o histórico de conversas existente é perguntado uma vez e não pode ser revisto. A sincronização também precisa começar dentro de 24 horas do onboarding e só pode rodar uma vez. As duas coisas produzem erros pouco familiares em vez de avisos quando são perdidas.

Desconectar ou reverter

Um número pode ser desconectado a qualquer momento, pelo painel ou pelo conector. O app do WhatsApp Business segue exatamente como antes, com as conversas e o histórico intactos, e nada no número em si fica permanentemente alterado por ter estado conectado.

Erros comuns

• Tratar a Coexistência como uma API diferente. Ela é a Cloud API com um onboarding diferente.
• Construir em torno de conversas em grupo. Elas ficam de fora em todo provedor.
• Achar que uma reconexão restaura o destino do webhook. Ela não restaura.

Perguntas frequentes

Continue lendo