Eventos de segmentos
Contactos que entran en un segmento con seguimiento o salen de él.
segment.contact_added
Se envía cuando un contacto empieza a coincidir con un segmento con seguimiento. Los segmentos sin seguimiento no envían este evento. Tampoco lo envía el primer recuento después de crear un segmento con seguimiento o de reanudar el seguimiento.
La misma entrada inicia las automatizaciones con el disparador Added to segment, y cumple los objetivos y reanuda los pasos Wait until con ese evento, salvo que reason sea segment_updated.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringevt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.typestringsegment.contact_added.objectobjectdata.objectobjectdata.Objeto de pertenencia a un segmento
objectstringsegment_membership.segmentobjectid y el name del segmento.contactobjectid, email, first_name, last_name y custom_fields.reasonstringcontact cuando cambiaron los contactos, incluidas las importaciones y las listas de contactos eliminadas; schedule cuando lo detectó la sincronización diaria, por ejemplo porque una regla de fecha ahora se cumple, o segment_updated cuando se editaron el origen o los filtros del segmento.joined_atstring{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "segment.contact_added",
"object": {
"object": "segment_membership",
"segment": {
"id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
"name": "Pro customers renewing soon"
},
"contact": {
"id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"custom_fields": {
"plan": "pro"
}
},
"reason": "contact",
"joined_at": "2026-10-18T12:00:00.000000+00:00"
},
"data": {
"object": {
"object": "segment_membership",
"segment": {
"id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
"name": "Pro customers renewing soon"
},
"contact": {
"id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"custom_fields": {
"plan": "pro"
}
},
"reason": "contact",
"joined_at": "2026-10-18T12:00:00.000000+00:00"
}
}
}segment.contact_removed
Se envía cuando un contacto deja de coincidir con un segmento con seguimiento. Los segmentos sin seguimiento no envían este evento, y tampoco lo envían los contactos que salen porque se han eliminado.
La misma salida inicia las automatizaciones con el disparador Removed from segment y termina las ejecuciones que tienen esa condición de salida, salvo que reason sea segment_updated.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringevt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.typestringsegment.contact_removed.objectobjectdata.objectobjectdata.Objeto de pertenencia a un segmento
objectstringsegment_membership.segmentobjectid y el name del segmento.contactobjectid, email, first_name, last_name y custom_fields.reasonstringcontact cuando cambiaron los contactos, incluidas las importaciones y las listas de contactos eliminadas; schedule cuando lo detectó la sincronización diaria, por ejemplo porque una regla de fecha ya no se cumple, o segment_updated cuando se editaron el origen o los filtros del segmento.left_atstring{
"event_id": "evt_2xLd4Ks8Vp1Rm6Wc3Nt9Bh5Qy0e",
"type": "segment.contact_removed",
"object": {
"object": "segment_membership",
"segment": {
"id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
"name": "Pro customers renewing soon"
},
"contact": {
"id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"custom_fields": {
"plan": "pro",
"renews_on": "2026-12-01"
}
},
"reason": "schedule",
"left_at": "2026-10-18T00:30:05.000000+00:00"
},
"data": {
"object": {
"object": "segment_membership",
"segment": {
"id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
"name": "Pro customers renewing soon"
},
"contact": {
"id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"custom_fields": {
"plan": "pro",
"renews_on": "2026-12-01"
}
},
"reason": "schedule",
"left_at": "2026-10-18T00:30:05.000000+00:00"
}
}
}