Survey Link

Survey Link permite crear URLs personalizadas para recopilar feedback de sus clientes. Simplemente genere un enlace con los parámetros deseados y envíelo por cualquier canal: correo electrónico, SMS, WhatsApp, QR Code, cupón fiscal, etc.

Endpoint

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

El api_token es el token de su instancia SoluCX. Puede encontrarlo en Configuraciones de la Instancia en la plataforma.

Cómo Funciona

Monte la URL con los parámetros deseados
Envíe el enlace al cliente por el canal de su preferencia
El cliente hace clic en el enlace y es dirigido a la encuesta
La respuesta se registra automáticamente en la plataforma

Importante: Para crear un nuevo cliente automáticamente, el enlace debe contener al menos name o customer_id.

Parámetros Disponibles

Identificación de la Transacción

Use estos parámetros cuando quiera vincular la encuesta a una transacción ya existente.

Parámetros de Transacción

transaction_idstring

ID externo de la transacción (de su sistema). Busca la transacción por la integración externa.

scx_transaction_idnumber

ID transacción interno SoluCX.

Datos del Cliente

Si no hay ID de transacción, el sistema creará una nueva transacción. Para ello, es necesario identificar al cliente.

Parámetros del Cliente

customer_idstring

ID externo del cliente (de su sistema). Obligatorio si name no se envía.

namestring

Nombre del cliente. Obligatorio si customer_id no se envía.

emailstring

Correo electrónico del cliente. Debe ser un correo válido.

phonestring

Teléfono principal. Formato brasileño (ej: 11999999999).

phone2string

Teléfono secundario.

documentstring

CPF o CNPJ del cliente.

birth_datestring

Fecha de nacimiento. Formato ISO (ej: 1990-12-31).

Datos de la Transacción y Colaborador

Parámetros de la Transacción

amountnumber

Valor de la transacción (ej: 150.00). Si no se informa, el valor predeterminado es 0.

store_idstring

ID externo de la unidad (tienda, hospital, agencia). Si no existe, intenta crear usando store_name.

store_namestring

Nombre de la unidad. Usado para crear la unidad automáticamente si no existe.

journeystring

Slug del journey. Dirige a la encuesta correcta. Si se omite, usa el journey predeterminado.

form_idstring

ID del formulario. Obligatorio para journeys del tipo Flex Survey.

employee_idstring

ID externo del colaborador. Si no existe, intenta crear usando employee_name.

employee_namestring

Nombre del colaborador. Usado para crear el colaborador automáticamente.

param_{clave}string

Parámetros personalizados para enriquecer la transacción (ej: param_numeroPedido, param_canalAtencion). Estos datos quedan disponibles para análisis, cruces y clusterizaciones dentro de la plataforma.

Atención: Use camelCase después del prefijo param_ (ej: param_orderId). No use snake_case (ej: param_order_id), ya que el sistema interpreta el underscore como separador.

Parámetros Avanzados de Configuración

Parámetros de Configuración

sourcestring

Canal de origen. Si no se informa, usa el canal predeterminado del journey o email. Valores aceptados: email, sms, whatsapp, widget, qrcode, tablet, ura, facebook, gmb, api, employee, push_notification, chatbot, workplace, portals.

scorenumber

Nota previa de la evaluación (ej: 10).

modestring

Si se define como widget, redirige a la versión compacta de la encuesta.

langstring

Idioma de la encuesta (ej: pt, en, es).

Ejemplos de Uso

Enlace Simple con ID de Transacción Externo

Cuando ya tiene una transacción registrada y quiere enviar la encuesta:

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

Enlace con Creación de Cliente y Transacción

Crea automáticamente el cliente y la transacción con los datos informados:

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

Enlace Especificando Journey y Colaborador

Dirige a un journey específico y vincula al colaborador:

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

Enlace con ID Interno SoluCX

Cuando tiene el ID interno de la transacción en SoluCX:

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

Enlace con Parámetros Personalizados

Enriquece la transacción con datos adicionales para análisis y cruces:

https://survey-link.solucx.com.br/link/{api_token}/?name=Juan&param_numeroPedido=1234&param_canalAtencion=App

Enlace Completo con Múltiples Parámetros

Ejemplo combinando cliente, transacción, colaborador y parámetros personalizados:

https://survey-link.solucx.com.br/link/{api_token}/?name=Maria%20Silva&[email protected]&phone=11999998888&amount=299.90&store_id=TI-001&employee_name=Vendedor%20Juan&journey=pos-venta&param_formaPago=Tarjeta&param_cuotas=3

Enlace con Formulario Específico

Para journeys del tipo Flex Survey que exigen un formulario:

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

Aplicaciones y Casos de Uso Reales

QR Code Genérico (Mostrador o Baño)

Ideal para ubicaciones físicas donde se desea capturar feedback espontáneo sin identificar al cliente individualmente.

Escenario: Un adhesivo con QR Code en el espejo del baño de un centro comercial o en el mostrador de atención de una agencia bancaria. Se crea un enlace estático con un nombre genérico.

Ejemplo de URL:

https://survey-link.solucx.com.br/link/{api_token}/?name=Visitante&store_id=CentroComercialSur&source=qrcode&journey=bano-limpieza

Resultado: El sistema crea una transacción para el cliente "Visitante" vinculada a la unidad "CentroComercialSur" en el journey de limpieza.

Enlace Post-Atención (WhatsApp/Chat)

Utilizado para finalizar una atención humana, donde el agente envía el enlace para evaluar la interacción.

Escenario: Al final de un soporte vía WhatsApp, el agente pega un enlace. El sistema de atención (CRM/Chatbot) genera el enlace inyectando el nombre del cliente y el nombre del agente.

Ejemplo de URL:

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

Cupón Fiscal (Impresión Dinámica)

El caso más rico en datos, donde cada venta genera un enlace único impreso al pie del cupón fiscal.

Escenario: El cliente recibe la factura con un QR Code y un llamado: "Escanee y evalúe su compra de $150,00 en la tienda Centro". El sistema de PDV (ERP) genera el enlace dinámicamente para cada venta.

Ejemplo de URL:

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

Ventaja: Permite rastrear exactamente qué caja (PDV), qué unidad y qué valor de venta generó la evaluación, cruzando datos financieros con NPS.

Firma de Correo Electrónico

Para recopilar feedback continuo de relación en intercambios de correo electrónico corporativos.

Escenario: Pie del correo electrónico de un gerente de cuentas. Enlace fijo en la firma del correo.

Ejemplo de URL:

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

Tótem de Autoservicio

Para capturar feedback en tótems de autoservicio en tiendas, aeropuertos u hospitales.

Escenario: Después de que el cliente finaliza una operación en el tótem (check-in, pago, consulta), el sistema muestra un QR Code para evaluación.

Ejemplo de URL:

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

Observaciones

El enlace puede enviarse por cualquier canal: correo electrónico, SMS, WhatsApp, QR Code, etc.
No hay autenticación vía header, solo vía token en la URL.
Si la unidad o colaborador no existen, el sistema intenta crearlos automáticamente usando store_name o employee_name.
Parámetros inválidos (como correo mal formateado o teléfono fuera del formato estándar) retornan error HTTP 400.

Chatbot Webhook

IFrame