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

# Campos y mapeo del Webhook

> Qué campos acepta el canal Webhook, cuáles son obligatorios y cómo mapear los nombres de campo de tu propio formulario.

## Campos que Asistian reconoce

| Campo        | Qué es                       | ¿Obligatorio?                      |
| ------------ | ---------------------------- | ---------------------------------- |
| `email`      | Correo del contacto          | **Email o teléfono: al menos uno** |
| `phone`      | Teléfono del contacto        | **Email o teléfono: al menos uno** |
| `first_name` | Nombre                       | Opcional                           |
| `last_name`  | Apellido                     | Opcional                           |
| `message`    | Mensaje o motivo de contacto | Opcional                           |

No necesitas enviar los dos identificadores: con el email **o** con el teléfono
basta para crear o encontrar al contacto.

<Tip>
  Envía el teléfono con código de país (por ejemplo `+525512345678`). Si el
  teléfono no es válido, Asistian lo descarta y continúa solo con el email.
</Tip>

## Campos adicionales

Cualquier otro campo que envíes (por ejemplo `empresa`, `presupuesto` o
`sucursal`) se guarda como **datos adicionales** de la conversación y aparece
en el mensaje que ve tu equipo. No hace falta configurarlos.

## Mapear los campos de tu formulario

Si tu formulario ya existe y usa otros nombres (`nombre`, `correo`, `celular`,
`comentarios`…), no tienes que cambiarlo:

<Steps>
  <Step title="Envía una prueba">
    Edita el canal y, en **Conecta tu formulario y envía una prueba**, haz clic
    en **Iniciar Prueba** y envía tu formulario. Asistian captura los campos
    que recibió.
  </Step>

  <Step title="Usa Auto-detectar">
    En **Mapea tus campos**, haz clic en **Auto-detectar**. Asistian reconoce
    los nombres más comunes en español e inglés y los asigna por ti.
  </Step>

  <Step title="Revisa y guarda">
    Ajusta a mano lo que haga falta eligiendo el campo de tu formulario para
    cada dato (nombre, apellido, email, teléfono, mensaje) y guarda el canal.
  </Step>
</Steps>

<Note>
  El mapeo admite campos anidados. Si tu sistema envía
  `{"contacto": {"correo": "ana@ejemplo.com"}}`, el campo se mapea como
  `contacto.correo`.
</Note>

Si no configuras ningún mapeo, Asistian usa los nombres estándar de la tabla de
arriba.