> ## 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.

# Canal Webhook: recibe contactos desde tu sitio web

> Guía paso a paso para conectar el formulario de tu sitio web u otro sistema a Asistian con el canal Webhook.

El canal **Webhook** te da una URL a la que tu sitio web, tu landing page o
cualquier otro sistema puede enviar los datos de un formulario. Cada envío crea
(o actualiza) un contacto y abre una conversación en tu bandeja.

<Note>
  El Webhook **solo recibe datos**: no puede enviar mensajes. Para contestarle
  a la persona que llenó el formulario, Asistian usa otro de tus canales
  (WhatsApp o correo). Lo eliges en el paso 4.
</Note>

## Crear el canal

<Steps>
  <Step title="Agrega el canal">
    Ve a **Configuración → Canales**, haz clic en **Añadir Canal** y, en el
    grupo **Captación de contactos**, elige **Webhook**. Ponle un nombre que
    te ayude a reconocerlo (por ejemplo, "Formulario de contacto del sitio") y
    elige el **buzón** al que llegarán las conversaciones.
  </Step>

  <Step title="Copia la URL de tu webhook">
    Asistian genera una URL única para este canal. Cópiala: es la dirección a
    la que tu formulario enviará los datos. La URL empieza a funcionar en
    cuanto creas el canal.
  </Step>

  <Step title="Envía estos campos">
    Tu formulario debe enviar un **POST** con el cuerpo en formato **JSON**:

    ```json theme={null}
    {
      "first_name": "Ana",
      "last_name": "López",
      "email": "ana@ejemplo.com",
      "phone": "+525512345678",
      "message": "Quiero información sobre sus servicios"
    }
    ```

    Para identificar al contacto hace falta **email o teléfono: al menos uno
    de los dos**. Todo lo demás es opcional. Consulta el detalle en
    [Campos y mapeo del Webhook](/mintlify/canales/webhook-campos).
  </Step>

  <Step title="Elige por dónde responder">
    En **Responder por teléfono con**, elige el canal (normalmente tu WhatsApp)
    con el que tu equipo contestará cuando el formulario traiga un teléfono.
    Después de crear el canal, al editarlo, también puedes elegir una cuenta en
    **Responder por correo con** para los envíos que solo traen email.
  </Step>

  <Step title="Crea el canal">
    Haz clic en **Crear**. El canal aparece en tu lista de canales y la URL ya
    acepta envíos.
  </Step>
</Steps>

<Warning>
  Si no eliges un canal de respuesta, los contactos llegarán a tu bandeja pero
  tu equipo **no podrá contestarles desde Asistian**.
</Warning>

## Probar que funciona

<Steps>
  <Step title="Abre el canal">
    En **Configuración → Canales**, haz clic en el ícono de engrane (**Editar
    canal**) de la tarjeta de tu canal Webhook.
  </Step>

  <Step title="Inicia la prueba">
    En el paso **Conecta tu formulario y envía una prueba**, haz clic en
    **Iniciar Prueba**. Asistian se queda esperando el siguiente envío.
  </Step>

  <Step title="Envía el formulario">
    Llena y envía tu formulario real, o usa el ejemplo de cURL que aparece en
    pantalla. En unos segundos verás los campos que Asistian recibió.
  </Step>
</Steps>

<Warning>
  La prueba **crea un contacto y una conversación reales** con los datos que
  envíes. Usa datos de prueba y bórralos cuando termines.
</Warning>

En el mismo paso, **Ejemplos de código** trae fragmentos listos para copiar en
cURL, JavaScript, PHP y HTML.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Qué pasa si la misma persona envía el formulario dos veces?">
    Asistian busca un contacto existente con el mismo email o teléfono. Si lo
    encuentra, agrega el nuevo envío a ese contacto en lugar de duplicarlo.
  </Accordion>

  <Accordion title="Mi formulario usa otros nombres de campo, ¿tengo que cambiarlo?">
    No. Envía una prueba y usa **Mapea tus campos** para indicarle a Asistian
    qué campo de tu formulario corresponde a nombre, email, teléfono y mensaje.
    Ver [Campos y mapeo del Webhook](/mintlify/canales/webhook-campos).
  </Accordion>

  <Accordion title="¿Cualquiera que conozca la URL puede enviar datos?">
    Sí, salvo que actives la clave secreta. Ver
    [Proteger tu Webhook con una clave secreta](/mintlify/canales/webhook-clave-secreta).
  </Accordion>

  <Accordion title="¿Cuándo debo regenerar la URL?">
    Solo si la URL se filtró o recibes envíos no deseados. Al regenerarla, **la
    URL anterior deja de funcionar de inmediato**: todo formulario que la use
    dejará de entregar contactos hasta que pegues la nueva.
  </Accordion>

  <Accordion title="¿Es lo mismo que los webhooks de Integraciones?">
    No. Los de **Configuración → Integraciones → Webhooks** avisan a otros
    sistemas cuando algo pasa en Asistian (salida). El **canal Webhook** recibe
    contactos desde fuera (entrada).
  </Accordion>
</AccordionGroup>