Eventos de tinkay ai

Lo que hace Tinkay AI: cuándo responde, con qué fuente, cuándo deriva, qué aprende y cuánto consume.

Lo que hace Tinkay AI: cuándo responde, con qué fuente, cuándo deriva, qué aprende y cuánto consume. Son 14 eventos. Todos llegan con la envoltura estándar y su contenido propio en data.

ai.replied

Tinkay AI respondió en una conversación.

Disponible desde 2026-01-15. Volumen alto. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`conversation_id`	string	ID de la conversación
`message_id`	string	Mensaje generado
`source`	string	memory \| model
`confidence`	number	0 a 1
`intent`	string	Intención detectada
`sources`	array	Artículos usados
`tokens`	object	Tokens de entrada y salida
`cost_ars`	number	Costo de la llamada en pesos

ai.replied

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.replied",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "conversation_id": "cv_1832",    "message_id": "msg_8f1c2a",    "source": "memory",    "confidence": 0.93,    "intent": "install_help",    "sources": [      "art_instalar_script"    ],    "tokens": {      "input": 1450,      "output": 220    },    "cost_ars": 7.94  }}

ai.resolved

Tinkay AI resolvió la consulta sin intervención humana.

Disponible desde 2026-01-15. Volumen alto. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`conversation_id`	string	ID de la conversación
`intent`	string	Intención
`turns`	number	Mensajes que tomó
`csat`	string	Calificación si la hubo

ai.resolved

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.resolved",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "conversation_id": "cv_1832",    "intent": "install_help",    "turns": 3,    "csat": "Calificación si la hubo"  }}

ai.handoff

Tinkay AI derivó la conversación a una persona.

Disponible desde 2026-01-15. Volumen alto. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`conversation_id`	string	ID de la conversación
`reason`	string	low_confidence \| sensitive_topic \| vip \| customer_request \| out_of_hours
`confidence`	number	Confianza del último intento
`team_id`	string	Equipo sugerido

ai.handoff

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.handoff",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "conversation_id": "cv_1832",    "reason": "low_confidence",    "confidence": 0.93,    "team_id": "team_soporte"  }}

ai.closed_conversation

Tinkay AI cerró la conversación después de resolverla.

Disponible desde 2026-09-02. Volumen medio. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`conversation_id`	string	ID de la conversación
`reason`	string	resolved \| no_response
`asked_csat`	boolean	Si pidió calificación

ai.closed_conversation

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.closed_conversation",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "conversation_id": "cv_1832",    "reason": "low_confidence",    "asked_csat": true  }}

ai.action_called

Tinkay AI llamó a una acción de tu sistema.

Disponible desde 2026-02-12. Volumen medio. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`conversation_id`	string	ID de la conversación
`action_id`	string	ID de la acción
`request`	object	Parámetros enviados
`response_status`	number	Código HTTP
`duration_ms`	number	Tiempo de respuesta

ai.action_called

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.action_called",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "conversation_id": "cv_1832",    "action_id": "act_subscription",    "request": {      "workspace": "tinkay"    },    "response_status": 200,    "duration_ms": 212  }}

ai.action_failed

Una acción devolvió error o venció el tiempo de espera.

Disponible desde 2026-02-12. Volumen bajo. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`conversation_id`	string	ID de la conversación
`action_id`	string	ID de la acción
`error`	string	Detalle del error
`timed_out`	boolean	true si venció

ai.action_failed

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.action_failed",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "conversation_id": "cv_1832",    "action_id": "act_subscription",    "error": "connect ETIMEDOUT",    "timed_out": false  }}

ai.answer_learned

Se aprobó una respuesta aprendida: desde ahora se responde sin llamar al modelo.

Disponible desde 2026-09-02. Volumen bajo. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`learned_answer_id`	string	ID del objeto
`question`	string	Pregunta canónica
`approved_by`	string	Quién la aprobó
`origin`	string	ai \| manual \| gap

ai.answer_learned

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.answer_learned",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "learned_answer_id": "kb_install",    "question": "¿Dónde pego el script de Tinkay en mi sitio?",    "approved_by": "mem_camila",    "origin": "ai"  }}

ai.answer_served

Se respondió con una respuesta aprendida, sin costo de modelo.

Disponible desde 2026-09-02. Volumen alto.

Campos de data

Campo	Tipo	Descripción
`learned_answer_id`	string	ID del objeto
`conversation_id`	string	ID de la conversación
`match_score`	number	Similitud con la pregunta
`saved_cost_ars`	number	Ahorro estimado en pesos

ai.answer_served

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.answer_served",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "learned_answer_id": "kb_install",    "conversation_id": "cv_1832",    "match_score": 0.91,    "saved_cost_ars": 7.59  }}

ai.answer_outdated

Cambió el artículo de origen y la respuesta aprendida quedó marcada para revisar.

Disponible desde 2026-09-02. Volumen bajo. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`learned_answer_id`	string	ID del objeto
`article_id`	string	Artículo que cambió
`reason`	string	Motivo

ai.answer_outdated

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.answer_outdated",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "learned_answer_id": "kb_install",    "article_id": "art_instalar_script",    "reason": "low_confidence"  }}

ai.training_requested

Alguien pidió aprobación para entrenar a la IA con una respuesta.

Disponible desde 2026-09-02. Volumen bajo. Se puede usar como disparador de automatizaciones. Requiere plan Avanzado.

Campos de data

Campo	Tipo	Descripción
`candidate_id`	string	ID del objeto
`requested_by`	string	Quién lo pidió
`approver_ids`	array	Quiénes pueden aprobarlo

ai.training_requested

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.training_requested",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "candidate_id": "cand_dotnet",    "requested_by": "mem_tomas",    "approver_ids": [      "mem_camila",      "mem_nico"    ]  }}

ai.budget_threshold

El consumo del modelo llegó al umbral configurado.

Disponible desde 2026-09-02. Volumen bajo. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`percent`	number	Porcentaje alcanzado
`spent_ars`	number	Gastado en el período
`budget_ars`	number	Presupuesto

ai.budget_threshold

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.budget_threshold",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "percent": 80,    "spent_ars": 366160,    "budget_ars": 460000  }}

ai.budget_exceeded

Se agotó el presupuesto o el cupo de resoluciones del plan.

Disponible desde 2026-09-02. Volumen bajo. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`spent_ars`	number	Gastado
`budget_ars`	number	Presupuesto
`fallback`	string	memory_only \| handoff \| byo_key
`byo_provider`	string	Proveedor propio si está configurado

ai.budget_exceeded

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.budget_exceeded",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "spent_ars": 366160,    "budget_ars": 460000,    "fallback": "memory_only",    "byo_provider": "openai"  }}

ai.provider_changed

Se cambió el proveedor del modelo, por ejemplo a una API propia.

Disponible desde 2026-09-02. Volumen bajo.

Campos de data

Campo	Tipo	Descripción
`provider`	string	tinkay \| openai \| anthropic \| azure \| google \| custom
`model`	string	Modelo elegido
`changed_by`	string	Quién lo cambió

ai.provider_changed

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.provider_changed",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "provider": "openai",    "model": "gpt-4o-mini",    "changed_by": "mem_camila"  }}

ai.provider_error

El proveedor de IA devolvió error y se aplicó el plan alternativo.

Disponible desde 2026-09-02. Volumen bajo. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`provider`	string	Proveedor
`status`	string	Código HTTP
`fallback_used`	string	memory \| handoff

ai.provider_error

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "ai.provider_error",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "provider": "openai",    "status": "open",    "fallback_used": "memory"  }}