[{"data":1,"prerenderedAt":629},["ShallowReactive",2],{"developers:\u002Fdevelopers\u002Fes\u002Freference-sync":3},{"doc":4,"lang":68,"nav":80,"alternatePath":184,"policy":185,"specVersion":229,"reference":230,"layout":75,"toc":621,"prev":625,"next":626,"operations":627,"overview":70,"heroExample":70},{"id":5,"title":6,"apiTag":7,"body":8,"description":65,"draft":66,"extension":67,"lang":68,"meta":69,"navTitle":70,"navigation":71,"order":72,"path":73,"rawbody":74,"section":75,"seo":76,"stem":77,"translationKey":78,"version":70,"__hash__":79},"developers_es\u002Fdevelopers\u002Fes\u002Freference-sync.md","Feed de cambios","sync",{"type":9,"value":10,"toc":59},"minimark",[11,16,40,51],[12,13,15],"h2",{"id":14},"resumen","Resumen",[17,18,19,27,28,31,32,35,36,39],"p",{},[20,21,23],"a",{"href":22},"\u002Fdevelopers\u002Fes\u002Freference-sync#sync.changes",[24,25,26],"code",{},"GET \u002Fv1\u002Fsync\u002Fchanges"," devuelve los cambios de un equipo, página a página, en el orden en que Totem los registró. Sin ",[24,29,30],{},"cursor",", empieza una carga inicial de todos los registros. Con el ",[24,33,34],{},"next_cursor"," de tu última página, devuelve lo que ha cambiado desde entonces. Cada elemento es el estado actual de un registro, o una eliminación que te indica que lo borres. En cualquier versión pueden aparecer en el feed nuevos tipos de registro: guarda u omite un elemento cuyo ",[24,37,38],{},"kind"," no conozcas y sigue sincronizando.",[17,41,42,43,45,46,50],{},"Guarda ",[24,44,34],{}," después de aplicar cada página, aunque venga vacía, y envíalo en tu siguiente petición. Un cursor caduca ",[47,48],"api-const",{"name":49},"CURSOR_MAX_AGE_DAYS"," días después del punto del feed al que llegó; un equipo que consultas cada pocos minutos nunca llega a ese punto.",[17,52,53,54,58],{},"Esta página es la referencia: los parámetros, el objeto de cada elemento y los errores. ",[20,55,57],{"href":56},"\u002Fdevelopers\u002Fes\u002Fsync","Sincroniza una copia"," es la guía: cómo aplicar una página, cómo recuperarte de cada error y cómo ejecutar un cliente de sincronización que Totem prueba.",{"title":60,"searchDepth":61,"depth":61,"links":62},"",3,[63],{"id":14,"depth":64,"text":15},2,"Un único endpoint que copia un equipo y, después, devuelve cada cambio, página a página.",false,"md","es",{},null,true,"90","\u002Fdevelopers\u002Fes\u002Freference-sync","---\ntitle: Feed de cambios\ndescription: Un único endpoint que copia un equipo y, después, devuelve cada cambio, página a página.\nsection: reference\norder: 90\ntranslationKey: reference-sync\nlang: es\ndraft: false\napiTag: sync\n---\n\n## Resumen\n\n[`GET \u002Fv1\u002Fsync\u002Fchanges`](\u002Fdevelopers\u002Fes\u002Freference-sync#sync.changes) devuelve los cambios de un equipo, página a página, en el orden en que Totem los registró. Sin `cursor`, empieza una carga inicial de todos los registros. Con el `next_cursor` de tu última página, devuelve lo que ha cambiado desde entonces. Cada elemento es el estado actual de un registro, o una eliminación que te indica que lo borres. En cualquier versión pueden aparecer en el feed nuevos tipos de registro: guarda u omite un elemento cuyo `kind` no conozcas y sigue sincronizando.\n\nGuarda `next_cursor` después de aplicar cada página, aunque venga vacía, y envíalo en tu siguiente petición. Un cursor caduca :api-const{name=\"CURSOR_MAX_AGE_DAYS\"} días después del punto del feed al que llegó; un equipo que consultas cada pocos minutos nunca llega a ese punto.\n\nEsta página es la referencia: los parámetros, el objeto de cada elemento y los errores. [Sincroniza una copia](\u002Fdevelopers\u002Fes\u002Fsync) es la guía: cómo aplicar una página, cómo recuperarte de cada error y cómo ejecutar un cliente de sincronización que Totem prueba.\n","reference",{"title":6,"description":65},"developers\u002Fes\u002Freference-sync","reference-sync","7WZ4MFh1IU84PUFoSB09v1aN9K1dZcD4bHzneoyb-T8",[81,96,121,165],{"section":82,"items":83},"start",[84,88,92],{"path":85,"title":86,"description":87},"\u002Fdevelopers\u002Fes","Introducción","Lee desde tus propios sistemas los leads, las llamadas, las conversaciones y las citas de tus equipos de Totem, y mantén una copia sincronizada.",{"path":89,"title":90,"description":91},"\u002Fdevelopers\u002Fes\u002Fquickstart","Inicio rápido","Haz tus primeras peticiones a la API de Totem en unos minutos. Comprueba tu clave, busca tu equipo, lista leads e inicia una sincronización.",{"path":93,"title":94,"description":95},"\u002Fdevelopers\u002Fes\u002Fauthentication","Autenticación","Las claves secretas y dónde pueden guardarse, la cabecera Totem-Team de las claves con varios equipos, la lista de IP permitidas y cómo rotar o revocar una clave.",{"section":97,"items":98},"guides",[99,103,105,109,113,117],{"path":100,"title":101,"description":102},"\u002Fdevelopers\u002Fes\u002Ftypescript","SDK de TypeScript","Usa el cliente oficial de TypeScript para leer tus datos de Totem, paginar listas y gestionar errores de la API desde tu servidor.",{"path":56,"title":57,"description":104},"Copia un equipo con el feed de cambios y mantén la copia al día. Aplica las páginas sin riesgos, recupérate de los errores y parte de un cliente de referencia que Totem prueba.",{"path":106,"title":107,"description":108},"\u002Fdevelopers\u002Fes\u002Fpagination","Listas y paginación","Cómo devuelven los endpoints de lista los registros página a página, cómo leer todas las páginas y qué orden y qué filtros admite una lista.",{"path":110,"title":111,"description":112},"\u002Fdevelopers\u002Fes\u002Fcoverage","Cobertura de los datos","Qué registra Totem, desde cuándo y cómo distinguir un valor vacío de un dato que nunca se registró.",{"path":114,"title":115,"description":116},"\u002Fdevelopers\u002Fes\u002Ftesting","Pruebas y puesta en producción","Cómo construir y probar una integración con seguridad mientras la API no tiene entorno de pruebas, y qué comprobar antes de pasar a producción.",{"path":118,"title":119,"description":120},"\u002Fdevelopers\u002Fes\u002Fsecurity","Seguridad y datos personales","Cómo protege Totem las claves de la API y los datos que sirve, qué registra de cada clave, dónde funciona la API y qué hacer con los datos personales que copias.",{"section":75,"items":122},[123,127,131,135,140,145,150,155,160,161],{"path":124,"title":125,"description":126},"\u002Fdevelopers\u002Fes\u002Fconventions","Convenciones","La notación de esta documentación y las reglas que siguen todas las respuestas: identificadores, fechas, valores vacíos, importes, enumeraciones, versiones, estabilidad, errores y textos no fiables.",{"path":128,"title":129,"description":130},"\u002Fdevelopers\u002Fes\u002Ferrors","Errores","El formato de los errores, cómo debe tratar tu integración cada tipo de error y todos los códigos de error, con cuándo ocurren y qué hacer.",{"path":132,"title":133,"description":134},"\u002Fdevelopers\u002Fes\u002Frate-limits","Límites de frecuencia y cuota","Cuánto puede leer una clave por minuto y por día, qué cuenta para cada límite, cómo reintentar tras un 429 y cuánto tarda una carga inicial.",{"path":136,"title":137,"description":138,"apiTag":139},"\u002Fdevelopers\u002Fes\u002Freference-account","Cuenta, equipos y miembros","Comprueba que una clave funciona y qué puede leer, lista sus equipos con su zona horaria, lista los miembros de cada equipo y comprueba que la API está funcionando.","account",{"path":141,"title":142,"description":143,"apiTag":144},"\u002Fdevelopers\u002Fes\u002Freference-leads","Leads, tableros y actividades","Lista, obtén y busca los leads y los clientes de un equipo, lee las actividades de cada lead y lista los tableros y las etapas por los que pasan.","leads",{"path":146,"title":147,"description":148,"apiTag":149},"\u002Fdevelopers\u002Fes\u002Freference-calls","Llamadas","Lista y obtén las llamadas de un equipo, con su dirección, su horario y un resultado normalizado. Sin grabaciones ni transcripciones.","calls",{"path":151,"title":152,"description":153,"apiTag":154},"\u002Fdevelopers\u002Fes\u002Freference-conversations","Conversaciones","Lista y obtén las conversaciones de un equipo en todos los canales, con su estado, la persona asignada, si una persona ha tomado el control y cuándo llegaron y salieron los últimos mensajes. Nunca el contenido de los mensajes.","conversations",{"path":156,"title":157,"description":158,"apiTag":159},"\u002Fdevelopers\u002Fes\u002Freference-bookings","Citas y servicios","Lista y obtén las citas de un equipo, y lista los servicios que pueden reservar sus clientes.","bookings",{"path":73,"title":6,"description":65,"apiTag":7},{"path":162,"title":163,"description":164},"\u002Fdevelopers\u002Fes\u002Fobjects","Todos los objetos","Todos los objetos que devuelve la API, campo a campo, con un ejemplo de cada uno.",{"section":166,"items":167},"resources",[168,172,176,180],{"path":169,"title":170,"description":171},"\u002Fdevelopers\u002Fes\u002Fchangelog","Registro de cambios","Los cambios de la API de Totem, del más reciente al más antiguo, cada uno bajo la fecha en que se publicó.",{"path":173,"title":174,"description":175},"\u002Fdevelopers\u002Fes\u002Fsupport","Soporte","Cómo pedir ayuda con la API de Totem, qué incluir en una solicitud y qué hacer si se filtra una clave.",{"path":177,"title":178,"description":179},"\u002Fdevelopers\u002Fes\u002Fglossary","Glosario","Los términos de esta documentación, definidos en un solo lugar, cada uno con un enlace a la página que lo explica.",{"path":181,"title":182,"description":183},"\u002Fdevelopers\u002Fes\u002Ffaq","Preguntas frecuentes","Respuestas breves a las preguntas más habituales sobre la API de Totem, con enlaces a los detalles.","\u002Fdevelopers\u002Freference-sync",{"ACTIVATION_MARGIN_MS":186,"ADMIN_ACCESS_DISCLOSURE_VERSION":187,"AUDIT_RETENTION_DAYS":188,"AUTH_FAILURE_LIMITS":189,"CAPTURE_LAG_FLOOR_MS":193,"CAPTURE_LAG_P99_MS":70,"CURSOR_MAX_AGE_DAYS":194,"DIRTY_TTL_DAYS":194,"FAMILY_TEAM_SCOPE":195,"FAMILY_TEAM_SCOPE_OPTIONS":196,"FEED_SETTLE_LAG_MS":198,"GATE_REFRESH_MS":186,"INTEGRATION_NAME_LENGTH":199,"INTEGRATION_PURPOSE_LENGTH":201,"KEY_CACHE_TTL_MS":204,"KEY_STATS_RETENTION_DAYS":205,"LEAD_RESPONSE_READ_BUDGET":206,"LIST_SCAN_MAX":209,"MAX_FAMILY_INTEGRATION_TEAMS":194,"MAX_INTEGRATIONS_PER_FAMILY":210,"MAX_IP_ALLOWLIST":191,"PAGE_LIMIT":211,"PLATFORM_CONFIG_TTL_MS":214,"REMOVAL_RETENTION_DAYS":215,"REQUEST_BODY_MAX_BYTES":216,"ROLL_GRACE_DEFAULT_HOURS":217,"ROLL_GRACE_HOURS":218,"SEARCH_MAX_RESULTS":210,"SENSITIVE_SECTOR_POLICY":221,"SENSITIVE_SECTOR_POLICY_OPTIONS":222,"SYNC_DAILY_BUDGET":224,"SYNC_VELOCITY":226,"TEAM_CACHE_TTL_MS":228},60000,"2026-10-17",365,{"perIpPerMinute":190,"perLookupIdPerMinute":191,"banMs":192},60,20,600000,300000,30,"explicit_list",[195,197],"all_family_teams",10000,{"min":64,"max":200},80,{"min":202,"max":203},1,280,5000,90,{"conversations":191,"messageReads":207,"calls":208},200,50,1000,10,{"default":212,"max":213},25,100,15000,45,16384,24,[219,202,217,220],0,168,"exclude",[221,223],"allow",{"floor":225,"recordsMultiplier":61},250000,{"perMinute":227,"burst":198},2000,30000,"1.0a",{"operations":231,"schemas":363,"errors":486,"commonErrors":617,"defaultStability":238,"policy":185,"problemExample":618},[232],{"id":233,"method":234,"path":235,"summary":236,"description":237,"stability":238,"scopes":239,"rateClass":7,"tenantBinding":244,"authenticated":71,"parameters":245,"parametersByLocation":264,"body":268,"bodyDescription":60,"responseFields":269,"responseComponent":293,"listOf":284,"example":294,"errors":342,"tag":7},"sync.changes","GET","\u002Fv1\u002Fsync\u002Fchanges","Lee el feed de cambios de un equipo","Devuelve la siguiente página de cambios de un equipo, en el orden en que Totem los registró: cada elemento es el estado actual de un registro o su eliminación. Sin `cursor` empieza una carga inicial de todos los registros; después de aplicar cada página, guarda su `next_cursor` y envíalo en la siguiente petición, aunque la página llegue vacía. Un cursor caduca 30 días después del punto del feed al que llegó o, mientras una carga inicial sigue en curso, 30 días después de que empezara.","beta",[240,241,242,243],"crm:read","calls:read","messages:read","calendar:read","team_header",[246,252,257],{"name":30,"type":247,"required":66,"description":248,"nullable":66,"typeLabel":247,"constraints":249,"location":251},"string","El `next_cursor` de la página anterior. Omítelo para empezar una carga inicial desde el principio.",{"minLength":202,"maxLength":250},512,"query",{"name":253,"type":254,"required":66,"description":255,"nullable":66,"typeLabel":254,"constraints":256,"location":251},"limit","integer","Elementos por página, de 1 a 100. Por defecto, 25.",{"minimum":202,"maximum":213,"default":212},{"name":258,"type":247,"required":66,"description":259,"nullable":66,"typeLabel":247,"constraints":260,"conditional":71,"location":263},"Totem-Team","El equipo que se lee, como identificador `team_…`. Omítelo si la clave lee un solo equipo; es obligatorio si lee varios (`400 team_required`). Si lo envías, debe indicar un equipo que la clave lee: un identificador mal formado recibe `400 invalid_request`, y un equipo fuera de la clave, `404 team_not_accessible`, igual que una petición sin la cabecera cuando la clave ya no lee ningún equipo.",{"prefixes":261},[262],"team_","header",{"path":265,"query":266,"header":267},[],[246,252],[257],[],[270,276,287,291],{"name":271,"type":272,"required":71,"description":273,"nullable":66,"typeLabel":247,"enumValues":274,"constant":71},"object","\"list\"","Siempre `list`.",[275],"list",{"name":277,"type":278,"required":71,"description":279,"nullable":66,"typeLabel":278,"typeTokens":280,"ref":284},"data","Array\u003CFeedItem>","Cambios en el orden en que Totem los registró. Durante una carga inicial, un registro puede aparecer más de una vez.",[281,283,285],{"text":282},"Array\u003C",{"text":284,"ref":284},"FeedItem",{"text":286},">",{"name":288,"type":289,"required":71,"description":290,"nullable":66,"typeLabel":289},"has_more","boolean","`true` si ya hay más cambios listos; `false` cuando estás al día.",{"name":34,"type":247,"required":71,"description":292,"nullable":66,"typeLabel":247},"Siempre presente, también en una página vacía. Guárdalo después de aplicar la página y envíalo en la siguiente petición.","FeedPage",{"object":275,"data":295,"has_more":66,"next_cursor":341},[296,323,329],{"kind":297,"id":298,"version":61,"object":299},"lead","lead_r72EfbRNUzuqORFJR0O8HxAwEXd93jGUTYMaMMXKSF0QbLS8CiUKJpEP34LFQG",{"id":298,"object":297,"livemode":66,"team":300,"record_kind":297,"name":301,"surname":302,"email":303,"company":304,"phone":305,"phone_status":306,"status":307,"status_set_by":308,"archive_reason":70,"archived_from_status":70,"contact_permissions":309,"merged_into":70,"transferred_to":70,"revived_at":70,"pipeline_cleared":66,"converted_at":70,"value_at_conversion":70,"priority":311,"tags":312,"board":314,"stage":315,"assignees":316,"estimated_value":318,"estimated_value_currency":70,"source":319,"source_channel":70,"source_detail":70,"source_provenance":320,"created_at":321,"version":61,"updated_at":322},"team_r9uYrIW4gSFJJ6hZQ9ip1UIpPaAD1CF7NR","Alex","Rivera","alex.rivera@example.com","Example Dental","+12025550123","valid","contacted","ai",{"do_not_contact":66,"email_opt_out":66,"email_opt_out_at":70,"whatsapp_consent":70,"provenance":310},{"do_not_contact":70,"email_opt_out":70,"whatsapp_consent":70},"high",[313],"spring-check-up","brd_r72EfbRNUzuqORFJR0O8HxAwEXd93jGUTYMaMMX3trzsVUZQuHcMSuDh1aRIst","stg_r72EfbRNUzuqORFJR0O8HxAwEXd93jGUTYMaMMXWBYWcKwVTY3CRZlVS3oYvs0",[317],"mem_h548E7UiYhutHhucVrQCzkM0eaea0",1200,"meta_lead_ads","member_editable","2026-09-28T10:15:00.000Z","2026-09-28T10:20:01.250Z",{"kind":324,"id":325,"version":326,"removed":327},"call","call_m1pf4APjJWVi3Z7ulyNaW8y3lUi7V",5,{"reason":328},"deleted",{"kind":330,"id":298,"version":331,"object":332},"lead_response",7,{"id":298,"object":330,"livemode":66,"team":300,"last_inbound_at":333,"last_outbound_at":334,"awaiting_reply":66,"last_answered_call_at":335,"last_whatsapp_delivery_status":336,"coverage":337,"version":331,"updated_at":340},"2026-10-01T08:58:00.000Z","2026-10-01T08:59:30.000Z","2026-09-28T10:17:00.000Z","read",{"conversations":64,"calls":202,"channels_without_delivery_data":338,"truncated":66},[339],"email","2026-10-01T08:59:31.040Z","eyJ2IjoxLCJ0ZWFtIjoidGVhbV9yOXVZcklXNGdTRkpKNmhaUTlpcDFVSXBQYUFEMUNGN05SIiwiZXBvY2giOjAsInQiOnsicyI6MTc5MDg0NTE3MSwibnMiOjQwMDAwMDAwfSwibiI6IjVkMjJhMTVlM2E5MmNmYTE4NzUzZTVmYzkyZmVjNzI0MjQyNjIzZDE2MGIxZTUxMzRiYTM1ODE5MmUzNzM0ZjEiLCJicyI6bnVsbH01ZPX02",[343,344,345,346,347,348,349,350,351,352,353,354,355,356,357,358,359,360,361,362],"invalid_request","secret_key_in_browser","invalid_credentials","key_expired","insufficient_scope","plan_not_entitled","ip_not_allowed","capability_disabled","rate_limited","internal_error","api_disabled","service_unavailable","team_required","team_not_accessible","team_state_restricted","sector_restricted","capture_not_ready","quota_exceeded","resync_required","sync_cursor_expired",[364],{"name":284,"description":365,"fields":366,"example":428,"variants":434,"sharedFields":481},"Un cambio: el estado actual del registro, o su eliminación.",[367,376,387,391,419,422],{"name":38,"type":368,"required":71,"description":369,"nullable":66,"typeLabel":247,"enumValues":370},"\"lead\" | \"lead_attribution\" | \"lead_response\" | \"activity\" | \"call\" | \"conversation\" | \"booking\" | \"board\"","El tipo del registro, como `lead` o `call`.",[297,371,330,372,324,373,374,375],"lead_attribution","activity","conversation","booking","board",{"name":377,"type":247,"required":71,"description":378,"nullable":66,"typeLabel":247,"constraints":379},"id","Identificador público del registro; las facetas `lead_attribution` y `lead_response` usan el de su lead. Identificador público del registro eliminado.",{"prefixes":380},[381,382,383,384,385,386],"lead_","act_","call_","conv_","bkg_","brd_",{"name":388,"type":254,"required":71,"description":389,"nullable":66,"typeLabel":254,"constraints":390},"version","La versión del registro. Aplica el elemento solo si es mayor que la versión que guardas.",{"minimum":202},{"name":271,"type":392,"required":66,"description":393,"nullable":66,"typeLabel":392,"typeTokens":394,"conditional":71},"Lead | LeadAttribution | LeadResponse | Activity | Call | Conversation | Booking | Board","El registro tal como está ahora.",[395,397,399,401,402,404,405,407,408,410,411,413,414,416,417],{"text":396,"ref":396},"Lead",{"text":398}," | ",{"text":400,"ref":400},"LeadAttribution",{"text":398},{"text":403,"ref":403},"LeadResponse",{"text":398},{"text":406,"ref":406},"Activity",{"text":398},{"text":409,"ref":409},"Call",{"text":398},{"text":412,"ref":412},"Conversation",{"text":398},{"text":415,"ref":415},"Booking",{"text":398},{"text":418,"ref":418},"Board",{"name":420,"type":271,"required":66,"description":421,"nullable":66,"typeLabel":271,"conditional":71},"removed","Presente solo en una eliminación.",{"name":423,"type":424,"required":71,"description":425,"nullable":66,"typeLabel":247,"enumValues":426},"removed.reason","\"erased\" | \"deleted\"","`erased` tras una supresión, que es también lo que hace borrar un lead, una llamada o una conversación en Totem: suprimir un lead suprime también sus llamadas, sus conversaciones y sus duplicados fusionados, mientras que sus citas se conservan con `lead` a `null`. `deleted` en cualquier otra eliminación. En ambos casos, borra tu copia y conserva esta versión para ignorar una copia anterior que llegue después.",[427,328],"erased",{"kind":297,"id":298,"version":61,"object":429},{"id":298,"object":297,"livemode":66,"team":300,"record_kind":297,"name":301,"surname":302,"email":303,"company":304,"phone":305,"phone_status":306,"status":307,"status_set_by":308,"archive_reason":70,"archived_from_status":70,"contact_permissions":430,"merged_into":70,"transferred_to":70,"revived_at":70,"pipeline_cleared":66,"converted_at":70,"value_at_conversion":70,"priority":311,"tags":432,"board":314,"stage":315,"assignees":433,"estimated_value":318,"estimated_value_currency":70,"source":319,"source_channel":70,"source_detail":70,"source_provenance":320,"created_at":321,"version":61,"updated_at":322},{"do_not_contact":66,"email_opt_out":66,"email_opt_out_at":70,"whatsapp_consent":70,"provenance":431},{"do_not_contact":70,"email_opt_out":70,"whatsapp_consent":70},[313],[317],[435,470],{"key":436,"title":60,"description":60,"discriminator":70,"distinct":437,"ownFields":438},"with-object",[271],[439,443],{"name":377,"type":247,"required":71,"description":440,"nullable":66,"typeLabel":247,"constraints":441},"Identificador público del registro; las facetas `lead_attribution` y `lead_response` usan el de su lead.",{"prefixes":442},[381,382,383,384,385,386],{"name":271,"type":392,"required":71,"description":393,"nullable":66,"typeLabel":392,"typeTokens":444,"discriminatedBy":460},[445,446,447,448,449,450,451,452,453,454,455,456,457,458,459],{"text":396,"ref":396},{"text":398},{"text":400,"ref":400},{"text":398},{"text":403,"ref":403},{"text":398},{"text":406,"ref":406},{"text":398},{"text":409,"ref":409},{"text":398},{"text":412,"ref":412},{"text":398},{"text":415,"ref":415},{"text":398},{"text":418,"ref":418},{"key":38,"cases":461},[462,463,464,465,466,467,468,469],{"value":297,"typeLabel":396,"ref":396},{"value":371,"typeLabel":400,"ref":400},{"value":330,"typeLabel":403,"ref":403},{"value":372,"typeLabel":406,"ref":406},{"value":324,"typeLabel":409,"ref":409},{"value":373,"typeLabel":412,"ref":412},{"value":374,"typeLabel":415,"ref":415},{"value":375,"typeLabel":418,"ref":418},{"key":471,"title":60,"description":60,"discriminator":70,"distinct":472,"ownFields":473},"with-removed",[420],[474,478,479],{"name":377,"type":247,"required":71,"description":475,"nullable":66,"typeLabel":247,"constraints":476},"Identificador público del registro eliminado.",{"prefixes":477},[381,382,383,384,385,386],{"name":420,"type":271,"required":71,"description":421,"nullable":66,"typeLabel":271},{"name":423,"type":424,"required":71,"description":425,"nullable":66,"typeLabel":247,"enumValues":480},[427,328],[482,484],{"name":38,"type":368,"required":71,"description":369,"nullable":66,"typeLabel":247,"enumValues":483},[297,371,330,372,324,373,374,375],{"name":388,"type":254,"required":71,"description":389,"nullable":66,"typeLabel":254,"constraints":485},{"minimum":202},[487,495,500,505,512,517,524,531,536,541,547,552,559,566,573,580,586,594,599,606,612],{"code":343,"status":488,"title":489,"wireTitle":490,"action":491,"description":492,"fix":493,"retryable":66,"retry":494},400,"Petición no válida","Invalid request","fix_request","Algo de la petición no es válido: un parámetro de consulta desconocido, repetido o fuera de rango, una cadena de consulta o un cuerpo en un endpoint que no los admite, un cursor emitido para otro endpoint, otros filtros u otro equipo, una cabecera `Totem-Team` mal formada o un cuerpo que no es el JSON que espera el endpoint. `param` indica el parámetro, la cabecera o el campo que ha fallado. Un cursor de conversaciones también se rechaza cuando se suprime la conversación a la que apunta.","Corrige lo que indica `param` antes de reintentar: la misma petición falla igual. Si es un cursor, envía el `next_cursor` que recibiste del mismo endpoint, con los mismos filtros y el mismo equipo. Si se rechaza un cursor de conversaciones que no cambiaste, vuelve a empezar esa lista desde la primera página.","no",{"code":355,"status":488,"title":496,"wireTitle":497,"action":491,"description":498,"fix":499,"retryable":66,"retry":494},"Falta el equipo","Team required","La clave lee más de un equipo y este endpoint lee los datos de uno, pero la petición no indica cuál.","Envía el identificador del equipo (`team_…`, tal como aparece en `GET \u002Fv1\u002Fteams`) en la cabecera `Totem-Team`.",{"code":344,"status":488,"title":501,"wireTitle":502,"action":491,"description":503,"fix":504,"retryable":66,"retry":494},"Clave secreta enviada desde un navegador","Secret key sent from a browser","La petición llevaba una clave secreta junto con una cabecera `Origin`, lo que indica que salió de un navegador. Totem la rechaza sin leer nada.","Llama a la API solo desde tu servidor. Si la clave ha estado en una página web, una aplicación móvil o una extensión del navegador, dala por filtrada: rótala y márcala como comprometida para que la antigua deje de funcionar al instante.",{"code":345,"status":506,"title":507,"wireTitle":508,"action":509,"description":510,"fix":511,"retryable":66,"retry":494},401,"Credenciales no válidas","Invalid credentials","check_credentials","Falta la cabecera `Authorization` o está mal formada, o la clave no existe, es incorrecta o está revocada, o su integración ya no está activa.","Envía `Authorization: Bearer \u003Cclave>` con una clave secreta vigente. No reintentes en bucle: muchos fallos desde la misma dirección IP, o con la misma clave, la bloquean durante un tiempo con `429 rate_limited`.",{"code":346,"status":506,"title":513,"wireTitle":514,"action":509,"description":515,"fix":516,"retryable":66,"retry":494},"Clave caducada","Key expired","La clave se rotó y su periodo de gracia ha terminado.","Despliega la clave que la sustituyó: la antigua ya superó su periodo de gracia y no volverá a funcionar. Si no hay ninguna que la sustituya, crea una clave nueva en Ajustes → Desarrolladores.",{"code":347,"status":518,"title":519,"wireTitle":520,"action":521,"description":522,"fix":523,"retryable":66,"retry":494},403,"Permisos insuficientes","Insufficient scope","contact_support","A la clave le falta un permiso que necesita este endpoint. Todas las claves de la versión 1.0a tienen el conjunto completo de lectura, así que no debería ocurrir.","Escribe a soporte e indica el `Totem-Request-Id` de la respuesta.",{"code":348,"status":518,"title":525,"wireTitle":526,"action":527,"description":528,"fix":529,"retryable":71,"retry":530},"El plan no incluye la API","Plan not entitled","keep_and_retry","El plan de la organización no incluye ahora mismo la API de Totem.","Conserva tus datos y tus cursores y deja de llamar hasta que el cliente vuelva a tener un plan con acceso a la API; después, continúa donde lo dejaste. Mientras el acceso está denegado, el feed no entrega nada de los equipos de la clave, tampoco eliminaciones: si la denegación dura más de lo que permite tu política de conservación, borra tu copia.","restored",{"code":349,"status":518,"title":532,"wireTitle":533,"action":509,"description":534,"fix":535,"retryable":66,"retry":494},"Dirección IP no permitida","IP address not allowed","La clave es válida, pero la petición salió de una dirección IP que no está en la lista de IP permitidas de la integración.","Llama desde una dirección permitida o pide a un administrador que añada la tuya a la lista en Ajustes → Desarrolladores.",{"code":357,"status":518,"title":537,"wireTitle":538,"action":527,"description":539,"fix":540,"retryable":71,"retry":530},"Equipo restringido","Team restricted","El equipo está restringido por ahora: está desactivado (por ejemplo, suspendido por impago), archivado o es solo de facturación, o tiene pausado el acceso a la API. `GET \u002Fv1\u002Fteams` lo sigue mostrando.","Conserva los datos y el cursor del equipo, omítelo en esta ejecución y vuelve a intentarlo más tarde. Los demás equipos de la clave no se ven afectados. Mientras el equipo está restringido, el feed no entrega nada de él, tampoco eliminaciones: si la restricción dura más de lo que permite tu política de conservación, borra la copia del equipo.",{"code":358,"status":518,"title":542,"wireTitle":543,"action":527,"description":544,"fix":545,"retryable":66,"retry":546},"Sector restringido","Sector restricted","Totem no exporta los datos de este equipo por la API porque el equipo trabaja en un sector sensible, como el sanitario, en el que sus registros pueden revelar información de salud.","Omite el equipo: esperar no lo cambia. El feed no entrega nada de él, tampoco eliminaciones, así que conserva lo que ya tengas solo mientras lo permita tu política de conservación y después borra la copia del equipo. Si necesitas sus datos, habla con el cliente o con Totem.","blocked",{"code":350,"status":518,"title":548,"wireTitle":549,"action":527,"description":550,"fix":551,"retryable":71,"retry":530},"Función desactivada","Capability disabled","Totem ha desactivado temporalmente este endpoint para todas las claves.","Conserva tus datos y tus cursores y vuelve a intentarlo más tarde; el resto de endpoints sigue funcionando.",{"code":553,"status":554,"title":555,"wireTitle":556,"action":491,"description":557,"fix":558,"retryable":66,"retry":494},"resource_missing",404,"Recurso no encontrado","Resource not found","El registro no existe, se eliminó, pertenece a un equipo que esta clave no lee o se creó hace tan poco que Totem aún no lo ha preparado. Un `GET` o un `POST` bajo `\u002Fv1\u002F` que no corresponde a ningún endpoint también recibe este código. Cualquier otro método, y cualquier ruta fuera de `\u002Fv1\u002F`, recibe un `404` simple del cortafuegos que protege la API, sin cuerpo de error ni `Totem-Request-Id`.","Comprueba el identificador y la ruta. Si el registro se acaba de crear, no reintentes en bucle: el feed de cambios lo entregará en cuanto esté listo.",{"code":356,"status":554,"title":560,"wireTitle":561,"action":562,"description":563,"fix":564,"retryable":66,"retry":565},"Equipo no accesible","Team not accessible","drop_team","La cabecera `Totem-Team` indica un equipo que esta clave no lee: uno que nunca incluyó, uno que se quitó de la clave o de la organización, o uno que se eliminó. Sin la cabecera, significa que la clave ya no lee ningún equipo.","Vuelve a leer `GET \u002Fv1\u002Fteams` antes de actuar. Si el equipo ya no aparece, borra su copia y su cursor; si sigue apareciendo, conserva todo y vuelve a intentarlo en la siguiente ejecución.","confirm",{"code":361,"status":567,"title":568,"wireTitle":569,"action":570,"description":571,"fix":572,"retryable":66,"retry":494},409,"Hay que volver a sincronizar","Resync required","resync","Totem no puede continuar el feed desde este cursor: los datos se restauraron desde una copia de seguridad o se detectó un hueco en los cambios del equipo.","Haz una resincronización completa: olvida las versiones que guardaste del equipo, vuelve a leer el feed sin cursor y, cuando estés al día, borra los registros locales del equipo que no hayan llegado. Hasta entonces, sigue usando tu copia actual.",{"code":359,"status":567,"title":574,"wireTitle":575,"action":576,"description":577,"fix":578,"retryable":71,"retry":579},"Los datos del equipo aún se están preparando","Team data is still being prepared","wait_capture","Totem aún está preparando los datos de este equipo para la API. Ocurre una sola vez por equipo, después de que se añada por primera vez a una clave; añadirlo después a otra clave no lo repite.","Conserva lo que tengas del equipo y vuelve a intentarlo dentro de unos minutos; mientras tanto, los demás equipos de la clave siguen sincronizándose.","later",{"code":362,"status":581,"title":582,"wireTitle":583,"action":570,"description":584,"fix":585,"retryable":66,"retry":494},410,"Cursor de sincronización caducado","Sync cursor expired","El cursor tiene más de 30 días, contados desde el punto del feed al que llegó (o, mientras una carga inicial sigue en curso, desde que empezó).","Haz una resincronización completa, como con `resync_required`. Para evitarlo, guarda el `next_cursor` de cada página, también de las vacías: el cursor de un equipo que consultas con regularidad nunca caduca.",{"code":351,"status":587,"title":588,"wireTitle":589,"action":590,"description":591,"fix":592,"retryable":71,"retry":593},429,"Límite de frecuencia superado","Rate limited","retry_after","La clave ha superado su límite de frecuencia (elementos por minuto), o demasiados intentos de autenticación fallidos desde esta dirección IP o con esta clave la han bloqueado durante un tiempo.","Espera los segundos que indica `Retry-After` y repite la misma petición. Cada petición aparta su `limit` completo al empezar y devuelve lo que no usa, así que con un `limit` más pequeño avanzas aunque quede poco margen.","after",{"code":360,"status":587,"title":595,"wireTitle":596,"action":590,"description":597,"fix":598,"retryable":71,"retry":593},"Cuota diaria superada","Daily quota exceeded","La clave ha consumido su cuota diaria de elementos. Para la cuota cuenta cada elemento que devuelven el feed de cambios y todas las listas, incluidas `GET \u002Fv1\u002Fteams`, `GET \u002Fv1\u002Fmembers`, `GET \u002Fv1\u002Fbooking_services` y las actividades de un lead. La cuota se renueva a las 00:00 UTC.","Deja de sincronizar hasta las 00:00 UTC (`Retry-After` indica los segundos que faltan) y continúa entonces con el mismo cursor: no se pierde nada. Las peticiones de un solo registro, como `GET \u002Fv1\u002Fleads\u002F{id}`, la búsqueda y `GET \u002Fv1\u002Fme` no cuentan para la cuota y siguen funcionando.",{"code":352,"status":600,"title":601,"wireTitle":602,"action":603,"description":604,"fix":605,"retryable":71,"retry":603},500,"Error interno","Internal error","backoff","Algo ha fallado dentro de Totem al responder a esta petición.","Reintenta con una espera exponencial. Si sigue fallando, escribe a soporte e indica el `Totem-Request-Id`.",{"code":353,"status":607,"title":608,"wireTitle":609,"action":603,"description":610,"fix":611,"retryable":71,"retry":603},503,"API desactivada","API disabled","Totem ha desactivado temporalmente la API para todas las claves.","Conserva tus datos y tus cursores y reintenta más tarde con una espera exponencial.",{"code":354,"status":607,"title":613,"wireTitle":614,"action":603,"description":615,"fix":616,"retryable":71,"retry":603},"Servicio no disponible","Service unavailable","Reservado: la API no devuelve hoy este código. Un `503` del balanceador de carga o de la plataforma que aloja la API llega sin cuerpo de error; trátalo como este código.","Reintenta con una espera exponencial; tus datos y tus cursores siguen siendo válidos.",[343,344,345,346,347,348,349,350,351,352,353,354],{"type":619,"title":556,"status":554,"code":553,"request_id":620,"doc_url":619},"https:\u002F\u002Ftotemstudio.ai\u002Fdevelopers\u002Ferrors#resource_missing","req_0f6b2c1e-8d4a-4b7e-9c3f-5a2d1e7b9c40",[622,623,624],{"id":14,"text":15,"depth":64},{"id":233,"text":236,"depth":64},{"id":284,"text":284,"depth":64},{"path":156,"title":157,"section":75},{"path":162,"title":163,"section":75},[628],{"id":233,"method":234,"path":235,"summary":236},1792502791084]