Criar uma Connection: o fluxo geral
Os mesmos cinco passos servem para todos os conectores: escolher no Marketplace, nomear a conexão, preencher credenciais, testar, mapear e ativar. E o modo simulação para quando ainda não tem chaves.
Uma Connection é um vínculo configurado com um sistema externo específico: uma loja Shopify, uma conta UPS, uma empresa ERP. Os guias por conector e o diretório dão os campos exatos de cada plataforma; este artigo é o fluxo que compartilham.
Antes de começar#
- Uma conta na outra plataforma com acesso de administrador (ou desenvolvedor): a maioria das credenciais fica atrás de uma página de admin ou de desenvolvedor.
- A lista de campos do seu conector no diretório de conectores (três partes, nesta seção): assim você sabe exatamente o que reunir.
- Na primeira conexão, prefira credenciais de teste / sandbox quando a plataforma oferecer; nunca pratique o mapping com dados reais.
Passos 1–2: escolher o conector e nomear a conexão#
- Abra Integration → Marketplace de conectores, filtre por categoria e clique no cartão do seu conector → Nova conexão.
- Dê um nome reconhecível, ex. “Shopify — loja principal US” ou “UPS — conta de produção”. Uma plataforma pode ter várias conexões (duas lojas, teste + produção); o nome as distingue.
Passo 3: preencher as credenciais#
- O assistente mostra exatamente os campos de que este conector precisa: vêm do registro de conectores, a mesma lista do diretório. Os obrigatórios estão marcados; não há campos ocultos.
- Cada campo tem uma ajuda dizendo onde o valor fica na outra plataforma; o diretório dá o caminho completo.
- Segredos (chaves, tokens, senhas) são criptografados e nunca exibidos por completo: após salvar, só uma prévia mascarada. Se um estiver errado, cole um novo; o antigo não pode ser “visto”.
- Se um conector não tiver lista de campos registrada (raro), o assistente usa um editor genérico chave-valor mais campos de segredo: escreva as chaves como a documentação da plataforma as nomeia.
Passo 4: testar a conexão#
O teste tem dois níveis: conectividade (as credenciais funcionam?) e, em conectores de documentos, uma prévia de um documento real (campos da plataforma → campos padrão, lado a lado). Uma falha diz em que nível está: 401 = credenciais; divergência na prévia = mapping. Corrija e repita; testar não muda nada em nenhum lado.
Onde fica o registro do teste: o registro de diagnóstico
Cada teste de conexão deixa um registro passo a passo na página de detalhes da conexão; para transportadoras, no diagnóstico expansível da linha. Abra-o se um teste falhar: ele mostra qual passo parou e por quê, na ordem de execução, para distinguir um problema de credenciais de um de mapping sem adivinhar. O registro guarda só passos e resultados, nunca seus segredos, só quais nomes de chave foram usados. Sem testes anteriores, a seção diz isso com clareza: execute um teste e o registro aparece aqui.
Passo 5: mapping e ativação#
- Escolha o modelo de mapping predefinido do seu conector e revise mais uma vez a prévia do documento: SKUs, quantidades, endereços e campos personalizados.
- Vincule seus produtos: SKUs do canal que não coincidem com um produto OMS ficam pendentes no Product Mapping; vincule-os lá ou os pedidos chegarão com linhas sem mapeamento.
- Ative. A partir daí a conexão sincroniza na programação definida e cada execução aparece em Integration → Runs e Logs. Acompanhe os primeiros documentos antes de confiar sem supervisão.
Gerenciar conexões depois#
- Ver e editar têm páginas próprias: clique em uma conexão em Integration → Conexões para abrir sua página de detalhes — status, configurações de sincronização, resumo da configuração e quais Flows a usam, tudo em um só lugar. A edição (nome, conteúdo, frequência, credenciais) é feita na página de edição da conexão; ao salvar, você volta aos detalhes.
- Editar credenciais: abra a conexão e cole o novo segredo, necessário após rotacionar uma chave ou quando um token expira. Teste logo depois.
- Desative em vez de excluir ao pausar um canal: a conexão desativada mantém seu mapping e histórico e pode ser reativada em um clique. Excluir perde a configuração.
- Conexões duplicadas fazem sentido quando aplicável (duas lojas da mesma plataforma, uma de teste + uma de produção). Cada Flow escolhe a conexão exata que usa.