Aprenda Mokapen.

Shopify

Ligue a sua loja Shopify ao Mokapen para trazer ao CRM os clientes (contactos), os produtos (com variantes e quantidades) e os encomendas da loja, e para exportar para a Shopify os produtos criados ou atualizados no Mokapen quando a direção de sync o permitir. Serve para unir e-commerce e gestão comercial: dados mestre, catálogo e histórico de compras 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

• Loja Shopify ativa (URL que termina em .myshopify.com).
• Permissão para autorizar a app Mokapen na Shopify (OAuth) com conta de administrador da loja.
• Plano Mokapen Premium adequado para integrações e-commerce. Sem plano, o botão de ligação abre o upgrade; em alguns fluxos a Shopify também pode propor uma cobrança recorrente ligada à app.
• 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 Shopify

1. Menu do utilizador → Integrações → Shopify.
2. Introduza o nome da loja (como no Shopify Admin; o URL completo termina em myshopify.com). Se não tiver a certeza, abra o painel Shopify e veja a barra de endereços do browser.
3. Inicie a autorização: será redirecionado para a Shopify para aceitar as permissões.
4. Aceite os scope solicitados (leitura/escrita de clientes e produtos, leitura de encomendas — ver abaixo).
5. Volte ao Mokapen: a loja aparece ligada. Se chegar da App Store Shopify, poderá ter de escolher a organização Mokapen onde instalar a ligação.

Se não aceitar na Shopify, nenhum dado é sincronizado. Após a ligação o Mokapen regista os webhook na loja: assim as atualizações de clientes, produtos e encomendas podem chegar em tempo real, além da sync bulk que lançar.

O que o Mokapen pede à Shopify

Na autorização OAuth o Mokapen solicita tipicamente:

• read_customers / write_customers — ler (e potencialmente escrever) os clientes Shopify.
• read_products / write_products — ler e atualizar produtos/variantes.
• read_orders — ler as encomendas da loja.

O Mokapen não substitui o painel Shopify para checkout, temas ou pagamentos: alinha os dados para (e, no caso dos produtos, a partir de) o CRM. Se revogar a app na Shopify ou o token expirar, desligue e volte a ligar a partir do Mokapen. A Shopify exige também endpoints GDPR (pedido de dados / redact): o Mokapen gere-os via webhook.

O que é sincronizado

Para o Mokapen (import / webhook)

• Clientes → Contactos — dados mestre Shopify entram na rubrica; se existirem dados de empresa podem criar/ligar também a empresa. Webhook em create/update/delete de clientes.
• Produtos e variantes → Produtos — catálogo com variantes; a quantidade de inventário Shopify da variante é mapeada para o campo quantidade da variante Mokapen (não é um módulo de armazém separado).
• Encomendas → Encomendas — as encomendas Shopify tornam-se encomendas de venda no Mokapen (com linhas de artigo), não deals de pipeline. Webhook nas atualizações de encomenda.
• Checkouts abandonados — na sync pode existir um fluxo de importação de checkouts abandonados Shopify (como encomendas/dados relacionados). Os relatórios dedicados a carrinhos abandonados / analytics e-commerce na página continuam a aparecer como Em breve: não os conte como funcionalidade já ativa.

Para a Shopify (export)

• Produtos — com direção sync «para Shopify» ou «ambas», o Mokapen pode exportar/atualizar produtos na loja (sync bulk e sync-out ao guardar um produto ligado, se a integração estiver ativa).
• Contactos e encomendas de saída — apesar dos scope write_customers, o export automático «sync out» implementado hoje diz respeito na prática aos produtos. Não assuma um export bidirecional completo de contactos ou encomendas: os clientes chegam sobretudo da Shopify para o Mokapen (import + webhook). Se o texto comercial falar de «bidirecional só contactos», verifique no seu ambiente o que a sync faz realmente após a ligação.

Na config a integração também lista os serviços, mas não há uma sync de serviços e-commerce dedicada como para os produtos: use Produtos para o catálogo da loja.

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

Na página Shopify, com a loja ligada, configura tipicamente:

Direção sync

• Só para o Mokapen — os dados partem da Shopify e entram no CRM.
• Ambas — import + export (onde suportado; hoje sobretudo produtos de saída).
• Só para a Shopify — envio do Mokapen para a loja (produtos).

Entidades

Contactos, encomendas e produtos aparecem como âmbitos de sync (muitas vezes já selecionados e não modificáveis na UI). A sync histórica e os webhook cobrem estes três blocos.

Partilhar sync

Quem ligou a loja pode permitir que outros membros usem a mesma ligação (toda a organização ou utilizadores selecionados), para que nem todos tenham de repetir OAuth.

Duplicados e conflitos

• Evitar duplicados — opção típica: contactos reconhecidos por email, para não criar duplicados na rubrica.
• Em caso de conflito — escolha se prevalece Shopify ou Mokapen quando o mesmo registo foi modificado em ambos os lados.

Sync automática vs manual

Com a sync automática ativa, as atualizações (e os webhook) mantêm os dados alinhados; pode ainda lançar uma sincronização manual para a carga histórica inicial. Antes de sincronizar marque a autorização de tratamento/partilha de dados exigida na página.

Fluxo recomendado

1. Ligue a loja e verifique Conta ligada.
2. Defina a direção sync (na maioria dos casos: Só para o Mokapen ou Ambas se quiser atualizar os produtos Shopify a partir do Mokapen).
3. Configure duplicados/conflitos e partilha.
4. Autorize e lance a primeira sync (pode demorar em catálogos grandes).
5. Verifique no Mokapen: Contactos, Produtos (variantes/qtd.), Encomendas.
6. Mantenha os webhook ativos: novas encomendas e atualizações de clientes/produtos chegarão sem relançar tudo de cada vez.

Desligar

Em Integrações → Shopify → desligar. No modal pode escolher se mantém no Mokapen os contactos, encomendas e produtos já importados, ou geri-los conforme as opções propostas. Após desligar os webhook deixam de atualizar; os dados já no CRM permanecem se escolheu mantê-los. Também pode revogar a app no painel Shopify.

Problemas frequentes

• Nome da loja inválido — use o subdomínio *.myshopify.com, não apenas o domínio personalizado da montra.
• Botão bloqueado / upgrade — é necessário um plano Premium adequado para e-commerce.
• Encomendas não em Oportunidades — está correto: vão para Encomendas. Abra Vendas → Encomendas.
• Quantidade de produto — provém da quantidade de variante Shopify; não é um WMS completo.
• Relatórios de carrinhos / analytics — se na página aparecerem «Em breve», ainda não estão operacionais.
• Token expirado / sync parada — desligue e volte a ligar; verifique que a app não foi desinstalada na Shopify.

Perguntas frequentes

P: Onde encontro o URL da loja?

R: Na barra de endereços do painel Shopify Admin: termina em myshopify.com.

P: As encomendas Shopify tornam-se oportunidades?

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

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

R: Sim, com direção sync que inclua o export e a integração ativa: os produtos (variantes) podem ser enviados/atualizados na loja.

P: Os contactos atualizam-se também do Mokapen para a Shopify?

R: O import e os webhook trazem os clientes Shopify para o CRM. O export automático de contactos não é o fluxo principal hoje (ao contrário dos produtos): verifique no seu plano/ambiente após a ligação.

P: Preciso do WooCommerce além da Shopify?

R: Não: são duas integrações e-commerce alternativas. Use Shopify se a loja está na Shopify; consulte o guia WooCommerce se usa WordPress/Woo.