> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laburen.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración de Formularios con Agentes

> Aprende a conectar formularios a tus Agentes de IA para recopilar información estructurada

# Conectando Formularios con Agentes

Los Agentes de Laburen pueden utilizar formularios para recopilar información estructurada de los usuarios durante una conversación. Esta integración es ideal para casos de uso como:

* Captura de datos de contacto
* Recopilación de información para cotizaciones
* Programación de citas o reservas
* Registro de solicitudes de soporte
* Encuestas de satisfacción

## Configuración de la Herramienta de Formulario

Para conectar un formulario a tu Agente, sigue estos pasos:

<Steps>
  <Step title="Crear un Formulario">
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/chatsappaicom/images/create-form.png" alt="Crear un Formulario" />

    1. Ve a la sección de [Formularios](https://dashboard.laburen.com/forms) en tu Dashboard
    2. Crea un nuevo formulario con los campos que necesitas
    3. Guarda y publica tu formulario
    4. Toma nota del ID del formulario (lo necesitarás en el siguiente paso)
  </Step>

  <Step title="Configurar la Herramienta de Formulario">
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/chatsappaicom/images/form-tool-config.png" alt="Configurar Herramienta de Formulario" />

    1. Ve a la configuración de tu [Agente](https://dashboard.laburen.com/agents)
    2. Navega a la pestaña "Configuración"
    3. En la sección "Herramientas", haz clic en "Añadir Herramienta"
    4. Selecciona "Herramienta de Formulario"
    5. Ingresa el ID del formulario que creaste
    6. Configura las opciones adicionales (ver abajo)
    7. Guarda los cambios
  </Step>

  <Step title="Personalizar el Comportamiento">
    Al configurar la Herramienta de Formulario, puedes ajustar estas opciones:

    * **Nombre de la Herramienta**: Un nombre descriptivo para identificar esta herramienta
    * **Descripción**: Instrucciones para el Agente sobre cuándo y cómo usar este formulario
    * **Condiciones de Activación**: Palabras clave o frases que activarán el formulario
    * **Mensaje de Introducción**: Texto que el Agente mostrará antes de presentar el formulario
    * **Mensaje de Finalización**: Texto que el Agente mostrará después de completar el formulario
  </Step>

  <Step title="Probar la Integración">
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/chatsappaicom/images/test-form-agent.png" alt="Probar Integración de Formulario" />

    1. Ve a la pestaña "Probar" de tu Agente
    2. Inicia una conversación que debería activar el formulario
    3. Verifica que el formulario se muestre correctamente
    4. Completa el formulario para asegurarte de que funciona como se espera
    5. Confirma que los datos se capturan correctamente
  </Step>
</Steps>

## Ejemplo de Configuración

Aquí hay un ejemplo de cómo configurar una Herramienta de Formulario para capturar información de contacto:

```json theme={null}
{
  "name": "Formulario de Contacto",
  "description": "Utiliza este formulario cuando un usuario quiera contactarnos, solicitar una cotización o programar una demostración",
  "formId": "form_abc123xyz",
  "triggerKeywords": [
    "contactar", "cotización", "demo", "demostración", "hablar con ventas", 
    "más información", "precio", "precios"
  ],
  "introMessage": "Para poder ayudarte mejor, necesito recopilar algunos datos. Por favor, completa el siguiente formulario:",
  "completionMessage": "¡Gracias por proporcionar tu información! Un miembro de nuestro equipo se pondrá en contacto contigo en las próximas 24 horas."
}
```

## Mejores Prácticas

Para obtener los mejores resultados al integrar formularios con tus Agentes:

* **Sé específico con las instrucciones**: Proporciona una descripción clara de cuándo el Agente debe utilizar el formulario
* **Limita el número de campos**: Mantén los formularios concisos para mejorar las tasas de finalización
* **Utiliza condiciones de activación precisas**: Define palabras clave específicas que indiquen la intención del usuario
* **Personaliza los mensajes**: Adapta los mensajes de introducción y finalización al tono de tu marca
* **Configura notificaciones**: Asegúrate de recibir alertas cuando los usuarios completen formularios

## Acceso a los Datos Recopilados

Los datos recopilados a través de formularios se pueden acceder de varias maneras:

1. **Dashboard de Laburen**: Ve a la sección de Formularios > Respuestas
2. **Notificaciones por Email**: Configura alertas para recibir los datos por correo electrónico
3. **Webhooks**: Configura webhooks para enviar los datos a tus sistemas externos
4. **API**: Accede a los datos programáticamente a través de la API de Laburen

<Note>
  Recuerda que los datos recopilados a través de formularios están sujetos a las leyes de protección de datos. Asegúrate de tener una política de privacidad clara y de obtener el consentimiento adecuado de los usuarios.
</Note>

## Solución de Problemas

Si tu formulario no se activa correctamente:

* Verifica que el ID del formulario sea correcto
* Asegúrate de que el formulario esté publicado y activo
* Revisa las condiciones de activación y ajústalas si es necesario
* Comprueba que el Agente tenga permisos para acceder al formulario
* Verifica que no haya conflictos con otras herramientas configuradas

Para más ayuda, contacta a nuestro equipo de soporte en [support@laburen.com](mailto:support@laburen.com).