snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s

This commit is contained in:
upstream-mirror
2026-09-17 23:28:13 +05:00
commit e7da97194a
32688 changed files with 4208681 additions and 0 deletions

View File

@@ -0,0 +1,34 @@
---
title: IA
description: Cómo Twenty utiliza la IA para mejorar tu experiencia de CRM.
icon: robot
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
Twenty integra la IA directamente en tu CRM, no como un truco publicitario, sino como una herramienta que funciona dentro de tu modelo de datos y sistema de permisos.
## Chatbot de IA
Haz preguntas sobre tus datos en lenguaje natural. El chatbot de IA puede consultar tus registros de CRM, resumir información y ayudarte a encontrar lo que buscas sin crear filtros complejos.
<VimeoEmbed videoId="1185511734" title="Chatbot de IA" />
## Agentes de IA
Los agentes de IA van más allá del chat: pueden ejecutar tareas de varios pasos de forma autónoma:
* Enriquecer registros con datos de fuentes externas
* Redactar y enviar correos electrónicos de seguimiento
* Analizar la salud del pipeline y marcar las oportunidades en riesgo
* Procesar datos entrantes y dirigirlos al equipo adecuado
Los agentes funcionan dentro de tus flujos de trabajo existentes, por lo que puedes combinar la IA con aprobaciones manuales, lógica condicional y llamadas a API externas.
## Permisos y seguridad
La IA en Twenty respeta tu modelo de permisos. Los agentes solo pueden acceder a objetos y campos que el usuario (o el rol) tiene permiso para ver. Los datos sensibles permanecen protegidos incluso cuando interviene la IA.
<Card title="Guía completa de IA" icon="arrow-right" href="/l/es/user-guide/ai/overview">
Referencia detallada sobre el chatbot, los agentes y los controles de permisos.
</Card>

View File

@@ -0,0 +1,41 @@
---
title: Aplicaciones
icon: cube
description: "Amplía Twenty con código: objetos personalizados, lógica del lado del servidor, componentes de IU y agentes de IA, todo como paquetes de TypeScript."
---
La mayoría de los CRM te dan un panel de configuración. Twenty te da una plataforma. Las aplicaciones son la forma en que los desarrolladores amplían Twenty más allá de lo que ofrece la IU: definen modelos de datos, lógica del lado del servidor, componentes de IU y capacidades de IA como código, y luego los implementan en uno o más espacios de trabajo.
## Por qué existen las aplicaciones
Los flujos de trabajo cubren la automatización sin código. Pero algunas cosas necesitan código: un motor de precios personalizado, una canalización de enriquecimiento propietaria, una verificación de cumplimiento que se ejecute en cada actualización de registro, un panel de IU personalizado que obtenga datos de una herramienta interna.
Las aplicaciones te permiten crear estos como extensiones de primera clase: no son scripts frágiles que se comunican con una API desde fuera, sino código que se ejecuta en la plataforma con acceso completo al sistema de tipos, el modelo de permisos y la IU.
## Lo que una aplicación puede definir
Una aplicación es un paquete de TypeScript que declara **entidades** usando `twenty-sdk`:
| Entidad | Qué hace |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Objetos y campos** | Nuevas tablas de datos y campos en objetos existentes, con el mismo tratamiento que los integrados. |
| **Funciones de lógica** | Funciones de TypeScript del lado del servidor activadas por rutas HTTP, programaciones de cron o eventos de base de datos |
| **Componentes de frontend** | Componentes de React aislados (sandboxed) que se renderizan dentro de la interfaz de Twenty (panel lateral, widgets, menú de comandos) |
| **Habilidades y agentes** | Capacidades de IA — instrucciones reutilizables y asistentes autónomos |
| **Vistas y navegación** | Vistas de lista preconfiguradas y elementos del menú lateral |
Todo se detecta mediante análisis de AST en tiempo de compilación; sin archivos de configuración ni código repetitivo de registro. Coloca un `export default defineObject(...)` en cualquier archivo `.ts` y el SDK lo detecta.
## Cómo se ejecutan
* **Las funciones de lógica** se ejecutan en procesos de Node.js aislados, en entornos sandbox separados del host. Acceden a los datos a través de un cliente de API tipado, limitado al ámbito de los permisos de rol de la app.
* **Los componentes de frontend** se ejecutan en Web Workers usando Remote DOM — aislados de la página principal pero renderizando elementos DOM nativos (no iframes).
* **Los permisos** se aplican a nivel de API. Una app solo ve lo que su rol permite.
## La experiencia del desarrollador
Escribes tu app como un proyecto de TypeScript en tu máquina. La CLI observa tus archivos fuente y los sincroniza en tiempo real con un servidor de Twenty en ejecución: edita un archivo y ve el cambio en la interfaz en cuestión de un segundo. El cliente de API tipado se regenera automáticamente cuando cambia el esquema. Cuando estés listo, `yarn twenty app:publish --private` envía la app a un servidor de producción, o `yarn twenty app:publish` publica tu app en npm y en el marketplace de Twenty.
<Card title="Crea tu primera app" icon="arrow-right" href="/l/es/developers/extend/apps/getting-started/quick-start">
Recorrido guiado en tres fases: generar el andamiaje, ejecutar un servidor local y sincronizar tus cambios.
</Card>

View File

@@ -0,0 +1,46 @@
---
title: Calendario y correo electrónico
description: Sincroniza tu correo electrónico y calendario con Twenty.
icon: envelope
---
Twenty se conecta con tus herramientas existentes para que tu CRM se mantenga actualizado sin necesidad de introducir datos manualmente.
## Sincronización del correo electrónico
Conecta tu buzón de **Google Workspace** o **Microsoft 365**. Una vez conectado:
* Los correos electrónicos se vinculan automáticamente a los registros de Empresa y Personas correspondientes
* Los hilos de correo electrónico completos son visibles en la cronología de cada registro
* Puedes enviar correos electrónicos directamente desde Twenty
* Se admiten múltiples buzones por usuario
Tú controlas lo que se importa: filtra por rango de fechas o remitente para evitar incorporar correos electrónicos irrelevantes.
## Sincronización del calendario
Los eventos del calendario se sincronizan automáticamente desde tu cuenta conectada. Los eventos aparecen en los registros pertinentes del CRM, lo que te ofrece una visión completa de tus interacciones con cada contacto o empresa.
## Integraciones
Más allá del correo electrónico y el calendario, Twenty se conecta a herramientas externas mediante:
| Método | Caso de uso |
| -------------------------------------- | ------------------------------------------------------------------------------------ |
| **API** | Crea integraciones personalizadas con la API GraphQL o REST |
| **Webhooks** | Envía notificaciones en tiempo real a sistemas externos cuando cambian los registros |
| **Zapier** | Conéctate a más de 5.000 aplicaciones sin código |
| **Acciones HTTP de flujos de trabajo** | Llama a cualquier API externa como parte de un flujo de trabajo automatizado |
## Aplicaciones personalizadas
Los desarrolladores pueden crear aplicaciones completas sobre Twenty, añadiendo interfaz de usuario personalizada, lógica del lado del servidor e integraciones profundas. Las aplicaciones pueden publicarse para la comunidad o mantenerse privadas.
<CardGroup cols={2}>
<Card title="Guía de calendario y correo electrónico" icon="envelope" href="/l/es/user-guide/calendar-emails/overview">
Configura la sincronización del correo electrónico, la sincronización del calendario y soluciona problemas.
</Card>
<Card title="API y extensiones" icon="plug" href="/l/es/developers/extend/api">
Crea integraciones personalizadas con la API de Twenty.
</Card>
</CardGroup>

View File

@@ -0,0 +1,37 @@
---
title: Tableros
description: Supervisa el rendimiento y visualiza tus datos de CRM con tableros personalizados.
icon: chart-bar
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
Los tableros te ofrecen visibilidad en tiempo real de los indicadores de tu negocio: estado del pipeline, rendimiento del equipo, tendencias de ingresos y cualquier otra cosa que quieras supervisar.
<VimeoEmbed videoId="1185511768" title="Tablero" />
## Widgets
Cada tablero está compuesto por widgets. Un widget es un solo gráfico o indicador vinculado a tus datos de CRM. Puedes configurar:
* **Tipo de gráfico** — Barras, líneas, pastel, número y más
* **Origen de datos** — Cualquier objeto en tu modelo de datos (estándar o personalizado)
* **Filtros** — Restringe a registros específicos, rangos de fechas o segmentos
* **Agregación** — Recuento, suma, promedio, mínimo, máximo en cualquier campo numérico
* **Agrupación** — Desglosa por campos seleccionados, fechas o relaciones
## Lo que puedes supervisar
* Valor del pipeline por etapa
* Negocios cerrados a lo largo del tiempo
* Importe medio de los negocios por fuente
* Tasas de finalización de tareas
* Métricas personalizadas en cualquier objeto
## Uso compartido
Los tableros son a nivel de espacio de trabajo: todos los miembros de tu equipo pueden verlos. Organiza los widgets en una cuadrícula y cambia su tamaño para crear la vista que mejor funcione para tu equipo.
<Card title="Guía completa de tableros" icon="arrow-right" href="/l/es/user-guide/dashboards/overview">
Referencia detallada sobre la creación de tableros, la configuración de widgets y los ajustes de gráficos.
</Card>

View File

@@ -0,0 +1,47 @@
---
title: Modelo de datos
description: Comprende cómo Twenty estructura tus datos con objetos, campos y relaciones.
icon: database
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
Todo en Twenty se basa en **objetos** y **campos**, los componentes básicos de tu modelo de datos.
## Objetos
Los objetos son las tablas que contienen tus datos. Twenty incluye objetos estándar de forma predeterminada:
* **Empresas** — Organizaciones con las que haces negocios
* **Personas** — Contactos individuales
* **Oportunidades** — Acuerdos en tu flujo de ventas
* **Tareas** — Acciones para tu equipo
* **Notas** — Texto de formato libre vinculado a registros
También puedes crear **objetos personalizados** para todo lo que tu negocio necesite: proyectos, tickets de soporte, productos, contratos o cualquier otra cosa.
## Campos
Los campos son las propiedades de cada objeto. Twenty admite una amplia variedad de tipos de campo:
| Categoría | Tipos |
| ------------- | ----------------------------------------------------------------------------------------------------------- |
| **Básico** | Texto, Número, Booleano, Fecha, Moneda, Valoración, Selección |
| **Compuesto** | Dirección (calle, ciudad, estado, código postal), Nombre completo, Enlaces, Teléfonos, Correos electrónicos |
| **Especial** | Relación, Archivo adjunto, JSON, Autor (quién creó/modificó) |
Cada objeto también obtiene campos de sistema automáticos: `id`, `createdAt`, `updatedAt`, `createdBy` y `position`.
## Relaciones
Los objetos se conectan entre sí mediante relaciones. Una empresa tiene muchas personas; una oportunidad pertenece a una empresa, y así sucesivamente. Puedes crear relaciones personalizadas entre cualquier objeto, incluidas relaciones de muchos a muchos.
## Por qué esto es tan potente
A diferencia de los CRM tradicionales, donde estás limitado a campos predefinidos en objetos predefinidos, Twenty te permite modelar tus datos exactamente de la misma manera en que funciona tu negocio. Los objetos personalizados reciben el mismo tratamiento de primera clase que los incorporados, incluidos los endpoints de API, las vistas, los permisos y los disparadores de flujos de trabajo.
<Card title="Análisis en profundidad del modelo de datos" icon="arrow-right" href="/l/es/user-guide/data-model/overview">
Referencia completa sobre objetos, campos, relaciones y cómo configurarlos.
</Card>
<VimeoEmbed videoId="1185511827" title="Modelo de datos" />

View File

@@ -0,0 +1,105 @@
---
title: Glosario
icon: book
description: Términos clave utilizados en Twenty.
---
## API
La API (Interfaz de Programación de Aplicaciones) permite conectar Twenty con otros sistemas de software y construir integraciones personalizadas.
## Aplicaciones
Las aplicaciones son extensiones personalizadas desarrolladas mediante código que pueden definir modelos de datos y funciones de lógica. Permiten que los desarrolladores creen personalizaciones reutilizables que pueden desplegarse en varios espacios de trabajo.
## Acciones de código
Las Acciones de código son pasos de flujo de trabajo que te permiten escribir JavaScript personalizado para transformar datos, realizar cálculos o ejecutar lógica compleja que no es posible con las acciones integradas.
## Menú de Comandos
El Menú de Comandos es una interfaz de acceso rápido (se abre con `Cmd + K` en Mac y `Ctrl + K` en Windows) que te permite realizar acciones, crear registros y navegar por tu espacio de trabajo de manera eficiente.
## Empresa y Personas
El CRM tiene dos tipos fundamentales de registros:
* Una `Empresa` representa un negocio u organización.
* `Personas` representan los clientes o prospectos actuales de tu empresa.
## Campos Personalizados
Los Campos Personalizados son campos de datos que creas para capturar información específica según las necesidades y procesos de tu negocio.
## Modelo de datos
Un Modelo de Datos es la estructura que define cómo se organiza la información en tu CRM, incluyendo qué objetos existen, sus propiedades (campos) y cómo se relacionan entre ellos.
## Favoritos
Los Favoritos son registros que has marcado para acceso rápido, apareciendo en tu barra lateral para una navegación instantánea a datos importantes.
## Campo
Un campo se refiere a un área específica donde se almacenan datos particulares de una entidad.
## Iterador
Un Iterador es una acción de flujo de trabajo que itera sobre un array de elementos, ejecutando acciones posteriores para cada elemento de la lista.
## Kanban
Un `Kanban` es una manera visual de rastrear los procesos de tu negocio utilizando tarjetas y columnas. Cada columna representa una etapa en tu proceso (por ejemplo: nuevo, en curso, ganado, perdido), y se mueven los registros a través de estas etapas a medida que progresan.
## Objeto
Un Objeto es una estructura de datos que representa un tipo específico de entidad en tu CRM (como Personas, Empresas u Oportunidades). Los Objetos pueden ser estándar (integrados) o personalizados (creados por ti).
## Oportunidades
Las Oportunidades en el CRM de Twenty son posibles tratos o ventas con cuentas o contactos.
## Registro
Un Registro indica una instancia de un objeto, como una cuenta o contacto específico.
## Campos de Relación
Los Campos de Relación crean conexiones entre diferentes objetos, permitiendo vincular registros (como conectar una Persona a una Empresa).
## Campos Estándar
Los Campos Estándar son campos de datos preconstruidos que vienen con los objetos por defecto y proporcionan funcionalidad común en todos los espacios de trabajo.
## Tareas
Las Tareas en el CRM de Twenty son actividades asignadas relacionadas con contactos, cuentas u oportunidades.
## Disparadores
Los disparadores son el punto de inicio de un flujo de trabajo — el evento o la condición que inicia la automatización. Entre los ejemplos se incluyen la creación de registros, las actualizaciones de registros, los webhooks o horarios programados.
## Vistas
Puedes personalizar la visualización de tus registros usando vistas, configurando diferentes filtros, diseños y opciones de clasificación para cada vista.
## Upsert
Upsert es una operación que combina "update" y "insert" — actualiza un registro existente si se encuentra una coincidencia, o crea un registro nuevo si no existe ninguna.
## Webhooks
Los Webhooks son mensajes automatizados que se envían desde Twenty a otras aplicaciones cuando ocurren eventos específicos, habilitando la sincronización de datos en tiempo real.
## Flujos de trabajo
Los Flujos de Trabajo son procesos automatizados que desencadenan acciones basadas en condiciones específicas, ayudándote a automatizar tareas repetitivas y procesos empresariales.
## Espacio de trabajo
Un `Espacio de Trabajo` típicamente representa una empresa que usa Twenty. Contiene todos los registros y datos que tú y los miembros de tu equipo añaden a Twenty.
Tiene un único nombre de dominio, que generalmente es el nombre de dominio que tu empresa utiliza para las direcciones de correo electrónico de los empleados.
## Miembros del espacio de trabajo
Los Miembros del Espacio de Trabajo son los usuarios de Twenty de tu equipo que tienen acceso a tu espacio de trabajo. Pueden asignarse como propietarios o responsables de registros.

View File

@@ -0,0 +1,74 @@
---
title: Diseño
description: Cómo navegar, explorar y visualizar registros en Twenty.
icon: table-columns
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## El diseño principal
El centro de la pantalla es donde viven tus registros: personas, empresas, oportunidades, tareas, notas, paneles de control, flujos de trabajo y cualquier objeto personalizado. Aquí puedes ver, editar y eliminar registros, y crear nuevas vistas.
<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
## Barra de navegación
La barra lateral izquierda te ofrece:
* **Selector de espacios de trabajo** — cambia entre espacios de trabajo o crea uno nuevo (desplegable superior)
* **Búsqueda** — presiona `/` para enfocarla al instante; busca en todos los objetos
* **Ajustes** — accede desde la parte superior izquierda
* **Favoritos** — vistas fijadas, únicas por usuario
* **Accesos directos a objetos** — acceso rápido a Personas, Empresas, Oportunidades, etc.
* **Flujos de trabajo** — crea automatizaciones
Arrastra elementos para reordenarlos, crea carpetas para agrupar objetos relacionados y oculta lo que no uses.
<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
## Menú de Comandos
Pulsa `Cmd+K` (Mac) o `Ctrl+K` (Windows), o haz clic en los tres puntos de la esquina superior derecha. Desde aquí puedes:
* Crea nuevos registros
* Importa y exporta datos en formato CSV
* Crea nuevas vistas
* Accede a los registros eliminados (Twenty admite eliminaciones lógicas y definitivas)
* Consulta los atajos de teclado para navegar por tu espacio de trabajo
<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}} />
## Buscar
Accesible mediante el Menú de Comandos, en la parte superior de la barra de navegación o presionando `/`. La búsqueda funciona en todos los objetos.
<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />
## Panel lateral
Haz clic en un registro para abrir el panel lateral a la derecha: una vista rápida de la información clave del registro sin salir de la página actual. Haz clic en **Abrir** para ir a la página completa del registro.
<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
## Vistas
Cada objeto admite varias vistas, sin límite por objeto. Usa el menú desplegable de la parte superior izquierda para cambiar entre ellas.
* **Tabla** — filas y columnas al estilo de una hoja de cálculo, con agrupación, edición en línea y personalización de columnas
* **Kanban** — tarjetas de arrastrar y soltar organizadas por un campo de selección, ideal para pipelines
* **Calendario** — registros colocados según un campo de fecha para la planificación basada en el tiempo
Cada vista guarda sus propios filtros, ordenación y visibilidad de campos. Comparte vistas con tu espacio de trabajo o mantenlas privadas. Marca vistas como favoritas para un acceso rápido desde la barra lateral.
<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
## Páginas de registro
Cuando abres un registro, la página de detalles se compone de **pestañas** y **widgets** configurables. Añade, elimina, reordena y cambia el tamaño de los widgets en una cuadrícula: campos, registros relacionados, correos electrónicos, cronología, tareas, notas, archivos, gráficos, iframes y más. Cada tipo de objeto tiene su propio diseño.
<Card title="Guía completa del diseño" icon="arrow-right" href="/l/es/user-guide/layout/overview">
Navegación, vistas, páginas de registros: referencia detallada y guías prácticas.
</Card>
<VimeoEmbed videoId="1185511790" title="Diseño" />

View File

@@ -0,0 +1,55 @@
---
title: Flujos de trabajo
description: Automatiza tus procesos empresariales con el creador visual de flujos de trabajo de Twenty.
icon: bolt
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
Los flujos de trabajo te permiten automatizar tareas repetitivas y conectar Twenty con herramientas externas, sin escribir código (aunque puedes hacerlo si quieres).
<VimeoEmbed videoId="1185511711" title="Flujo de trabajo" />
## Cómo funcionan los flujos de trabajo
Cada flujo de trabajo tiene tres partes:
1. **Disparador** — Lo que inicia el flujo de trabajo
2. **Pasos** — Lo que ocurre a continuación (una o más acciones en secuencia)
3. **Variables** — Datos que fluyen entre los pasos
## Disparadores
| Disparador | Cuándo se activa |
| ---------------------- | ------------------------------------------------------------------------------------------------- |
| **Evento de registro** | Se crea, actualiza, elimina o se realiza un upsert en un registro |
| **Manual** | Un usuario hace clic en un botón (en un único registro, en múltiples registros o de forma global) |
| **Programación** | En un intervalo recurrente (sintaxis cron) |
| **Webhook** | Un sistema externo envía un HTTP POST |
## Acciones
Los flujos de trabajo pueden encadenar cualquier combinación de:
* **Operaciones de registro** — Crear, actualizar, buscar, eliminar o realizar un upsert en registros
* **Enviar correo electrónico** — Enviar o redactar correos electrónicos desde cuentas conectadas
* **Solicitud HTTP** — Llamar a cualquier API externa
* **Código** — Ejecutar JavaScript personalizado para lógica compleja
* **Ramificaciones** — Condiciones if/else para dividir la ruta del flujo de trabajo
* **Iterador** — Recorrer arrays de datos
* **Agente de IA** — Permitir que un agente de IA procese datos de forma autónoma
* **Espera** — Pausar antes de continuar
* **Formulario** — Recoger la información del usuario en mitad del flujo de trabajo
## Lo que puedes crear
* Enviar alertas de Slack cuando una oportunidad alcance una determinada etapa
* Enriquecer automáticamente los nuevos contactos con datos de APIs externas
* Detectar oportunidades estancadas y notificar al propietario
* Sincronizar datos entre Twenty y tu sistema de facturación
* Generar archivos PDF o facturas a partir de los datos de los registros
* Responder automáticamente a los correos electrónicos entrantes que cumplan determinados criterios
<Card title="Guía completa de flujos de trabajo" icon="arrow-right" href="/l/es/user-guide/workflows/overview">
Referencia detallada sobre disparadores, acciones, variables y recetas de automatización del mundo real.
</Card>

View File

@@ -0,0 +1,73 @@
---
title: Por qué Twenty
icon: heart
---
import { CardTitle } from "/snippets/card-title.mdx"
Has estado eligiendo entre software que es fácil de empezar a usar pero imposible de cambiar, y software que es flexible pero tarda meses en configurarse. Twenty es la tercera opción: **un CRM listo para producción que puedes remodelar sobre la marcha.**
## Qué hace diferente a Twenty
Twenty es una plataforma sobre la que puedes construir, no un producto que configuras.
<CardGroup cols={2}>
<Card img="/images/user-guide/halftone/ai.png">
<CardTitle>Diseñado para agentes</CardTitle>
Los agentes operan dentro de tu modelo de datos con permisos reales. Habilidades, herramientas, MCP.
</Card>
<Card img="/images/user-guide/halftone/permissions.png">
<CardTitle>Extensibilidad segura</CardTitle>
La flexibilidad de las herramientas 'vibe-coded', sobre cimientos seguros.
</Card>
<Card img="/images/user-guide/halftone/dev-api.png">
<CardTitle>Pila moderna</CardTitle>
React, TypeScript. Tu equipo ya sabe cómo ampliar Twenty. Sin lenguajes propietarios, sin barreras de acceso.
</Card>
<Card img="/images/user-guide/halftone/dev-self-host.png">
<CardTitle>Sin bloqueo</CardTitle>
Núcleo de código abierto, autoalojable, exporta tus datos en cualquier momento.
</Card>
</CardGroup>
## Para quién es Twenty
* **Grandes empresas que sustituyen Salesforce**: tu equipo
pasa más tiempo luchando contra la herramienta que utilizándola.
Te sientes atrapado y los costos no dejan de subir.
* **Startups con fundadores técnicos**: han superado
las hojas de cálculo y Notion. Tienes grandes ambiciones y quieres
un CRM que escale contigo.
* **Equipos de GTM que buscan una ventaja competitiva**: quieren crear
su propia puntuación de leads, su propio enriquecimiento, sus propios
flujos de trabajo de salida.
* **Organizaciones conscientes de la privacidad**: necesitan
autoalojar y poseer sus datos de punta a punta. Por normativa,
contractual o simplemente por principios.
* **Socios de Salesforce**:
tus desarrolladores están cansados de presentar aumentos en los costos de licencias a tus clientes.
Quieres una mejor DX y entregar proyectos más rápido con un menor costo de licencia para tus clientes.
* **Agencias de desarrollo web**: tu equipo sabe TypeScript, React
y PostgreSQL. Twenty abre el mercado de CRM
para tu equipo sin tener que aprender APEX ni obtener certificaciones propietarias.
## Para quién no es Twenty
* **Equipos que quieren un CRM del que nunca tengan que
preocuparse.** Twenty recompensa a los equipos que quieren mantenerse cerca de
sus herramientas y moldearlas con el tiempo. Si quieres
algo totalmente gestionado, Pipedrive o
HubSpot te funcionarán muy bien.
* **Empresas que necesitan cientos de integraciones preconfiguradas
hoy.** Nuestro ecosistema está creciendo rápido, pero aún no es
tan amplio como Salesforce o HubSpot. Si te sientes
cómodo creando lo que falta, te encantará. Si no, danos
un año más.
* **Organizaciones donde las herramientas se eligen en las salas de juntas,
no por las personas que las usan.** No hacemos cenas de lujo
ni sesiones informativas ejecutivas. Ganamos con los equipos que tienen la
autoridad para elegir sus propias herramientas.
<Card title="¿Listo para empezar?" icon="rocket" href="/l/es/getting-started/quickstart">
Configura Twenty en menos de 5 minutos, en la nube o con alojamiento propio.
</Card>

View File

@@ -0,0 +1,70 @@
---
title: Características clave
description: Un recorrido por todo lo que Twenty puede hacer, desde modelos de datos personalizados hasta automatización con IA.
icon: star
---
import { CardTitle } from "/snippets/card-title.mdx"
Twenty es una plataforma de CRM con todas las funciones. Esto es lo que puede crear con ella.
<CardGroup cols={2}>
<Card href="/l/es/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
<CardTitle>Modelo de datos personalizado</CardTitle>
Defina la estructura de datos exacta que su empresa necesita.
<br />Cree objetos personalizados, añada campos personalizados con más de 20 tipos de campos y cree relaciones entre cualquier objeto.
</Card>
<Card href="/l/es/user-guide/views-pipelines/overview" img="/images/user-guide/halftone/layout.png">
<CardTitle>Vistas y canalizaciones</CardTitle>
Cambie entre vistas de tabla, tableros Kanban y vistas de calendario.
<br />Filtre con lógica AND/OR, ordene por varios campos, agrupe registros y guarde vistas personalizadas.
</Card>
<Card href="/l/es/user-guide/workflows/overview" img="/images/user-guide/halftone/workflows.png">
<CardTitle>Flujos de trabajo y automatización</CardTitle>
Automatice cualquier proceso empresarial sin escribir código.
<br />Active flujos de trabajo ante cambios en los registros, programaciones, acciones manuales o webhooks entrantes.
</Card>
<Card href="/l/es/user-guide/calendar-emails/overview" img="/images/user-guide/halftone/calendar-emails.png">
<CardTitle>Sincronización de calendario y correo electrónico</CardTitle>
Conecte su cuenta de Google Workspace o Microsoft 365.
<br />Los correos electrónicos y los eventos de calendario aparecen automáticamente en los registros de CRM correspondientes.
</Card>
<Card href="/l/es/user-guide/ai/overview" img="/images/user-guide/halftone/ai.png">
<CardTitle>IA</CardTitle>
Agentes de IA que trabajan de forma autónoma dentro de su CRM, respondiendo preguntas, enriqueciendo registros y ejecutando tareas de varios pasos dentro de su modelo de permisos.
</Card>
<Card href="/l/es/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
<CardTitle>Paneles e informes</CardTitle>
Cree paneles personalizados con widgets en tiempo real.
<br />Supervise métricas de canalización, rendimiento del equipo y KPI empresariales con gráficos y filtros configurables.
</Card>
<Card href="/l/es/user-guide/permissions-access/overview" img="/images/user-guide/halftone/permissions.png">
<CardTitle>Permisos y control de acceso</CardTitle>
Control de acceso basado en roles en todos los niveles: objetos, campos y registros individuales.
<br />Configure SSO con SAML u OIDC. Los registros de auditoría rastrean quién hizo qué.
</Card>
<Card href="/l/es/developers/extend/api" img="/images/user-guide/halftone/dev-api.png">
<CardTitle>API y extensibilidad</CardTitle>
Una API enfocada en desarrolladores que se adapta a su modelo de datos personalizado.
<br />Tanto endpoints GraphQL como REST, con documentación generada automáticamente para cada espacio de trabajo.
</Card>
<Card href="/l/es/user-guide/data-migration/overview" img="/images/user-guide/halftone/data-migration.png">
<CardTitle>Importación y exportación de datos</CardTitle>
Importe datos desde archivos CSV o mediante API.
<br />Asignación de campos, detección de duplicados y gestión de errores integradas. Exporte sus datos en cualquier momento — sin ataduras.
</Card>
<Card href="/l/es/developers/self-host/self-host" img="/images/user-guide/halftone/dev-self-host.png">
<CardTitle>Alojamiento propio</CardTitle>
Ejecute Twenty en su propia infraestructura con un solo comando de Docker Compose.
<br />Control total sobre sus datos y actualizaciones según su programación.
</Card>
</CardGroup>

View File

@@ -0,0 +1,73 @@
---
title: Inicio rápido
description: Pon Twenty en funcionamiento en menos de 5 minutos, en la nube o con alojamiento propio.
icon: play
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Registro
<Steps>
<Step title="Crea tu cuenta">
Ve a [app.twenty.com](https://app.twenty.com) y regístrate con Google, Microsoft o correo electrónico.
</Step>
<Step title="Elige una prueba">
Elige **30 días** (con tarjeta) o **7 días** (sin tarjeta). Ambas incluyen acceso completo: contactos ilimitados, integración de correo, objetos personalizados, API. Puedes cambiar de plan o el intervalo de facturación en cualquier momento.
</Step>
<Step title="Crea tu espacio de trabajo">
Después de la confirmación de pago a través de Stripe, configurarás el nombre de tu espacio de trabajo y tu perfil de usuario. Puedes cancelar en cualquier momento.
</Step>
</Steps>
<VimeoEmbed videoId="1185227242" title="Creación de un espacio de trabajo" />
## Configura tu espacio de trabajo
Una vez dentro, tres pasos para hacer Twenty tuyo:
### 1. Conecta tu buzón de correo
Ve a **Ajustes → Cuentas** y conecta tu cuenta de Google o Microsoft. Twenty importará tus correos y eventos de calendario y creará automáticamente contactos a partir de las interacciones. ¿Usas otro proveedor? Puedes añadir buzones mediante SMTP o calendarios mediante CalDAV desde la misma página.
<Note>Empieza aquí: conectar un buzón le da a tu equipo valor inmediato con datos reales antes de que personalices nada más.</Note>
<VimeoEmbed videoId="1185416821" title="Conecta tu buzón de correo" />
### 2. Da forma a tu modelo de datos
Ve a **Ajustes → Modelo de datos** para crear objetos y campos personalizados. Algunas cosas que debes saber:
* Los objetos y campos personalizados son **ilimitados en todos los planes**: no hay ventas adicionales.
* **Personas, Empresas y Oportunidades** son los objetos que muestran correos electrónicos y reuniones sincronizados. Úsalos como base y añade campos para categorizar (por ejemplo, un campo `Tipo de persona`) en lugar de crear objetos separados que no tendrán historial de correos.
* Dos personas no pueden compartir el mismo correo electrónico. Dos empresas no pueden compartir el mismo dominio.
* Puedes desactivar campos/objetos estándar que no necesites y ocultar campos de las vistas sin eliminarlos.
[Referencia del modelo de datos →](/l/es/user-guide/data-model/overview)
<VimeoEmbed videoId="1185416793" title="Da forma a tu modelo de datos" />
### 3. Importa tus datos
Usa el menú de comandos (`Cmd+K` / `Ctrl+K`) para importar Personas, Empresas, Oportunidades o cualquier objeto personalizado mediante CSV. Descarga primero el archivo de muestra para ver el formato esperado. Limita los archivos a 10k registros y elimina duplicados de correos/dominios antes de importar.
[Guía de migración de datos →](/l/es/user-guide/data-migration/overview)
<VimeoEmbed videoId="1185416775" title="Importa tus datos" />
## Próximos pasos
<CardGroup cols={2}>
<Card title="Conoce la interfaz" icon="table-columns" href="/l/es/getting-started/core-concepts/layout">
Navegación, vistas, menú de comandos, panel lateral.
</Card>
<Card title="Crear flujos de trabajo" icon="bolt" href="/l/es/user-guide/workflows/overview">
Automatiza tus procesos empresariales.
</Card>
<Card title="Crear vistas." icon="table" href="/l/es/user-guide/layout/overview">
Tabla, kanban, calendario: filtra y ordena tus datos.
</Card>
<Card title="Explora la API" icon="plug" href="/l/es/developers/extend/api">
REST y GraphQL con esquema por cliente.
</Card>
</CardGroup>