> For the complete documentation index, see [llms.txt](https://boundaryai.gitbook.io/boundaryai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://boundaryai.gitbook.io/boundaryai-docs/boundaryai-docs-es/api-y-webhooks/concepts-and-naming.md).

# Conceptos y nomenclatura

Cómo los sustantivos de la API se corresponden con lo que ve en el producto.

La API habla el mismo modelo que el producto. Cuatro sustantivos cubren casi todo:

| Sustantivo de la API (recomendado) | En el producto                                                                                 | Qué es                                                                            |
| ---------------------------------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `grupo_de_feedback`                | [Grupo de feedback](/boundaryai-docs/boundaryai-docs-es/grupos-de-feedback/feedback-groups.md) | El contenedor del proyecto. Todo lo relacionado con un programa vive en un grupo. |
| `fuente`                           | Una fuente dentro de un grupo                                                                  | Un flujo de comentarios: una encuesta, una carga, un conector o tu envío por API. |
| `campo`                            | Una pregunta / columna                                                                         | Un campo tipado en una fuente: texto libre, NPS, una escala, metadatos.           |
| elemento (en `content`)            | Una respuesta / comentario                                                                     | Un fragmento de comentarios enviado a un campo.                                   |

Dos conceptos del producto que encontrarás en las respuestas:

* **Monitores** ([Supervisión personalizada](/boundaryai-docs/boundaryai-docs-es/analizando-sus-comentarios/custom-monitoring.md)) aparecen en las lecturas de análisis bajo la `banderas` clave, y el evento webhook relacionado es `flag.raised`. Esos son los *nombres de cableado heredados* de lo que el producto ahora llama monitores; los payloads son estables, así que los suscriptores existentes no se rompen.
* **Análisis** es asíncrono. El envío devuelve inmediatamente; los temas, el sentimiento y las coincidencias de monitores aparecen cuando se completa la pasada de análisis (suscríbete a `analysis.completed` en lugar de hacer sondeo). Para una fuente en un grupo que [hace seguimiento de los comentarios a lo largo del tiempo](/boundaryai-docs/boundaryai-docs-es/analizando-sus-comentarios/tracking-feedback-over-time-evolution.md), la lectura de análisis agrega cada período analizado y devuelve `analysis_id: null`, porque no existe una única ejecución de todo el tiempo que nombrar; usa como clave `analysis_status` ("available" o "none"), nunca en `analysis_id`.

***

### ¿Ya está integrado con el vocabulario anterior?

Las integraciones construidas cuando la API hablaba `survey_series` / `survey` / `pregunta` siguen funcionando sin cambios: esas rutas (`/survey_series/create`, `/survey/create`, `/content/push`, y otras) usan los mismos manejadores que las rutas documentadas aquí, están completamente soportadas y están cubiertas por la [política de compatibilidad](/boundaryai-docs/boundaryai-docs-es/api-y-webhooks/changelog.md). Las mantenemos fuera de la referencia principal para que exista exactamente una forma documentada de hacer cada cosa; se enumeran bajo **Vocabulario clásico (alias)**. La correspondencia, por si lees código antiguo: `survey_series` = grupo de feedback, `survey` = fuente, `pregunta` = campo.

***

### Tipos de campo

Al crear una fuente, cada campo toma un `field_type`:

| Tipo          | Usar para                                                                          |
| ------------- | ---------------------------------------------------------------------------------- |
| `DEPTH_TEXT`  | Texto libre largo: el campo que la IA analiza para temas, sentimiento y monitores. |
| `TEXT`        | Texto libre corto: nombres, frases breves.                                         |
| `NPS`         | La puntuación de probabilidad de recomendar de 0 a 10.                             |
| `RATING`      | Una escala numérica con tus propios límites (`min_value` / `max_value`).           |
| `SCQ` / `MCQ` | Opción única / múltiple (`field_options`).                                         |
| `DROPDOWN`    | Opción única presentada como una lista desplegable (`field_options`).              |
| `RANKING`     | Los encuestados ordenan el `field_options`.                                        |
| `METADATA`    | Contexto para segmentación (región, nivel, agente); importado pero no analizado.   |

Los nombres no distinguen mayúsculas y minúsculas, y `long_answer` / `short_answer` se aceptan como sinónimos de `DEPTH_TEXT` / `TEXT`. Una fuente admite hasta 100 campos por llamada de creación.

La señal analítica más rica proviene de las `DEPTH_TEXT` campos; `METADATA` los campos impulsan la segmentación en las vistas de análisis, exactamente igual que con [cargas](/boundaryai-docs/boundaryai-docs-es/incorporacion-de-sus-comentarios/uploading-an-existing-dataset.md).

***

### `feedback_type`: dile a la plataforma qué son los datos

Las fuentes aceptan opcionalmente un `feedback_type` (`survey`, `call_transcript`, `app_review`, `support_ticket`, `chat`, `correo electrónico`, `social_media`, `review`, `otro`; predeterminado `survey`). Se refleja en los listados y ayuda a la plataforma a encuadrar los datos correctamente. Elige el más cercano en lugar de poner todo por defecto a `otro`.