SURVEY LINK

Endpoints

Gerar link de pesquisa

GET /link/{api_token}/

Descrição: Gera um link de pesquisa customizado para o cliente responder a pesquisa via URL. Os parâmetros podem ser passados via query string.

Exemplo de URL:

https://survey-link.solucx.com.br/link/{api_token}/?customer_id=c1234&employee_id=e1234&store_id=s1234&amount=75&score=10

Exemplo com formulário:

https://survey-link.solucx.com.br/link/a1b2c3d4e5f6/?transaction_id=t1234&form_id=11

Exemplo com parâmetro extra:

https://survey-link.solucx.com.br/link/a1b2c3d4e5f6/?transaction_id=t1234&form_id=11&param_orderId=o123

Parâmetros de Path

api_tokenobrigatóriostring
Token da instância SoluCX.

Parâmetros de Query

transaction_idstring
ID externo da transação.
form_idstring
ID do formulário.
customer_idstring
ID do cliente.
employee_idstring
ID do colaborador.
store_idstring
ID da unidade.
amountnumber
Valor da transação.
scorenumber
Nota da avaliação.
param_{key}string
Parâmetros extras para rastreabilidade (ex: param_orderId).

Respostas:

  • Redireciona para a página de pesquisa customizada.
  • Em caso de erro, retorna mensagem de erro na página.

Exemplo de Retorno

O usuário será direcionado para a interface de pesquisa personalizada, conforme os parâmetros enviados.

Observações

  • O endpoint aceita parâmetros extras prefixados com param_ para rastreabilidade.
  • O link pode ser enviado diretamente ao cliente por e-mail, SMS, WhatsApp, etc.
  • Não há autenticação via header, apenas via token na URL.

Exemplos de uso

Chatbot Webhook
Template URL
As informações de experiência e avaliação são enviadas para Solucx por um Link, através de Query String na URL. É criada uma transação e uma avaliação no mesmo instante.