Saiba tudo sobre o que é SFTP e como usá-lo

Confira o passo a passo completo para configurar e utilizar o SFTP na Track CXM, desde a ativação até o processamento das respostas.

O que é SFTP?

SFTP, significa, “SSH File Transfer Protocol” ou “Secure File Transfer Protocol” e é um protocolo de transferência segura de arquivos entre servidores ou computadores, e no caso da Track CXM, é uma das formas seguras de enviar as informações para nosso sistema.

Você também pode enviar dados para a Track CXM utilizando nossa API Track CXM ou importando seu arquivo ao criar uma nova distribuição.
Importante:

Esta integração precisa de configuração adicional do time da Track, ou seja, você precisa aguardar até que estas configurações sejam realizadas. Para configuração, acione o seu gerente de contas para dar start no processo.

 

Qual a função da utilização do SFTP na Track CXM?

O SFTP é utilizado para realizar transferências de arquivos CSV para criar novas distribuições de pesquisas, ou seja, toda vez que um arquivo for disponibilizado o sistema iniciará o envio das pesquisas que estão associadas a ele.

Como configurar o SFTP na Track CXM?

Siga este passo a passo para ativar e utilizar o SFTP na Track CXM.

Solicitação de Integração

  1. Entre em contato com nosso time de Atendimento ou CSM solicitando a ativação do SFTP.
  2. Após recebermos sua solicitação, nossa equipe interna criará um registro com os dados da sua empresa para iniciar o processo.
  3. Quando a integração for liberada e validada, você receberá por e-mail as credenciais do SFTP, juntamente com a documentação necessária.

Pré-requisitos

Certifique-se de que os seguintes itens estejam configurados:

  • Integração SFTP Ativa: Habilite a integração em sua conta (acesse Integrações -> SFTP).
  • Pesquisa Criada: Crie a pesquisa desejada na plataforma (acesse Pesquisas -> Nova Pesquisa).

Etapas para Importação

  1. Nomeação do Arquivo: Nomeie o arquivo seguindo as diretrizes disponíveis em Integrações -> SFTP.
  2. Upload do Arquivo: Envie o arquivo corretamente configurado para a pasta designada para sua organização.

Processamento dos Dados

Após o envio, o sistema da Track CXM executa os seguintes passos automaticamente:

  1. Leitura e Validação: O sistema lê o arquivo enviado e valida os dados.
  2. Registro dos Dados: Os dados são registrados no banco de dados.
  3. Envio da Pesquisa: A mensagem é enviada ao destinatário pelo canal configurado (e-mail, WhatsApp ou SMS).

Acompanhamento das Respostas

  • O destinatário recebe a pesquisa e responde pelo link fornecido.
  • O sistema CXM processa as respostas e calcula as métricas, que ficam disponíveis para análise na plataforma.


IMPORTANTE:

As informações disponibilizadas para conexão ao SFTP são confidenciais, não a disponibilize para e-mails de grupo ou pessoas não autorizadas.



Como formatar o nome do arquivo para envio via SFTP?

Os arquivos enviados devem seguir o formato CSV e nomeados no seguinte formato:

<Código de Pesquisa>_<Canal de distribuição>_SC<Data_Horario>_RE<Data de lembrete>.csv

 

Exemplo:

afaT_EMAIL_SC191120201400_RE201120201400.csv

Onde as informações que podem ser adicionadas separadas por “_” são:

  • Código de pesquisas: O código da pesquisa pode ser encontrado na sua lista de pesquisas.

    image.png


  • Canal de distribuição:

     
    • Para envio via E-mail use: EMAIL

    • Para envio via SMS use: SMSLINK

    • Para envio via WhatsApp use: WHATSAPP​

     

  • Data_Horário: (Opcional) Caso a data seja informada, a distribuição será agendada para a mesma. Caso a data não seja informada, a distribuição não será agendada e ocorrerá logo após o processamento do arquivo. Formato esperado: SCDDMMAAAAhhmm (com prefixo SC)

  • Data de lembrete: (Opcional) Caso a data de lembrete seja informada, a distribuição será acionada novamente na data. Formato: REDDMMAAAAhhmm (com prefixo RE)

  • Data de expiração: (Opcional) Se a data de expiração for informada, a pesquisa será expirada na data passada por parâmetro. Formato: EXDDMMAAAAhhmm (com prefixo EX)

  • Identificador do template de convite por e-mail: (opcional) Se o identificador do template de convite de e-mail for informado, será utilizado para gerar a mensagem de convite da pesquisa. Formato: TI<identificadorTemplate>

  • Identificador do template de lembrete de e-mail: (opcional) Se o identificador do template de lembrete de e-mail for informado, será utilizado para gerar o convite de lembrete da pesquisa. Formato: TR<identificadorTemplate>

    O identificador de template pode ser encontrado na sua lista de templates (https://app.track.co/organization/templates)

  • Identificador do template de convite SMS: (opcional) Se o identificador do template de convite SMS for informado, será utilizado para gerar o convite de mensagem da pesquisa; Formato: TSI<identificadorTemplate>

    O identificador de template pode ser encontrado na sua lista de templates (https://app.track.co/organization/templates)

  • Identificador de template de lembrete SMS: (opcional) Se o identificador do template de mensagem de lembrete for informado, será utilizado para gerar o convite de lembrete da pesquisa. Formato: TSR<identificadorTemplate>

    O identificador de template pode ser encontrado na sua lista de templates (https://app.track.co/organization/templates)

  • Identificador da mensagem de agradecimento : (Opcional) Se o identificador do template da mensagem de agradecimento for informado, será utilizado para gerar a mensagem de agradecimento da pesquisa. Formato TC<templateIdentifier>

    O identificador de template pode ser encontrado na sua lista de templates (https://app.track.co/organization/templates)

  • Identificador do template expirado: (Opcional) Se o identificador do template de pesquisa expirada for informado, será utilizado para gerar a mensagem de pesquisa expirada. Formato: TE<templateIdentifier>

    O identificador de template pode ser encontrado na sua lista de templates (https://app.track.co/organization/templates)

  • Identificador da integração WhatsApp: (Obrigatório para canal de distribuição WhatsApp) Informar o identificador da integração WhatsApp. Formato: WIHASHafaTed (prefixo WIHASH)

    O identificador da integração pode ser encontrado na sua lista de integrações no bloco de WhatsApp (quando sua integração WhatsApp já foi realizada).

image.png


  • Nome do template WhatsApp do provedor: (Obrigatório para canal de distribuição Whatsapp) Informar o nome do template do provedor WhatsApp (o nome do template não pode conter underline). Formato: TWNAMEtemplate-whatsapp-1 (com prefixo TWNAME)

    O nome do seu template de WhatsApp pode ser encontrado na lista de seleção de templates durante uma nova distribuição, ou você pode solicitar essa informação para nosso time de atendimento.

  • Linguagem do template WhatsApp: (Obrigatório para canal de distribuição Whatsapp) Informar a linguagem do template do provedor WhatsApp (a linguagem do template não pode conter underline). Formato: TWLANG, Exemplo: TWLANGpt-BR

  • Onde:

    • Português: pt-BR

    • Inglês: en-US

    • Espanhol: es-ES​

    •  

  • Variáveis do template WhatsApp: (Obrigatório se o template WhatsApp exigir variáveis) Informar as variáveis do template WhatsApp separadas por --, as variáveis podem ser encontradas nas tags na tela de atributos.

    Formato: TWVARcustomer.name--interaction.produto--customer.cpf (com prefixo TWVAR)

    Exemplo: Se seu template utiliza as variáreis customer.name, interaction.produto e interaction.vendedor nessa ordem, o nome do seu arquivo deve incluir essas variáveis.

    Resultado: TWVARcustomer.name--interaction.produto--interaction.vendedor

    Lembre-se, as informações devem estar ordenadas conforme o uso no template e devem existir como atributos cadastrados no sistema.

Importante:

O arquivo csv deve ser configurado em UTF-8 (delimitado por vírgulas).

 



Definir templates padrão no SFTP

Para definir templates padrão no SFTP, acesse a integração SFTP no menu integrações e  preencha os campos no ambiente de configuração de SFTP:

image.png


Uma vez que os campos forem definidos o sistema utilizará os templates selecionados como padrão para as distribuições geradas via SFTP.


 

Caso haja dúvidas, saiba que estamos prontos para te ajudar.


Você pode se comunicar com a nossa equipe de Atendimento ao Cliente através do chat no canto inferior direito da tela; ou, se preferir, envie suas perguntas por e-mail para
suporte@track.co, ou ainda entre em contato conosco pelo telefone: (11) 4858-9924 digitando a opção 5.