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

# Formularios de WhatsApp (Flows)

> Pide varios datos de una sola vez con un formulario que el cliente llena dentro de WhatsApp, sin salir del chat.

Un **formulario de WhatsApp** (WhatsApp Flow) es una pantalla que se abre dentro de la conversación y en la que el cliente llena varios datos de una sola vez.

Es la alternativa a preguntar dato por dato.

| Sin formulario                                                                                    | Con formulario                                               |
| ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| "¿Me das tu nombre?" → espera → "¿Tu número de identidad?" → espera → "¿Método de pago?" → espera | El cliente toca un botón, llena todo en una pantalla y envía |
| El agente arma la información a mano, mensaje por mensaje                                         | Los datos llegan completos y ordenados                       |
| El cliente puede abandonar a mitad de camino                                                      | No puede enviar hasta completar los campos obligatorios      |
| Un dato mal escrito hay que volver a pedirlo                                                      | Puedes exigir un formato y validarlo antes de enviar         |

<Callout type="info">
  El cliente **no sale de WhatsApp** ni abre un enlace externo. Todo pasa dentro del chat.
</Callout>

## Crear un formulario

<Steps>
  <Step title="Ve a Formularios y crea uno nuevo">
    Ponle un nombre que reconozcas después — por ejemplo "Datos Nicaragua".
  </Step>

  <Step title="Elige cómo armarlo">
    Tienes dos caminos: **describirlo con IA** o **armarlo tú**.
  </Step>

  <Step title="Describirlo con IA (recomendado)">
    Pega el texto de las preguntas que hoy haces a mano y pídele que arme el formulario. La IA convierte cada pregunta en su campo correcto: texto, opción única, sí/no, número.

    No necesitas saber nada de código.
  </Step>

  <Step title="Armarlo tú">
    También puedes agregar los campos uno por uno, o editar directamente la definición del formulario si quieres control total.
  </Step>

  <Step title="Pruébalo antes de usarlo">
    Usa la opción de prueba para verlo tal como lo verá el cliente y recorrer todos los pasos.
  </Step>

  <Step title="Guarda">
    El formulario queda disponible para usarlo desde el inbox y desde las respuestas rápidas.
  </Step>
</Steps>

## Qué puede hacer un formulario

* **Campos de texto** — nombre, número de identidad, celular.
* **Opciones** — método de pago (efectivo o tarjeta), sí/no.
* **Pasos condicionales** — si el cliente responde "efectivo", le preguntas si necesita cambio; si responde "tarjeta", te saltas esa pregunta.
* **Campos obligatorios** — el cliente no puede enviar hasta completarlos.
* **Formato** — puedes exigir que un dato venga con cierta forma.

## Cómo lo usas en el día a día

### Desde una respuesta rápida

Es la forma más cómoda. Creas una respuesta rápida, eliges **Formulario** y seleccionas cuál. Le pones un texto de acompañamiento — por ejemplo "Para continuar, ingresa tus datos" — y la guardas.

A partir de ahí, el agente solo elige esa respuesta rápida y el formulario se envía.

### Desde el inbox

En la conversación, el agente puede enviar cualquier formulario guardado directamente desde el compositor.

### Qué ve el cliente

Le llega un mensaje con un botón. Al tocarlo se abre la pantalla del formulario, la completa y la envía. La información llega completa a la conversación — el agente no tuvo que preguntar nada.

## Preguntas frecuentes

<Accordions>
  <Accordion title="¿Tiene costo enviar un formulario?">
    No. El formulario en sí no tiene costo. Lo que se cobra es el mensaje que lo transporta, con las mismas reglas de siempre: dentro de la ventana de 24 horas es libre, fuera de ella necesitas una plantilla.
  </Accordion>

  <Accordion title="¿Cuántos formularios puedo tener?">
    Depende de tu plan. Si necesitas más, escríbenos a [hi@shimli.app](mailto:hi@shimli.app).
  </Accordion>

  <Accordion title="¿Necesito saber programar?">
    No. Describe lo que quieres pedir y la IA arma el formulario. La edición manual está ahí solo por si quieres control total.
  </Accordion>

  <Accordion title="¿En qué se diferencia de un formulario web?">
    El formulario de WhatsApp se llena **dentro del chat**. El [formulario web](/guides/databases) se publica en internet y se comparte con un enlace — sirve para capturar datos fuera de la conversación, por ejemplo desde tu sitio o una campaña.
  </Accordion>
</Accordions>