Las palabras que usa esta documentación, en un solo lugar. Cada entrada enlaza con la página que la explica por completo.
Cuenta
Integración. La conexión con la API de Totem que un administrador crea en Ajustes → Desarrolladores: un nombre y los equipos que lee, con descripción y lista de IP permitidas opcionales. La interfaz lo llama Crear clave API. Su identificador empieza por prn_, y GET /v1/me la describe. Consulta Autenticación.
Clave. El secreto, que empieza por tsk_live_, que tu servidor envía en la cabecera Authorization. Pertenece a una integración. Totem la muestra una sola vez; puedes rotarla o revocarla en cualquier momento. Consulta Autenticación.
Equipo. Un espacio de trabajo de Totem, con sus propios tableros, miembros, leads, llamadas, conversaciones y citas. Su identificador empieza por team_. Una clave lee uno o varios equipos, y si lee varios, las peticiones sobre las colecciones de un equipo lo indican en la cabecera Totem-Team. Consulta Autenticación.
Organización. Una cuenta de facturación y sus subequipos. Una integración puede cubrir varios equipos, siempre que pertenezcan a la misma organización. En Ajustes → Desarrolladores, una integración que cubre varios de sus equipos tiene el ámbito del acceso Equipos elegidos de la familia, y nombres de la API como family_transfer o family_origin se refieren a ella. Consulta Autenticación.
Administrador de la familia. Un administrador de la cuenta de facturación de una organización que figura en ella como administrador de la familia. Solo un administrador de la familia puede crear o modificar una integración que cubra varios equipos. Consulta Autenticación.
Miembro. Una persona de un equipo, identificada solo por su nombre visible. Los identificadores de miembro empiezan por mem_ y son de un solo equipo: la misma persona tiene un identificador distinto en cada equipo. Consulta GET /v1/members.
Registros del CRM
Tablero. Un embudo que un equipo usa para organizar sus leads, con sus etapas en orden. Los identificadores de tablero empiezan por brd_. Consulta GET /v1/boards.
Etapa. Un paso de un tablero, como «Contactado». Los identificadores de etapa empiezan por stg_. El stage de un lead indica el paso en el que está, y las etapas viajan dentro de su tablero. Consulta GET /v1/boards.
Lead. Una persona o empresa con la que trabaja un equipo, con su posición en el embudo, su origen y sus permisos de contacto. Los identificadores de lead empiezan por lead_. Consulta la referencia de leads.
Cliente. Un registro de los endpoints de leads con record_kind: "client". No tiene estado del embudo, así que su status es null. Consulta GET /v1/leads.
Actividad. Un cambio de etapa, de estado o de responsables de un lead. Una actividad no cambia una vez escrita. Los identificadores de actividad empiezan por act_. Consulta GET /v1/leads/{id}/activities.
Faceta. Una parte de un lead que la API entrega como un objeto propio, con el identificador del lead y su propia versión. Un lead tiene dos: su atribución, de dónde vino, y su respuesta, cómo le ha respondido el equipo en sus conversaciones y llamadas. Un mensaje nuevo cambia la respuesta, no el lead. Consulta GET /v1/leads/{id}.
Llamada. Los metadatos de una llamada telefónica con un lead, como su dirección, su duración y su resultado. Nunca una grabación ni una transcripción. Los identificadores de llamada empiezan por call_. Consulta la referencia de llamadas.
Conversación. Los metadatos de una conversación con un lead en un canal, como su estado y cuándo llegaron y salieron los últimos mensajes, sin los mensajes en sí. Los identificadores de conversación empiezan por conv_. Consulta la referencia de conversaciones.
Cita. Una cita en el calendario del equipo: reservada para un servicio reservable, un evento del calendario conectado o una importación de un sistema de citas externo. En la API se llama booking, y su identificador empieza por bkg_. Consulta la referencia de citas.
Servicio reservable. Algo que se puede reservar con el equipo, como una primera consulta, en línea, en persona o por teléfono. Su identificador empieza por svc_. Consulta GET /v1/booking_services.
Sincronización
Feed de cambios. GET /v1/sync/changes: todos los cambios de los registros de un equipo, en orden, página a página. Cada elemento es un registro de un kind o una eliminación. Consulta Sincroniza una copia.
Cursor. Una cadena opaca que marca tu posición en una lista o en el feed de cambios. Guárdalo tal como lo recibiste, y no lo construyas ni lo modifiques nunca. Un cursor del feed de cambios es de un solo equipo, y deja de funcionar 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 esta empezara. Consulta Listas y paginación y Guarda el cursor.
Versión. Un entero que lleva cada registro que entrega el feed de cambios y que crece cada vez que el registro cambia. Aplica un elemento solo si su versión es mayor que la que tienes. Consulta Convenciones.
Carga inicial. La primera pasada por el feed de cambios, sin cursor. Entrega todos los registros del equipo y después se pone al día con los cambios hechos mientras tanto. Consulta Haz la carga inicial.
Resincronización completa. Una nueva carga inicial que reconstruye tu copia de un equipo, después de 410 sync_cursor_expired o 409 resync_required. Funciona marcando y barriendo: olvida las versiones que guardaste, marca cada registro que entrega el feed y, cuando se haya puesto al día, borra todos los registros de ese equipo que no marcaste. Consulta Resincronización completa.
Eliminación. Un elemento del feed de cambios con removed en lugar de object. Borra tu copia de ese registro en todos los sitios a los que lo copiaste. Su reason indica el motivo: erased si el registro se suprimió, deleted si desapareció de Totem de cualquier otra forma. Consulta Eliminaciones.
Borrado. Una eliminación con reason: "deleted": el registro desapareció de Totem sin suprimirse. Consulta Eliminaciones.
Supresión. Una eliminación con reason: "erased": el registro se suprimió por motivos de privacidad, por ejemplo porque la persona ejerció su derecho de supresión (artículo 17 del RGPD), o porque alguien eliminó definitivamente en Totem un lead, una llamada o una conversación, lo que siempre los suprime. Consulta ¿Cómo respeto las solicitudes de supresión? en las preguntas frecuentes.
Marca de eliminación. Lo que conservas después de aplicar una eliminación: el kind, el id y la version del registro, sin sus datos. En inglés se llama tombstone. Impide que una copia más antigua del registro, entregada de nuevo más tarde, lo haga reaparecer. Consulta Aplica una página.
Fusión. Dos leads de la misma persona combinados en uno. El lead fusionado no se elimina: queda como un lead archivado cuyo merged_into indica el lead que continúa. Consulta Fusiones.
Traspaso. Un lead que pasa a otro equipo de la misma organización. El original queda como un lead archivado cuyo transferred_to indica el team de destino y, cuando Totem puede indicarlo, el lead de destino. El equipo de destino puede ser uno que tu clave no lee. Consulta Traspasos.
Límites y errores
Límite de frecuencia. La velocidad a la que puede leer una clave: hasta 2.000 elementos por minuto, con ráfagas de hasta 10.000. Al superarlo, la API responde 429 rate_limited con Retry-After. Consulta Límite de frecuencia.
Cuota diaria. Cuántos elementos puede leer una clave en un día UTC del feed de cambios y de todas las listas, incluidos los equipos, los miembros, los servicios reservables y las actividades de un lead: 250.000 elementos, o 3 veces el número de registros de sus equipos si es mayor. Las consultas de un solo registro, la búsqueda y GET /v1/me no cuentan. Al superarla, esos endpoints responden 429 quota_exceeded hasta las 00:00 UTC. Consulta Cuota diaria.
livemode. Un campo de todo recurso. Es true en todo lo que devuelve la API, y false en los datos de ejemplo de esta documentación y del archivo fixtures.json del kit. Consulta Convenciones.
Identificador de petición. La cabecera Totem-Request-Id de cada respuesta que envía la propia API, que el cuerpo de un error repite en request_id. Cítalo cuando pidas ayuda. Consulta Soporte.
Código de error. El code del cuerpo de un error, como team_required. Decide según él, y búscalo en la página de Errores.