Webhooks

Los activadores de webhook te permiten alcanzar prospectos instantáneamente cuando sistemas externos envían datos a SignalCore. Esto es ideal para velocidad de respuesta: responder a envíos de formularios, eventos de CRM o cualquier sistema externo en tiempo real.


Cómo funciona

  1. El sistema externo envía una solicitud POST a tu URL de webhook
  2. SignalCore captura el payload y busca el prospecto
  3. Si el prospecto existe, la estrategia se ejecuta con datos actualizados
  4. Si el prospecto no existe, se crea un nuevo prospecto
  5. La estrategia comienza automáticamente

Configurar un activador de webhook

Paso 1: Configura el webhook

Cuando agregues un activador de webhook a tu estrategia, aparecerá un modal de configuración.

Campo de búsqueda — Selecciona qué campo usar para encontrar prospectos existentes en tu base de datos (correo electrónico o número de teléfono).

Modal de configuración de webhook

Paso 2: Copia la URL del webhook

Después de guardar tu estrategia, se genera una URL de webhook única. Copia esta URL y configura tu sistema externo para enviar solicitudes POST a ella.

URL de webhook

Prueba tu webhook enviando un payload de muestra desde tu sistema externo. SignalCore lo capturará para el mapeo de campos.

Paso 3: Selecciona un payload de muestra

Una vez que hayas enviado un payload de prueba, SignalCore lo captura como muestra. Selecciona el payload de muestra para usar en el mapeo de campos.

Seleccionar payload de muestra

Paso 4: Mapea campos al prospecto

Usa el mapeador visual de campos para conectar campos del payload de webhook a campos de prospecto en SignalCore. Navega por estructuras de payload anidadas y mapea cada campo a la propiedad de prospecto correspondiente.

Interfaz de mapeo de campos

Opciones de mapeo de campos:

Campo de prospectoDescripción
contact.emailDirección de correo del prospecto
contact.numberNúmero de teléfono del prospecto
contact.first_nameNombre del prospecto
contact.last_nameApellido del prospecto
meta.*Campos de metadatos personalizados

Formato del payload de webhook

Tu sistema externo debe enviar un payload JSON mediante solicitud POST:

1{
2 "email": "lead@example.com",
3 "phone": "+1234567890",
4 "first_name": "John",
5 "last_name": "Doe",
6 "source": "website_form",
7 "custom_field": "value"
8}

Mejores prácticas

Siempre envía un payload de prueba primero para capturar la estructura antes de mapear campos.

  • Usa nombres de campo consistentes — Asegúrate de que tu sistema externo envíe datos con claves consistentes
  • Incluye campo de búsqueda — Siempre incluye correo electrónico o teléfono para coincidencia de prospectos
  • Prueba antes de activar — Verifica que los mapeos de campos funcionen correctamente con datos de prueba

Los payloads de webhook se almacenan para depuración. Puedes ver payloads capturados en la configuración de la estrategia.