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

# Formularios y webhooks: capta leads automáticamente

> Cómo crear un formulario para tu sitio web o un webhook para Zapier, Make o tu sistema, y qué hace Clientix con cada lead que llega.

> [!NOTE]
>
> Esta función es para el **dueño** y los **gerentes**. Los leads que llegan quedan como contactos a nombre de la persona que elijas como responsable.

## Qué es cada cosa

| | Formulario | Webhook |
| - | - | - |
| Qué es | Una página que Clientix aloja; la enlazas o la incrustas en tu sitio | Una dirección a la que otra herramienta (Zapier, Make, n8n, tu sistema) envía leads |
| Quién lo usa | Tus visitantes, sin cuenta | Tu herramienta, con una credencial |
| Dónde | **Formularios** en el menú | **Formularios** en el menú |

## Crear un formulario

**1. Entra a Formularios**

En el menú lateral, **Formularios**, y pulsa **Nuevo formulario o webhook**.

**2. Elige el tipo y llena los datos**

Nombre (es el título que verá quien lo llene), responsable de los leads, etapa inicial, origen y, si quieres, pedir teléfono o empresa, campos personalizados y un mensaje de agradecimiento.

**3. Guarda el enlace**

Al crearlo verás el **enlace** y el código para incrustarlo. **Es la única vez que se muestra completo**: cópialo ahora. Si lo pierdes, usa **Token nuevo** (el anterior deja de funcionar).

**4. Pégalo en tu sitio**

Enlázalo en un botón o incrústalo con el código que te damos (un `iframe`).

## Qué pasa cuando alguien lo llena

* Se crea un **contacto nuevo** a nombre del responsable, con el origen que elegiste.
* Si ese correo o teléfono **ya existía**, **no se modifica nada** del contacto: solo se agrega una nota en su historial (a lo más una por día). La persona que llenó el formulario ve exactamente el mismo mensaje en ambos casos, por seguridad.
* La **empresa** que escriba el visitante queda como una nota en el contacto; **no** se crea ni se enlaza una empresa de tu cuenta automáticamente. (El webhook sí puede enlazarla o crearla.)
* Si el correo o teléfono estaba en la lista de personas que pidieron no ser contactadas, esa **baja se vuelve a aplicar**.

## Consentimiento

Puedes pedir consentimiento por correo, WhatsApp, SMS o llamadas. El formulario muestra una casilla **sin marcar** por cada canal, con el texto que tú escribes. Solo si la persona la marca queda registrada su autorización, con ese texto como constancia.

> [!WARNING]
>
> La autorización queda como **«sin verificar»**: Clientix no comprueba que el correo o teléfono sea de quien llenó el formulario. Antes de enviar mensajes comerciales conviene confirmarla (por ejemplo, con un correo de confirmación). Además, **solo se registra para contactos nuevos**: si el contacto ya existía, el formulario no puede autorizarlo.

## Webhook para otras herramientas

Al crearlo recibes la **dirección**, la **cabecera de autorización** (`Authorization: Bearer …`) y un ejemplo de llamada. Acepta: nombre (obligatorio), correo o teléfono (uno de los dos), empresa, etapa, origen, campos personalizados y consentimiento (con su constancia). Responde `created` o `existing` con el id del contacto.

## Límites y seguridad

* Hasta **300 envíos por hora** por formulario (1000 en un webhook) y **2000 por día** por empresa; pasado el tope se responde "demasiados envíos".
* Las solicitudes públicas no pueden pesar más de 16 KB.
* **Pausar** un formulario lo desactiva al instante; **Token nuevo** invalida el anterior.
* Si el dominio de tu empresa deja de estar verificado, formularios y webhooks dejan de recibir hasta que lo restablezcas.
* El formulario incluye una trampa contra robots; quien la active recibe "gracias" pero no se guarda nada.


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