[{"data":1,"prerenderedAt":689},["ShallowReactive",2],{"developers:\u002Fdevelopers\u002Fes\u002Freference-conversations":3},{"doc":4,"lang":153,"nav":165,"alternatePath":269,"policy":270,"specVersion":314,"reference":315,"layout":160,"toc":679,"prev":684,"next":685,"operations":686,"overview":155,"heroExample":155},{"id":5,"title":6,"apiTag":7,"body":8,"description":150,"draft":151,"extension":152,"lang":153,"meta":154,"navTitle":155,"navigation":156,"order":157,"path":158,"rawbody":159,"section":160,"seo":161,"stem":162,"translationKey":163,"version":155,"__hash__":164},"developers_es\u002Fdevelopers\u002Fes\u002Freference-conversations.md","Conversaciones","conversations",{"type":9,"value":10,"toc":144},"minimark",[11,16,34,106,120],[12,13,15],"h2",{"id":14},"resumen","Resumen",[17,18,19,20,24,25,29,30,33],"p",{},"Una ",[21,22,23],"strong",{},"conversación"," es un hilo con un lead en un canal y una cuenta de empresa: WhatsApp, correo electrónico, el chat web (",[26,27,28],"code",{},"chatbot","), Facebook, Instagram, SMS o TikTok. Un lead puede tener varias conversaciones en el mismo canal y cuenta de empresa, una por cada dirección de contacto (teléfono, correo electrónico o usuario) que haya usado, así que usa el ",[26,31,32],{},"id"," de la conversación como clave de tu copia. Recibes los metadatos de la conversación, nunca sus mensajes:",[35,36,37,48,62,71,90],"ul",{},[38,39,40,43,44,47],"li",{},[26,41,42],{},"channel_type",": el canal, o ",[26,45,46],{},"null"," para un canal que esta versión de la API no conoce.",[38,49,50,53,54,57,58,61],{},[26,51,52],{},"status",": ",[26,55,56],{},"active"," o ",[26,59,60],{},"archived"," en la bandeja de entrada del equipo.",[38,63,64,67,68,70],{},[26,65,66],{},"assignee",": el miembro del equipo al que está asignada la conversación, o ",[26,69,46],{},".",[38,72,73,53,76,79,80,83,84,86,87,89],{},[26,74,75],{},"reply_mode",[26,77,78],{},"human"," mientras una persona ha tomado el control de la conversación, incluido un chat de WhatsApp que se atiende desde la app WhatsApp Business, y ",[26,81,82],{},"ai"," en los demás casos. ",[26,85,82],{}," significa que no hay una toma de control activa; no significa que haya un asistente configurado o respondiendo en ese canal. Una toma de control con límite de tiempo vuelve a ",[26,88,82],{}," cuando termina, y en ese momento la conversación recibe una versión nueva.",[38,91,92,95,96,99,100,102,103,105],{},[26,93,94],{},"last_inbound_at"," y ",[26,97,98],{},"last_outbound_at",": cuándo llegó el último mensaje del cliente y cuándo salió hacia él el último mensaje que no falló. Los mensajes suprimidos, el historial de WhatsApp importado y los mensajes de los visitantes del chat web no cuentan como entrantes, así que una conversación ",[26,101,28],{}," lo trae como ",[26,104,46],{},". El historial de WhatsApp importado sí cuenta como saliente.",[17,107,108,109,112,113,70],{},"El nombre, el teléfono o el usuario del contacto viajan en el lead vinculado, no en la conversación. Para ver el conjunto de todos los canales de un lead, lee la faceta ",[26,110,111],{},"response"," del lead con ",[114,115,117],"a",{"href":116},"\u002Fdevelopers\u002Fes\u002Freference-leads#leads.get",[26,118,119],{},"GET \u002Fv1\u002Fleads\u002F{id}",[17,121,122,123,95,129,135,136,139,140,70],{},"Usa ",[114,124,126],{"href":125},"\u002Fdevelopers\u002Fes\u002Freference-conversations#conversations.list",[26,127,128],{},"GET \u002Fv1\u002Fconversations",[114,130,132],{"href":131},"\u002Fdevelopers\u002Fes\u002Freference-conversations#conversations.get",[26,133,134],{},"GET \u002Fv1\u002Fconversations\u002F{id}"," para consultar conversaciones; ",[26,137,138],{},"GET \u002Fv1\u002Fconversations?lead="," lista las conversaciones de un lead. Para mantener una copia, sigue el feed de cambios: lo explica ",[114,141,143],{"href":142},"\u002Fdevelopers\u002Fes\u002Fsync","Sincroniza una copia",{"title":145,"searchDepth":146,"depth":146,"links":147},"",3,[148],{"id":14,"depth":149,"text":15},2,"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.",false,"md","es",{},null,true,"70","\u002Fdevelopers\u002Fes\u002Freference-conversations","---\ntitle: Conversaciones\ndescription: 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.\nsection: reference\norder: 70\ntranslationKey: reference-conversations\nlang: es\ndraft: false\napiTag: conversations\n---\n\n## Resumen\n\nUna **conversación** es un hilo con un lead en un canal y una cuenta de empresa: WhatsApp, correo electrónico, el chat web (`chatbot`), Facebook, Instagram, SMS o TikTok. Un lead puede tener varias conversaciones en el mismo canal y cuenta de empresa, una por cada dirección de contacto (teléfono, correo electrónico o usuario) que haya usado, así que usa el `id` de la conversación como clave de tu copia. Recibes los metadatos de la conversación, nunca sus mensajes:\n\n- `channel_type`: el canal, o `null` para un canal que esta versión de la API no conoce.\n- `status`: `active` o `archived` en la bandeja de entrada del equipo.\n- `assignee`: el miembro del equipo al que está asignada la conversación, o `null`.\n- `reply_mode`: `human` mientras una persona ha tomado el control de la conversación, incluido un chat de WhatsApp que se atiende desde la app WhatsApp Business, y `ai` en los demás casos. `ai` significa que no hay una toma de control activa; no significa que haya un asistente configurado o respondiendo en ese canal. Una toma de control con límite de tiempo vuelve a `ai` cuando termina, y en ese momento la conversación recibe una versión nueva.\n- `last_inbound_at` y `last_outbound_at`: cuándo llegó el último mensaje del cliente y cuándo salió hacia él el último mensaje que no falló. Los mensajes suprimidos, el historial de WhatsApp importado y los mensajes de los visitantes del chat web no cuentan como entrantes, así que una conversación `chatbot` lo trae como `null`. El historial de WhatsApp importado sí cuenta como saliente.\n\nEl nombre, el teléfono o el usuario del contacto viajan en el lead vinculado, no en la conversación. Para ver el conjunto de todos los canales de un lead, lee la faceta `response` del lead con [`GET \u002Fv1\u002Fleads\u002F{id}`](\u002Fdevelopers\u002Fes\u002Freference-leads#leads.get).\n\nUsa [`GET \u002Fv1\u002Fconversations`](\u002Fdevelopers\u002Fes\u002Freference-conversations#conversations.list) y [`GET \u002Fv1\u002Fconversations\u002F{id}`](\u002Fdevelopers\u002Fes\u002Freference-conversations#conversations.get) para consultar conversaciones; `GET \u002Fv1\u002Fconversations?lead=` lista las conversaciones de un lead. Para mantener una copia, sigue el feed de cambios: lo explica [Sincroniza una copia](\u002Fdevelopers\u002Fes\u002Fsync).\n","reference",{"title":6,"description":150},"developers\u002Fes\u002Freference-conversations","reference-conversations","ITLZwNSCm2uoO4Usuv-ZByY2q3JqU8pQVFZbatVklkk",[166,181,206,250],{"section":167,"items":168},"start",[169,173,177],{"path":170,"title":171,"description":172},"\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":174,"title":175,"description":176},"\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":178,"title":179,"description":180},"\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":182,"items":183},"guides",[184,188,190,194,198,202],{"path":185,"title":186,"description":187},"\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":142,"title":143,"description":189},"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":191,"title":192,"description":193},"\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":195,"title":196,"description":197},"\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":199,"title":200,"description":201},"\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":203,"title":204,"description":205},"\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":160,"items":207},[208,212,216,220,225,230,235,236,241,246],{"path":209,"title":210,"description":211},"\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":213,"title":214,"description":215},"\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":217,"title":218,"description":219},"\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":221,"title":222,"description":223,"apiTag":224},"\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":226,"title":227,"description":228,"apiTag":229},"\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":231,"title":232,"description":233,"apiTag":234},"\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":158,"title":6,"description":150,"apiTag":7},{"path":237,"title":238,"description":239,"apiTag":240},"\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":242,"title":243,"description":244,"apiTag":245},"\u002Fdevelopers\u002Fes\u002Freference-sync","Feed de cambios","Un único endpoint que copia un equipo y, después, devuelve cada cambio, página a página.","sync",{"path":247,"title":248,"description":249},"\u002Fdevelopers\u002Fes\u002Fobjects","Todos los objetos","Todos los objetos que devuelve la API, campo a campo, con un ejemplo de cada uno.",{"section":251,"items":252},"resources",[253,257,261,265],{"path":254,"title":255,"description":256},"\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":258,"title":259,"description":260},"\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":262,"title":263,"description":264},"\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":266,"title":267,"description":268},"\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-conversations",{"ACTIVATION_MARGIN_MS":271,"ADMIN_ACCESS_DISCLOSURE_VERSION":272,"AUDIT_RETENTION_DAYS":273,"AUTH_FAILURE_LIMITS":274,"CAPTURE_LAG_FLOOR_MS":278,"CAPTURE_LAG_P99_MS":155,"CURSOR_MAX_AGE_DAYS":279,"DIRTY_TTL_DAYS":279,"FAMILY_TEAM_SCOPE":280,"FAMILY_TEAM_SCOPE_OPTIONS":281,"FEED_SETTLE_LAG_MS":283,"GATE_REFRESH_MS":271,"INTEGRATION_NAME_LENGTH":284,"INTEGRATION_PURPOSE_LENGTH":286,"KEY_CACHE_TTL_MS":289,"KEY_STATS_RETENTION_DAYS":290,"LEAD_RESPONSE_READ_BUDGET":291,"LIST_SCAN_MAX":294,"MAX_FAMILY_INTEGRATION_TEAMS":279,"MAX_INTEGRATIONS_PER_FAMILY":295,"MAX_IP_ALLOWLIST":276,"PAGE_LIMIT":296,"PLATFORM_CONFIG_TTL_MS":299,"REMOVAL_RETENTION_DAYS":300,"REQUEST_BODY_MAX_BYTES":301,"ROLL_GRACE_DEFAULT_HOURS":302,"ROLL_GRACE_HOURS":303,"SEARCH_MAX_RESULTS":295,"SENSITIVE_SECTOR_POLICY":306,"SENSITIVE_SECTOR_POLICY_OPTIONS":307,"SYNC_DAILY_BUDGET":309,"SYNC_VELOCITY":311,"TEAM_CACHE_TTL_MS":313},60000,"2026-10-17",365,{"perIpPerMinute":275,"perLookupIdPerMinute":276,"banMs":277},60,20,600000,300000,30,"explicit_list",[280,282],"all_family_teams",10000,{"min":149,"max":285},80,{"min":287,"max":288},1,280,5000,90,{"conversations":276,"messageReads":292,"calls":293},200,50,1000,10,{"default":297,"max":298},25,100,15000,45,16384,24,[304,287,302,305],0,168,"exclude",[306,308],"allow",{"floor":310,"recordsMultiplier":146},250000,{"perMinute":312,"burst":283},2000,30000,"1.0a",{"operations":316,"schemas":505,"errors":543,"commonErrors":675,"defaultStability":323,"policy":270,"problemExample":676},[317,418],{"id":318,"method":319,"path":320,"summary":321,"description":322,"stability":323,"scopes":324,"rateClass":245,"tenantBinding":326,"authenticated":156,"parameters":327,"parametersByLocation":353,"body":357,"bodyDescription":145,"responseFields":358,"responseComponent":384,"listOf":373,"example":385,"errors":399,"tag":7},"conversations.list","GET","\u002Fv1\u002Fconversations","Lista las conversaciones","Devuelve una página de conversaciones del equipo, una por canal, cuenta de empresa y dirección de contacto: canal, estado en la bandeja de entrada, responsable y la hora de los últimos mensajes recibidos y enviados. Envía `lead` para obtener las conversaciones de un lead. El contenido de los mensajes nunca se exporta.","beta",[325],"messages:read","team_header",[328,334,340,346],{"name":329,"type":330,"required":151,"description":331,"nullable":151,"typeLabel":330,"constraints":332,"location":333},"limit","integer","Elementos por página, de 1 a 100. Por defecto, 25.",{"minimum":287,"maximum":298,"default":297},"query",{"name":335,"type":336,"required":151,"description":337,"nullable":151,"typeLabel":336,"constraints":338,"location":333},"cursor","string","El `next_cursor` de la página anterior. Omítelo en la primera página.",{"minLength":287,"maxLength":339},512,{"name":341,"type":336,"required":151,"description":342,"nullable":151,"typeLabel":336,"constraints":343,"location":333},"lead","Solo las conversaciones vinculadas a este lead: el `lead` de cada elemento es este identificador. Un lead de otro equipo, o que no existe, no coincide con nada.",{"prefixes":344},[345],"lead_",{"name":347,"type":336,"required":151,"description":348,"nullable":151,"typeLabel":336,"constraints":349,"conditional":156,"location":352},"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":350},[351],"team_","header",{"path":354,"query":355,"header":356},[],[328,334,340],[346],[],[359,365,376,380],{"name":360,"type":361,"required":156,"description":362,"nullable":151,"typeLabel":336,"enumValues":363,"constant":156},"object","\"list\"","Siempre `list`.",[364],"list",{"name":366,"type":367,"required":156,"description":368,"nullable":151,"typeLabel":367,"typeTokens":369,"ref":373},"data","Array\u003CConversation>","Los elementos de esta página.",[370,372,374],{"text":371},"Array\u003C",{"text":373,"ref":373},"Conversation",{"text":375},">",{"name":377,"type":378,"required":156,"description":379,"nullable":151,"typeLabel":378},"has_more","boolean","`true` si hay otra página: pídela con `next_cursor`, aunque esta traiga menos elementos que `limit`.",{"name":381,"type":382,"required":156,"description":383,"nullable":156,"typeLabel":336},"next_cursor","string | null","Cursor opaco de la página siguiente, o null en la última. No lo interpretes.","ConversationList",{"object":364,"data":386,"has_more":151,"next_cursor":155},[387],{"id":388,"object":389,"livemode":151,"team":390,"lead":391,"channel_type":392,"status":56,"assignee":393,"reply_mode":82,"created_at":394,"last_inbound_at":395,"last_outbound_at":396,"version":397,"updated_at":398},"conv_m3GhGjRHmFbww1g10oqOp7j3gWqPJ","conversation","team_r9uYrIW4gSFJJ6hZQ9ip1UIpPaAD1CF7NR","lead_r72EfbRNUzuqORFJR0O8HxAwEXd93jGUTYMaMMXKSF0QbLS8CiUKJpEP34LFQG","whatsapp","mem_h548E7UiYhutHhucVrQCzkM0eaea0","2026-09-28T10:16:00.000Z","2026-10-01T08:58:00.000Z","2026-10-01T08:59:30.000Z",12,"2026-10-01T08:59:31.040Z",[400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,415,416,417],"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",{"id":419,"method":319,"path":420,"summary":421,"description":422,"stability":323,"scopes":423,"rateClass":424,"tenantBinding":425,"authenticated":156,"parameters":426,"parametersByLocation":433,"body":437,"bodyDescription":145,"responseFields":438,"responseComponent":373,"listOf":155,"example":502,"errors":503,"tag":7},"conversations.get","\u002Fv1\u002Fconversations\u002F{id}","Obtén una conversación","Devuelve una conversación por su identificador, sin el contenido de los mensajes. Una conversación que esta clave no puede leer, o que se eliminó, responde `404 resource_missing`.",[325],"read","resource_id",[427],{"name":32,"type":336,"required":156,"description":428,"nullable":151,"typeLabel":336,"constraints":429,"location":432},"El identificador público de la conversación.",{"prefixes":430},[431],"conv_","path",{"path":434,"query":435,"header":436},[427],[],[],[],[439,443,447,450,455,459,468,472,477,481,487,490,493,497],{"name":32,"type":336,"required":156,"description":440,"nullable":151,"typeLabel":336,"constraints":441},"Identificador público del registro.",{"prefixes":442},[431],{"name":360,"type":444,"required":156,"description":445,"nullable":151,"typeLabel":336,"enumValues":446,"constant":156},"\"conversation\"","Siempre `conversation`.",[389],{"name":448,"type":378,"required":156,"description":449,"nullable":151,"typeLabel":378},"livemode","`true` en datos reales; `false` en los datos de ejemplo.",{"name":451,"type":336,"required":156,"description":452,"nullable":151,"typeLabel":336,"constraints":453},"team","El equipo al que pertenece este registro.",{"prefixes":454},[351],{"name":341,"type":382,"required":156,"description":456,"nullable":156,"typeLabel":336,"constraints":457},"El lead al que está vinculada la conversación, o null si no está vinculada o el lead ya no existe. El nombre, el teléfono y el usuario solo aparecen en el lead.",{"prefixes":458},[345],{"name":42,"type":460,"required":156,"description":461,"nullable":156,"typeLabel":336,"enumValues":462},"\"sms\" | \"whatsapp\" | \"facebook\" | \"instagram\" | \"tiktok\" | \"chatbot\" | \"email\" | null","El canal: `whatsapp`, `email`, `chatbot` (el chat web), `facebook`, `instagram`, `sms` o `tiktok`; null si es un valor que esta versión no conoce. Un lead puede tener varias conversaciones en el mismo canal y cuenta de empresa, una por cada dirección de contacto (teléfono, correo electrónico o usuario) que haya usado, así que usa el `id` como clave de tu copia.",[463,392,464,465,466,28,467],"sms","facebook","instagram","tiktok","email",{"name":52,"type":469,"required":156,"description":470,"nullable":156,"typeLabel":336,"enumValues":471},"\"active\" | \"archived\" | null","`active` o `archived` en la bandeja del equipo; null si es un valor que esta versión no conoce.",[56,60],{"name":66,"type":382,"required":156,"description":473,"nullable":156,"typeLabel":336,"constraints":474},"El miembro del equipo asignado a la conversación (ver `\u002Fmembers`), o null.",{"prefixes":475},[476],"mem_",{"name":75,"type":478,"required":156,"description":479,"nullable":151,"typeLabel":336,"enumValues":480},"\"ai\" | \"human\"","`human` mientras una persona ha tomado la conversación, incluido un chat de WhatsApp que se atiende desde la app WhatsApp Business; `ai` en otro caso. `ai` significa que no hay una toma activa, no que haya un asistente configurado o respondiendo en este canal. Una toma temporal vuelve a `ai` cuando caduca, y la versión del registro cambia entonces.",[82,78],{"name":482,"type":483,"required":156,"description":484,"nullable":156,"typeLabel":336,"constraints":485},"created_at","string (date-time) | null","Cuándo se creó la conversación (UTC).",{"format":486},"date-time",{"name":94,"type":483,"required":156,"description":488,"nullable":156,"typeLabel":336,"constraints":489},"El último mensaje del cliente (UTC). No cuentan: mensajes borrados, historial de WhatsApp importado ni los turnos del visitante del chat web, así que una conversación `chatbot` da null. Los contenidos compartidos de Instagram no se distinguen y sí cuentan.",{"format":486},{"name":98,"type":483,"required":156,"description":491,"nullable":156,"typeLabel":336,"constraints":492},"El último mensaje enviado al cliente que no falló (UTC), lo enviara quien lo enviara. El historial de WhatsApp importado sí cuenta.",{"format":486},{"name":494,"type":330,"required":156,"description":495,"nullable":151,"typeLabel":330,"constraints":496},"version","Aumenta cada vez que cambia alguno de los campos exportados del registro. Aplica un cambio solo si su versión es mayor que la que guardas.",{"minimum":287},{"name":498,"type":499,"required":156,"description":500,"nullable":151,"typeLabel":336,"constraints":501},"updated_at","string (date-time)","Cuándo registró Totem esta versión (UTC). No es la hora en que ocurrió el hecho.",{"format":486},{"id":388,"object":389,"livemode":151,"team":390,"lead":391,"channel_type":392,"status":56,"assignee":393,"reply_mode":82,"created_at":394,"last_inbound_at":395,"last_outbound_at":396,"version":397,"updated_at":398},[400,401,402,403,404,405,406,407,408,409,410,411,504,414,415,416],"resource_missing",[506],{"name":373,"description":507,"fields":508,"example":540,"variants":541,"sharedFields":542},"Una conversación en un canal: su estado, su responsable y la hora de los últimos mensajes, nunca su contenido.",[509,512,514,515,518,521,523,525,528,530,532,534,536,538],{"name":32,"type":336,"required":156,"description":440,"nullable":151,"typeLabel":336,"constraints":510},{"prefixes":511},[431],{"name":360,"type":444,"required":156,"description":445,"nullable":151,"typeLabel":336,"enumValues":513,"constant":156},[389],{"name":448,"type":378,"required":156,"description":449,"nullable":151,"typeLabel":378},{"name":451,"type":336,"required":156,"description":452,"nullable":151,"typeLabel":336,"constraints":516},{"prefixes":517},[351],{"name":341,"type":382,"required":156,"description":456,"nullable":156,"typeLabel":336,"constraints":519},{"prefixes":520},[345],{"name":42,"type":460,"required":156,"description":461,"nullable":156,"typeLabel":336,"enumValues":522},[463,392,464,465,466,28,467],{"name":52,"type":469,"required":156,"description":470,"nullable":156,"typeLabel":336,"enumValues":524},[56,60],{"name":66,"type":382,"required":156,"description":473,"nullable":156,"typeLabel":336,"constraints":526},{"prefixes":527},[476],{"name":75,"type":478,"required":156,"description":479,"nullable":151,"typeLabel":336,"enumValues":529},[82,78],{"name":482,"type":483,"required":156,"description":484,"nullable":156,"typeLabel":336,"constraints":531},{"format":486},{"name":94,"type":483,"required":156,"description":488,"nullable":156,"typeLabel":336,"constraints":533},{"format":486},{"name":98,"type":483,"required":156,"description":491,"nullable":156,"typeLabel":336,"constraints":535},{"format":486},{"name":494,"type":330,"required":156,"description":495,"nullable":151,"typeLabel":330,"constraints":537},{"minimum":287},{"name":498,"type":499,"required":156,"description":500,"nullable":151,"typeLabel":336,"constraints":539},{"format":486},{"id":388,"object":389,"livemode":151,"team":390,"lead":391,"channel_type":392,"status":56,"assignee":393,"reply_mode":82,"created_at":394,"last_inbound_at":395,"last_outbound_at":396,"version":397,"updated_at":398},[],[],[544,552,557,562,569,574,581,588,593,598,604,609,615,622,630,637,644,652,657,664,670],{"code":400,"status":545,"title":546,"wireTitle":547,"action":548,"description":549,"fix":550,"retryable":151,"retry":551},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":412,"status":545,"title":553,"wireTitle":554,"action":548,"description":555,"fix":556,"retryable":151,"retry":551},"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":401,"status":545,"title":558,"wireTitle":559,"action":548,"description":560,"fix":561,"retryable":151,"retry":551},"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":402,"status":563,"title":564,"wireTitle":565,"action":566,"description":567,"fix":568,"retryable":151,"retry":551},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":403,"status":563,"title":570,"wireTitle":571,"action":566,"description":572,"fix":573,"retryable":151,"retry":551},"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":404,"status":575,"title":576,"wireTitle":577,"action":578,"description":579,"fix":580,"retryable":151,"retry":551},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":405,"status":575,"title":582,"wireTitle":583,"action":584,"description":585,"fix":586,"retryable":156,"retry":587},"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":406,"status":575,"title":589,"wireTitle":590,"action":566,"description":591,"fix":592,"retryable":151,"retry":551},"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":414,"status":575,"title":594,"wireTitle":595,"action":584,"description":596,"fix":597,"retryable":156,"retry":587},"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":415,"status":575,"title":599,"wireTitle":600,"action":584,"description":601,"fix":602,"retryable":151,"retry":603},"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":407,"status":575,"title":605,"wireTitle":606,"action":584,"description":607,"fix":608,"retryable":156,"retry":587},"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":504,"status":610,"title":611,"wireTitle":612,"action":548,"description":613,"fix":614,"retryable":151,"retry":551},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":413,"status":610,"title":616,"wireTitle":617,"action":618,"description":619,"fix":620,"retryable":151,"retry":621},"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":623,"status":624,"title":625,"wireTitle":626,"action":627,"description":628,"fix":629,"retryable":151,"retry":551},"resync_required",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":416,"status":624,"title":631,"wireTitle":632,"action":633,"description":634,"fix":635,"retryable":156,"retry":636},"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":638,"status":639,"title":640,"wireTitle":641,"action":627,"description":642,"fix":643,"retryable":151,"retry":551},"sync_cursor_expired",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":408,"status":645,"title":646,"wireTitle":647,"action":648,"description":649,"fix":650,"retryable":156,"retry":651},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":417,"status":645,"title":653,"wireTitle":654,"action":648,"description":655,"fix":656,"retryable":156,"retry":651},"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":409,"status":658,"title":659,"wireTitle":660,"action":661,"description":662,"fix":663,"retryable":156,"retry":661},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":410,"status":665,"title":666,"wireTitle":667,"action":661,"description":668,"fix":669,"retryable":156,"retry":661},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":411,"status":665,"title":671,"wireTitle":672,"action":661,"description":673,"fix":674,"retryable":156,"retry":661},"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.",[400,401,402,403,404,405,406,407,408,409,410,411],{"type":677,"title":612,"status":610,"code":504,"request_id":678,"doc_url":677},"https:\u002F\u002Ftotemstudio.ai\u002Fdevelopers\u002Ferrors#resource_missing","req_0f6b2c1e-8d4a-4b7e-9c3f-5a2d1e7b9c40",[680,681,682,683],{"id":14,"text":15,"depth":149},{"id":318,"text":321,"depth":149},{"id":419,"text":421,"depth":149},{"id":373,"text":373,"depth":149},{"path":231,"title":232,"section":160},{"path":237,"title":238,"section":160},[687,688],{"id":318,"method":319,"path":320,"summary":321},{"id":419,"method":319,"path":420,"summary":421},1792502791042]