Survey Link

O Survey Link permite criar URLs personalizadas para coletar feedback dos seus clientes. Basta gerar um link com os parâmetros desejados e enviá-lo por qualquer canal: e-mail, SMS, WhatsApp, QR Code, cupom fiscal, etc.

Endpoint

URL Base: https://survey-link.solucx.com.br/link/{api_token}/

O api_token é o token da sua instância SoluCX. Você pode encontrá-lo em Configurações da Instância na plataforma.

Como Funciona

Monte a URL com os parâmetros desejados
Envie o link ao cliente pelo canal de sua preferência
O cliente clica no link e é direcionado para a pesquisa
A resposta é registrada automaticamente na plataforma

Importante: Para criar um novo cliente automaticamente, o link deve conter pelo menos name ou customer_id.

Parâmetros Disponíveis

Identificação da Transação

Use estes parâmetros quando quiser vincular a pesquisa a uma transação já existente.

Parâmetros de Transação

transaction_idstring

ID externo da transação (do seu sistema). Busca a transação pela integração externa.

scx_transaction_idnumber

ID transação interno SoluCX.

Dados do Cliente

Se não houver ID de transação, o sistema criará uma nova transação. Para isso, é necessário identificar o cliente.

Parâmetros do Cliente

customer_idstring

ID externo do cliente (do seu sistema). Obrigatório se name não for enviado.

namestring

Nome do cliente. Obrigatório se customer_id não for enviado.

emailstring

E-mail do cliente. Deve ser um e-mail válido.

phonestring

Telefone principal. Formato brasileiro (ex: 11999999999).

phone2string

Telefone secundário.

documentstring

CPF ou CNPJ do cliente.

birth_datestring

Data de nascimento. Formato ISO (ex: 1990-12-31).

Dados da Transação e Colaborador

Parâmetros da Transação

amountnumber

Valor da transação (ex: 150.00). Se não informado, o valor padrão é 0.

store_idstring

ID externo da unidade (loja, hospital, agência). Se não existir, tenta criar usando store_name.

store_namestring

Nome da unidade. Usado para criar a unidade automaticamente se ela não existir.

journeystring

Slug da jornada. Direciona para a pesquisa correta. Se omitido, usa a jornada padrão.

form_idstring

ID do formulário. Obrigatório para jornadas do tipo Flex Survey.

employee_idstring

ID externo do colaborador. Se não existir, tenta criar usando employee_name.

employee_namestring

Nome do colaborador. Usado para criar o colaborador automaticamente.

param_{chave}string

Parâmetros personalizados para enriquecer a transação (ex: param_numeroPedido, param_canalAtendimento). Esses dados ficam disponíveis para análises, cruzamentos e clusterizações dentro da plataforma.

Atenção: Use camelCase após o prefixo param_ (ex: param_orderId). Não use snake_case (ex: param_order_id), pois o sistema interpreta o underscore como separador.

Parâmetros Avançados de Configuração

Parâmetros de Configuração

sourcestring

Canal de origem. Se não informado, usa o canal padrão da jornada ou email. Valores aceitos: email, sms, whatsapp, widget, qrcode, tablet, ura, facebook, gmb, api, employee, push_notification, chatbot, workplace, portals.

scorenumber

Nota prévia da avaliação (ex: 10).

modestring

Se definido como widget, redireciona para a versão compacta da pesquisa.

langstring

Idioma da pesquisa (ex: pt, en, es).

Exemplos de Uso

Link Simples com ID de Transação Externo

Quando você já tem uma transação cadastrada e quer enviar a pesquisa:

https://survey-link.solucx.com.br/link/{api_token}/?transaction_id=ORD-998877

Link com Criação de Cliente e Transação

Cria automaticamente o cliente e a transação com os dados informados:

https://survey-link.solucx.com.br/link/{api_token}/?name=Maria&[email protected]&document=12345678900&amount=150&store_id=UN01

Link Especificando Jornada e Colaborador

Direciona para uma jornada específica e vincula ao colaborador:

https://survey-link.solucx.com.br/link/{api_token}/?name=Cliente&journey=pos-venda&employee_name=Carlos

Link com ID Interno SoluCX

Quando você tem o ID interno da transação no SoluCX:

https://survey-link.solucx.com.br/link/{api_token}/?scx_transaction_id=105543

Link com Parâmetros Personalizados

Enriquece a transação com dados adicionais para análises e cruzamentos:

https://survey-link.solucx.com.br/link/{api_token}/?name=João&param_numeroPedido=1234&param_canalAtendimento=App

Link Completo com Múltiplos Parâmetros

Exemplo combinando cliente, transação, colaborador e parâmetros personalizados:

https://survey-link.solucx.com.br/link/{api_token}/?name=Maria%20Silva&[email protected]&phone=11999998888&amount=299.90&store_id=LJ-001&employee_name=Vendedor%20João&journey=pos-venda&param_formaPagamento=Cartao&param_parcelas=3

Link com Formulário Específico

Para jornadas do tipo Flex Survey que exigem um formulário:

https://survey-link.solucx.com.br/link/{api_token}/?name=Cliente&form_id=42&journey=pesquisa-satisfacao

Aplicações e Casos de Uso Reais

QR Code Genérico (Balcão ou Banheiro)

Ideal para locais físicos onde se deseja capturar feedback espontâneo sem identificar o cliente individualmente.

Cenário: Um adesivo com QR Code no espelho do banheiro de um shopping ou no balcão de atendimento de uma agência bancária. Cria-se um link estático com um nome genérico.

Exemplo de URL:

https://survey-link.solucx.com.br/link/{api_token}/?name=Visitante&store_id=ShoppingSul&source=qrcode&journey=banheiro-limpeza

Resultado: O sistema cria uma transação para o cliente "Visitante" vinculada à unidade "ShoppingSul" na jornada de limpeza.

Link Pós-Atendimento (WhatsApp/Chat)

Utilizado para finalizar um atendimento humano, onde o atendente envia o link para avaliar a interação.

Cenário: Ao final de um suporte via WhatsApp, o atendente cola um link. O sistema de atendimento (CRM/Chatbot) gera o link injetando o nome do cliente e o nome do atendente.

Exemplo de URL:

https://survey-link.solucx.com.br/link/{api_token}/?name=Ana&employee_name=AtendenteJoao&source=whatsapp&journey=suporte-tecnico

Cupom Fiscal (Impressão Dinâmica)

O caso mais rico em dados, onde cada venda gera um link único impresso no rodapé do cupom fiscal.

Cenário: O cliente recebe a nota fiscal com um QR Code e uma chamada: "Escaneie e avalie sua compra de R$ 150,00 na loja Centro". O sistema de PDV (ERP) gera o link dinamicamente para cada venda.

Exemplo de URL:

https://survey-link.solucx.com.br/link/{api_token}/?name=Consumidor&amount=150.00&store_id=LJ-CENTRO&param_pdv=CX03&param_nsu=888999&source=qrcode

Vantagem: Permite rastrear exatamente qual caixa (PDV), qual unidade e qual valor de venda gerou a avaliação, cruzando dados financeiros com NPS.

Assinatura de E-mail

Para coletar feedback contínuo de relacionamento em trocas de e-mail corporativos.

Cenário: Rodapé do e-mail de um gerente de contas. Link fixo na assinatura do e-mail.

Exemplo de URL:

https://survey-link.solucx.com.br/link/{api_token}/?name=Parceiro&employee_name=GerenteRoberto&journey=relacionamento-b2b&source=email

Totem de Autoatendimento

Para capturar feedback em totens de autoatendimento em lojas, aeroportos ou hospitais.

Cenário: Após o cliente finalizar uma operação no totem (check-in, pagamento, consulta), o sistema exibe um QR Code para avaliação.

Exemplo de URL:

https://survey-link.solucx.com.br/link/{api_token}/?name=Usuario&store_id=AEROPORTO-GRU&source=tablet&journey=autoatendimento&param_tipoOperacao=checkin&param_totemId=T05

Observações

O link pode ser enviado por qualquer canal: e-mail, SMS, WhatsApp, QR Code, etc.
Não há autenticação via header, apenas via token na URL.
Se a unidade ou colaborador não existirem, o sistema tenta criá-los automaticamente usando store_name ou employee_name.
Parâmetros inválidos (como e-mail mal formatado ou telefone fora do padrão) retornam erro HTTP 400.

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.