Este artigo tem como finalidade auxiliar nas configurações específicas desse provedor, se ainda não leu o artigo de configuração de integração nativa, comece por ele clicando aqui.
Nós oferecemos uma integração de colaboradores via SFTP. Por meio dela, a base é atualizada na Plataforma cada vez que vocês enviarem um arquivo único no formato csv (não são aceitos outros formatos) com as informações da base completa de colaboradores de vocês que deve estar na Qulture. Note que cada sincronização entende que a fonte de verdade de usuários ativos é esse csv, ou seja, se enviarem hoje João e Maria e amanhã enviarem somente Maria, João será inativado. Essa integração roda às 12:30 e às 2 diariamente.
Essa integração é um pouco diferente das demais porque ela não integra diretamente nossa plataforma com o sistema fonte, seja porque esse sistema não possui uma API REST que a gente possa integrar, ou porque a Qulture não pode ter esse acesso. Sendo assim, sua empresa irá criar um programa que coloca um csv com os usuários numa pasta na AWS e nosso sync irá ler dessa pasta. Além disso essa integração possui um custo mensal, validar o valor com a gerente de conta.
Em resumo:
-
Programa de vocês lê da FONTE, prepara um csv e sobe na pasta por SFTP
-
Qulture pega esse arquivo, cria uma importação e apaga o arquivo
🤓 SFTP significa Secure File Transfer Protocol
Esse protocolo ajuda a aumentar a segurança na transferência desse csv. Com ele, sua empresa gera uma senha dupla: uma de vocês (secreta) e outra nossa (pública). Nós configuramos uma pasta com a nossa e o sistema de vocês consegue jogar o arquivo nela com a senha privada.
⚙️ Como configurar?
Nós utilizamos o servico AWS Transfer for SFTP(https://aws.amazon.com/pt/sftp/) para fazer a transferência segura dos arquivos.
Para que possamos configurar para sua empresa, precisamos que vocês nos ajudem.
-
Vocês: criam o modelo de csv (leia esse artigo que fala sobre o mapeamento dos campos).
-
Vocês: Geraram uma chave SSH (https://docs.aws.amazon.com/pt_br/transfer/latest/userguide/key-management.html#sshkeygen)
-
Vocês: Enviam para nós as informações dos passos (1) e (2), através de um chamado no portal
-
Qulture: Responderemos esse chamado depois que tivermos criado a conexão na AWS para que possamos testar o fluxo com vocês e fazer quaisquer ajustes necessários.
-
Qulture: Responderemos esse chamado quando a integração de teste estiver aprovada.
👀 Algumas observações importantes
-
O nome do arquivo tem que ser sempre o mesmo para toda importação, sendo assim, precisamos que vocês sempre enviem com o formato users.csv
-
O encoding do arquivo precisa ser UTF-8
-
O separador do arquivo precisa ser ponto e vírgula (";")
-
Coloque os headers das colunas com palavras sem caracteres especiais e separadas por underline, ex: coloque "matricula_do_lider" ao invés de "Matrícula do Líder".
-
A importação dos dados ocorre duas vezes ao dia (2:00 da manhã e meio-dia). Quando o sistema acaba de importar os dados, ele renomeia o arquivo que usou, adicionando o sufixo "_backup".