ConnectWiz + WooCommerce

Integração em produção

Sincronização do WooCommerce nos dois sentidos — com um contrato de propriedade

A maioria das «integrações Woo» é um botão de importação e uma oração. Esta é uma sincronização governada, nos dois sentidos, em que decide, domínio de dados a domínio de dados, que sistema é dono da verdade — e cada conflito aterra num registo em vez de escrever por cima em silêncio.

Emparelhamento com um clique Propriedade campo a campo Conflitos num registo
WooCommerce × ConnectWiz
Ensaie antes de ir para produção
Produtos, imagens, variações a entrar
Propriedade: Woo / aqui / ambos — a decisão é sua
Conflito apanhado → registo, nova tentativa
30+
Campos transportados por produto — imagens, janelas de promoção, GTIN, tags, up-/cross-sells, variações
15 min
Duração do link de emparelhamento — o aperto de mão de ligação expira em vez de ficar por ali
4
Tópicos de webhook aprovisionados automaticamente — as alterações de produtos, encomendas e clientes entram sozinhas
2.000
Produtos por execução de importação — um teto declarado, não uma surpresa na linha 2.001

E-commerce

O que faz — ao certo

Emparelhamento com um clique

O fluxo de autorização padrão do WooCommerce aprovisiona chaves de API e webhooks automaticamente — sem o ritual de copiar chaves, sem lista de verificação de webhooks.

Importação a fundo

Imagens, árvores de categorias, preços normais e de promoção com as respetivas janelas, GTIN, 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 a sério

As edições de produtos feitas aqui podem ser escritas de volta no Woo — governadas por um interruptor por operação com modo de ensaio, para ver o que mudaria antes de alguma coisa mudar.

Propriedade campo a campo

Domínio a domínio, escolhe: os dados vivem no Woo, vivem aqui, ou sincronizam nos dois sentidos. Os campos cuja propriedade está noutro lado aparecem só de leitura, com o motivo no ecrã — sem o caos dos dois donos.

Um registo de conflitos

As sincronizações falhadas ou em conflito aterram num registo visível, com resolver e repetir — nunca uma escrita por cima em silêncio, descoberta na altura do inventário.

As encomendas entram no fluxo

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

Por dentro

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

Um aperto de mão de emparelhamento paranoico

O link de ligação expira em 15 minutos, o callback é marcado como consumido antes de qualquer outra coisa para nunca poder ser repetido com credenciais antigas — e o URL da loja usado é aquele que escreveu, nunca aquele que um callback diz ser.

À prova de repetições, por desenho

O Woo renumera os IDs de entrega a cada nova tentativa, por isso a desduplicação ignora-os de propósito e usa como chave o conteúdo da mensagem. Na saída, a chave de idempotência viaja nos próprios metadados da encomenda e é reencontrada por pesquisa — porque o caso perigoso é a escrita que chegou enquanto a resposta se perdia.

Relações numa segunda passagem

Os upsells e os cross-sells chegam como IDs da loja a apontar para produtos que podem ainda não existir — por isso resolvem-se numa segunda passagem, depois de o catálogo aterrar, e a árvore de categorias é obtida à parte, porque o payload de um produto só nomeia as folhas.

A moeda lida uma vez, como deve ser

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

Um mapa de estados conservador

Os envios de estado de entrega só mapeiam onde os vocabulários concordam mesmo; uma encomenda «devolvida» nunca é traduzida à força — chega a um humano como nota da encomenda. E as notas de estado são publicadas com a notificação ao cliente desligada, para o Woo não enviar um e-mail a mais ao seu cliente.

O que escreveu ganha

Um campo que uma pessoa editou à mão aqui nunca é escrito por cima por uma importação — a sincronização respeita o humano, e di-lo no cartão de origem de cada item.

Configuração

Como se liga

01

Emparelhe a loja

Clique em ligar, aprove no administrador do seu WooCommerce — as chaves e os webhooks são aprovisionados automaticamente.

02

Escolha a propriedade

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

03

Ensaie e depois vá para produção

Corra primeiro as operações de escrita de volta em modo de ensaio; passe para produção quando o diff parecer certo.

Melhor em conjunto

Com o que se combina

Plugin para WordPress

O plugin identifica os clientes Woo com sessão iniciada dentro do chat — a mesma pessoa que a sincronização já conhece, com as encomendas anexadas, sem ter de se registar outra vez.

Feeds de produtos

O catálogo importado pode ser publicado como feed do Google Shopping / Meta Commerce — uma variante por linha, saltos honestos com motivo, sem conversões de moeda inventadas. Veja o Commerce.

Wiz + flows

A IA responde a «onde está a minha encomenda?» a partir dos dados em direto da loja, e os flows podem reagir a eventos de comércio — a sincronização é o chão em que tudo o resto assenta.

Segurança e garantias

As garantias aborrecidas

Chaves aprovisionadas, nunca coladas

O fluxo wc-auth faz com que a sua loja nos entregue as chaves do lado do servidor — encriptadas em repouso, sem ritual de copiar e colar para um humano deixar escapar.

Todos os webhooks provados

As entregas de entrada são assinadas por HMAC com um segredo que cunhamos por loja e comparadas em tempo constante — uma «atualização de produto» falsificada bate com o nariz na porta.

Educado com a sua loja

As entregas verificadas mas não tratadas respondem à mesma sucesso, porque o Woo desativa um webhook ao fim de cinco falhas seguidas — absorvemos as esquisitices em vez de deixar a sua loja desistir de nós.

Saída protegida contra SSRF

Cada chamada ao URL da sua loja passa por uma guarda de saída — um «endereço de loja» malicioso não pode ser usado para sondar redes internas.

As letras pequenas, sem rodeios

Limites, declarados

Sem processamento de pagamentos

As encomendas sincronizam; cobrar cartões continua com a sua loja e o seu prestador de pagamentos — fingir o contrário é como as plataformas se tornam meio-banco, e mal.

A multimédia segue a propriedade

Onde o Woo é dono dos campos de conteúdo, eles ficam só de leitura aqui por desenho — a graça de um contrato de propriedade é que também nos obriga a nós.

O teto dos 2.000 produtos

Uma execução de importação leva até 2.000 produtos — um limite de engenharia declarado. Catálogos maiores são uma conversa de escala que preferimos ter com honestidade a deixar rebentar o tempo em silêncio.

As encomendas são lidas, não copiadas

As encomendas da loja aparecem em direto na ficha do contacto (em cache por um minuto, as dez mais recentes) em vez de serem duplicadas para um segundo registo — uma decisão deliberada de uma só fonte da verdade, declarada aqui.

FAQ do WooCommerce

Respostas diretas

Mais respostas no FAQ, ou pergunte-nos diretamente.

Produtos com imagens, categorias, preços normais e de promoção com as respetivas janelas, GTIN, tags, up- e cross-sells, e variações com os seus próprios preços e imagens — para dentro no emparelhamento, e para fora através das operações de escrita de volta que ativar domínio a domínio. As encomendas chegam marcadas com a origem WooCommerce.

Não — é esse o centro do desenho. A escrita de volta corre operação a operação, por trás de um modo de ensaio; a propriedade campo a campo torna só de leitura os campos cuja propriedade está noutro lado; as chaves de idempotência determinísticas tornam as repetições seguras; e tudo o que entre em conflito aterra num registo visível para um humano resolver.

Resolvem trabalhos diferentes: esta integração sincroniza o catálogo e as encomendas; o plugin para WordPress incorpora o widget de chat e identifica os clientes por SSO, para que um cliente Woo com sessão iniciada seja reconhecido no chat. A maioria das lojas usa os dois.

A integração distingue «a loja está em baixo» de «este cliente nunca comprou nada» — uma falha de transporte aparece como erro, nunca é mostrada em silêncio como histórico vazio. As leituras falhadas recuam e tentam de novo em vez de martelar o seu servidor.

Cada encomenda espelhada leva nos metadados uma chave de idempotência determinística e, antes de criar, a integração procura essa chave — por isso nem o caso feio em que a escrita chegou mas a resposta se perdeu consegue produzir uma segunda encomenda. A verificação de duplicados também corre em modo de ensaio.

São — os clientes são associados pela identidade da conta onde existe uma, e as encomendas de convidado são encontradas por pesquisa de e-mail ou de telefone, por isso quem pergunta «onde está o meu pacote?» no chat é reconhecido de qualquer das formas.

Ligado com honestidade vale mais do que ligado com alarido.

Cada integração aqui está descrita pelo que faz na realidade — direção, propriedade dos dados e limites incluídos.