Este artigo explica, em um tutorial guiado, como ativar a integração entre sua conta Martz e sua loja na Irroba.
Criando o Usuário API na Irroba
Para integrar sua loja com a Martz, você precisará criar um Usuário API no painel administrativo da Irroba. Esse usuário fornecerá as credenciais necessárias (usuário e senha) para a conexão com a Martz.
Passo 1 — Acesse a área de Usuários API
Faça login no painel administrativo da sua loja Irroba.
No menu lateral, acesse Usuários → Usuários API.
Clique em + Adicionar para criar um novo usuário de API.
Passo 2 — Preencha os dados do Usuário API
Na tela de criação do Usuário API, preencha os campos conforme abaixo:
Campo | O que preencher |
Um e-mail de contato (pode ser o e-mail do responsável pela integração) | |
Usuário | Defina um nome de usuário (ex.: |
Senha | Clique no ícone para gerar uma senha automaticamente |
Webhook de pedidos | Cole a URL de webhook da Martz (veja a seção de Webhooks abaixo) |
Webhook de Carrinho Abandonado | Cole a mesma URL de webhook da Martz |
⚠️ Atenção: Os campos de webhook são opcionais neste momento, mas recomendamos que sejam preenchidos durante a criação do usuário. Veja a seção Configuração de Webhooks abaixo para obter a URL.
Passo 3 — Salve e copie as credenciais
Clique em Salvar para finalizar a criação do Usuário API.
Após salvar, copie o Usuário e a Senha gerados. Esses dados serão necessários na próxima etapa.
⚠️ Atenção: As credenciais são informações sensíveis. Não as compartilhe com terceiros.
Referência: Para mais detalhes sobre a API da Irroba, consulte a documentação oficial da API Irroba.
Integrando com a Martz
Com as credenciais 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.
Na seção de E-commerces, localize a Irroba e clique em Integrar.
No modal que se abrirá, preencha os campos com as credenciais obtidas na Irroba:
Usuário da API — cole o Usuário criado no passo anterior.
Senha do usuário — cole a Senha gerada no passo anterior.
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 (categorias, produtos, clientes, pedidos e carrinhos abandonados). 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 Irroba!
⚠️ Atenção: Caso já tenha preenchido os campos de webhook durante a criação do Usuário API, essa etapa já está concluída.
Os webhooks permitem que a Irroba 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 da Irroba na seção URLs de notificações.
Passo 02 — Configure os webhooks na Irroba
Com a URL em mãos, acesse o painel administrativo da Irroba:
Vá em Usuários → Usuários API.
Localize o Usuário API criado para a Martz e clique para editá-lo.
Nos campos de webhook, cole a URL copiada da Martz:
Webhook de pedidos: cole a URL de webhook da Martz
Webhook de Carrinho Abandonado: cole a mesma URL de webhook da Martz
Clique em Salvar.
Observação: A Irroba possui dois campos de webhook separados: um para pedidos e outro para carrinho abandonado. Preencha ambos com a URL da Martz para garantir que tanto os pedidos quanto os carrinhos abandonados sejam sincronizados em tempo real.
🎉 Pronto! Agora a Irroba notificará a Martz em tempo real sobre novos pedidos e carrinhos abandonados, garantindo que seus dados estejam sempre atualizados.