Para realizar a integração entre seu sistema e nossa plataforma, você pode utilizar a API. Todos os métodos estão documentados neste site: API V2 Tracksale.

Conforme descrito na documentação da API, a integração só é possível utilizando o token de autenticação. O token é o responsável por autorizar que a ação desejada seja realizada utilizando a API. Sobre ele, são importantes as seguintes considerações:

  • O token só pode ser gerado por usuários que possuem nível de acesso de Gerente e Administrador;
  • Cada token pertence ao usuário e não à conta, ou seja, o usuário deve estar ativo e permanecer com um dos dois níveis de acesso que permitem o seu uso.

Se sua integração não está funcionando, o token deve ser a primeira coisa a ser checada. Caso o token seja inválido, a API irá retornar a mensagem ""error": "Invalid Authorization Token"".

Como aplicar filtros em métodos do tipo GET

Quando se utiliza o método do tipo GET os filtros aplicados devem ser passados como parâmetros que são informados na URL do método. Os filtros possíveis são informados na seção de parâmetros da documentação logo após a descrição do método.

Para inserir um filtro basta inserir um sinal de interrogação após a URL do método e depois informar quais são os filtros aplicados, concatenando cada parâmetro com o símbolo & (e comercial). 

Exemplos:
1 - Obter opiniões de um período e exibindo os valores de tags:
A URL já com os parâmetros informados deverá ser api.tracksale.co/v2/report/answer?start=AAAA-MM-DD&end=AAAA-MM-DD&tags=true onde AAAA representa o ano, MM o mês e DD o dia.

2 - Obter o relatório de categorias dos últimos 30 dias de campanhas específicas:
O código da campanha deverá ser informado na URL através do parâmetro codes, ficando da seguinte forma: api.tracksale.co/v2/report/category?codes=1,2 , onde o retorno será o relatório de categorias das campanhas 1 e 2.


Como agendar um disparo utilizando método do tipo POST

Para agendar o disparo de uma pesquisa utilizando a API é importante saber que o horário de agendamento deve ser informado utilizando o padrão Unix Timestamp. Para que a data e horário informado sejam corretos, utilize o seguinte site para auxiliar: https://www.unixtimestamp.com/index.php

Ao clicar em “Convert” o site irá retornar o tempo em Unix Timestamp.

O número em verde é o equivalente à data informada. 

Ele deve ser informado no parâmetro "schedule_time", conforme imagem a seguir.

Após enviar a requisição a API retornará o código do lote e a quantidade de clientes inseridos. 

Na plataforma o lote irá constar como agendado. 

Caso queira agendar o disparo para mais de um cliente em um mesmo lote você deve informar os clientes entre chaves. Seguindo a mesma estrutura do request mostrado anteriormente. Não se esquecer da vírgula para separar os clientes.

O retorno irá informar quantos clientes foram inseridos. 

Caso queira realizar o disparo imediatamente, basta informar o parâmetro "schedule_time” como sendo 0 (zero).

Encontrou sua resposta?