O WhatsApp Business integra com o Jefacil por dois caminhos complementares:

1. Catálogo — os produtos do Jefacil vão pro Meta Commerce Manager (o mesmo catálogo que alimenta Instagram Shops e Facebook Shops), por feed automático ou por CSV.
2. Pedidos — quando um cliente compra pelo chat, o pedido cai no Jefacil como “pendente” pra ser convertido em venda.

Tudo fica em Integrações → WhatsApp, sempre referente à loja ativa no seletor do topo.

Catálogo automático por feed (recomendado)

Em vez de exportar e subir CSV a cada mudança, você cola uma URL no Commerce Manager e a Meta passa a buscar os produtos sozinha.

Em Integrações → WhatsApp → Feed automático, clique em Gerar link e copie a URL (ela aparece uma vez só — o token não é exibido de novo). Depois, no Commerce Manager:

1. Abra o catálogo → Itens do catálogo → Fontes de dados → Adicionar itens.
2. Escolha Feed de dados e depois Usar uma URL.
3. Cole a URL e defina a frequência (horária é o mínimo que a Meta oferece).
4. Moeda BRL.

A partir daí, preço e disponibilidade acompanham a loja sem você fazer nada. Entram os mesmos produtos do CSV: ativos e do tipo mercadoria.

É a mesma URL do Google Shopping. Se você já configurou o feed lá, é o mesmo link — e rotacionar ou desabilitar o token afeta os dois canais de uma vez.

O que o feed não resolve: não é tempo real. A Meta puxa no ciclo que você agendou, então uma venda no PDV leva até o próximo ciclo pra refletir no catálogo do chat.

Exportar catálogo pro Commerce Manager (CSV)

A alternativa manual ao feed — útil pra uma carga inicial ou quando você quer conferir o arquivo antes de subir.

Integrações → WhatsApp → Exportar catálogo (CSV).

O Jefacil gera um CSV no formato exato que o Meta espera (id, title, description, availability, condition, price, brand, link, image_link). Baixa o arquivo, sobe no Commerce Manager em Adicionar itens → Upload em massa → Importar arquivo.

O id do CSV é o código interno do produto no Jefacil (não o SKU). É o mesmo id que o feed automático publica, e é ele que volta no pedido do chat pra o Jefacil saber qual produto o cliente escolheu — por isso os dois caminhos podem conviver sem duplicar item no Commerce Manager.

Importante: a coluna image_link só é preenchida para produtos que têm foto no Jefacil. Produtos sem foto entram no Commerce Manager como “incompletos” e não aparecem no chat até ter imagem. Faça upload das fotos no Jefacil antes de exportar (edite o produto em Produtos → editar → Foto).

Importar catálogo do Commerce Manager

Se você já tem produtos no Commerce Manager e quer trazer pro Jefacil sem redigitar, use Integrações → WhatsApp → Importar catálogo (CSV).

Exporte o CSV pelo Meta, depois sobe no Jefacil. O que acontece:

• Produto existente (coluna id) — o Jefacil atualiza o produto (nome, descrição, preço). Ele casa primeiro pelo código interno e, se não achar, pelo SKU — assim funciona tanto com um CSV que saiu daqui quanto com uma planilha que você mesmo montou.
• Produto novo — cria o produto no catálogo e adiciona ao estoque da loja atual com saldo zero.
• Estoque não é alterado em updates. Novos produtos entram com stock=0 (você ajusta depois).
• Mudança de preço gera entrada no histórico (Relatórios → Histórico de preços).

Se alguma linha tem erro (SKU faltando, preço inválido), o Jefacil devolve 422 com a lista de erros — corrige no CSV e tenta de novo. Nada é parcialmente importado.

Pedidos recebidos

Quando um cliente abre seu catálogo do WhatsApp, escolhe produtos e envia o pedido pelo chat, a Meta manda um evento pro nosso webhook. O Jefacil monta o pedido e ele aparece em Pedidos, na aba WhatsApp — junto com os do balcão, do atacado e dos outros canais. O PDV avisa no topo quando tem pedido esperando.

Se algum item do pedido não estiver no catálogo desta loja, o Jefacil não chuta: o pedido não é montado e aparece numa faixa no topo de Pedidos, dizendo qual item não foi encontrado. Cadastre o produto e o próximo pedido entra sozinho; esse você lança à mão.

Configurar o webhook

Quem dá o play na configuração é o super admin (ou você, se rodar um Jefacil próprio):

1. No Meta Developer Console, em WhatsApp → Configuration → Webhook:
   • Callback URL: https://seu-app.com.br/api/webhooks/whatsapp
   • Verify token: qualquer string aleatória que bata com WHATSAPP_VERIFY_TOKEN no .env
   • Webhook fields: marque messages
2. Meta valida o token fazendo um GET (o Jefacil devolve o hub.challenge).
3. Sempre que chegar evento, o Jefacil valida o HMAC-SHA256 com WHATSAPP_APP_SECRET.

Associar um número à uma loja

Cada número WhatsApp Business tem um phone_number_id único. Você encontra esse ID no Meta Developer Console em WhatsApp → API Setup, logo abaixo do número.

No Jefacil, em Integrações → WhatsApp → Número do WhatsApp Business, cole o valor e salve. Isso roteia pedidos daquele número pra loja certa, e o selo ao lado passa de “Não conectado” pra “Conectado”.

Só o dono ou um administrador da empresa altera esse campo.

Converter pedido em venda

Em Pedidos → aba WhatsApp, cada linha mostra cliente, itens, total e data. Você confirma e fatura por ali mesmo, escolhendo a forma de pagamento — não precisa passar pelo PDV. Clicando em “Converter em venda”:

1. O Jefacil marca o pedido como CONVERTED.
2. Abre o PDV com o carrinho pré-preenchido — mapeando o SKU de cada product_retailer_id do pedido pro StoreProduct da loja.
3. Se algum item não bate com o estoque local, aparece um aviso com o código. Você adiciona manualmente ou ignora.
4. Segue o checkout normal do PDV (pagamento, NFC-e, etc.).

Descartar pedido

Se for pedido teste, spam ou compra inválida, clique em “Descartar”. O pedido vira DISMISSED e some da lista de pendentes. Não é apagado — fica no histórico pra auditoria.

Limitações conhecidas

• O catálogo nunca é tempo real. Com feed, a atualização chega no ciclo agendado pela Meta; com CSV, só quando você re-exporta e sobe de novo.
• Sem variações de produto (tamanho/cor). Um produto com grade sai como um item só, e pedido de produto com grade não converte sozinho no PDV — falta a numeração, que o catálogo do WhatsApp não carrega.
• Imagens não são enviadas no import do CSV — você faz upload direto no Jefacil (Produtos → editar → Foto).
• Não dá pra escolher quais produtos vão pro WhatsApp: vai o catálogo inteiro da loja (ativos, tipo mercadoria). A seleção por canal existe hoje só nos marketplaces.

Sem WhatsApp Business? Sem problema

O export CSV funciona igual pra Instagram Shops e Facebook Shops (mesmo formato do Commerce Manager). Ou use o feed público do Google Shopping — mesma loja alimenta os 3 canais com um clique a mais.