Coexistence for WhatsApp — o guia completo

Requer Odoo Enterprise 17, 18, 19 ou 20. Estende o app nativo de WhatsApp do Odoo, que só existe no Enterprise, então não instala no Odoo Community. Odoo.sh e on-premise; não disponível no Odoo Online. A instância precisa estar acessível pela internet por HTTPS, porque a Meta entrega as mensagens recebidas a um webhook no seu próprio domínio.

Mantenha o número no celular. Coloque o Odoo por cima.

O caminho normal para a Cloud API do WhatsApp pede que você abra mão do número: uma vez migrado, ele deixa de funcionar no app WhatsApp Business do celular. Para um negócio cujo histórico de vendas inteiro vive nesse app, isso é impeditivo.

Coexistence é a resposta oficial da Meta, e este módulo a traz para o Odoo. Você escaneia um QR code e, a partir desse momento, o mesmo número funciona nos dois lugares ao mesmo tempo: sua equipe continua respondendo pelo celular e o Odoo vê tudo.

Como funciona

• As mensagens que sua equipe digita no celular aparecem no Odoo como mensagens enviadas na conversa do cliente, então o histórico fica completo.
• As mensagens que os clientes enviam chegam ao Odoo pelo webhook, exatamente como em um número dedicado de Cloud API.
• O Odoo também pode enviar: respostas dentro da janela de 24 horas e modelos aprovados.
• Seus contatos e até seis meses de histórico podem ser importados uma vez, na conexão, com a sincronização única da Meta.

O que você recebe

• O número fica no celular. Sua equipe continua respondendo pelo app WhatsApp Business. Nada é migrado.
• Conexão por QR. O Embedded Signup da Meta dentro do Odoo. Sem SMS, sem número novo, sem IDs para digitar à mão.
• Respostas do celular espelhadas no Odoo. Os ecos enviados caem na mesma conversa, deduplicados pelo id da mensagem, então nada aparece duas vezes.
• Tudo no Discuss. Recebidas e enviadas em canais normais do Discuss, em contatos normais.
• Importação única de histórico. Contatos e até seis meses de conversas, importados na conexão.
• Zero configuração de webhook. A conta gera sua própria Callback URL e seu Verify Token e se inscreve sozinha.
• Vários números, uma base de dados. Cada número é sua própria conta, com seus usuários e sua restrição de empresa.
• Sete idiomas. Inglês, espanhol, português, italiano, francês, alemão e árabe.

Um passeio em três telas

Requisitos

Duas formas de ter permissão para usar o Coexistence

O WhatsApp Coexistence é ativado pelo Embedded Signup da Meta, que só funciona com um app registrado na Meta como Tech Provider e aprovado para o recurso WhatsApp Business App Onboarding. Um app de desenvolvedor comum não consegue. Há duas formas de cumprir esse requisito:

Com uma licença da RC Studio. Você compra uma chave de licença, cola no Odoo e conecta escaneando um QR code. Nada para registrar na Meta, sem revisão de app, sem liberação de domínios. A licença é cobrada separadamente deste módulo e não está incluída na compra.

Com o seu próprio app de Tech Provider, ou o de um terceiro. Este módulo funciona com qualquer um deles. Você informa o App ID, o App Secret e a Login Configuration que o seu provedor lhe dá, e a conexão passa a rodar pelo app da Meta dele em vez do da RC Studio. Essas credenciais são emitidas por esse provedor, não pela RC Studio. A RC Studio não pode obtê-las por você e não se responsabiliza se o seu provedor não as entregar, revogá-las, cobrar à parte por elas ou não ter sido aprovado pela Meta para o recurso WhatsApp Business App Onboarding. Confirme com o seu provedor que você receberá um App ID, um App Secret e uma Login Configuration de coexistence antes de comprar este módulo.

Modo A · Coexistence com licença da RC Studio (recomendado)

Toda a configuração é: colar a chave, clicar em Conectar, escanear o QR. Nada para registrar na Meta, sem revisão de app e sem domínio para liberar, porque o diálogo do Facebook roda na própria página da RC Studio.

As três etapas que você realmente vê, no modo licença

A Meta permite uma única sincronização de contatos e uma única de histórico por conexão. Se falharem, a única forma de repeti-las é desvincular o número e conectá-lo de novo.

Modo B · Coexistence com o seu próprio app de Tech Provider

Funciona com o seu próprio app ou com o de qualquer outro provedor. Nos dois casos o app precisa estar aprovado pela Meta para o recurso WhatsApp Business App Onboarding, e o App ID, o App Secret e a Login Configuration são entregues a você por esse provedor. A RC Studio não pode obtê-los e não se responsabiliza se o provedor não os entregar.

• Deixe a licença da RC Studio vazia.
• Preencha App ID e App Secret do seu app.
• Preencha Meta Login Configuration com o ID da sua configuração de «Facebook Login for Business».
• Adicione o seu domínio do Odoo ao app da Meta, em Domínios do app e Domínios permitidos para o SDK de JavaScript. Esta etapa não tem API e precisa ser feita à mão para cada domínio.
• Clique em Conectar por Coexistence e siga com o QR.

No modo B não há janela da RC Studio: o diálogo do Facebook abre direto da sua própria página do Odoo, sobre o seu próprio app.

Webhook

Não há nada para colar na Meta, em nenhum dos dois modos. A conta gera sua própria Callback URL e seu Webhook Verify Token e os registra na Meta como parte da conexão do número, inscrevendo-se no campo messages e em smb_message_echoes. Se a sua URL do Odoo mudar algum dia, o botão Reinscrever webhook no formulário da conta aponta a Meta para a nova, e Remover override do webhook desfaz isso.

Perfis

Onde as conversas ficam

No Discuss, exatamente onde o app de WhatsApp do próprio Odoo as coloca: um canal por cliente no número que recebeu a mensagem. Você responde pelo Discuss com anexos, emoji, citações e reações. Este módulo muda como o número se conecta, não onde você responde.

Uma lista de conversas com busca, filtro de não lidas e seletor por número não faz parte deste módulo. Ela vem de WhatsApp: Single Thread and Inbox, vendido e instalado à parte; WhatsApp: Account Icon on Threads adiciona o ícone colorido por número. O Coexistence funciona sem nenhum dos dois.

Responder pelo Discuss

As mesmas conversas aparecem no Discuss, na categoria WhatsApp — útil para quem já vive no Discuss e prefere não trocar de tela. Quando um colega responde pelo celular, o Coexistence espelha essa mensagem no mesmo canal como mensagem enviada.

Enviar um modelo a partir de um documento

Toda cotação, fatura, ordem de entrega e contato tem um botão WhatsApp no chatter. Escolha o modelo, revise a pré-visualização com os dados já substituídos e envie. A mensagem fica no chatter do documento e na conversa do cliente.

Envios automáticos

Configurações → Técnico → Ações de servidor → Novo, tipo Enviar WhatsApp, escolha o modelo. Dispare a partir de uma regra de automação — na confirmação do pedido, por exemplo — ou pelo menu de ações de uma visão de lista para enviar a muitos registros de uma vez.

Estados e novas tentativas

WhatsApp → Mensagens guarda cada mensagem com o seu estado: na fila, enviada, entregue, lida, respondida, erro ou devolvida, com o código de erro da Meta quando há. As que falharam podem ser reenviadas selecionando-as e executando WhatsApp: reenviar mensagens com falha. Um cron tenta a fila novamente a cada hora.

A janela de 24 horas e o descadastro

Vinte e quatro horas depois da última mensagem do cliente, o WhatsApp só permite modelos. O editor se bloqueia e oferece um botão para reabrir a conversa com um modelo. Se um cliente responder STOP, UNSUBSCRIBE ou STOP PROMOTIONS, o Odoo coloca o número na lista de bloqueio e para de enviar para ele. Essas são as palavras que o app de WhatsApp do Odoo reconhece.

Perguntas frequentes

Preciso usar a RC Studio como meu Tech Provider? Não. Você tem três opções e o módulo suporta todas. Um: usar o seu próprio app — você se registra na Meta, obtém a aprovação para o recurso WhatsApp Business App Onboarding e se torna Tech Provider. Dois: usar qualquer Tech Provider terceiro; o módulo funciona com qualquer um. Três: usar o serviço de Tech Provider da RC Studio, cobrado à parte deste módulo. O que importa nas opções um e dois é que o provedor precisa entregar a você um App ID, um App Secret e uma Login Configuration de coexistence. Sem esses três valores o Embedded Signup não roda. A RC Studio não pode obtê-los por você e não se responsabiliza se um provedor terceiro se recusar, revogá-los ou cobrar à parte por eles.

Funciona no Odoo Online (SaaS)? Não. O Odoo Online não aceita módulos de terceiros. O Enterprise roda no Odoo.sh e on-premise. Sua instância precisa estar acessível por HTTPS público, porque a Meta entrega as mensagens a um webhook no seu domínio.

Posso continuar usando o número no celular? Sim — esse é todo o sentido do Coexistence. O mesmo número vive no app WhatsApp Business e na Cloud API ao mesmo tempo. Sua equipe continua respondendo pelo celular e o Odoo vê tudo: as mensagens recebidas e as respostas digitadas no celular, que chegam como ecos e aparecem na conversa como mensagens enviadas. No modo Cloud API dedicado, o número deixa de funcionar no celular.

Perco meu histórico ao conectar? Com o Coexistence, a Meta deixa você importar seus contatos e até seis meses de histórico uma vez, durante a conexão. A Meta permite uma única sincronização de contatos e uma única de histórico por conexão; se falharem, a única forma de repeti-las é desvincular o número e conectá-lo de novo.

Há algum limite que eu deva conhecer antes de comprar? Sim, e é da Meta, não do módulo. As mensagens que sua equipe digita no celular saem como estão e não podem ser interceptadas nem reescritas; a API as recebe depois, como ecos. Se você precisa controlar 100% do tráfego de saída, a escolha certa é a Cloud API dedicada, não o Coexistence. O app da Meta também tem uma cota de chamadas por hora: se acabar, é preciso esperar, e tentar de novo na hora só estende a janela.

Quanto a Meta cobra pelas mensagens? A Meta cobra por mensagem entregue. As mensagens de modelo têm uma tarifa que depende da categoria (marketing, utilidade, autenticação) e do país do cliente. A partir de 1º de outubro de 2026 a Meta passa a cobrar também as respostas livres que você envia dentro da janela de 24 horas (mensagens de serviço), na mesma tarifa das mensagens de utilidade e autenticação; até lá são gratuitas. Receber mensagens continua gratuito. Os detalhes e as tabelas de preço estão na página de preços da Meta. A RC Studio não cobra por mensagem.

O módulo envia meus dados para um servidor da RC Studio? Só na conexão, e só o mínimo. As mensagens nunca passam por nós, nem as que você envia nem as que recebe. O token comercial vive na sua própria base de dados, então o seu Odoo fala direto com a Meta, e ao conectar o número o nosso serviço registra na Meta o endereço do seu Odoo como destino das entregas: a Meta entrega diretamente à sua instância, em uma URL secreta que só a Meta e o seu Odoo conhecem. Nosso serviço nem sequer expõe um endpoint para enviar ou receber mensagens. O que passa por nós é a conexão: o app secret da Meta é nosso e nunca é copiado para a sua base de dados, então somos nós que trocamos a autorização da Meta pelo seu token de acesso e o entregamos a você. É só isso. Se preferir que a RC Studio não participe nem da conexão, o módulo funciona exatamente igual com o seu próprio app da Meta.

Quais dados a RC Studio guarda? Três coisas, e só enquanto o número está conectado: o app secret da Meta (guardado por nós justamente para nunca precisar ser copiado na sua base de dados), a chave de licença que emitimos para você e uma cópia criptografada do seu token de WABA, necessária para reinscrever o webhook quando a sua URL do Odoo muda e para disparar a sincronização inicial. Quando você nos pede para desconectar o número, a inscrição do nosso app é removida da sua WABA e o registro inteiro é apagado, token criptografado incluído. Você também pode remover o override do webhook por conta própria a qualquer momento, pelo botão Remover override do webhook no formulário da conta. Seu token comercial também fica no seu próprio Odoo, e é isso que torna o envio de mensagens direto e independente do nosso serviço.

Nosso número e nossa WABA continuam no nosso próprio Business Portfolio? Sim, sempre. O número e a WABA são seus e ficam no seu Business Portfolio. Um Tech Provider só atua como ponte entre a sua WABA e os serviços da Meta; nunca assume a propriedade de nada. O Meta Business Suite também continua funcionando normalmente — o Coexistence adiciona a Cloud API ao lado das ferramentas da Meta, não as substitui.

Podemos testar primeiro em staging e depois ir para produção? Sim, e essa é a ordem recomendada. No celular não há interrupção nenhuma. Do lado do Odoo, ir para produção muda a URL da sua instância e com ela o endereço onde a Meta entrega os eventos, então a licença precisa ser renovada e o webhook reinscrito na nova URL — o módulo tem um botão para isso. Nos poucos minutos que isso leva, o Odoo para de enviar e receber; o celular não. Note que a importação única de histórico não se repete ao mover o número.

Posso usar modelos que eu já tinha aprovados na Meta? Sim. Use o botão Sincronizar modelos no formulário da conta.

E se a Meta rejeitar a sincronização com o erro 133010? Significa que o número não foi vinculado como coexistence. O botão Diagnosticar número no formulário da conta verifica isso em uma única chamada e diz se a conexão precisa ser refeita.

Quais versões do Odoo são suportadas e em que idiomas está a interface? Odoo 17.0, 18.0, 19.0 e 20.0 — cada versão é comprada separadamente na loja do Odoo. A interface vem em inglês, espanhol, português, italiano, francês, alemão e árabe.

Suporte

O suporte está incluído para qualquer pessoa que compre o módulo. A instalação e a configuração do lado da Meta podem ser contratadas separadamente. Use a página de suporte deste módulo no Odoo Apps para tudo relacionado à sua compra: chega direto a nós e mantém o histórico vinculado à sua licença.

Trânsito de dados: mensagens e mídias viajam diretamente entre a sua instância do Odoo e a Cloud API da Meta, em qualquer modo de conexão. Com licença da RC Studio, o serviço de Tech Provider da RC Studio participa apenas na conexão do número: emite o token de acesso da Meta e registra o endereço do seu Odoo como destino das entregas. A RC Studio não recebe nem armazena conteúdo de mensagens. Política de privacidade.

WhatsApp é uma marca da Meta Platforms, Inc. A RC Studio não é afiliada, endossada nem patrocinada pela Meta. Este módulo é publicado sob a Odoo Proprietary License v1.0 (OPL-1).