🏢 Plano avançado — o aplicativo WhatsApp com a API oficial da Meta faz parte da edição Enterprise e não vem no odoo PME padrão. O Odoo mantém um ambiente personalizado Enterprise para quem precisa dele; veja como pedir no fim deste artigo.
Quando o volume cresce, mandar mensagem pelo celular de cada vendedor deixa de funcionar: o cliente conversa com números diferentes, as respostas se perdem quando alguém sai de férias e ninguém consegue avisar cem clientes de uma vez que a fatura venceu. A integração oficial com a API do WhatsApp Business resolve isso com um número único da empresa ligado ao sistema.
Com ela o sistema envia mensagens sozinho a partir de modelos aprovados pela Meta (confirmação de pedido, fatura, lembrete, ingresso de evento), recebe as respostas dos clientes numa conversa dentro do próprio sistema e distribui essas conversas entre os usuários responsáveis. Em troca, a configuração é mais técnica e a Meta cobra pelas mensagens.
❗ Importante
A integração só funciona com uma conta da Plataforma WhatsApp Business (API). O WhatsApp pessoal e o aplicativo WhatsApp Business do celular não servem, e o número usado na API deixa de funcionar no aplicativo do celular. Se você só quer mandar cotações e faturas pelo seu próprio WhatsApp, use o artigo WhatsApp Web (Comunidade), que não tem custo nem cadastro na Meta.
Antes de tudo: o que é esta integração
Esta não é uma função que se liga com um clique, nem o WhatsApp do celular aberto dentro do sistema. É uma integração entre dois sistemas: o odoo PME de um lado e a plataforma oficial de WhatsApp da Meta (dona do WhatsApp) do outro. Os dois conversam por uma conexão técnica (API), com códigos de acesso, regras de aprovação e cobrança da própria Meta.
Pense na emissão de boleto registrado: o sistema gera o boleto, mas quem registra e cobra é o banco, e antes de começar a empresa precisa ter conta no banco, convênio aprovado e as chaves de acesso configuradas. Aqui é igual. O sistema monta e registra as mensagens; quem entrega, aprova os textos e cobra é a Meta.
❗ Em uma frase
WhatsApp Enterprise = conta empresarial na Meta + número exclusivo da empresa + conexão técnica com o sistema + modelos de mensagem aprovados pela Meta + cobrança da Meta por mensagem. Sem qualquer uma dessas partes, a integração não funciona.
Qual das duas soluções é a sua?
A maioria das empresas que só quer mandar cotação, pedido e fatura para o cliente pelo WhatsApp não precisa desta integração. Use a tabela para decidir antes de seguir.
| WhatsApp Web (Comunidade) | WhatsApp Business API (Enterprise) | |
| Para que serve | O vendedor manda o documento pelo WhatsApp dele | A empresa atende e dispara mensagens por um número oficial ligado ao sistema |
| Quem envia | A pessoa, apertando enviar no WhatsApp | O próprio sistema, inclusive em lote e de forma automática |
| Número | O número que cada um já usa | Um número exclusivo da empresa (deixa de funcionar no app do celular) |
| Respostas do cliente | Ficam no celular | Chegam dentro do sistema, para a equipe |
| Cadastro na Meta | Não precisa | Obrigatório: conta empresarial, app, verificação e forma de pagamento |
| Custo por mensagem | Nenhum | Cobrado pela Meta, no cartão da empresa |
| Implantação | Pronta em minutos | Projeto técnico, com o Odoo acompanhando |
| Artigo | WhatsApp Web (Comunidade) | Este artigo |
Quem faz o quê
Boa parte das dúvidas vem de achar que tudo acontece dentro do sistema. Não acontece: cada parte tem a sua responsabilidade.
| Parte | Responsabilidade |
| Sua empresa | Criar e manter a conta no Meta Business, comprovar a empresa quando a Meta pedir, disponibilizar um número exclusivo, cadastrar a forma de pagamento e pagar a Meta pelas mensagens. |
| Meta | Entregar as mensagens, aprovar ou recusar os modelos de texto, definir limites de envio e cobrar pelo uso. |
| Odoo | Disponibilizar o ambiente Enterprise, fazer a conexão técnica entre o sistema e a Meta, configurar os primeiros modelos e treinar a equipe. |
| Sistema | Montar as mensagens com os dados dos documentos, enviar pela Meta, receber as respostas e guardar o histórico. |
O que você precisa ter antes de pedir
☐ Plano com o ambiente Enterprise do Odoo (fale com [email protected]).
☐ Uma conta pessoal no Facebook do responsável, que vai administrar a conta da empresa na Meta.
☐ Documentos da empresa (CNPJ, contrato social, comprovante de endereço) para a verificação da Meta.
☐ Um número de telefone exclusivo, que não será mais usado no aplicativo do celular.
☐ Um cartão de crédito empresarial para cadastrar na Meta.
☐ Site da empresa com página de política de privacidade.
☐ A lista das mensagens que você quer enviar (ex.: confirmação de pedido, fatura, lembrete de vencimento).
💡 Não domina os acessos da Meta? O Odoo configura por você
Sua empresa não precisa entregar senha. No Meta Business Suite › Configurações › Usuários › Parceiros, clique em Adicionar › Dar a um parceiro acesso aos seus ativos, informe o ID do portfólio do Odoo 1415504896016430 (Odoo PME) e compartilhe a conta do WhatsApp Business e o app com controle total. O Odoo passa a enxergar esses itens no próprio painel e faz a configuração por aqui. Sua empresa continua dona da conta e pode remover o acesso a qualquer momento. Depois de compartilhar, avise o Odoo em [email protected].
💡 Como o Odoo conduz
Com a lista acima pronta, o Odoo agenda a implantação e faz a configuração técnica junto com o responsável pela conta na Meta. Os passos abaixo mostram o que acontece nessa implantação; eles servem para você entender o processo e acompanhar, não para fazer sozinho.
Como a conversa acontece
Existem dois caminhos. No primeiro, a empresa começa: o sistema envia um modelo aprovado a um ou vários clientes e, se o cliente responder, abre-se uma conversa no aplicativo Mensagens do sistema. No segundo, o cliente começa, escrevendo para o número público da empresa, e o sistema abre um chat com os usuários responsáveis por aquele canal. Mensagens livres, fora de modelo, só podem ser mandadas enquanto a conversa com o cliente está aberta.
💡 Dica
Empresas com áreas distintas (vendas, financeiro, suporte) costumam criar uma conta de WhatsApp por área, cada uma com o seu número e os seus responsáveis.
Visão geral da implantação
A maior parte do trabalho acontece no ambiente da Meta. O sistema só recebe os códigos gerados lá e devolve dois dados para a Meta saber para onde mandar as mensagens recebidas.
Os seis passos da conexão, na ordem em que são feitos.
1. Conta no Meta Business
No Meta Business Suite, clique em Criar conta, informe o nome da empresa, o administrador e um e-mail corporativo, e confirme o e-mail que a Meta envia.
⚠️ Atenção
A Meta exige uma conta pessoal do Facebook com pelo menos uma hora de existência para criar a conta comercial. Se o perfil for recém-criado, a tentativa dá erro. Depois, sempre que for configurar, troque para a conta comercial pelo seletor de contas no canto superior direito.
2. App de desenvolvedor
Em Meta for Developers › Meus apps, vá em Meus apps › Criar app. Dê um nome (por exemplo, o nome do seu sistema), informe o e-mail de contato, escolha o caso de uso Outros e o tipo Comercial, e ligue o app ao portfólio da sua conta Meta Business. Criado, ele aparece na lista de apps com o tipo Business.
Lista de apps no Meta for Developers · códigos mascarados.
⛔ Cuidado
O nome do app não pode conter marcas da Meta: a palavra "WhatsApp" no nome faz o cadastro ser recusado. E se a conta comercial estiver bloqueada para anúncios, o app não pode ser criado até o bloqueio ser resolvido no Meta Business Suite.
3. Produto WhatsApp e mensagem de teste
No painel do app, em Adicionar produtos, clique em Configurar no bloco WhatsApp e escolha a conta Meta Business. A Meta entrega um número de teste, que pode mandar mensagens de graça para até cinco números cadastrados. Em WhatsApp › Configuração da API, cadastre o seu celular em Para, confirme o código recebido e clique em Enviar mensagem. Se a mensagem chegar, a API está funcionando. É nesta mesma tela que ficam o token de acesso, o ID do número de telefone e o ID da conta do WhatsApp Business usados no passo seguinte.
WhatsApp › Configuração da API no Meta, com os IDs mascarados.
Guia da Meta: primeiros passos da Cloud API.
4. Conta do WhatsApp Business no sistema
No sistema, abra WhatsApp › Configuração › Contas do WhatsApp Business e clique em Novo. Copie da tela Configuração da API do Meta os códigos abaixo. O segredo do aplicativo fica em Configurações do app › Básico › Segredo do app, no Meta.
| No Meta | No sistema |
| ID do número de telefone | ID do número de telefone |
| ID da conta do WhatsApp Business | ID da conta |
| ID do app | ID do aplicativo |
| Token de acesso temporário | Token de acesso |
| Segredo do app | Segredo do aplicativo |
Clique em Testar conexão. Com tudo certo, aparece uma mensagem verde e o bloco Receber mensagens passa a mostrar a URL de retorno e o token de verificação. Em Controle você escolhe quem é avisado das novas conversas e em quais empresas a conta pode ser usada.
Conta do WhatsApp Business configurada, com os códigos mascarados · dados ilustrativos.
⛔ Cuidado
Token de acesso, segredo do aplicativo e token do webhook dão controle total do número da empresa. Nunca mande esses códigos por e-mail ou chat, nem os mostre em prints.
5. Webhook: para receber as respostas
De volta ao Meta, em WhatsApp › Configuração (ou Webhooks no menu do app), clique em Editar, cole a URL de retorno de chamada e o Token de verificação copiados do sistema e clique em Verificar e salvar. Depois, em Campos do webhook › Gerenciar, assine: account_update, message_template_quality_update, message_template_status_update, messages e template_category_update.
WhatsApp › Configuração no Meta: URL de retorno, token de verificação e campos assinados · valores mascarados.
Guia da Meta: configurar webhooks.
ℹ️ Nota
A URL de retorno precisa ser pública, com https e o domínio do seu sistema. Um ambiente que só abre na rede interna da empresa não recebe as mensagens da Meta.
6. Número definitivo, token fixo e app ativo
Em Configuração da API › Adicionar número de telefone, informe o nome comercial, o site, o país, o perfil (nome de exibição, fuso, categoria) e o número que será usado. A Meta confirma o número por SMS ou ligação e pede uma forma de pagamento, que é onde as mensagens serão cobradas.
O token temporário expira em poucas horas. Para produção, crie um usuário do sistema (guia da Meta) em Configurações do negócio › Usuários › Usuários do sistema, dê a ele controle total do app e gere um token sem validade com as permissões business_management, whatsapp_business_messaging e whatsapp_business_management. Troque o token na conta dentro do sistema.
Por fim, no painel do app, mude o Modo do app de Desenvolvimento para Ativo. Antes disso a Meta exige a URL da sua política de privacidade em Configurações do app › Básico.
⚠️ Atenção
Enquanto o app estiver em Desenvolvimento, o sistema só consegue falar com os números de teste cadastrados. E se o número ficar preso em "Pendente", gere de novo o token temporário escolhendo Participar de todas as contas do WhatsApp atuais e futuras.
Modelos de mensagem
Toda mensagem que a empresa inicia precisa sair de um modelo aprovado pela Meta. Os modelos ficam em WhatsApp › Modelos. A lista mostra em que documento cada um é usado e a situação: Rascunho, Pendente (em análise pela Meta) ou Aprovado.
Modelos de WhatsApp com a situação de aprovação · dados ilustrativos.
No modelo você define a conta, o documento em que ele se aplica (pedido de venda, fatura, contato, oportunidade), o campo de telefone usado, o idioma, o cabeçalho (texto, imagem, vídeo, documento ou localização) e a categoria. Na aba Corpo vai o texto, com marcadores numerados: {{1}}, {{2}} e assim por diante. Na aba Variáveis cada marcador é ligado a um campo do documento ou ao link do portal. Na aba Botões entram respostas rápidas, link para site ou ligação.
Modelo de confirmação de pedido com os marcadores ligados aos campos do pedido · dados ilustrativos.
| Categoria | Quando usar |
| Utilidade | Mensagens sobre um pedido, fatura, conta ou solicitação específica do cliente |
| Marketing | Promoções, novidades e qualquer mensagem que não seja utilidade nem autenticação |
| Autenticação | Senhas de uso único para login ou confirmação de transação |
Pronto o modelo, clique em Enviar para aprovação. Ele fica Pendente até a Meta decidir e o administrador recebe um e-mail com o resultado. Os modelos também podem ser criados e acompanhados no Gerenciador do WhatsApp › Modelos de mensagem. Aprovado, use Sincronizar modelos na conta (ou Sincronizar modelo no próprio modelo) para o sistema passar a oferecê-lo.
⛔ Cuidado
Categoria errada é o motivo mais comum de rejeição: um lembrete com oferta de desconto, por exemplo, é Marketing e não Utilidade. E alterar o documento de aplicação ou o campo de telefone de um modelo já aprovado pode gerar erro; o campo de telefone deve apontar sempre para Telefone ou Celular.
Quanto custa
O sistema não cobra por mensagem, mas a Meta sim. As mensagens de modelo são cobradas conforme a categoria (marketing costuma ser a mais cara, utilidade e autenticação mais baratas) e o país do destinatário, direto na forma de pagamento cadastrada no Meta Business. A tabela de preços é da Meta e muda com o tempo; consulte a página de preços da Plataforma WhatsApp Business antes de planejar campanhas.
⚠️ Atenção
A Meta pode pedir a verificação da empresa, com envio de documentos, para liberar volumes maiores ou permissões avançadas. Separe contrato social e comprovante de endereço antes de começar (verificação de empresa na Meta).
Problemas comuns
| Mensagem | O que fazer |
| Erro 190: a sessão expirou | O token temporário venceu. Gere o token fixo pelo usuário do sistema e troque na conta. |
| Erro 100: solicitação não suportada | O token foi gerado por um usuário do sistema sem perfil de administrador. Crie um usuário do sistema Admin. |
| Modelo duplicado não é permitido | Há modelos com o mesmo nome no sistema e na Meta. Renomeie no sistema e sincronize de novo. |
| As respostas não chegam | Confira a URL de retorno, o token de verificação e os campos assinados no webhook. |
| Falha no envio | Em WhatsApp › Mensagens, exiba as colunas Tipo de falha e Motivo da falha. |
Perguntas frequentes
Posso usar o número que já está no celular da empresa?
Pode, migrando-o para a API. A partir daí ele deixa de funcionar no aplicativo do celular e as conversas passam a ser feitas pelo sistema.
Quem vê as mensagens que chegam?
Os usuários indicados em Notificar usuários na conta. Depois que alguém responde, a conversa fica com quem está nela; se ninguém responder em 15 dias, uma nova mensagem do cliente volta a avisar todos.
Dá para mandar um modelo para vários clientes de uma vez?
Sim, desde que o envio múltiplo esteja liberado no modelo.
É complicado?
A implantação é técnica e depende da Meta (verificação, número e aprovação dos modelos), por isso é conduzida pelo Odoo. Depois de pronta, o uso no dia a dia é simples: escolher o modelo e enviar.
Posso ligar isso sozinho no meu odoo PME?
Não. O odoo PME padrão não traz este recurso; ele existe no ambiente Enterprise do Odoo e é ativado por implantação. Se o que você precisa é só mandar documentos pelo seu WhatsApp, use o WhatsApp Web (Comunidade).
Quanto tempo leva?
Depende principalmente da Meta: a verificação da empresa e a aprovação dos modelos costumam ser o que mais demora. A parte do Odoo é feita numa sessão de implantação.
Ambiente personalizado Enterprise
Este recurso existe num ambiente personalizado Enterprise mantido pelo Odoo. Para verificar se ele atende a sua empresa ou ativá-lo num plano avançado, envie um e-mail para [email protected].
Referência: documentação oficial do aplicativo WhatsApp (edição 19), adaptada para o odoo PME. Telas de um ambiente Enterprise com códigos e nomes mascarados.