Skip to main content
Para la configuración general, empieza por la guía de recopilación. Esta página desarrolla un ejemplo práctico. Recopilar datos convierte las respuestas de una conversación en una solicitud estructurada guardada en Visito. En este ejemplo, una persona interesada en comprar vivienda comparte una zona de Nueva York, un presupuesto y un plazo. El agente pide la información pendiente, confirma las preferencias y las guarda. No necesitas una hoja de cálculo, un servidor API ni un webhook. El ejemplo registra preferencias; no busca propiedades, evalúa compradores, agenda visitas ni crea automáticamente una oportunidad comercial.
Las capturas muestran el panel en inglés y una prueba local con datos ficticios. La conversación aparece bajo el contacto de prueba autenticado; la zona y el presupuesto son valores de demostración. Usa el negocio y el contacto de prueba adecuados para tu espacio.

​
1. Crea la acción

Abre Configuración → Acciones y selecciona Recopilar datos (Collect data en las capturas). Usa un nombre específico:
En Cuándo y cómo debe usarla la IA, describe la intención del cliente, las preguntas y el momento de guardar:
Elige Disponible en conscientemente. Esta demostración usa Todos los negocios en un espacio controlado. Si el equipo inmobiliario pertenece a un espacio con varios negocios, selecciona el correspondiente para no ofrecer la acción en conversaciones ajenas. Configuración general con el propósito, el alcance y el modo exclusivo del área de pruebas. La captura muestra el editor de una acción guardada. La creación reúne esos ajustes con los campos y el destino opcional. Después puedes reabrirla y usar las pestañas General, Campos y Destino.

​
2. Define los tres campos

Selecciona Agregar campo para cada fila. Mantén Obligatorio marcado en los tres. Los nombres son identificadores estables de los valores guardados. Usa minúsculas, números y guiones bajos, empezando por una letra. Las descripciones orientan al agente; resultan más útiles que una etiqueta aislada. Usa estas descripciones: neighborhood
budget_usd
purchase_timeframe
Campos de texto y número con sus descripciones y valores obligatorios. Para Selección única, escribe cada opción en Agregar opción y pulsa Enter después de cada una:
Comprueba que aparezcan como tres etiquetas independientes. Conservamos las opciones en inglés para reproducir exactamente la demostración; puedes traducirlas al configurar tu propia acción. El cliente puede decir «en los próximos seis meses» y el valor guardado debe coincidir con la opción configurada Within 6 months. No conviertas silenciosamente un plazo diferente en la opción más cercana. Campo de plazo con tres opciones individuales. El tipo numérico guarda 900000 como número, no como el texto $900,000. La convención USD procede del nombre del campo y sus instrucciones. El tipo numérico por sí solo no explica la moneda al cliente.
«Obligatorio» exige un valor antes del envío. Confirmar antes de guardar forma parte de las instrucciones de esta acción; la casilla no añade por sí sola un paso de confirmación.

​
3. Deja el destino vacío

Mantén vacíos Destino HTTPS y Token bearer. La solicitud se guarda en Visito. Destino opcional vacío y explicación de que las solicitudes se guardan solo en Visito. El webhook permite enviar los datos recopilados a otro sistema. Es distinto de una acción de Conectar un sistema, que consulta una API para obtener un resultado durante la conversación. Este ejemplo no envió ningún webhook. Selecciona Crear acción. Las acciones nuevas empiezan en Solo área de pruebas. El control de estado ofrece: Para una prueba controlada en Webchat, reabre la acción, selecciona Activa y Guardar cambios. Usa preferencias ficticias. En esta demostración local se desactivó temporalmente el planificador para probar las acciones de la capa de respuesta; no se verificó el enrutamiento de producción. La acción activa bajo el filtro Collect data.

​
4. Prueba una conversación natural

Inicia una conversación nueva en Webchat. Usa la intención normal del cliente, sin indicar al agente el nombre interno de la herramienta.
  1. Cliente: «Hola, quiero comprar una vivienda en Nueva York. ¿Puedo compartir lo que busco?»
  2. El agente pregunta por la zona, el presupuesto máximo en USD y el plazo.
  3. Cliente: «Park Slope, en Brooklyn, con un presupuesto máximo de 900.000 dólares estadounidenses».
  4. El agente pide el plazo pendiente en lugar de guardar un registro incompleto.
El agente pide el plazo pendiente tras recibir la zona y el presupuesto.
  1. Cliente: «En los próximos seis meses».
  2. El agente repite las tres preferencias y pide confirmación.
El agente resume las preferencias antes de guardarlas.
  1. Cliente: «Sí, es correcto. Guarda esas preferencias».
  2. Se ejecuta la acción, Webchat muestra Request saved y el agente confirma los datos guardados.
Recopilación correcta en Webchat después de la confirmación. La conversación real de las capturas se hizo en inglés. Produjo una solicitud con estos valores:

​
5. Revisa el historial de Acciones

Abre Acciones → Historial, selecciona la acción en el filtro Acción y abre la ejecución correspondiente. Actualiza si todavía no aparece la más reciente. La demostración muestra Completed → Information saved, entorno Live, los tres parámetros y una respuesta con status: submitted y un submissionId. «Live» identifica el modo del canal; la captura corresponde a un entorno local de prueba. El historial muestra los parámetros con sus tipos y el identificador de la solicitud. El identificador de la solicitud es el resultado concreto que respalda la confirmación del agente. La ejecución tardó 32 ms en el entorno local; es el tiempo de la acción, no una garantía de latencia de toda la conversación.

​
6. Revisa la conversación y el registro

Selecciona Abrir conversación en el detalle de ejecución. Despliega NYC homebuyer preferences · Completed en la conversación. Verás el resultado Saved, los campos enviados con sus tipos y la versión de la acción utilizada. Comprobante desplegado dentro de la conversación. Abre la pestaña CRM de la conversación. En Action submissions, comprueba la misma zona, presupuesto numérico y plazo. Webhook: Not configured es correcto porque el destino estaba vacío. Valores guardados en el CRM junto al comprobante de la acción completada. El panel también indica No sales opportunity yet. Una solicitud no crea automáticamente una oportunidad comercial, una asignación de seguimiento ni una llamada programada. Configura esos pasos aparte si los necesitas. Para un flujo real de captación, añade un campo de contacto solo cuando sea necesario y explica su propósito al cliente.

​
Reutilización y solución de problemas

  • El agente no puede usar la acción: revisa el modo, el negocio, los cambios guardados y si el enrutamiento transfirió la conversación antes de que pudiera ejecutarse.
  • No aparece en CRM tras una prueba en Playground: es lo esperado; las solicitudes de prueba están separadas de los registros de los canales reales.
  • Falta una respuesta obligatoria: el agente debe pedirla, no inventarla.
  • El cliente indica otro plazo: pide elegir una opción compatible o modifica conscientemente las opciones de la acción.
  • El cliente corrige un dato: confirma las preferencias corregidas antes de enviarlas. No supongas que una nueva ejecución modifica el registro anterior.
  • El agente dice que guardó los datos: verifica el comprobante y la solicitud; la respuesta en lenguaje natural no basta como evidencia.
Antes de publicar tu versión, prueba respuestas incompletas, moneda ambigua, opciones no admitidas, correcciones antes de guardar y un envío completo. Esta guía verificó directamente la solicitud del campo pendiente, la confirmación, la normalización numérica y de opciones, el historial y el registro en CRM. No se probó la entrega por webhook ni el enrutamiento de producción. Después de capturar el ejemplo local, devuelve la acción a Solo área de pruebas para evitar nuevos registros en canales reales de forma involuntaria. La solicitud demostrada y el historial permanecen disponibles.