.jpg "Elaine")
A integração entre a Olist e a AdMan permite conectar as duas plataformas para que as informações da sua operação sejam disponibilizadas corretamente na AdMan.
Para realizar essa configuração, é necessário ser administrador na Olist, gerar as chaves de acesso e configurar o Webhook responsável pelo envio das informações de estoque.
Neste artigo, você encontrará o passo a passo completo para realizar essa configuração.
Requisitos para realizar a integração
Antes de iniciar, certifique-se de que você possui acesso de administrador à sua conta Olist.
Também é necessário que as extensões Gestão de Aplicativos e Webhooks estejam disponíveis e instaladas na sua conta Olist.
Importante: durante o processo, você precisará alternar entre a AdMan e a Olist. Recomendamos manter as duas plataformas abertas em abas diferentes do navegador.
1. Acesse a integração da Olist na AdMan
Na AdMan, acesse o menu Integrações e localize a opção Olist.
Clique em Configurar.
Na tela de configuração, serão apresentadas duas informações importantes para o processo:
-
URL de redirecionamento
-
URL do Webhook
Também será exibida a área Chaves de acesso, onde posteriormente serão inseridos o Client ID e o Client Secret gerados na Olist.
Mantenha essa tela aberta durante o processo.
2. Instale a extensão Webhooks na Olist
Acesse sua conta Olist e, no menu lateral, entre em Loja de extensões.
Pesquise por Webhooks e clique em Instalar.
A extensão será utilizada para configurar o envio de notificações de estoque para a AdMan.
3. Crie um aplicativo para a AdMan
Após instalar a extensão, acesse, no menu da Olist:
Configurações → Aplicativos → Aplicativos API
Na tela de Aplicativos API, clique em + Novo aplicativo.
No campo Nome do aplicativo, informe:
AdMan
Em seguida, no campo URL de Redirecionamento, informe a URL apresentada na tela de integração da Olist dentro da AdMan.
Para evitar erros, recomendamos utilizar o botão de copiar disponível na AdMan e colar a URL diretamente no campo da Olist.
4. Configure as permissões do aplicativo
Ainda na criação do aplicativo, será necessário definir as permissões que a AdMan terá para consultar as informações da Olist.
Em Permissões do aplicativo, habilite a permissão de Leitura para os seguintes módulos:
-
Produtos
-
Pedidos
-
Estoque
-
Informações da Conta
-
Gatilhos
Não é necessário habilitar permissões de Incluir e editar ou Excluir para esses módulos.
Após configurar as permissões, clique em Salvar.
5. Copie as chaves de acesso
Depois de salvar o aplicativo, a Olist irá gerar as chaves de acesso.
Serão disponibilizadas duas informações:
Client ID
Client Secret
Utilize o botão de copiar disponível ao lado de cada informação para copiá-las.
🔐 Atenção: o Client Secret é uma informação de acesso e deve ser mantido em segurança. Não compartilhe essa chave publicamente.
6. Insira as chaves na AdMan
Retorne à tela de integração da Olist na AdMan.
Na seção Chaves de acesso, cole:
-
o Client ID no campo correspondente;
-
o Client Secret no campo correspondente.
Depois, clique em Salvar chaves.
Com isso, a AdMan estará autorizada a realizar a comunicação necessária com a Olist.
7. Configure o Webhook de estoque
Com as chaves configuradas, é necessário realizar a configuração do Webhook.
Na Olist, acesse:
Configurações → Webhooks
Na tela de Webhooks, localize a opção:
Receber notificações de lançamentos de estoque
Ative essa opção.
Em seguida, no campo URL da notificação de lançamentos de estoque, insira a URL do Webhook disponibilizada pela AdMan.
Você pode copiar essa URL diretamente da tela de integração da Olist na AdMan.
Após inserir a URL, clique em Salvar.
8. Finalize a integração
Depois de concluir as configurações na Olist, retorne à AdMan.
Confira se o Client ID e o Client Secret foram inseridos corretamente e se o Webhook de estoque foi configurado na Olist.
Com todas as etapas concluídas, a integração estará configurada.
Quer acompanhar o passo a passo?
Preparamos um vídeo mostrando como criar as chaves de acesso na Olist, configurar as permissões e ativar o Webhook para conectar sua conta à AdMan.