Passar para o conteúdo principal

Importação de Produtos via SFTP

Automatize a importação do seu catálogo de produtos na OmniChat

Escrito por Caroline Silva

O SFTP (Secure File Transfer Protocol) é um protocolo seguro de transferência de arquivos que permite sincronizar o seu catálogo de produtos diretamente com a OmniChat. É a alternativa recomendada quando a integração via API (api-docs.omni.chat) não for viável.

A autenticação no SFTP da OmniChat é feita exclusivamente por chave pública SSH — um dos métodos mais seguros disponíveis. Você precisará gerar um par de chaves (pública e privada) e enviar apenas a chave pública para a OmniChat.

Parte 1 — Gerando as chaves SSH

macOS ou Linux

No Terminal, execute o comando abaixo para gerar o par de chaves:

ssh-keygen -P "" -f transfer-key

Para conectar ao SFTP da OmniChat posteriormente, utilize:

sftp -oIdentityFile=<caminho_da_chave_privada> -v <nome-de-usuario>@sftp.omni.chat

Windows 10

No Windows, são necessários dois programas adicionais:

  • WinSCP — realiza a conexão SFTP entre o seu computador e a OmniChat. Download: winscp.net

  • PuTTYgen — converte a chave SSH para o formato compatível com o WinSCP (.ppk). Download: puttygen.com (versões 32 e 64 bits disponíveis).

Verificando se o OpenSSH está instalado (Windows)

  1. Acesse Menu Iniciar → Configurações → Aplicativos → Aplicativos e Recursos

  2. Clique em Recursos opcionais.

  3. Verifique se o Cliente OpenSSH aparece na lista. Se não estiver instalado, siga as instruções da Microsoft para instalá-lo.

Gerando o par de chaves no Windows

  1. Abra o Prompt de Comando como administrador: no Menu Iniciar, digite cmd, clique com o botão direito e selecione Executar como administrador.

  2. No prompt, execute: ssh-keygen e pressione Enter.

  3. Quando solicitado o local de salvamento, pressione Enter para aceitar o padrão: C:\users\seu_usuario\.ssh\id_rsa

  4. Quando solicitada uma passphrase, pressione Enter duas vezes (sem preencher). As chaves serão geradas.

  5. Na pasta C:\users\seu_usuario\.ssh, você encontrará dois arquivos chamados id_rsa: um é a chave privada e o outro (com ícone de cadeado/P) é a chave pública.

A chave pública (id_rsa.pub) é o arquivo que deve ser enviado para a equipe de suporte da OmniChat. Nunca compartilhe a chave privada.

Parte 2 — Ativando a conexão

Após enviar a chave pública e receber o nome de usuário criado pela OmniChat para sua empresa, siga os passos abaixo para configurar o WinSCP (configuração única):

  1. Abra o WinSCP e acesse Sessão → Nova Sessão (ou pressione Ctrl+N).

  2. Preencha os campos: Host: sftp.omni.chat | Usuário: nome informado pela OmniChat. Em seguida, clique em Avançado.

  3. Dentro das configurações avançadas, acesse SSH → Autenticação. No campo Arquivo de Chave Privada, localize o arquivo id_rsa (sem extensão) na pasta .ssh.

  4. Se solicitado, confirme a conversão da chave para o formato PuTTY (.ppk) e salve na mesma pasta.

  5. Ajuste as permissões do arquivo .ppk: clique com o botão direito → Propriedades → Segurança → Avançadas. Certifique-se de que somente o seu usuário esteja listado nas entradas de permissão. Remova os demais clicando em Desabilitar herança.

  6. Retorne à tela do WinSCP, confirme que a chave .ppk está selecionada e clique em OK.

  7. Clique em Salvar e depois em OK. Um atalho será criado na lista lateral do WinSCP.

  8. Para iniciar a conexão, selecione o atalho salvo e clique em Login. A tela do WinSCP exibirá dois painéis: o seu computador à esquerda e o servidor da OmniChat à direita.

Importações futuras: para enviar novas planilhas, basta selecionar o atalho salvo e clicar em Login — os passos 1 a 7 só precisam ser feitos uma vez.

Parte 3 — Formato do arquivo CSV

O arquivo de importação deve seguir exatamente as especificações abaixo:

Requisito

Especificação

Formato

.CSV

Codificação

UTF-8

Delimitador de colunas

Ponto e vírgula (;)

Colunas obrigatórias (linhas sem esses campos não serão importadas):

  • ID

  • Variant ID

  • Name

  • Variant Price

Um template modelo está disponível para facilitar a preparação dos dados. Solicite ao suporte da OmniChat ou acesse aqui.

Tabela de preço (opcional)

Caso queira vincular uma tabela de preços ao arquivo, solicite ao suporte o ID da tabela de preço e preencha a coluna PRICING TABLE ID em todas as linhas. Esse ID só é necessário na criação de uma nova tabela — atualizações de preços em tabelas existentes não exigem novo ID.

Parte 4 — Realizando a importação

  1. Com a conexão ativa no WinSCP, localize o arquivo CSV no painel do seu computador (lado esquerdo).

  2. Arraste o arquivo para o painel da OmniChat (lado direito).

  3. Confirme o envio na janela que será exibida clicando em OK.

  4. O arquivo entrará na fila de importação da OmniChat. O processamento pode levar entre 1 e 2 horas.

Limites do arquivo

Limite

Valor máximo

Tamanho do arquivo CSV

30 MB

Número de linhas

80.000

Caso seu arquivo ultrapasse esses limites, entre em contato com o suporte da OmniChat antes de tentar o envio.

Respondeu à sua pergunta?