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

# Formularios de WhatsApp

> Qué son los formularios de WhatsApp, las tres formas en que un formulario llega al cliente (agente de IA, Bandeja de entrada, botón de plantilla) y dónde quedan las respuestas.

Un formulario de WhatsApp es un formulario corto que se abre **dentro del chat de WhatsApp**. El cliente toca un botón en tu mensaje, completa campos con formato (texto, email, teléfono, número, fecha, opciones, sí/no, una casilla de consentimiento o una hora para una cita) y lo envía. WhatsApp revisa el formato en el teléfono, así que recibes un email real y una fecha real en lugar de "el martes que viene".

Usa un formulario cuando necesitas **varias respuestas en un formato limpio**: calificar un lead, recoger datos de contacto, pedir una cotización, el consentimiento a tus términos o agendar una cita. Para una sola pregunta, un mensaje normal o botones es más simple.

Los formularios funcionan **solo en WhatsApp**.

## Activa los formularios de WhatsApp en un número

Cada número de WhatsApp tiene un interruptor **Formularios de WhatsApp**. Un administrador lo activa en **Canales**, luego **WhatsApp**: haz clic en el número y abre la pestaña **Formularios de WhatsApp**. Ciarem registra entonces una clave de seguridad en ese número ante Meta, que todo formulario necesita.

* Los números que conectes a partir de ahora empiezan con los formularios **activados**.
* Si un número que usas no tiene los formularios activados, Ciarem te lo pide donde trabajas con formularios (Gestionar formularios, el paso **Formularios** del agente, el selector de formularios de la Bandeja, el botón de formulario de una plantilla): **Los formularios de WhatsApp no están activados en +1 … · Activar**. Los administradores lo activan ahí mismo; al resto del equipo se le pide avisar a un administrador.
* **Requiere atención** significa que Meta no aceptó la clave o ya no la tiene. Se muestra el motivo que dio Meta; corrígelo (por ejemplo, el método de pago de la cuenta de WhatsApp) y vuelve a activarlo.
* Una vez activado, no se puede desactivar: Meta conserva la clave y los formularios ya enviados desde el número dejarían de funcionar.

## Tres formas de enviar un formulario

| Quién lo envía | Cómo | Detalles |
| - | - | - |
| **Tu agente de IA** | Un agente calificador o de citas puede armar su propio formulario, y cualquier agente puede enviar formularios que tú creaste | [Formularios de WhatsApp en tus agentes de IA](https://help.ciarem.ai/es/ai-agent/whatsapp-forms-for-agents.md) |
| **Tu equipo, desde la Bandeja de entrada** | El botón **Formulario de WhatsApp** del redactor | [más abajo](#enviar-un-formulario-desde-la-bandeja-de-entrada) |
| **Una plantilla** | Un botón **Abrir un formulario** en una plantilla de mensaje, también en envíos masivos | [Crear formularios de WhatsApp](https://help.ciarem.ai/es/channels/whatsapp-forms-builder.md#agregar-un-formulario-a-una-plantilla) |

Los formularios que creas tú están en **Canales**, luego **WhatsApp**, luego **Gestionar formularios**. Consulta [Crear formularios de WhatsApp](https://help.ciarem.ai/es/channels/whatsapp-forms-builder.md).

## Enviar un formulario desde la Bandeja de entrada

**1. Abre el selector de formularios**

En una conversación de WhatsApp, haz clic en el botón **Formulario de WhatsApp** del redactor.

**2. Elige un formulario y escribe el mensaje**

Elige un formulario publicado, revisa la vista previa y escribe el **Mensaje** que lo acompaña (por ejemplo "Completa tus datos para recibir tu cotización"). El encabezado y el pie son opcionales.

**3. Envía**

Pulsa **Enviar formulario**. El cliente recibe tu mensaje con el botón del formulario.

Desde la Bandeja de entrada puedes enviar el mismo formulario otra vez cuando lo necesites. Como cualquier mensaje libre, solo sale mientras la [ventana de 24 horas](https://help.ciarem.ai/es/using-ciarem/inbox.md) está abierta. Cuando está cerrada, usa una plantilla con un botón **Abrir un formulario**. La conversación tiene que tener un contacto, porque ahí se guardan las respuestas.

## Dónde quedan las respuestas

* **En el contacto.** Cada campo configurado para guardarse en una propiedad escribe la respuesta en el contacto en cuanto el cliente envía el formulario, lo atienda la IA o una persona. Una respuesta vacía nunca borra lo que el contacto ya tenía.
* **En la conversación.** El envío aparece como una tarjeta con el nombre del formulario, **Formulario enviado**, cuántas respuestas llegaron y cuántas se guardaron en el contacto. **Ver respuestas** abre cada pregunta con su respuesta; las que se guardaron llevan la marca **Guardado en el contacto** con el nombre de la propiedad. Las fotos y los documentos se ven como miniaturas y tarjetas de descarga, y la tarjeta avisa si un archivo no se pudo guardar. En la app móvil el envío se ve como un resumen en texto.
* **Para el agente de IA.** El agente lee las respuestas en la conversación y no vuelve a hacer esas preguntas.
* **Para tus sistemas.** El [evento de webhook](https://help.ciarem.ai/es/webhooks/events.md) **Formulario de WhatsApp enviado** se dispara con cada envío.

Los campos que se guardan en una propiedad se **rellenan** con lo que el contacto ya tiene (en los formularios que creas puedes desactivarlo por campo), así el cliente solo confirma o corrige.

## Ten en cuenta

* **Meta limita el texto.** La etiqueta de un campo admite hasta 20 caracteres (30 en campos de opciones, 40 en fechas). En los formularios de un agente las etiquetas largas se cortan, así que usa nombres de propiedad cortos.
* **Un formulario se publica en Meta, y un formulario publicado no puede cambiar.** Ciarem se encarga: cada cambio publica una versión nueva. Los mensajes ya enviados siguen abriendo la versión con la que salieron.
* **Los formularios pertenecen a tu cuenta de WhatsApp Business**, y cualquier número de esa cuenta puede enviarlos.
* **Un formulario vale 30 días.** Después, las respuestas que lleguen con él se muestran en la conversación pero no se guardan en el contacto, y un formulario de reserva avisa que caducó. Envía uno nuevo.
* **El agente de IA envía cada formulario una vez por conversación.** Si el cliente lo cierra, el mensaje sigue en el chat y puede volver a tocar su botón.

¿Algo no funciona? Consulta [Solución de problemas de formularios de WhatsApp](https://help.ciarem.ai/es/channels/whatsapp-forms-troubleshooting.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.