Este artigo explica, em um tutorial guiado, como obter o token de autenticação na Shoppub e inseri-lo na Martz para concluir sua integração.
Token de autenticação
O primeiro passo é obter o token de autenticação da sua loja Shoppub. Para isso, siga os passos abaixo:
Passo 01 — Acesse a área de API da Shoppub
Acesse a área administrativa da sua loja Shoppub pelo endereço:
http://sua-loja/shoppub-v2/clientes/clienteapiproxy/Clique em Adicionar Usuário API.
Digite o nome do usuário que utilizará o token (ex.: Martz) e clique em Salvar.
⚠️ Atenção: O token é uma credencial sensível. Não o compartilhe com terceiros.
Integrando com a Martz
Com o token em mãos, siga para o painel da Martz e finalize a integração:
Acesse o Painel da Martz e faça login na sua conta.
Clique no seu nome de usuário no canto superior direito da tela.
Acesse Configurações → Integrações.
4. Na tela de integrações, dentro da seção de E-commerces, localize a Shoppub e clique em Integrar.
5. Preencha os campos solicitados no modal e clique em Criar integração.
Pronto, sua integração está completa! ✅
Agora é só aguardar que a Martz começará a sincronizar as informações da sua loja. Essa sincronização pode demorar até 1 hora para ser iniciada. O tempo de término vai depender do tamanho da base da sua loja.
Configuração de Webhooks
Etapa muito importante para melhor eficiência na comunicação com sua loja Shoppub!
⚠️ Atenção: Esta etapa deverá ser realizada após a integração da loja com a Martz, conforme etapas anteriores deste tutorial.
Os webhooks permitem que a Shoppub notifique a Martz automaticamente quando um evento ocorrer na sua loja (uma nova venda, carrinho abandonado, etc.), garantindo uma sincronização mais rápida e eficiente.
Passo 01 — Copie a URL de webhook da Martz
No painel da Martz, acesse Configurações → Chaves de acesso e copie a URL de webhook disponibilizada.
Passo 02 — Configure o webhook de Pedidos na Shoppub
Na área administrativa da Shoppub, vá em APIs e Webhooks → Webhooks.
Edite o Webhook de Pedidos.
Na aba Configurações, preencha:
Url para notificação: cole a URL obtida no painel da Martz
Identificador: nome da sua loja em minúsculo
A seção "Selecione os métodos de pagamento que utilizam este webhook" pode ser mantida sem alterações.
Clique em Salvar e ative o webhook.
Passo 03 — Configure o webhook de Carrinhos abandonados
Volte à tela anterior e edite o Webhook de Carrinhos abandonados.
Na aba Configurações, preencha da mesma forma:
Url para notificação: cole a URL obtida no painel da Martz
Identificador: nome da sua loja em minúsculo
Clique em Ativar e Salvar.
🎉 Pronto! Agora a Shoppub notificará a Martz em tempo real sobre os eventos configurados, garantindo que seus dados estejam sempre atualizados.