El servidor de llamadas y el servicio de IA envían sus datos a esta API. Cada servicio usa su propia clave.
| Nombre | Clave | Último uso | Estado | |
|---|---|---|---|---|
| nuevio | tkz_7df54453… | 18 oct 2026, 11:33 a.m. | Activa | |
| nuevio | tkz_414894e8… | 18 oct 2026, 1:25 p.m. | Activa | |
| alejito | tkz_91009685… | 29 oct 2026, 6:50 p.m. | Activa | |
| Pruebas (borrar) | cen_5fa36809… | 17 oct 2026, 8:50 p.m. | Revocada |
curl -X POST https://web-repo-xi.vercel.app/api/v1/incidents \
-H "Authorization: Bearer $TISKZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"external_id":"llamada-8841","org_id":"org_uav","title":"Llamada entrante","channel":"llamada"}'curl -X POST https://web-repo-xi.vercel.app/api/v1/incidents/{id}/signals \
-H "Authorization: Bearer $TISKZ_API_KEY" -H "Content-Type: application/json" \
-d '[{"type":"suplantacion","explanation":"Se presenta como familiar sin forma de verificarlo.","confidence":0.8}]'
curl -X POST https://web-repo-xi.vercel.app/api/v1/incidents/{id}/entities \
-H "Authorization: Bearer $TISKZ_API_KEY" -H "Content-Type: application/json" \
-d '[{"kind":"telefono","value":"55 2841 7730","provenance":"mostrado"}]'curl -X PATCH https://web-repo-xi.vercel.app/api/v1/incidents/{id} \
-H "Authorization: Bearer $TISKZ_API_KEY" -H "Content-Type: application/json" \
-d '{"status":"finalizado","ended_at":"2026-10-17T19:05:00Z","risk_score":82,"summary":"Posible suplantación con solicitud de dinero."}'Cada envío actualiza el panel en vivo y recalcula los vínculos del incidente. Los POST aceptan un objeto o un arreglo de hasta 500 elementos.
Authorization: Bearer tkz_… o X-API-Key: tkz_…{ "error": { "code", "message", "details" } } con 401, 404, 409 o 422./organizationsOrganizaciones que reciben casos en el panel.
/usersPersonas que tuvieron la conversación (rol «usuario») y analistas del panel.
/incidentsConversaciones analizadas. Solo aparecen en el panel de la organización indicada en org_id (null = no compartido).
/signalsSeñales inferidas por la IA, con su explicación (sin citas de la conversación: el panel no guarda transcripciones). Tipos conocidos: urgencia, dinero, datos_sensibles, secreto, amenaza, suplantacion, aislamiento (se aceptan otros).
/incidents/{id}/signals/entitiesDatos puntuales para Perú: telefono, cuenta, cci, billetera, monto y otros. normalized se recalcula en el servidor; cuentas requieren analysis_meta.bank para comparar y billeteras analysis_meta.wallet. Un dato repetido en el mismo incidente se ignora. Se conserva el original y su procedencia.
/incidents/{id}/entities/voice-samplesEmbeddings de voz (dato biométrico sensible). Se usan para proponer vínculos por similitud; la API nunca los devuelve.
/incidents/{id}/voice-samples/voice-profilesAgrupaciones vocales revisables con código estable; no acreditan identidad personal.
/suspectsAlias que un analista da a casos que cree obra del mismo estafador. Sirve para llevar registro: no identifica a una persona. Los casos se asocian con PATCH /incidents/{id} { suspect_id }.
/actionsBitácora del incidente: captura iniciada, alerta mostrada, permiso otorgado, etc.
/incidents/{id}/actions/notesCorrecciones, observaciones y conclusiones revisadas del incidente.
/incidents/{id}/notes/linksPosibles relaciones entre dos incidentes. El panel también los calcula solo (voz, datos repetidos y patrón de señales). Filtra por incident_id para ver los de un caso.