Cobertura de los datos · API de Totem

La API devuelve lo que Totem ha registrado y te dice de dónde sale cada dato. No reconstruye atribuciones antiguas, no se inventa cambios de estado que nadie registró y no incluye el contenido de los mensajes. Esta página te dice en qué datos puedes confiar y qué significa un valor vacío.

Qué registra Totem y desde cuándo

Dato	De dónde sale	Límites
Quién es el lead y en qué punto está	El lead tal como está ahora: datos de contacto, `status`, `board` y `stage`.	Las personas del equipo pueden editarlos en cualquier momento. Un valor que esta versión de la API no conoce llega como `null`, `other` o `unknown`, según el campo; Todos los objetos indica cuál.
Cómo llegó el lead por primera vez (`attribution.original_capture`)	Se registra una sola vez, al crear el lead (`capture: at_creation`). Un lead sin ese registro, porque se creó antes de que Totem empezara a registrarlo o porque su creación no se registró, recibe una copia del lead tal como estaba cuando su equipo se añadió por primera vez a una integración (`capture: at_activation`).	Una copia `at_activation` muestra el lead en ese día, no el formulario que la persona rellenó al principio.
El último formulario de un anuncio (`attribution.latest_submission`)	El envío de formulario de anuncio más reciente registrado para el lead, también si repite un contacto que Totem ya tenía.	Nunca cambia cómo llegó el lead por primera vez. Los envíos de Google Ads y LinkedIn dejan de poder leerse a los 90 días (`expires_at`). Un envío de LinkedIn que la persona borró después deja de mostrarse. Cuando un envío caduca o se retira, el feed de cambios entrega una nueva versión de `lead_attribution` sin él, que puede mostrar un envío anterior; sustituye tu copia por ella. Hoy no se puede conectar LinkedIn Lead Sync, y los formularios de Google Ads solo los conecta Totem, así que la mayoría de los equipos no tienen envíos `google_ads` ni `linkedin`.
Datos de la campaña, el anuncio y el formulario de Google, LinkedIn y Meta	Lo que envió la plataforma de anuncios, campo a campo, cada uno con su `provenance`.	Totem no atribuye leads a posteriori ni consulta los identificadores en las API de las plataformas para completar huecos.
El anuncio que abrió una conversación (`original_capture.ad_referral`)	El primer referido de un anuncio de Meta en la conversación que creó el lead.	Solo desde el día en que Totem empezó a registrarlo, como explica la nota de arriba. Nunca los mensajes.
Las actividades y las fechas que fijan (`converted_at`, `revived_at`)	Cada cambio de etapa, de estado o de miembros asignados que Totem registró.	Solo desde el día en que Totem empezó a registrarlos, como explica la nota de arriba. Totem no se inventa cambios que no registró.
Cómo ha respondido el equipo (la `response` del lead)	Las horas de los mensajes y las llamadas de todas las conversaciones del lead.	No se cuentan los mensajes suprimidos ni los de los visitantes del chat web, y el historial de WhatsApp importado no cuenta como mensaje del cliente ni como respuesta. Una respuesta es un mensaje enviado registrado como respuesta de conversación o sin propósito. La prospección y los mensajes transaccionales, como los recordatorios, se excluyen cuando están registrados como tales, pero muchos envíos automáticos no tienen propósito y sí cuentan como respuesta. Totem lee como máximo 20 conversaciones, 200 mensajes y 50 llamadas por lead; por encima de eso, `coverage.truncated` es `true`.
Llamadas, conversaciones y citas	Los metadatos que Totem guarda de cada una.	Un enlace a un lead que ya no existe es `null`. Sin grabaciones, transcripciones, notas ni pagos. Una cita reprogramada antes de que Totem empezara a registrar los enlaces de reprogramación puede no tener su enlace `rescheduled_from` o `rescheduled_to`.
Permisos de contacto	Los rechazos que Totem guardó, cada uno con su `provenance`.	Un consentimiento `null` significa desconocido, nunca sí. Aplica los permisos antes de contactar con nadie.

Origen de los datos y valores vacíos

Muchos campos te dicen de dónde sale su valor:

capture, en original_capture: at_creation si se registró al crear el lead, o at_activation si se copió una sola vez, cuando su equipo se añadió por primera vez a una integración, para un lead sin registro de captura: uno creado antes de que Totem empezara a registrar la atribución, o cuya creación no se registró.
provenance, en cada campo de campaña, anuncio, formulario y UTM: provider si lo envió la plataforma de anuncios, team_alias si lo escribió alguien del equipo, stored_metadata si sale de datos del lead que el equipo puede editar, stored_metadata_at_activation si esos datos se copiaron una sola vez al activarse, y not_captured exactamente cuando value es null.
source_provenance, en un lead: server_written si Totem fijó él mismo el origen a partir de la plataforma de anuncios, o member_editable si las personas del equipo pueden cambiarlo.
original_capture_missing_reason y latest_submission_missing_reason: not_captured siempre que el objeto que los acompaña es null, sea cual sea el motivo: Totem no lo registró, el lead nunca llegó por un formulario de anuncio, o el envío caducó o se retiró.

Y cuando un valor está vacío:

Una fecha null no demuestra que algo no ocurriera. Puede significar que Totem no lo registró.
Un consentimiento null es desconocido. Nunca es un consentimiento.
Comprueba coverage.truncated antes de dar por completa la respuesta de un lead.

Todos los objetos describe cada campo y enumera los valores que puede tomar hoy cada uno de estos campos.