ConnectWiz + WooCommerce

Integração no ar

Sincronização com o WooCommerce nos dois sentidos — e um contrato de propriedade dos dados

A maioria das “integrações com o Woo” é um botão de importar e uma reza. Esta aqui é uma sincronização governada, nos dois sentidos, em que você decide, domínio de dado por domínio de dado, qual sistema é dono da verdade — e todo conflito cai em um registro em vez de sobrescrever em silêncio.

Pareamento em um clique Propriedade campo a campo Conflitos em um registro
WooCommerce × ConnectWiz
Ensaie antes de valer
Produtos, imagens e variações entrando
Propriedade: Woo / aqui / os dois — você decide
Conflito detectado → registro, nova tentativa
30+
Campos levados por produto — imagens, janelas de promoção, GTINs, tags, up-/cross-sell, variações
15 min
Validade do link de pareamento — o aperto de mão da conexão expira em vez de ficar por aí
4
Tópicos de webhook provisionados automaticamente — mudanças de produto, pedido e cliente entram sozinhas
2.000
Produtos por rodada de importação — um teto declarado, não uma surpresa na linha 2.001

E-commerce

O que faz, exatamente

Pareamento em um clique

O fluxo padrão de autorização do WooCommerce provisiona chaves de API e webhooks automaticamente — sem ritual de copiar chave, sem checklist de webhook.

Importação profunda

Imagens, árvores de categoria, preço normal e promocional com as respectivas janelas, GTINs, tags, upsells e cross-sells, preços e imagens das variações — o catálogo chega inteiro, não como um esqueleto de nome e preço.

Escrita de volta de verdade

As edições de produto feitas aqui podem voltar gravadas para o Woo — governadas por uma chave para cada operação e com modo de ensaio, para você ver o que mudaria antes que algo mude.

Propriedade campo a campo

Você escolhe, domínio por domínio: o dado mora no Woo, mora aqui, ou sincroniza nos dois sentidos. Os campos de quem manda do outro lado aparecem só para leitura, com o motivo na tela — sem o caos de dois donos.

Um registro de conflitos

As sincronizações que falham ou conflitam caem em um registro visível, com resolver e tentar de novo — nunca uma sobrescrita silenciosa descoberta na hora do inventário.

Os pedidos entram no fluxo

Os pedidos do Woo aparecem com a origem marcada, ao lado dos pedidos da loja no chat, da IA e da API — uma só verdade de pedido em todas as superfícies.

Por dentro

A engenharia de sincronização que a maioria das integrações pula

Um aperto de mão paranoico no pareamento

O link de conexão expira em 15 minutos, o callback é marcado como consumido antes de qualquer outra coisa para nunca sofrer replay com credenciais antigas — e a URL da loja usada é a que você digitou, nunca a que um callback alega.

À prova de retentativas, de propósito

O Woo renumera os IDs de entrega a cada retentativa, então a deduplicação ignora esses IDs de propósito e usa o conteúdo da mensagem como chave. Na saída, a chave de idempotency viaja nos próprios metadados do pedido e é reencontrada por busca — porque o caso perigoso é a escrita que chegou enquanto a resposta se perdeu.

Relações em uma segunda passada

Upsells e cross-sells chegam como IDs da loja apontando para produtos que talvez ainda não existam — por isso são resolvidos em uma segunda passada, depois que o catálogo chega, e a árvore de categorias é buscada à parte, porque o payload de um produto só nomeia as folhas.

Moeda lida uma vez, do jeito certo

O Woo publica a moeda por pedido e nunca por produto — então a moeda da loja é lida uma vez, nas configurações da própria loja, antes de o catálogo importar, em vez de ser adivinhada linha a linha.

Um mapa de status conservador

Os envios de status de entrega só são mapeados onde os vocabulários realmente batem; um pedido “devolvido” nunca é traduzido à força — em vez disso, chega a um humano como nota do pedido. E as notas de status são publicadas com a notificação ao cliente desligada, para o Woo não mandar e-mail duas vezes para o seu cliente.

O que você digitou prevalece

Um campo que uma pessoa editou à mão aqui nunca é sobrescrito por uma importação — a sincronização respeita o humano, e diz isso no cartão de origem de cada item.

Configuração

Como se conecta

01

Pareie a loja

Clique em conectar, aprove no admin do seu WooCommerce — as chaves e os webhooks são provisionados para você.

02

Escolha quem é dono

Escolha, domínio de dado por domínio de dado, quem é dono da verdade: o Woo, o ConnectWiz, ou os dois sentidos.

03

Ensaie e depois coloque no ar

Rode as operações de escrita de volta em modo de ensaio primeiro; passe para valendo quando o diff estiver do jeito certo.

Melhor em conjunto

Com o que se combina

Plugin para WordPress

O plugin autentica no chat os clientes Woo que já estão logados — a mesma pessoa que a sincronização já conhece, com os pedidos junto, sem novo cadastro.

Feeds de produto

O catálogo importado pode ser publicado como feed do Google Shopping / Meta Commerce — uma variação por linha, itens pulados com o motivo declarado, sem conversão de moeda inventada. Veja o Commerce.

Wiz + flows

A IA responde “cadê o meu pedido?” com os dados ao vivo da loja, e os flows conseguem reagir a eventos de commerce — a sincronização é o chão em que todo o resto se apoia.

Segurança e garantias

As garantias chatas

Chaves provisionadas, nunca coladas

No fluxo wc-auth, é a sua loja que entrega as chaves para a gente do lado do servidor — criptografadas em repouso, sem ritual de copiar e colar para um humano vazar.

Todo webhook comprovado

As entregas que chegam são assinadas com HMAC, usando um segredo que geramos por loja, e comparadas em tempo constante — uma “atualização de produto” forjada bate na porta e volta.

Educado com a sua loja

Entregas verificadas mas não tratadas ainda respondem sucesso, porque o Woo desativa um webhook depois de cinco falhas seguidas — a gente absorve as esquisitices em vez de deixar a sua loja desistir da gente.

Saída protegida contra SSRF

Toda chamada para a URL da sua loja passa por uma proteção de saída — um “endereço de loja” malicioso não serve para sondar redes internas.

As letras miúdas, sem rodeios

Limites, com todas as letras

Sem processamento de pagamento

Os pedidos sincronizam; cobrar no cartão continua com a sua loja e o seu meio de pagamento — fingir o contrário é como as plataformas viram meio banco, e mal feito.

A mídia segue a propriedade

Onde o Woo é dono dos campos de conteúdo, eles ficam só para leitura aqui, de propósito — a graça de um contrato de propriedade é que ele obriga a gente também.

O teto de 2.000 produtos

Uma rodada de importação leva até 2.000 produtos — um limite de engenharia declarado. Catálogos maiores são uma conversa de escala que a gente prefere ter sem rodeios a estourar o tempo em silêncio.

Os pedidos são lidos, não copiados

Os pedidos da loja aparecem ao vivo no contato (em cache por um minuto, os dez mais recentes) em vez de serem duplicados em um segundo registro — é uma decisão deliberada de fonte única da verdade, declarada aqui.

FAQ do WooCommerce

Respostas diretas

Mais respostas no FAQ, ou pergunte direto para a gente.

Produtos com imagens, categorias, preço normal/promocional e as janelas correspondentes, GTINs, tags, up- e cross-sells, e variações com preço e imagem próprios — entrando já no pareamento e saindo pelas operações de escrita de volta que você habilita domínio por domínio. Os pedidos chegam marcados com a origem WooCommerce.

Não — esse é justamente o centro do projeto. A escrita de volta roda operação por operação atrás de um modo de ensaio, a propriedade campo a campo deixa só para leitura o que é de outro dono, chaves de idempotency determinísticas tornam as retentativas seguras, e tudo o que conflita cai em um registro visível para um humano resolver.

Eles resolvem coisas diferentes: esta integração sincroniza catálogo e pedidos; o plugin para WordPress incorpora o widget de chat e autentica o cliente por SSO, para que um cliente Woo logado seja reconhecido no chat. A maioria das lojas usa os dois.

A integração sabe a diferença entre “a loja caiu” e “este cliente nunca comprou nada” — uma falha de transporte aparece como erro, nunca vira um histórico vazio em silêncio. As leituras que falham recuam e tentam de novo em vez de martelar o seu servidor.

Todo pedido espelhado leva uma chave de idempotency determinística nos metadados, e antes de criar qualquer coisa a integração procura por essa chave — então nem o caso feio, em que a escrita chegou mas a resposta se perdeu, gera um segundo pedido. A checagem de duplicidade roda no modo de ensaio também.

Batem — os clientes são casados pela identidade da conta quando ela existe, e os pedidos sem cadastro são encontrados por busca de e-mail ou telefone, então quem pergunta “cadê a minha encomenda?” no chat é reconhecido de um jeito ou de outro.

Conectado com honestidade vale mais do que conectado com estardalhaço.

Cada integração aqui está descrita pelo que ela realmente faz — direção, propriedade dos dados e limites inclusos.