# Formularios

> Pega la dirección de tu agente en tu herramienta de formularios: cuando alguien deja su número, el agente le escribe primero por WhatsApp.

Source: https://docs.whatsetter.com/es/dashboard/forms/

Alguien deja su número en uno de tus formularios, y tu agente le escribe
primero por WhatsApp. La página **Formularios** da la dirección de cada
agente: la pegas una vez en tu herramienta de formularios.

## Para qué sirve la página Formularios

Abre **Formularios** en el menú, bajo **Prospectar**. Alguien rellena uno de
tus formularios, en tu web, una página de ventas o un anuncio, y deja su
número de teléfono. Tras una breve espera, 3 minutos por defecto, tu agente
le escribe primero por WhatsApp. La persona no tiene que hacer clic en nada.

Funciona con una dirección. Cada agente tiene una. La pegas una vez en tu
herramienta de formularios, y cada respuesta nueva que la herramienta recibe
se transmite al agente. Esta dirección se llamaba antes la URL del webhook.

En esta página no se crea nada: lista tus agentes, dice cuáles están listos y
te deja copiar su dirección.

Es una de las tres formas en que un contacto llega a un agente, junto con los
[enlaces](/es/dashboard/tracked-links/), donde la persona hace clic y escribe
primero, y las [listas](/es/dashboard/lists/), donde importas los contactos.

## Encontrar y copiar la dirección de un agente

Abre **Formularios**. Bajo **La dirección de cada agente**, cada agente es una
línea con un botón **Copiar la dirección**.

Haz clic en una línea para abrirla. La dirección completa aparece bajo
**Dirección para pegar en tu herramienta de formularios**, con un botón
**Copiar**, la **Espera del primer mensaje** y un enlace
**Ver el primer mensaje**.

La dirección está en el dominio de tu panel y termina en `/f/` seguido de un
código propio del agente, por ejemplo `https://app.whatsetter.com/f/k3x9…`.
Ese código es lo que la mantiene privada: pégala solo en tu herramienta de
formularios.

Hay una dirección por agente: lo que llega a esa dirección es para él. Un
agente tiene su dirección desde el día en que se crea. Los agentes que todavía
no están activos quedan bajo **Borradores**: ya tienen su dirección, pero no
escriben a nadie hasta que estén activos. Los agentes que siguen grupos no
aparecen.

Si la página indica «Crea primero un agente», mira
[Crea tu agente IA](/es/getting-started/agent/).

## Pegar la dirección en tu herramienta de formularios

En tu herramienta de formularios, busca la palabra «webhook»: ahí va la
dirección. La herramienta debe enviar cada respuesta a la dirección con el
método POST. La página **Formularios** indica dónde pegarla, bajo
**Dónde pegar la dirección**:

| Herramienta | Dónde va la dirección |
|---|---|
| Typeform | Connect, luego Webhooks y «Add a webhook». |
| Tally | Integraciones, luego Webhooks. |
| Systeme.io | Formulario, Ajustes y «URL Webhook». |
| HubSpot | Formulario, Integraciones y «Añadir un webhook». |
| Zapier o Make | Añade una acción «Webhook» que envíe un POST a la dirección. Úsala para los formularios de tus anuncios en redes sociales. |

Pega la dirección del agente que debe escribir a esas personas. Un formulario
envía a un agente. Una respuesta de más de 1 MB se rechaza, y una dirección
que recibe más de 60 respuestas en un minuto rechaza las siguientes durante un
momento.

## Recibir los contactos de tus anuncios de Facebook e Instagram

Los formularios de anuncios de Facebook e Instagram (Lead Ads) no tienen campo de webhook: pasan por Zapier o Make. Después, tu agente escribe primero a cada persona que deja su número.

1. Abre **Formularios** y copia la dirección del agente que debe escribir a estas personas.
2. En Zapier o Make, crea un escenario que empiece con cada nuevo contacto de tu formulario de anuncio.
3. Añade una acción «Webhook» que envíe un POST a la dirección de tu agente, con el número de teléfono y el nombre.

## Cambiar la dirección de un agente compartida por error

Si la dirección de un agente llegó adonde no debía, cámbiala: la nueva
reemplaza a la antigua.

1. Abre **Formularios** y haz clic en la línea del agente.
2. Junto a **¿Dirección compartida por error?**, haz clic en **Cambiar de dirección**.
3. Confirma con **Nueva dirección**. **Cancelar** no cambia nada.
4. Copia la nueva dirección y pégala en tu herramienta de formularios, en lugar de la antigua.

La dirección antigua deja de funcionar enseguida: los formularios que todavía
la usan ya no llegan. Necesitas el derecho
**Conectar herramientas (calendario, enlaces, Instagram)**.

## Qué campos debe enviar tu formulario

No se impone ningún formato: tus campos conservan su nombre. WhatSetter lee
las respuestas y encuentra lo que necesita. La página **Formularios** lo
resume bajo **Lo que envía tu formulario**:

| Campo | ¿Hace falta? | Para qué sirve |
|---|---|---|
| El número de teléfono | Obligatorio | El número al que escribe el agente. |
| El nombre | Recomendado | El agente saluda a la persona por su nombre. |
| Todas las demás respuestas | Opcional | Email, necesidad, presupuesto: el agente las lee y las usa en su primer mensaje. |

Ejemplo de lo que envía una herramienta:

```json
{
  "nombre": "Camila",
  "teléfono": "+34 612 34 56 78",
  "necesidad": "Reformar mi cocina"
}
```

Sin número de teléfono, el agente no puede escribir, y no se crea nada.

## Qué formato de número enviar

Envía el número con el prefijo del país: `+34 612 34 56 78` o
`0034 612 34 56 78`. Un número que empieza por `+` o `00` se usa tal cual. Es
el formato más seguro. Los espacios, los puntos, los guiones y los paréntesis
no cuentan.

Un número enviado sin prefijo se adivina por su forma, y la lectura puede ser
errónea:

- 10 cifras que empiezan por 0 se leen como un número francés;
- 11 cifras que empiezan por 0 se leen como un número británico;
- 10 cifras que no empiezan por 0 se leen como un número de Estados Unidos o Canadá.

Los demás formatos locales pueden leerse en el país equivocado, y el mensaje
no llega entonces a ninguna parte. Cuando tu formulario se usa en un solo
país, haz que el campo de teléfono pida el prefijo, o añádelo en tu
herramienta antes de enviar.

## Qué agente recibe el contacto

El agente cuya dirección recibió el formulario. No hay lista que elegir ni
nada que asignar: una dirección pertenece a un agente, y ese agente escribe
desde su propio número de WhatsApp, con su propio primer mensaje.

- Para enviar dos formularios a dos agentes distintos, pega una dirección distinta en cada formulario.
- Para enviar varios formularios al mismo agente, pega la misma dirección en todos.
- Un contacto que llega por un formulario no aparece en **Listas**. Una vez que el agente ha escrito, la persona está en [Conversaciones](/es/dashboard/conversations/) y en [Leads](/es/dashboard/leads/), como cualquier otro lead.

Un formulario recibe respuesta una persona cada vez, tras la espera ajustada
en el agente. Para elegir tú el ritmo, los días y los horarios, importa mejor
los contactos en una [lista](/es/dashboard/lists/).

## Cuándo escribe el agente después de un formulario, y qué escribe

Abre **Formularios** y haz clic en la línea de un agente.
**Espera del primer mensaje** es el tiempo entre el formulario y el primer
mensaje del agente. Es de 3 minutos como mínimo. Haz clic en **Modificar**
para cambiarlo: llegas a la pestaña **Ajustes** del agente, sección
**Envío**, donde las opciones son 3, 10 o 30 minutos, o 1, 2, 4, 8 o 24 horas.

**Lo que escribe el agente** es su primer mensaje, escrito para cada persona a
partir del prompt del agente y de las respuestas del formulario. Haz clic en
**Ver el primer mensaje** para leerlo o cambiarlo en la pestaña **Prompt**
del agente, bajo **Primer mensaje**.

El mensaje puede salir un poco después de la espera cuando el número acaba de
escribir a otra persona: los primeros mensajes se espacian para proteger el
número. Mira [Cómo protegemos tu número](/es/dashboard/anti-ban/).

## Qué significa cada estado de la página Formularios

Abre **Formularios**. La línea de arriba cuenta los agentes listos para
recibir tus formularios, y cada agente tiene un estado:

| Estado | Qué significa |
|---|---|
| **Listo** | El agente está activo y su número funciona. Su línea dice al cabo de cuánto tiempo escribe. |
| **Por revisar** | El agente está activo, pero su número está desconectado, espera ser reconectado, o falta. Abre la línea y haz clic en **Reconectar** o **Conectar un número**: se abre la página **Números de WhatsApp**, con la ventana de conexión de este agente para **Reconectar**. |
| **En pausa** | Un formulario recibido no envía ningún mensaje. Haz clic en **Abrir el agente** para reactivarlo. |
| **Borrador** | El agente todavía no está activo: un formulario recibido no envía ningún mensaje. |

Los formularios recibidos mientras un agente está en pausa o en borrador no se
guardan: nadie recibe un mensaje más tarde. Un formulario recibido mientras el
número de un agente activo está desconectado espera, y el primer mensaje sale
después de la reconexión.

## Probar un formulario

1. Abre **Formularios** y comprueba que el agente indica **Listo**.
2. Rellena tu propio formulario, como lo haría un visitante, con un número de WhatsApp al que este agente nunca haya escrito. Escribe el número con el prefijo del país.
3. Espera la **Espera del primer mensaje**, 3 minutos como mínimo.
4. Mira WhatsApp en ese teléfono: llega el primer mensaje del agente. En la aplicación, la persona aparece en [Conversaciones](/es/dashboard/conversations/).

Usa un número nuevo en cada prueba. La página **Formularios** enuncia la
regla: «Una persona a la que este agente ya contactó no recibe un segundo
primer mensaje.» Una segunda prueba con el mismo número no es por tanto una
prueba válida.

Para leer lo que escribiría el agente sin enviar nada, usa la pestaña
**Probar** del agente: mira [Prueba tu agente](/es/dashboard/playground/).

## Por qué un formulario enviado no manda ningún mensaje

Abre **Formularios** y revisa estas causas en orden:

1. El agente está **En pausa** o en **Borrador**: los formularios se ignoran hasta que esté activo.
2. El formulario no envió ningún número, o envió uno ilegible. Envíalo con el prefijo del país.
3. El número no está en WhatsApp: no se envía nada.
4. Este agente ya escribió a esa persona. La página enuncia la regla: «Una persona a la que este agente ya contactó no recibe un segundo primer mensaje.» Es la causa habitual cuando pruebas dos veces con el mismo número.
5. El mensaje está en camino: sale después de la **Espera del primer mensaje**, 3 minutos como mínimo.
6. El número del agente está desconectado (estado **Por revisar**): el contacto espera, y el mensaje sale después de la reconexión.
7. Se agotaron los mensajes del mes de tu plan, o la cuenta está suspendida tras un pago fallido: mira [Suscripción](/es/dashboard/billing/).
8. La dirección de tu herramienta de formularios no es la que muestra la página **Formularios**, por ejemplo porque se cambió con **Cambiar de dirección**, o la herramienta no envía con el método POST.

## Enviar tus leads a otra herramienta, el sentido contrario

La página **Formularios** recibe contactos. Para hacer lo contrario y enviar
tus leads cualificados a tu CRM u otra herramienta, usa el enlace
**Abrir API y MCP** al pie de la página: abre esa parte de
**Configuración**.

Para los desarrolladores, dos páginas van más lejos.
[Webhooks firmados](/es/developers/webhooks/) describe lo que WhatSetter
envía a tus herramientas cuando le pasa algo a un lead.
[API: campañas](/es/developers/guides/campaigns/) muestra cómo entregar un
contacto a un agente desde tu propio código, en lugar de una herramienta de
formularios.

## Quién puede abrir la página Formularios

La entrada **Formularios** del menú y su página solo aparecen para las
personas que tienen el derecho
**Conectar herramientas (calendario, enlaces, Instagram)**. **Propietario** y
**Admin** lo tienen. Los demás roles no, salvo que les des ese derecho en un
rol **A medida**.

Copiar una dirección no requiere nada más. Cambiar la espera o el primer
mensaje se hace en el agente, y requiere el derecho de modificar los agentes.

Los roles y los derechos se ajustan en [Equipo](/es/dashboard/team/).

## Relacionado

- [Enlaces con seguimiento](/es/dashboard/tracked-links/)
- [Listas e importación](/es/dashboard/lists/)
- [El prompt de tu agente](/es/dashboard/prompt/)
- [API: campañas](/es/developers/guides/campaigns/)
