Integrações

Dados da integração Interago: o que pedir à equipe em linguagem de operador

Algumas informações são importantes para a integração, mas não precisam virar uma conversa técnica. O operador só precisa saber o que pedir, onde essa

  • Publicado em 19/09/2026
  • Atualizado em 22/09/2026
  • Equipe do Interago

Algumas informações são importantes para a integração, mas não precisam virar uma conversa técnica. O operador só precisa saber o que pedir, onde essa informação será usada e como conferir se a resposta combina com a loja.

Este roteiro cobre três pontos que costumam travar a operação: o endereço de retorno da autorização, a regra que associa produtos e o depósito que fornece o saldo.

Para quem é

Operador que vai abrir uma integração, corrigir uma configuração ou pedir apoio e quer chegar à equipe com perguntas claras, sem enviar dados secretos.

Em uma frase

Peça à equipe o endereço de retorno aprovado, a regra de associação dos produtos e o depósito correto para o seu site. Peça a orientação, nunca a chave de acesso.

Como chegar ao ponto da dúvida

  1. No painel SaaS, selecione o site correto.
  2. Acesse Extensões > Konektor > Integrações.
  3. Clique em Configurar no sistema conectado.
  4. Confira Acesso, Configurações, O que sincronizar e Situação.
  5. Anote o nome que a tela dá ao campo ou ao aviso, sem copiar credenciais.

1. Endereço de retorno da autorização

O que é, em linguagem de operador

É o endereço para o qual o sistema conectado devolve você depois que a autorização termina. Ele faz a ponte de volta para o Konektor. Se estiver diferente do endereço aprovado, a autorização pode não terminar ou você pode voltar para uma tela de erro.

O que pedir à equipe

Pergunte:

  • Qual é o endereço de retorno aprovado para este site?
  • Ele deve ser informado exatamente como a equipe enviar?
  • Existe diferença entre ambiente de teste e loja em produção?
  • O sistema conectado pede um endereço único ou mais de um?
  • Depois de salvar o endereço, devo autorizar de novo?

Não invente, encurte, traduza ou adapte o endereço. Copie apenas a orientação recebida e use o campo indicado pelo sistema conectado.

Como relatar um problema

Envie:

  • nome da loja;
  • nome do sistema conectado;
  • horário da tentativa;
  • mensagem exibida na tela;
  • print sem chaves ou segredos.

Não envie Client Secret, senha, token ou código de autorização. A equipe precisa confirmar o endereço, não receber sua credencial.

2. Regra de associação dos produtos

O que é, em linguagem de operador

É a regra que diz como a integração reconhece que o produto da loja e o produto do sistema de gestão são o mesmo item. No dia a dia, a equipe pode chamar isso de matching, vínculo, casamento ou associação.

O operador precisa saber qual informação deve ser igual nos dois lados. Pode ser código, SKU, EAN ou outra regra definida para o site. Não escolha uma delas por conta própria.

O que pedir à equipe

Pergunte:

  • Qual campo faz o vínculo dos produtos nesta loja?
  • O valor precisa ser exatamente igual nos dois lados?
  • Como a regra trata variações?
  • O que acontece quando dois produtos têm o mesmo nome?
  • A coleta cria um produto novo ou tenta encontrar um existente?
  • O envio atualiza um item já vinculado ou pode criar cadastro?
  • Como vejo na tela que o vínculo foi concluído?

Como validar a resposta

  1. Escolha um produto simples como piloto.
  2. Compare o campo informado pela equipe nos dois lados.
  3. Faça uma coleta ou envio pequeno, conforme a casa oficial.
  4. Leia Situação e Eventos.
  5. Confira o produto no catálogo e no sistema de gestão.
  6. Só depois teste estoque ou pedido.

Para entender por que isso importa, veja Konektor: o que é produto vinculado e por que estoque e pedido dependem disso.

3. Depósito ou local que fornece o saldo

O que é, em linguagem de operador

É o estoque físico ou lógico que a integração deve consultar para saber quanto está disponível para a loja. Um sistema de gestão pode ter mais de um depósito. O saldo total da empresa nem sempre é o saldo que a vitrine pode vender.

O que pedir à equipe

Pergunte:

  • Qual depósito abastece esta loja?
  • O Konektor usa saldo disponível, saldo físico ou outro tipo?
  • O depósito muda por filial, site ou canal?
  • O saldo reservado fica fora da quantidade vendável?
  • O mesmo produto pode usar depósitos diferentes em momentos diferentes?
  • Onde essa escolha aparece na aba Configurações?
  • Depois de alterar o depósito, devo salvar e sincronizar?

Não selecione o primeiro depósito da lista. Um local errado pode mostrar estoque zerado, liberar venda indevida ou fazer o operador acreditar que a integração parou.

Como validar a resposta

  1. Anote o depósito indicado pela equipe.
  2. Escolha um produto piloto com saldo conhecido.
  3. Compare o saldo disponível no depósito com o saldo da loja.
  4. Salve uma mudança somente se a equipe orientar.
  5. Use Sincronizar agora uma vez ou aguarde a fila conforme o caso.
  6. Confira Situação, Eventos e a ficha do produto.

O checklist de ativação está em Konektor: checklist antes de ligar estoque e pedidos juntos.

Modelo de mensagem para a equipe

Você pode copiar e preencher:

Olá! Estou configurando o Konektor da loja [nome da loja] com [nome do sistema]. A tela mostra [mensagem ou situação] em [ação: catálogo, estoque ou pedido], por volta de [horário]. Podem confirmar, por favor: 1) o endereço de retorno aprovado para esta loja; 2) qual campo faz o vínculo dos produtos e como conferir o vínculo; 3) qual depósito e qual tipo de saldo devo usar? Vou testar com o produto [nome e código não secreto]. Não estou enviando chaves ou segredos.

O modelo dá contexto suficiente sem pedir que você compartilhe acesso.

O que enviar e o que guardar

Pode enviar

  • nome da loja;
  • sistema conectado;
  • nome e código comercial do produto piloto;
  • horário aproximado;
  • caminho percorrido no painel;
  • texto do aviso;
  • print com dados sensíveis escondidos.

Não envie

  • senha;
  • Client Secret;
  • token;
  • código de autorização;
  • arquivo exportado com credenciais;
  • print com campos secretos visíveis.

Se uma credencial foi exposta, avise a equipe e siga o procedimento de troca definido para o sistema conectado.

Como saber se a resposta resolveu

A resposta está completa quando você consegue dizer:

  • onde a autorização deve voltar;
  • qual campo identifica o mesmo produto;
  • qual depósito alimenta o saldo;
  • quem é a casa oficial do estoque;
  • qual teste será feito;
  • como ler o resultado em Situação e Eventos.

Se um desses pontos continuar vago, faça uma pergunta específica em vez de ligar estoque e pedidos no escuro.

Checklist para pedir ajuda

  • [ ] Nome da loja e sistema informado.
  • [ ] Ação e horário registrados.
  • [ ] Mensagem copiada sem dados secretos.
  • [ ] Endereço de retorno solicitado, sem inventar valor.
  • [ ] Regra de associação solicitada.
  • [ ] Depósito e tipo de saldo solicitados.
  • [ ] Produto piloto escolhido.
  • [ ] Nenhuma chave ou senha compartilhada.

Artigos relacionados

Este artigo foi útil?