Jefacil Jefacil
Entrar Começar grátis

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

  1. Catálogo — CSV vai e volta entre Jefacil e Meta Commerce Manager (o mesmo catálogo que alimenta Instagram Shops e Facebook Shops).
  2. Pedidos — quando um cliente compra pelo chat, o pedido cai no Jefacil como “pendente” pra ser convertido em venda.

Exportar catálogo pro Commerce Manager

Canais → WhatsApp → Exportar p/ WhatsApp.

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 SKU do Jefacil — manter esse mapeamento é o que permite o import reverso funcionar depois.

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 Canais → WhatsApp → Importar do WhatsApp.

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

  • SKU existente (coluna id) — o Jefacil atualiza o produto (nome, descrição, preço).
  • SKU 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 ingere em Pedidos recebidos (PENDING) e notifica na tab WhatsApp.

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 Configurações → Lojas → editar loja → WhatsApp Business phone number ID, cole o valor. Isso roteia pedidos daquele número pra loja certa.

Converter pedido em venda

Na lista de Pedidos recebidos, cada linha mostra: cliente, telefone, itens, total e data. 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 SKU não bate com o estoque local, aparece um aviso: “SKU-X não encontrado”. 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

  • Sem sync automático de estoque. Se você muda o saldo no Jefacil, não empurra pro Commerce Manager — você precisa re-exportar o CSV e re-subir.
  • Sem variações de produto no export (tamanho/cor). Se o produto tem variações, cada variação vira um item separado no Commerce Manager (mapeie no seu catálogo do Jefacil como SKUs distintos).
  • Imagens não são enviadas no import do CSV — você faz upload direto no Jefacil (Produtos → editar → Foto).

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.