Skip to main content
POST
Actualizar un monitor

Autorizaciones

pubrio-api-key
string
header
requerido

Un token de API único que representa las acciones que realizas a través de la API, junto con los permisos y operaciones correspondientes. Puedes crearlo en la sección Configuración.

Cuerpo

application/json
monitor_id
string<uuid>
requerido

Identificador único del monitor que se va a actualizar.

name
string

Nombre del monitor.

description
string

Descripción del monitor.

detection_mode
enum<string>

Cómo se detectan las señales. signal_first explora el mercado de forma amplia; company_first hace seguimiento de una lista de cuentas específica y requiere al menos una empresa, dominio o URL de LinkedIn. Inmutable después de la creación: cambiarlo en un monitor existente devuelve 40021. Crea un nuevo monitor en su lugar.

Opciones disponibles:
company_first,
signal_first
signal_types
enum<string>[]

Tipos de señales a monitorear.

Opciones disponibles:
jobs,
news,
advertisements,
expansions
signal_filters
object[]

Una entrada por cada flujo de señales que supervisa el monitor.

Ejemplo:
company_filters
object

Filtros de empresa globales aplicados como una segunda capa en todos los tipos de señales. Acepta los mismos parámetros que el endpoint Company Search: ubicaciones, empleados, tecnologías, verticales y más.

Ejemplo:
companies
string<uuid>[]

Lista de UUID de domain_search_id de empresa. Alternativa: usa domains o linkedin_urls.

domains
string[]

Lista de dominios de empresa. Alternativa a companies.

linkedin_urls
string<uri>[]

Lista de URL de empresa de LinkedIn. Alternativa a companies.

is_company_enrichment
boolean

Si se debe enriquecer los datos de la empresa.

is_people_enrichment
boolean

Si se debe enriquecer los datos de personas.

people_enrichment_configs
object[]

Arreglo de capas de enriquecimiento de personas. Cada capa ejecuta una búsqueda de personas independiente. Contiene max_people_to_return (1-25), people_contact_types (arreglo; hace referencia a los tipos de contacto de Redeem: email-work, email-personal, phone) y filters (los mismos parámetros que el endpoint People Search).

Ejemplo:
destination_type
enum<string>

Tipo de destino de entrega.

Opciones disponibles:
webhook,
email,
sequences
destination_config
object

Configuración del destino. Para webhook: requiere webhook_url (cadena), y opcionalmente headers (objeto) y body (objeto). Para email: acepta email (cadena) o emails (arreglo de cadenas). Para secuencias: requiere sequence_identifier (cadena) además de al menos uno de is_people_search_enrolled / is_company_contact_enrolled establecido en true.

Ejemplo:
frequency_minute
integer

Frecuencia de activación en minutos. Mín.: 0, Máx.: 10080, Predeterminado: 0.

Rango requerido: 0 <= x <= 10080
max_failure_trigger
integer

Número máximo de fallos consecutivos antes de pausar. Mín.: 1, Máx.: 10, Predeterminado: 5.

Rango requerido: 1 <= x <= 10
max_daily_trigger
integer

Número máximo de activaciones por día. Mín.: 0, Máx.: 86400, Predeterminado: 500.

Rango requerido: 0 <= x <= 86400
max_records_per_trigger
integer

Controla el número máximo de registros entregados por activación. Los valores más bajos reducen el tamaño de la carga útil por entrega, lo cual se recomienda para conjuntos de resultados grandes o integraciones con límite de tasa. Mín.: 1, Máx.: 100, Predeterminado: 25. Consulta Setting up Webhooks para más orientación.

Rango requerido: 1 <= x <= 100
notification_email
string<email>

Correo electrónico para notificaciones de fallos.

max_retry_per_trigger
integer

Número máximo de reintentos por activación. Mín.: 0, Máx.: 3, Predeterminado: 1.

Rango requerido: 0 <= x <= 3
retry_delay_second
integer

Retraso entre reintentos en segundos. Mín.: 1, Máx.: 5, Predeterminado: 1.

Rango requerido: 1 <= x <= 5
status
enum<string>

Estado del ciclo de vida a establecer. Cambiar el estado reinicia el contador de fallos.

Opciones disponibles:
draft,
active,
paused,
inactive

Respuesta

Respuesta correcta que contiene el monitor actualizado. La respuesta siempre incluye monitor_id, name, detection_mode, destination_type, status, masked_signature y last_modified, además de cualquier otra columna que formara parte de la actualización.

data
object

El monitor actualizado. También se devuelve cualquier otra columna incluida en la actualización.