---
title: "Eventos"
description: "El sobre CloudEvents que comparten todos los eventos de Qomni."
version: "es"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.qomni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Eventos

Todo evento es un [CloudEvent 1.0](https://cloudevents.io): el mismo sobre y, dentro de `data`, lo propio de cada evento. `id` es la clave de idempotencia (sale del trabajo, no del azar) y `subject` es el workspace, así que un consumidor puede descartar duplicados y procesar en orden por workspace. Los nombres siguen `ai.qomni.<dominio>.<objeto>.<acción>.v<n>`.

## Sobre

CloudEvents 1.0 as every qomni event uses it (STYLE.md, events). Each event schema is this envelope plus its `type` and its `data`. `id` is the idempotency key, derived from the work; `subject` is the workspace slug, so brokers partition by workspace; `time` is when it happened.

| Campo | Tipo | Detalle |
| --- | --- | --- |
| `specversion` <br /><span class="q-ev-flag q-ev-required">Obligatorio</span> | string | `"1.0"` |
| `id` <br /><span class="q-ev-flag q-ev-required">Obligatorio</span> | string | ≤ 200 |
| `source` <br /><span class="q-ev-flag q-ev-required">Obligatorio</span> | string | Who publishes it, e.g. /cells/co1/agents |
| `type` <br /><span class="q-ev-flag q-ev-required">Obligatorio</span> | string |  |
| `time` <br /><span class="q-ev-flag q-ev-required">Obligatorio</span> | string | `date-time` |
| `datacontenttype` <br /><span class="q-ev-flag q-ev-required">Obligatorio</span> | string | `"application/json"` |
| `subject` <br /><span class="q-ev-flag q-ev-required">Obligatorio</span> | string | The workspace slug. |
| `livemode` <br /><span class="q-ev-flag q-ev-optional">Opcional</span> | boolean | CloudEvents extension: false for test-mode work. |
| `traceparent` <br /><span class="q-ev-flag q-ev-optional">Opcional</span> | string | CloudEvents distributed-tracing extension. |
| `data` <br /><span class="q-ev-flag q-ev-required">Obligatorio</span> | object |  |

## Objetos compartidos

Objetos que varios eventos llevan dentro de `data`.

### `actor`

Who or what acted: an agent, a member, an API key (its ID, never the key) or the system.

| Campo | Tipo | Detalle |
| --- | --- | --- |
| `type` <br /><span class="q-ev-flag q-ev-required">Obligatorio</span> | string | `agent`, `member`, `api_key`, `system` |
| `id` <br /><span class="q-ev-flag q-ev-required">Obligatorio</span> | string |  |
| `on_behalf_of` <br /><span class="q-ev-flag q-ev-optional">Opcional</span> | string | The member an API key or an approved agent action acts for. |

### `subject`

| Campo | Tipo | Detalle |
| --- | --- | --- |
| `type` <br /><span class="q-ev-flag q-ev-required">Obligatorio</span> | string | `agent`, `conversation`, `call`, `phone_number` |
| `id` <br /><span class="q-ev-flag q-ev-required">Obligatorio</span> | string |  |

Source: https://docs.qomni.ai/es/events/index.mdx
