Webhooks de Talana

Los Webhooks de Talana permiten integraciones ágiles y eficientes al ofrecer notificaciones en tiempo real de los eventos críticos del sistema, evitando el polling constante hacia nuestra API.

¿Qué son y cómo funcionan?

Los webhooks funcionan como una notificación de empuje (push notification). Cuando ocurre un evento en Talana (por ejemplo, la creación, modificación o eliminación de un recurso), nuestro sistema realiza una solicitud HTTP POST al endpoint que hayas definido previamente.

El cuerpo del mensaje (payload) incluye la información detallada del evento, permitiendo que su aplicación procese los cambios de forma instantánea.

Autenticación y seguridad

La seguridad de los datos es una prioridad para Talana. Por ello, todos los endpoints que reciban notificaciones deben implementar Autenticación Básica (Basic Auth).

Durante la configuración, usted deberá proporcionar las credenciales (usuario y contraseña), las cuales se incluirán en el encabezado de la solicitud HTTP.

Authorization: Basic (username:password)

Importante: Este método permite que su servicio verifique que la notificación proviene legítimamente de la plataforma de Talana.

Cómo solicitar

Comunícate con el SAC para que puedan derivarte al equipo de Back.
El equipo de Back configurará el webhook que necesites, según los modelos que se muestran más abajo.
Se te comunicará cuando el webhook esté configurado.

Estructura del mensaje

Ejemplo genérico del contenido enviado a tu endpoint:

{
  "event": "persona.creada",
  "data": {
    // Payload del modelo correspondiente
  }
}

Modelos de Webhooks

Cada webhook incluye en el campo data un objeto JSON con la información del modelo afectado. A continuación se detallan los modelos disponibles según el tipo de evento.

Eventos Disponibles

Módulo	Eventos Disponibles	Descripción breve
Persona	`persona.creada`, `persona.modificada`, `persona.eliminada`	Cambios en la ficha del trabajador
Contrato	`contrato.creada`, `contrato.modificada`, `contrato.eliminada`	Creación, actualización o eliminación de contratos
Vacaciones	`vacaciones.creada`, `vacaciones.modificada`, `vacaciones.eliminada`	Solicitudes y cambios de vacaciones
Razón Social	`razonsocial.creada`, `razonsocial.modificada`, `razonsocial.eliminada`	Cambios en los datos de la razón social
Ausencia	`ausencia.creada`, `ausencia.modificada`, `ausencia.eliminada`	Creación, modificación o eliminación de ausencias
Centro de Costo	`centrocosto.creada`, `centrocosto.modificada`, `centrocosto.eliminada`	Actualizaciones en centros de costo
Sucursal	`sucursal.creada`, `sucursal.modificada`, `sucursal.eliminada`	Cambios en sucursales
Unidad Organizacional	`unidadorganizacional.creada`, `unidadorganizacional.modificada`, `unidadorganizacional.eliminada`	Cambios en gerencias o áreas
Documento	`documento.creada`, `documento.modificada`, `documento.eliminada`	Creación, firma o eliminación de documentos
Firma Digital	`firma.solicitud.creada`, `firma.solicitud.modificada`, `firma.solicitud.eliminada`, `firma.solicitud.detalle`	Eventos del proceso de firma digital
Firma Digital Detalle	`firma.solicitud.detalle`	Detalle de Solicitud de Firma

Persona

Evento: persona.creada / persona.actualizada / persona.eliminada

{
  "id": 0,
    "fechaCreacion": "2025-11-05T13:42:32.959Z",
    "rut": "string",
    "nombre": "string",
    "apellidoPaterno": "string",
    "apellidoMaterno": "string",
    "sexo": "M",
    "fechaNacimiento": "2025-11-05",
    "nacionalidad": "string",
    "username": "string",
    "email": "[email protected]",
    "permisos": [
      {
        "nombre": "string",
        "vigente": true
      }
    ],
    "detalles": [
      {
        "id": 0,
        "foto": "string",
        "idiomas": [
          {
            "id": 0,
            "nombre": "string"
          }
        ],
        "codigoUbicacion": "string",
        "fechaCreacion": "2025-11-05T13:42:32.959Z",
        "validoDesde": "2025-11-05",
        "email": "[email protected]",
        "emailPersonal": "[email protected]",
        "telefono": "string",
        "celular": "string",
        "direccionCalle": "string",
        "direccionNumero": "string",
        "direccionDepartamento": "string",
        "nivelEducacional": "sin info",
        "colegio": "string",
        "institucionEstudiosSuperiores": "string",
        "profesion": "string",
        "observaciones": "string",
        "contactosDeEmergencia": "string",
        "sangre": "ap",
        "alergias": "string",
        "discapacidades": "string",
        "enfermedades_cronicas": "string",
        "medicamentos_permanentes": "string",
        "direccionComuna": 0,
        "direccionCiudad": 0,
        "estadoCivil": "string"
      }
    ],
    "externalReference": "string",
    "empresa": {
      "id": 0,
      "fechaCreacion": "2025-11-05T13:42:32.959Z",
      "nombre": "string",
      "vigente": true,
      "url": "string",
      "logo": "string",
      "logoWebPublica": "string",
      "ordenWebPublica": 0,
      "esPrueba": true,
      "tier": "tier2",
      "tags": {},
      "company_group": 0,
      "calendarioDeFeriados": 0,
      "pais": "string"
    },
    "userDefinedFields": "string",
    "anexo": "string"
}

Contrato

Evento: contrato.creado / contrato.actualizado / contrato.eliminado

{
  "id": 0,
  "empleado": 0,
  "codigo": "string",
  "fechaCreacion": "2025-11-05T15:44:35.994Z",
  "tipoContrato": 0,
  "empleadorRazonSocial": 0,
  "cargo": "string",
  "fechaContratacion": "2025-11-05",
  "desde": "2025-11-05",
  "hasta": "2025-11-05",
  "unidadOrganizacional": 0,
  "sucursal": {
    "id": 0,
    "empresa": 0,
    "nombre": "string",
    "desde": "2025-11-05",
    "fechaCreacion": "2025-11-05T15:44:35.994Z",
    "creadoPor": 0,
    "vigente": true,
    "direccionCalle": "string",
    "direccionNumero": "string",
    "direccionDepartamento": "string",
    "direccionComuna": 0,
    "direccionCiudad": 0,
    "telefono": "string",
    "externalReference": "string",
    "location": "string",
    "location_parseado": "string",
    "rango": 30,
    "beacons": [],
    "timezone": "string"
  },
  "anexo": "string",
  "centroCosto": {
    "id": 0,
    "parent": 0,
    "empresa": 0,
    "codigo": "string",
    "nombre": "string",
    "externalReference":"string",
    "vigente": true,
    "user_defined_fields": {}
  },
  "jornada": 0,
  "horasDeLaJornada": 0,
  "sindicato": 0,
  "jefe": 0,
  "esPensionado": "N",
  "isapre": 0,
  "montoPactadoIsapre": 0.0,
  "montoPactadoIsapreMoneda": "%",
  "montoPactado2Isapre": 0.0,
  "afp": 0,
  "adscribeASeguroCesantiaParaContratosPreviosA2002": false,
  "apv": false,
  "apvMonto": 0.0,
  "apvMoneda": "UF",
  "apvMontoCalculado": 0.0,
  "apvInstitucion": 0,
  "apvTipo": "B",
  "apvCuentaDos": 0.0,
  "apvCuentaDosMoneda": "UF",
  "depositoConvenidoMonto": 0.0,
  "depositoConvenidoMoneda": "UF",
  "retencionJuducialDestinatario": "string",
  "sueldoPatronal": false,
  "sueldoBase": 0.0,
  "sueldoFormaPago": "Transferencia",
  "sueldoBanco": 0,
  "sueldoCuentaCorriente": "string",
  "sueldoCuentaCorrienteTipo": "Cuenta Vista",
  "sueldoTipoPago": "mensual",
  "mesesImponiblesreconocidos": 0,
  "vacacionesReconocidoDesde": "2025-11-05",
  "asignacionMovilizacion": 0.0,
  "asignacionColacion": 0,
  "fechaDeContratacionReconocidaParaAnosDeServicio": "2025-11-05",
  "pagaTresPrimerosDiasLicencia": false,
  "mantieneRentaLiquidaLicencia": false,
  "diasAdministrativos": 0,
  "beneficiosInfoAdicional": "string",
  "indemnizacionSinTopeAnos": false,
  "indemnizacionSinTopeRenta": false,
  "diasAdicionalesVacaciones": 0,
  "creadoPor": 0,
  "descripcionDelCargo": "string",
  "asignacionZonaExtrema": 0.0,
  "unidadOrganizacionalDetails": {
    "parent": 0,
    "nombre": "string",
    "externalReference": "string",
    "id": 0,
    "codigo": "string"
  },
  "tipoContratoDetails": {
    "id": 0,
    "nombre": "string"
  },
  "externalReference": "string",
  "finiquitado": false,
  "motivoEgreso": 0,
  "INE": {
    "nombre": "string",
    "codigo": "string"
  },
  "fechaModificacion": "2025-11-05T15:44:35.994Z",
  "userDefinedFields": {
    
  }
}

Vacaciones

Evento: vacaciones.creadas / vacaciones.actualizadas / vacaciones.eliminadas

{
  "empleado": 0,
  "vacacionesDesde": "2025-11-05",
  "numeroDias": 0,
  "jornada": "M",
  "mediosDias": true,
  "vacacionesHasta": "2025-11-05",
  "vacacionesRetorno": "2025-11-05",
  "aprobada": "A",
  "aprobadaPor": 0,
  "creadaPor": 0,
  "tipoVacaciones": "string",
  "fechaAprobacion": "2025-11-05T13:42:32.959Z",
  "detallesTrabajador": {
    "id": 0,
    "fechaCreacion": "2025-11-05T13:42:32.959Z",
    "rut": "string",
    "nombre": "string",
    "apellidoPaterno": "string",
    "apellidoMaterno": "string",
    "sexo": "M",
    "fechaNacimiento": "2025-11-05",
    "nacionalidad": "string",
    "username": "string",
    "email": "[email protected]",
    "permisos": [
      {
        "nombre": "string",
        "vigente": true
      }
    ],
    "detalles": [
      {
        "id": 0,
        "foto": "string",
        "idiomas": [
          {
            "id": 0,
            "nombre": "string"
          }
        ],
        "codigoUbicacion": "string",
        "fechaCreacion": "2025-11-05T13:42:32.959Z",
        "validoDesde": "2025-11-05",
        "email": "[email protected]",
        "emailPersonal": "[email protected]",
        "telefono": "string",
        "celular": "string",
        "direccionCalle": "string",
        "direccionNumero": "string",
        "direccionDepartamento": "string",
        "nivelEducacional": "sin info",
        "colegio": "string",
        "institucionEstudiosSuperiores": "string",
        "profesion": "string",
        "observaciones": "string",
        "contactosDeEmergencia": "string",
        "sangre": "ap",
        "alergias": "string",
        "discapacidades": "string",
        "enfermedades_cronicas": "string",
        "medicamentos_permanentes": "string",
        "direccionComuna": 0,
        "direccionCiudad": 0,
        "estadoCivil": "string"
      }
    ],
    "externalReference": "string",
    "empresa": {
      "id": 0,
      "fechaCreacion": "2025-11-05T13:42:32.959Z",
      "nombre": "string",
      "vigente": true,
      "url": "string",
      "logo": "string",
      "logoWebPublica": "string",
      "ordenWebPublica": 0,
      "esPrueba": true,
      "tier": "tier2",
      "tags": {},
      "company_group": 0,
      "calendarioDeFeriados": 0,
      "pais": "string"
    },
    "userDefinedFields": "string",
    "anexo": "string"
  },
  "externalReference": "string",
  "id": 0,
  "fechaCreacion": "2025-11-05T13:42:32.959Z",
  "read_person": true,
  "read_boss": true,
  "type": "string"
}

Razón Social

Evento: razonsocial.creada / razonsocial.modificada / razonsocial.eliminada

{
  "id": 0,
  "rut": "string",
  "razonSocial": "string",
  "nombreComercial": "string",
  "giro": "string",
  "direccion": "string",
  "calleCasaMatriz": "string",
  "numeroCasaMatriz": "string",
  "mutualPorcentajeDescuento": 0,
  "mutualCodigoSucursal": "string",
  "telefono": "string",
  "cuentaCorrientePagoNomina": "string",
  "representanteLegal": "string",
  "rutRepresentanteLegal": "string",
  "logo": "string",
  "fechaCreacion": "2025-11-05T13:42:32.959Z",
  "empresa_est": true,
  "representanteEmail": "[email protected]",
  "representanteTelefono": "string",
  "appeal_days_for_rejected_requests": 0,
  "appeal_area_for_rejected_requests": "string",
  "empresa": 0,
  "regionCasaMatriz": 0,
  "comunaCasaMatriz": 0,
  "cajaCompensacion": 0,
  "mutual": 0,
  "comuna": 0,
  "bancoPagoNomina": 0
}

Ausencia

Evento: ausencia.creada / ausencia.actualizada / ausencia.eliminada

{
      "empleado": 0,
      "fechaDesde": "2025-11-05",
      "numeroDias": 0,
      "fechaHasta": "2025-11-05",
      "aprobada": true,
      "aprobadaPor": 0,
      "fechaAprobacion": "2025-11-05",
      "tipoAusencia": "string",
      "documentacion": "string",
      "rebajaSalario": true,
      "esContinuacion": true,
      "creadoPor": 0,
      "fechaCreacion": "2025-11-05T15:44:35.994Z",
      "fechaRetorno": "2025-11-05",
      "numeroLicencia": "string",
      "medicoLicencia": "string",
      "id": 0,
      "externalReference": "string",
      "detallesTrabajador": {
        "id": 0,
        "fechaCreacion": "2025-11-05T15:44:35.994Z",
        "rut": "string",
        "nombre": "string",
        "apellidoPaterno": "string",
        "apellidoMaterno": "string",
        "sexo": "M",
        "fechaNacimiento": "2025-11-05",
        "nacionalidad": "string",
        "username": "string",
        "email": "[email protected]",
        "permisos": [
          {
            "nombre": "string",
            "vigente": true
          }
        ],
        "detalles": [
          {
            "id": 0,
            "foto": "string",
            "idiomas": [
              {
                "id": 0,
                "nombre": "string"
              }
            ],
            "codigoUbicacion": "string",
            "fechaCreacion": "2025-11-05T15:44:35.994Z",
            "validoDesde": "2025-11-05",
            "email": "[email protected]",
            "emailPersonal": "[email protected]",
            "telefono": "string",
            "celular": "string",
            "direccionCalle": "string",
            "direccionNumero": "string",
            "direccionDepartamento": "string",
            "nivelEducacional": "sin info",
            "colegio": "string",
            "institucionEstudiosSuperiores": "string",
            "profesion": "string",
            "observaciones": "string",
            "contactosDeEmergencia": "string",
            "sangre": "ap",
            "alergias": "string",
            "discapacidades": "string",
            "enfermedades_cronicas": "string",
            "medicamentos_permanentes": "string",
            "direccionComuna": 0,
            "direccionCiudad": 0,
            "estadoCivil": "string"
          }
        ],
        "externalReference": "string",
        "empresa": {
          "id": 0,
          "fechaCreacion": "2025-11-05T15:44:35.994Z",
          "nombre": "string",
          "vigente": true,
          "url": "string",
          "logo": "string",
          "logoWebPublica": "string",
          "ordenWebPublica": 0,
          "esPrueba": true,
          "tier": "tier2",
          "tags": {},
          "company_group": 0,
          "calendarioDeFeriados": 0,
          "pais": "string"
        },
        "userDefinedFields": "string",
        "anexo": "string"
      },
      "horaDesde": "string",
      "numeroHoras": 0,
      "numeroMinutos": 0,
      "horaHasta": "string",
      "motivo": "string",
      "mediosDias": true
    }

Centro de Costo

Evento: centrocosto.creado / centrocosto.actualizado / centrocosto.eliminado

{
  "id": 0,
  "parent": 0,
  "empresa": 0,
  "codigo": "string",
  "nombre": "string",
  "externalReference": "string",
  "vigente": true,
  "user_defined_fields": "string"
}

Sucursal

Evento: sucursal.creada / sucursal.actualizada / sucursal.eliminada

{
  "id": 0,
  "empresa": 0,
  "nombre": "string",
  "desde": "2025-11-05",
  "fechaCreacion": "2025-11-05T13:42:32.959Z",
  "creadoPor": 0,
  "vigente": true,
  "direccionCalle": "string",
  "direccionNumero": "string",
  "direccionDepartamento": "string",
  "direccionComuna": 0,
  "direccionCiudad": 0,
  "telefono": "string",
  "externalReference": "string",
  "location": "string",
  "location_parseado": "string",
  "rango": 0,
  "beacons": "string",
  "timezone": "string"
}

Unidad Organizacional

Evento: unidadorganizacional.creada / unidadorganizacional.modificada / unidadorganizacional.eliminada

{
  "parent": 0,
  "nombre": "string",
  "externalReference": "string",
  "id": 0,
  "codigo": "string"
}

Documento

Evento: documento.creado / documento.modificado / documento.eliminado

{
  "id": 0,
  "empleado": 0,
  "empleado_detalles": {
    "id": 0,
    "nombre": "string",
    "apellidoPaterno": "string",
    "apellidoMaterno": "string",
    "cargo": "string",
    "gerencia": "string",
    "avatar": "string",
    "rut": "string",
    "full_name": "string"
  },
  "nombre": "string",
  "fechaCreacion": "2025-11-05T13:42:32.959Z",
  "categoria": "string",
  "puedeVerloElTrabajador": true,
  "adjunto": "string",
  "creadoPor": 0,
  "user_defined_fields": "string"
}

Solicitud de Firma

Evento: firma.solicitud.creada / firma.solicitud.modificada / firma.solicitud.eliminada / firma.solicituddetalle

{
  "signingRequest": 0,
  "documentType": "string",
  "documentReference": "string",
  "requestTS": "2025-11-05T13:42:32.959Z"
}

Detalle Solicitud de Firma

Evento: firma.solicitud.detalle

{
  "id": 0,
  "details": [
    {
      "id": 0,
      "signed": true,
      "status": "P",
      "token": "string",
      "signatureTS": "2025-11-05T13:42:32.959Z",
      "TSASignature": "string",
      "ip": "string",
      "userAgent": "string",
      "passVerification": "string",
      "huella": "string",
      "rejection_reason": "string",
      "signingRequest": 0,
      "requestedUser": 0
    }
  ]
}