Todas as coleções
Vendas
Clientes
O que é a ferramenta de conversão e como ela funciona
O que é a ferramenta de conversão e como ela funciona
Uma guia sobre como utilizar a ferramenta de importador de conversão
D
Escrito por Douglas Garcia
Atualizado há mais de uma semana

A funcionalidade de conversões pode ser acessada dentro do menu de automação na aba lateral esquerda do site da OmniChat, conforme o exemplo abaixo:

Através dessa tela, o usuário pode compartilhar as suas informações de conversão com a OmniChat para calcular o ROAS das campanhas e determinar a influência da OmniChat em conversões concluídas em outros canais.

Nesta tela o usuário poderá visualizar uma lista de todas os processos de importações de conversões realizados, seja por arquivo ou API, e seus respectivos status. Nessa tela o usuário também tem a possibilidade de enviar novas importações, através do upload de arquivo.


Como realizar a importação do arquivo?

Existem duas formas de fazer o upload das informações, sendo respectivamente via tela de conversões na página da OmniChat e pela API; vamos a elas:

Importação de conversão via upload de arquivo CSV:

Ao acessar a tela de conversões (conforme a primeira imagem deste documento), clicar no botão Importar no canto superior direito da tela:

Será carregado um pop-up solicitando o upload do arquivo, também será solicitado que seja dado um nome para a sua importação:

Como deve ser montado o arquivo que será importado?

Para se realizar a importação de um arquivo pela ferramenta, algumas regras devem ser respeitadas:

  • O arquivo deve ser no formato .CSV

  • O arquivo deve ter tamanho máximo de 6MB

  • A separação dos itens deve ser feita por vírgula (,) ou ponto e vírgula (;)

Importante: As colunas do arquivo CSV possuem validação “Case Sensitive”, tenha isso em mente quando for formatar o arquivo.

Abaixo um exemplo de um arquivo CSV válido:

type,origin,channel,eventDate,customData.value,customData.externalId,customer.countryCode,customer.phoneNumber,customer.email,customer.name,customer.lastName

ORDER,ERP,Filial Barigui,2022-03-08T15:24:33.955Z,1234.56,ORD-AS8988SDS,55,41991929394,omni.chat@omni.chat,Ednaldo,Pereira

No campo nome da importação são permitidos no máximo, 100 caracteres (e no mínimo 3 caracteres), caso você ultrapasse esse limite, um alerta é exibido na tela:

O mesmo vale para o campo de upload do arquivo, caso o arquivo selecionado não respeite as regras (formato e tamanho), será exibido um alerta de erro no campo, e o botão Importar continuará desabilitado:

Caso o arquivo esteja dentro dos parâmetros solicitados e a importação nomeada corretamente, o botão Importar será habilitado:

Importante: A tela só valida o formato e o tamanho do arquivo, caso o mesmo possua algum erro em seus dados, estes erros só serão “pegos” no momento que o arquivo for processo (pós upload)

Caso deseje substituir o arquivo anexado, basta clicar na lixeira, conforme indicado na imagem abaixo:

Importante: Caso seja anexado algum arquivo com erro (como mostrado nas imagens anteriores), não existe a necessidade de fechar o pop-up e abri-lo novamente, basta arrastar o novo arquivo para o campo indicado que o mesmo substituirá o anterior.

Após clicar em Importar, um alerta com a mensagem “Arquivo importado com sucesso” será exibido na parte superior central da tela, e a importação realizada será incorporada na lista com o status “Criado”:

Após o processamento do arquivo, o mesmo terá o seu status atualizado;

Se todos os dados forem computados corretamente, o status será alterado para Finalizado, caso contrário, o status será alterado para Erro:

Importação de conversão via upload de arquivo API:

Existem dois métodos que podem ser utilizados na API:

Para se realizar a importação de dados via API, é necessário inserir os valores “x-api-key” e “x-api-secret” no header, esses dados podem ser obtidos na página da OmniChat, acessando pelo menu lateral esquerdo: Configurações > Integrações > API. Tanto o método POST quanto o método GET necessitam desses dados no header.

Os dados da importação devem ser inseridos no body da requisição, conforme exemplo abaixo:

Ao realizar a requisição, caso esteja tudo correto, será gerado um ID como resposta da requisição:

É possível consultar o sucesso da requisição utilizando o método GET informado neste documento, basta realizar a requisição que o mesmo irá retornar a lista de importações realizadas pelo usuário conforme exemplo abaixo:

Para consultar o status do processamento, basta voltar a tela da OmniChat, a requisição estará junto as demais importações na lista:

Respondeu à sua pergunta?