Aprenda Mokapen.

WooCommerce

Ligue a sua loja WooCommerce (WordPress) ao Mokapen para trazer ao CRM os clientes (contactos), os produtos (com variações e stock) e os encomendas da loja, e para exportar para o WooCommerce os produtos criados ou atualizados no Mokapen quando a direção de sync o permitir. Mesmo objetivo que a Shopify: unir e-commerce e gestão comercial no mesmo workspace.

Visão geral: Integrações. As encomendas importadas tornam-se encomendas de venda no Mokapen (módulo Encomendas), não oportunidades de pipeline.

Requisitos

• Site WordPress com WooCommerce ativo e acessível em HTTPS.
• Permissão para autorizar o Mokapen através do fluxo WC Auth (administrador WordPress / WooCommerce).
• Plano Mokapen Premium adequado para integrações e-commerce. Sem plano, o botão de ligação abre o upgrade.
• Permissões Mokapen sobre contactos, produtos e encomendas na sua organização (consulte Funções e permissões).
• Acesso a Integrações (membro/admin conforme white-label e função org).

Ligar a loja WooCommerce

1. Menu do utilizador → Integrações → WooCommerce.
2. Introduza o endereço web da loja (URL do site, ex. https://oseudominio.com). Encontra-o na barra de endereços quando está no backend WordPress / montra WooCommerce.
3. Inicie a autorização: será redirecionado para WordPress/WooCommerce à página WC Auth (/wc-auth/v1/authorize) com scope read_write.
4. Aceite gerar as chaves API para o Mokapen (consumer key / secret são guardadas encriptadas no Mokapen — não há um formulário «colar API key» manual).
5. Volte ao Mokapen: a loja fica ligada. O Mokapen regista os webhook WooCommerce (/wp-json/wc/v3/webhooks) para receber atualizações em tempo real.

Se não aceitar a autorização, nenhum dado é sincronizado. O URL deve ser válido e em HTTPS: caso contrário a validação falha.

O que o Mokapen pede ao WooCommerce

O fluxo WC Auth concede ao Mokapen acesso de leitura/escrita às API REST WooCommerce necessárias para clientes, produtos (e variações), encomendas e webhook. O Mokapen não substitui o painel WooCommerce/WordPress para temas, pagamentos ou plugins: alinha os dados para (e, no caso dos produtos, a partir de) o CRM.

Se revogar as chaves ou desinstalar a autorização no WordPress, desligue e volte a ligar a partir do Mokapen.

O que é sincronizado

Para o Mokapen (import / webhook)

• Clientes → Contactos — clientes WooCommerce na rubrica (e empresa se os dados o permitirem). Atualizações também via webhook.
• Produtos e variações → Produtos — catálogo com variações; o stock WooCommerce (stock_quantity) é mapeado para a quantidade de variante Mokapen.
• Encomendas → Encomendas — as encomendas WooCommerce tornam-se encomendas de venda no Mokapen (com linhas), não deals de pipeline. Webhook nas atualizações.
• Carrinhos abandonados / relatórios — menções comerciais ou entradas «Em breve» na UI não equivalem a um import de relatórios de carrinhos já ativo como noutros fluxos: não os conte como funcionalidade completa se na página ainda aparecerem como em breve.

Para o WooCommerce (export)

• Produtos — com direção sync «para WooCommerce» ou «ambas», o Mokapen pode exportar/atualizar produtos na loja (sync bulk e sync-out ao guardar produto, se a integração estiver ativa).
• Contactos e encomendas de saída — como na Shopify, o export automático «sync out» implementado hoje diz respeito na prática aos produtos. Os clientes chegam sobretudo do WooCommerce para o Mokapen (import + webhook). Não assuma um export bidirecional completo de contactos só porque o texto comercial o sugere: verifique após a ligação.

Na config também aparece serviços, mas não há uma sync de serviços dedicada: para o catálogo da loja use Produtos.

Definições após a ligação

Na página WooCommerce, com a loja ligada:

Direção sync

• Só para o Mokapen — WooCommerce → CRM.
• Ambas — import + export (onde suportado; hoje sobretudo produtos de saída).
• Só para o WooCommerce — Mokapen → loja (produtos).

Entidades

Contactos, encomendas e produtos são os âmbitos de sync (muitas vezes pré-selecionados e não modificáveis na UI).

Partilhar sync

Quem ligou pode partilhar a ligação com toda a organização ou utilizadores selecionados.

Duplicados e conflitos

• Evitar duplicados — normalmente reconhecimento de contactos por email.
• Em caso de conflito — prevalece WooCommerce ou Mokapen.

Privacidade (WooCommerce)

Ao contrário da Shopify, na página WooCommerce também pode encontrar controlos de privacidade e colaboradores/stakeholder relacionados com a visibilidade dos dados sincronizados na org. Configure-os se a equipa não deve ver todo o catálogo/clientes importados da mesma forma.

Sync automática vs manual

Ative a sync automática para atualizações contínuas (junto com os webhook); use a sync manual para a carga histórica. Marque a autorização de dados na página antes de sincronizar.

Fluxo recomendado

1. Verifique HTTPS e WooCommerce atualizado no site.
2. Ligue a loja em Integrações → WooCommerce e complete WC Auth.
3. Defina direção sync, duplicados, conflitos, privacidade (se aplicável) e partilha.
4. Autorize e lance a primeira sync.
5. Verifique Contactos, Produtos (variações/stock), Encomendas no Mokapen.
6. Mantenha os webhook ativos para novos eventos sem relançar tudo de cada vez.

Desligar

Em Integrações → WooCommerce → desligar. No modal escolha se mantém no Mokapen contactos, encomendas e produtos já importados. Após desligar os webhook deixam de atualizar; os dados já no CRM permanecem se os manteve. Também pode revogar chaves/autorizações no painel WordPress.

Problemas frequentes

• URL inválido / sem HTTPS — use o endereço completo do site com https://.
• Autorização falhada — é necessário um admin WordPress; verifique que WooCommerce e os permalink REST funcionam (firewall/plugins de segurança podem bloquear WC Auth ou os webhook).
• Botão bloqueado / upgrade — é necessário um plano Premium adequado para e-commerce.
• Encomendas não em Oportunidades — está correto: vão para Encomendas (Vendas → Encomendas).
• Stock / quantidade — provém de stock_quantity das variações; não é um WMS completo.
• Webhook que não chegam — o site deve ser acessível a partir da internet; ambientes locais ou com basic auth muitas vezes não recebem as notificações WooCommerce.

Perguntas frequentes

P: Tenho de gerar as API key manualmente no WooCommerce?

R: Não. Use o fluxo WC Auth a partir da página Integrações Mokapen: as chaves são criadas e guardadas ao voltar da autorização.

P: As encomendas WooCommerce tornam-se oportunidades?

R: Não. No Mokapen tornam-se encomendas de venda. Qualquer texto que fale de «oportunidades» é impreciso face ao comportamento atual.

P: Posso atualizar os produtos WooCommerce a partir do Mokapen?

R: Sim, com direção sync que inclua o export e a integração ativa.

P: Diferença em relação à Shopify?

R: Mesmo modelo de dados (contactos, produtos, encomendas) e mesma lógica Premium e-commerce. Muda a ligação: Shopify usa OAuth na app Shopify; WooCommerce usa WC Auth no URL do seu site WordPress. Consulte também o guia Shopify.

P: É necessário HTTPS?

R: Sim. Sem HTTPS a ligação e os webhook não são fiáveis (e a validação de URL pode falhar).