Saltar al contenido
Beta

Recursos Registro de cambios

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ó.

Cada entrada lleva su fecha, y una entrada que te pide cambiar tu integración o hacer una resincronización completa empieza por Acción necesaria. En Convenciones se explica qué puede cambiar durante la Beta.

1.0a: actualizaciones de la Beta (2026-10-18)

  • GET /v1/calls, GET /v1/conversations y GET /v1/bookings admiten un filtro opcional lead: las llamadas, las conversaciones o las citas de un lead, sin recorrer toda la lista.
  • POST /v1/leads/search por phone también encuentra el número guardado en los formatos que escriben las bibliotecas de teléfonos (+1 202-555-0123, (202) 555-0123 y 2025550123), como lo guardaban las importaciones antiguas.
  • La documentación en español muestra el título de cada error en español. El title del cuerpo de un error sigue en inglés.
  • Totem deja de exportar los equipos de un sector de actividad sensible, como el sanitario, hasta que cambie su política de sectores. Un equipo así ya no se puede añadir a una integración, y una clave que ya lo cubre recibe 403 sector_restricted para él. Omite el equipo. El feed de cambios 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 tu copia.
  • Las actividades cuya primera captura falló se capturan ahora más tarde, así que un lead puede recibir actividades anteriores a las que ya tienes.
  • transferred_to.lead documenta ahora que también es null cuando el traspaso cayó en un lead de anuncios que ya existía o en otro lead con identificador fijo.
  • La documentación indica ahora que la API solo es accesible por IPv4, así que una entrada IPv6 de una lista de IP permitidas nunca coincide.
  • Las llamadas que Totem ha conciliado o importado de su proveedor de voz con IA indican ahora su outcome real, en lugar de unknown. Una llamada en curso indica duration_seconds como null.
  • Un lead cuyo estado no conoce esta versión trae ahora record_kind: "lead" con status: null, en lugar de client.
  • En un lead, attribution.original_capture.origin.kind es siempre conversation o call, y original_capture.source usa los mismos valores que el source del lead. Un envío de LinkedIn que la persona retiró ya no aparece como el último envío.
  • Acción necesaria. Una clave de un solo equipo deja de leer su equipo, con 404 team_not_accessible, cuando el equipo entra en una organización, sale de ella o cambia de organización. Revócala y crea una nueva.
  • El límite de frecuencia por clave cobra al menos un elemento por cada petición que cuenta, también por una búsqueda sin resultados y por un 404. Límites de frecuencia y cuota indica qué no se cobra.
  • Un cursor manipulado de GET /v1/sync/changes recibe 400 invalid_request, en lugar de un 500.
  • Los intentos fallidos con una clave revocada o caducada ya no cuentan para un bloqueo, y una clave bloqueada sigue funcionando para quien tiene su secreto real.
  • limit documenta su valor por defecto, 25. La documentación explica ahora qué envía el feed de cambios al borrar un lead, una llamada o una conversación en Totem, y qué responde el cortafuegos fuera de /v1/.
  • SDK de TypeScript 0.1.0-beta.2: acciones y códigos de error tipados, reintentos que respetan el plazo, enums abiertos y compatibilidad con Node.js 22.12.

1.0a: Beta (2026-10-18)

Beta pública. Los administradores de equipos y de la organización que cumplen los requisitos pueden crear integraciones en Ajustes → Desarrolladores, sin invitación.

  • La primera versión de la API: de solo lectura y en beta.
  • Endpoints para la integración y sus equipos, tableros, miembros, servicios reservables, leads (con su atribución, su respuesta y sus actividades), llamadas, conversaciones y citas.
  • El feed de cambios, GET /v1/sync/changes, con eliminaciones y resincronización completa.
  • Claves secretas con rotación, revocación y una lista opcional de IP permitidas, gestionadas en Ajustes → Desarrolladores.
  • Sin webhooks: consulta el feed de cambios cada 1 a 5 minutos.

Versión de la API 1.0a