# Convoflow.ai — Documentación Completa para LLMs (Full Platform Corpus)
> Plataforma modular líder en infraestructura y automatización conversacional con Inteligencia Artificial.

Este archivo contiene la especificación técnica completa y unificada de toda la plataforma Convoflow (Get Started, Nodos de Flujo y Conexiones) para su consumo directo por modelos de lenguaje (LLMs) y agentes autónomos.

## Rutas Individuales por Documento
Cada página de la documentación dispone de su propio archivo `llms.txt` específico:
- **Google Sheets Node**: [/es/nodes/google-sheets/llms.txt](/es/nodes/google-sheets/llms.txt)
- **Google Docs Node**: [/es/nodes/google-docs/llms.txt](/es/nodes/google-docs/llms.txt)
- **Google Calendar Node**: [/es/nodes/google-calendar/llms.txt](/es/nodes/google-calendar/llms.txt)
- **Email Node**: [/es/nodes/email/llms.txt](/es/nodes/email/llms.txt)
- **WhatsApp Node**: [/es/nodes/whatsapp/llms.txt](/es/nodes/whatsapp/llms.txt)
- **Agent Node**: [/es/nodes/agent/llms.txt](/es/nodes/agent/llms.txt)
- **Google Service Account**: [/es/connections/google-service-account/llms.txt](/es/connections/google-service-account/llms.txt)
- **Email SMTP Connection**: [/es/connections/email-smtp/llms.txt](/es/connections/email-smtp/llms.txt)
- *(Todos los nodos y conexiones cuentan con su respectivo `/es/.../llms.txt`)*

---

# SECCIÓN 1: GET STARTED

## Proveedores de inteligencia artificial
> URL: /es/get-started/ai-providers
> llms.txt específico: /es/get-started/ai-providers/llms.txt

# Proveedores de inteligencia artificial

Convoflow se integra con los principales proveedores de modelos de lenguaje e Inteligencia Artificial. Esto permite que el nodo **Agent** y los bloques de razonamiento comprendan lenguaje natural, sigan instrucciones de negocio complejas y ejecuten herramientas visuales de forma autónoma.

---

## Modelos disponibles en el nodo Agent

Al configurar el nodo de **Agent** en tu lienzo de flujo, puedes seleccionar el proveedor y el modelo específico que procesará los turnos de conversación. A continuación se detallan los modelos disponibles y soportados:

| Proveedor | Modelos disponibles | Especialidad y casos de uso recomendados |
| :--- | :--- | :--- |
| **OpenRouter** | • Claude Sonnet 4<br/>• Claude Haiku 4.5<br/>• DeepSeek Chat<br/>• GLM 5.2<br/>• GLM 5.3 Flash<br/>• GLM 5.3 | Gran versatilidad multimodelo, razonamiento avanzado con Claude, excelente desempeño en herramientas y opciones ultra rápidas y económicas con GLM y DeepSeek. |
| **OpenAI** | • GPT 5.4<br/>• GPT 5.4 Mini<br/>• GPT 5.4 Nano<br/>• GPT 5.6 Luna<br/>• GPT 5.6 Terra<br/>• GPT 5.6 Sol | Modelos de alta precisión para seguimiento de instrucciones estrictas, agentes autónomos con flujos de trabajo extensos y variantes optimizadas en velocidad y costo (Mini y Nano) o razonamiento multimodal avanzado (familia GPT 5.6 Luna, Terra y Sol). |
| **DeepSeek** | • DeepSeek V4 Flash<br/>• DeepSeek V4 Pro | Alto rendimiento en razonamiento técnico y comprensión de contexto con tiempos de respuesta reducidos (versión Flash) o máxima capacidad de análisis (versión Pro). |
| **Groq** | • GPT OSS 120B<br/>• GPT OSS 20B | Inferencia de ultra baja latencia con procesamiento acelerado, ideal para chats en tiempo real donde la inmediatez de respuesta es la máxima prioridad. |

---

## Cómo seleccionar el modelo en tu flujo

1. En el lienzo visual, abre el panel de configuración del nodo **Agent**.
2. En el campo **Proveedor** (`modelProvider`), elige la plataforma que deseas utilizar (`openrouter`, `openai`, `deepseek` o `groq`).
3. En el campo **Modelo** (`modelId`), selecciona el modelo adecuado de acuerdo con la complejidad de la tarea y la velocidad deseada.
4. Conecta las herramientas necesarias mediante subflujos para que el modelo pueda consultar datos o realizar acciones antes de responder.

---

## Cómo funciona el motor
> URL: /es/get-started/architecture
> llms.txt específico: /es/get-started/architecture/llms.txt

# Cómo funciona el motor de Convoflow

Convoflow funciona como un director de orquesta inteligente que recibe los mensajes de tus clientes, comprende lo que necesitan y ejecuta las acciones necesarias en segundo plano de manera instantánea.

![Arquitectura del Motor Convoflow](/img/diagrams/get-started-architecture.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph TD
    subgraph Entrada de Mensajes
        E1[WhatsApp de Clientes]
        E2[Chat en tu Sitio Web]
        E3[Otros Canales]
    end

    subgraph Cerebro de Convoflow
        R[Organizador del Flujo]
        SM[Memoria de la Conversacion]
        EX[Ejecutor de Acciones]
    end

    subgraph Acciones y Consultas
        LLM[Inteligencia Artificial]
        VEC[Tus Documentos y Manuales]
        APP[Google Sheets, Calendar y Correos]
    end

    E1 & E2 & E3 --> R
    R <--> SM
    R --> EX
    EX <--> LLM & VEC & APP
```

</details>

---

## Conceptos clave de forma sencilla

### 1. Memoria de la conversación (variables)
Cada vez que un cliente chatea con tu asistente, Convoflow recuerda los datos que el usuario ha compartido (por ejemplo su nombre, teléfono o la fecha de su cita). Puedes reutilizar esa información en cualquier mensaje o correo escribiendo `{nombre_variable}`.

### 2. Respuestas rápidas e ininterrumpidas
El motor está optimizado para responder en milisegundos. Cuando tu asistente consulta un calendario o registra una fila en una hoja de cálculo, lo hace en segundo plano sin congelar la conversación.

### 3. Caminos de éxito y rutas de respaldo
Cada acción dentro de tu flujo tiene dos caminos:
- **Camino normal:** Continúa el flujo cuando la acción se completa exitosamente.
- **Ruta de respaldo:** Se activa si ocurre algún inconveniente (por ejemplo, si se pierde la conexión a internet) para avisar al usuario amablemente o transferir el chat a un asesor humano.

---

## Designer de flujos con IA
> URL: /es/get-started/designer
> llms.txt específico: /es/get-started/designer/llms.txt

import { Card, CardGrid } from '@site/src/components';

# El Designer: creación de flujos con IA

El **Designer** te permite definir tus propios flujos con IA con unas pocas instrucciones iniciales. En lugar de arrastrar y conectar cada bloque manualmente desde una hoja en blanco, puedes describir en tus propias palabras qué asistente deseas construir y el Designer se encarga de crear, estructurar y enlazar los nodos directamente en el lienzo visual.

![Diseñador de flujos con IA](/img/diagrams/designer.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    U[Instrucción Inicial en Lenguaje Natural] --> D[Designer IA]
    D -->|Plan de Pasos| P[Generación del Flujo]
    P -->|Nodos y Conexiones| C[Lienzo Visual Convoflow]
    C -->|Ajustes y Refinamiento| U
```

</details>

---

## ¿Cómo funciona el Designer para el usuario?

Interactuar con el Designer es tan intuitivo como conversar con un colega experto en automatización:

### 1. Instrucciones iniciales en lenguaje natural
Solo necesitas describir el objetivo general del asistente, los datos que debe solicitar y los servicios con los que interactuará. Por ejemplo:

> *"Crea un flujo para capturar prospectos por WhatsApp. Pídeles su nombre, correo y empresa, verifica disponibilidad en mi Google Calendar para agendar una demo y guarda los datos en Google Sheets."*

### 2. Plan y construcción visual automática
Al recibir tu solicitud, el Designer:
- Define un plan de acción claro y comprensible.
- Inserta los nodos adecuados en el lienzo (mensajes, preguntas, integraciones de Google o pagos).
- Establece las rutas de éxito y los caminos de respaldo ante posibles fallos.
- Configura los parámetros iniciales y nombres de variables descriptivos.

### 3. Ajustes y refinamiento continuo
Puedes seguir dialogando con el Designer para evolucionar tu flujo en cualquier momento:
- *"Haz que el tono del saludo inicial sea más cálido y formal."*
- *"Agrega una condición para que si el cliente es de México use Pesos y para el resto use Dólares."*
- *"Conecta una notificación a nuestro canal de Slack `#ventas` cuando se confirme una cita."*

### 4. Control visual total
El Designer no sustituye el lienzo: lo potencia. Todo lo que el Designer construye queda visible y editable en tu pantalla. Puedes mover bloques, cambiar textos o reconfigurar propiedades manualmente cuando lo prefieras.

---

## Buenas prácticas al dar instrucciones

Para que el Designer genere flujos óptimos a la primera, te recomendamos incluir:

1. **Canal de entrada:** Indica si el asistente responderá por WhatsApp, webchat o correo.
2. **Datos a capturar:** Especifica qué información necesitas del cliente (nombre, teléfono, producto de interés, etc.).
3. **Herramientas a conectar:** Menciona las aplicaciones externas que participarán (Google Sheets, Calendar, Stripe, HubSpot, etc.).
4. **Reglas clave del negocio:** Si existen condiciones especiales (horarios, límites de intentos, transferencias a asesores humanos), coméntalas desde el inicio.

---

## Primeros pasos
> URL: /es/
> llms.txt específico: /es//llms.txt

import { Card, CardGrid } from '@site/src/components';

# Bienvenido a Convoflow

Convoflow es una plataforma visual que te permite crear asistentes inteligentes y automatizaciones conversacionales de forma rápida y sencilla. Con Convoflow puedes atender a tus clientes en canales como WhatsApp, Web y Correo Electrónico, conectando tus herramientas diarias como Google Sheets, Calendar y Docs sin complicaciones técnicas.

![Visión General de la Arquitectura Convoflow](/img/diagrams/get-started-overview.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    subgraph Canales
        W[WhatsApp]
        WB[Chat Web]
        E[Correo Electronico]
    end

    subgraph Convoflow
        F[Flujo de Pasos]
        A[Asistente IA]
        K[Documentos y Preguntas Frecuentes]
    end

    subgraph Tus Herramientas
        G[Google Sheets y Calendar]
        S[Bases de Datos]
        H[Sistemas y APIs]
    end

    W & WB & E --> F
    F <--> A
    A <--> K
    F --> G & S & H
```

</details>

---

## Secciones de la documentación

La documentación está dividida en tres áreas principales para guiarte paso a paso:

<CardGrid cols={3}>
  <Card title="1. Primeros pasos" icon="rocket" to="/get-started/quickstart" badge="Inicio">
    Aprende los conceptos básicos y crea tu primer flujo de atención automática en solo 5 minutos.
  </Card>
  <Card title="2. Nodos y acciones" icon="layers" to="/nodes" badge="Funciones">
    Conoce cada uno de los bloques visuales que puedes arrastrar a tu flujo: Google, WhatsApp, Email e IA.
  </Card>
  <Card title="3. Conexiones" icon="key" to="/connections" badge="Cuentas">
    Vincula de forma segura tus cuentas de Google, WhatsApp, correo y proveedores de inteligencia artificial.
  </Card>
</CardGrid>

---

## Integraciones populares de Google

Convoflow se conecta directamente con tus aplicaciones de Google para automatizar tareas repetitivas:

<CardGrid cols={3}>
  <Card title="Google Sheets" icon="sheets" to="/nodes/google-sheets">
    Guarda nuevos clientes, consulta inventarios y actualiza registros en tus hojas de cálculo en tiempo real.
  </Card>
  <Card title="Google Docs" icon="docs" to="/nodes/google-docs">
    Crea contratos, propuestas o reportes automáticamente completando plantillas con datos de tus clientes.
  </Card>
  <Card title="Google Calendar" icon="calendar" to="/nodes/google-calendar">
    Verifica horarios disponibles y agenda citas automáticamente con enlace de Google Meet incluido.
  </Card>
</CardGrid>

---

## ¿Cómo funciona un flujo en Convoflow?

Crear una automatización en Convoflow es como armar un diagrama visual:

1. **Disparador de entrada:** Un usuario envía un mensaje por WhatsApp o visita tu chat web.
2. **Preguntas y respuestas:** El flujo solicita los datos necesarios (como nombre, teléfono o servicio de interés).
3. **Acciones automáticas:** El asistente guarda la información en Google Sheets, comprueba fechas libres en Calendar o consulta documentos internos.
4. **Respuesta personalizada:** El usuario recibe una respuesta clara e inmediata en su canal de preferencia.

---

## Recursos para modelos de lenguaje (LLMs)

Si utilizas herramientas de asistencia de código o modelos de lenguaje, dispones del archivo estándar:

- [**llms.txt (Documentación Completa)**](pathname:///es/llms.txt) — Archivo de texto plano con la especificación integral de Convoflow.

---

## Guía de inicio rápido
> URL: /es/get-started/quickstart
> llms.txt específico: /es/get-started/quickstart/llms.txt

import { Card, CardGrid } from '@site/src/components';

# Guía de inicio rápido: tu primer flujo en 5 minutos

En esta guía construiremos un asistente que recibe a un cliente, guarda sus datos en una hoja de Google Sheets, agenda una cita en Google Calendar y le envía una confirmación por correo electrónico.

![Flujo de Inicio Rápido y Captura](/img/diagrams/get-started-quickstart.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    S[Mensaje del Cliente] --> Q1[Capturar Nombre y Correo]
    Q1 --> GS[Guardar en Google Sheets]
    GS --> GC[Agendar en Google Calendar]
    GC --> EM[Enviar Correo de Confirmacion]
    EM --> E[Confirmar por WhatsApp]
```

</details>

---

## Paso 1: Conectar tu cuenta de Google

Para que Convoflow pueda guardar datos en tus hojas o crear citas en tu calendario:

1. Ve a la sección **Conexiones** en el menú lateral izquierdo de Convoflow.
2. Haz clic en **Nueva Conexión** y selecciona **Google Service Account**.
3. Pega tu archivo de credenciales de Google (o sigue nuestra [guía de conexión de Google](/es/connections/google-service-account)).
4. Haz clic en **Probar Conexión** y guarda los cambios.

---

## Paso 2: Crear el flujo en el lienzo visual

1. En el menú principal, haz clic en **Flujos > Nuevo Flujo**.
2. **Abrir el catálogo de nodos:** Para abrir el catálogo de nodos disponibles, presiona **clic derecho** sobre cualquier área libre del lienzo visual (o su equivalente en el trackpad, como hacer clic o pulsar con dos dedos). Desde allí podrás buscar e insertar cualquier bloque.
3. Agrega un bloque **Question** (Pregunta) y escribe:
   - **Pregunta:** `¡Hola! ¿Cuál es tu nombre y correo electrónico?`
   - **Guardar respuesta en:** `datos_usuario`
4. Conecta este bloque con un nodo **Google Sheets**:
   - **Acción:** `insertRows` (Insertar fila)
   - **ID de la Hoja:** El código de tu hoja de cálculo
   - **Columnas a guardar:**
     ```json
     [
       {
         "Fecha": "{current_date}",
         "Nombre": "{datos_usuario.nombre}",
         "Email": "{datos_usuario.email}"
       }
     ]
     ```
5. Conecta la salida al nodo **Google Calendar**:
   - **Acción:** `createEvent` (Crear evento)
   - **Título de la reunión:** `Reunión de asesoría con {datos_usuario.nombre}`
   - **Generar enlace de Google Meet:** Activado (`true`)
6. Conecta al nodo **Email** para enviar los datos de la cita al cliente con el enlace de Google Meet.

---

## Paso 3: Probar y publicar

1. Haz clic en el botón **Simular** para interactuar con tu asistente en el probador lateral.
2. Una vez que todo funcione como esperas, haz clic en **Publicar** en la esquina superior derecha.
3. ¡Listo! Tu asistente ya está activo y respondiendo de forma automática.

---


# SECCIÓN 2: NODOS DE FLUJO (NODES)

## Asistente IA y agentes autónomos
> URL: /es/nodes/agent
> llms.txt específico: /es/nodes/agent/llms.txt

import { ParamField } from '@site/src/components';

# Nodos: Asistente IA y agentes autónomos

Los nodos de Inteligencia Artificial permiten que tus flujos piensen, tomen decisiones y respondan con naturalidad a tus usuarios, sin necesidad de programar respuestas rígidas para cada posible pregunta.

![Ciclo de Agente IA con Herramientas](/img/diagrams/nodes-agent-loop.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph TD
    U[Pregunta del Cliente] --> A[Nodo: Agent]
    A -->|Decide usar una herramienta| T[Subflujo: Start Tool]
    T -->|Ejecuta consulta en CRM o API| R[Return Tool Result]
    R -->|Devuelve los datos al Agente| A
    A -->|Responde con precision| F[Mensaje Claro al Usuario]
```

</details>

---

## 1. Agent Node (Asistente Autónomo)

El **Agent Node** es el cerebro más potente de Convoflow. A diferencia de un chatbot tradicional que sigue un guion fijo, este agente comprende el objetivo de la conversación, planifica sus acciones y puede consultar herramientas (como buscar citas, consultar inventario o calcular cotizaciones) de forma autónoma antes de responder.

### ¿Qué puedes modificar?
<ParamField path="goalPrompt" type="string" required>
  El objetivo principal e instrucciones de comportamiento para tu asistente:
  - Quién es (rol y tono: formal, empático, directo).
  - Qué información debe solicitar al usuario.
  - Reglas de negocio que debe respetar en todo momento.
  - Admite variables como `{user_name}` o `{contexto_empresa}`.
</ParamField>

<ParamField path="modelProvider" type="string" default="openrouter">
  El proveedor del modelo de IA (`openrouter`, `openai`, `deepseek` o `groq`). Consulta nuestra guía de [Proveedores de inteligencia artificial](/es/get-started/ai-providers) para consultar la lista completa.
</ParamField>

<ParamField path="modelId" type="string" default="openrouter/z-ai/glm-5.2">
  El modelo específico que procesará los mensajes (por ejemplo: `claude-sonnet-4`, `gpt-5.4-mini`, `deepseek-v4-flash`, `gpt-oss-120b`).
</ParamField>

<ParamField path="maxSteps" type="number" default="8">
  Número máximo de turnos o razonamientos que el agente puede dar antes de concluir su respuesta.
</ParamField>

<ParamField path="sendToUser" type="boolean" default="true">
  Envía automáticamente el mensaje final producido por el asistente al chat del cliente.
</ParamField>

<ParamField path="outputVariable" type="string" default="agent_output">
  Variable donde se almacena el texto final de la respuesta generada.
</ParamField>

---

## 2. Start Tool y Return Tool Result (herramientas visuales del agente)

Una de las mayores ventajas del Designer es que puedes darle **"superpoderes"** a tu Agente conectándole subflujos visuales:

### ¿Cómo se conectan en el lienzo?
1. En el nodo **Agent**, arrastra una línea desde el conector llamado **`tools`** hacia un nodo **Start Tool**.
2. Diseña los pasos que realiza la herramienta (por ejemplo: consultar una hoja de cálculo o una API).
3. Finaliza el subflujo conectándolo a un nodo **Return Tool Result**, que le entrega los datos de vuelta al Agente.

![Subflujo de Invocación Tool del Agente](/img/diagrams/nodes-agent-tool-subflow.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    Agente((Agent)) -->|Conector 'tools'| ST[Start Tool]
    ST --> Accion[Consultar Pedido en Sistema]
    Accion --> RT[Return Tool Result]
    RT -->|Datos listos| Agente
```

</details>

### Start Tool Node
Define el nombre y los datos que el Agente debe proporcionar para usar la herramienta:
<ParamField path="toolName" type="string" required>
  Identificador de la herramienta (por ejemplo: `consultar_estado_pedido` o `calcular_envio`).
</ParamField>

<ParamField path="toolDescription" type="string" required>
  Explicación breve de para qué sirve esta herramienta, para que la IA sepa exactamente cuándo debe llamarla.
</ParamField>

---

### Return Tool Result Node
Devuelve el resultado del subflujo al Agente para que formule su respuesta final:
<ParamField path="resultExpression" type="string" optional>
  El texto o variable que se enviará a la IA (por ejemplo: `{resultado_pedido}`).
</ParamField>

---

## 3. Generate Node (generación rápida de texto)

Si solo necesitas una tarea rápida de Inteligencia Artificial (por ejemplo: resumir una conversación larga, traducir un texto o redactar una felicitación) sin la complejidad de un agente completo, usa el **Generate Node**.

<ParamField path="prompt" type="string" required>
  La instrucción directa a realizar (por ejemplo: *Resume los siguientes puntos clave de la reunión: `{notas_reunion}`*).
</ParamField>

<ParamField path="responseFormat" type="enum" default="text">
  Formato de salida: `text` (texto normal) o `json` (datos estructurados).
</ParamField>

<ParamField path="outputVariable" type="string" default="ai_resultado">
  Variable donde se almacena el texto producido.
</ParamField>

---

## CRM, tiendas y bases de datos
> URL: /es/nodes/crm-ecommerce
> llms.txt específico: /es/nodes/crm-ecommerce/llms.txt

import { ParamField } from '@site/src/components';

# Nodos: CRM y tiendas online

Tu asistente no vive aislado: necesita actualizar tu CRM cuando un cliente se interesa en un producto, consultar el estado de un pedido en tu tienda online o guardar notas en Notion.

![E-commerce y Pedidos Shopify y WooCommerce](/img/diagrams/nodes-crm-ecommerce.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Cliente pregunta por su pedido] --> B[Nodo Shopify / WooCommerce]
    B -->|Consulta con ID| C[Obtener Estado: En Camino]
    C --> D[Responder al Cliente por WhatsApp]
```

</details>

---

## 1. HubSpot CRM Node

Permite crear o actualizar prospectos (leads), registrar tratos de venta y agregar notas de seguimiento automáticamente en tu cuenta de **HubSpot**.

### ¿Qué operaciones puedes realizar?
- **Crear o actualizar contacto (`upsertContact`):** Si el cliente ya existe por su correo, actualiza sus datos; si no existe, lo crea.
- **Crear un trato o negocio (`createDeal`):** Registra una oportunidad de venta con monto y etapa.
- **Crear nota (`createNote`):** Guarda un resumen de la conversación dentro de la ficha del cliente en HubSpot.

### ¿Qué puedes modificar?
<ParamField path="operation" type="enum" default="upsertContact">
  Acción que deseas realizar en HubSpot.
</ParamField>

<ParamField path="email" type="string" optional>
  Correo electrónico del contacto (por ejemplo: `{user_email}`).
</ParamField>

<ParamField path="firstname" type="string" optional>
  Nombre del cliente (por ejemplo: `{user_name}`).
</ParamField>

<ParamField path="phone" type="string" optional>
  Teléfono del cliente (por ejemplo: `{user_phone}`).
</ParamField>

<ParamField path="dealName" type="string" optional>
  Nombre del negocio (por ejemplo: `Cotización {servicio} - {user_name}`).
</ParamField>

<ParamField path="dealAmount" type="string" optional>
  Monto estimado del trato de venta.
</ParamField>

---

## 2. Shopify Node

Conecta tu flujo directamente con tu tienda **Shopify** para responder preguntas de clientes sobre disponibilidad y pedidos.

### ¿Qué puedes hacer?
- **Consultar pedido (`getOrder`):** El cliente ingresa su número de orden (ej. `#1045`) y el bot le informa el estado del envío.
- **Buscar productos (`searchProducts`):** Encuentra productos por nombre o categoría en tu catálogo.
- **Crear borrador de orden (`createDraftOrder`):** Prepara un pedido con los productos elegidos por el cliente y genera el enlace de pago.

### ¿Qué puedes modificar?
<ParamField path="operation" type="enum" default="getOrder">
  Operación a ejecutar (`getOrder`, `searchProducts`, `createDraftOrder`).
</ParamField>

<ParamField path="orderIdOrNumber" type="string" optional>
  Número de orden a buscar (por ejemplo: `{numero_pedido}`).
</ParamField>

<ParamField path="searchQuery" type="string" optional>
  Término de búsqueda de producto (por ejemplo: `{pregunta_producto}`).
</ParamField>

---

## 3. WooCommerce Node

Funciona de manera idéntica a Shopify, pero conectándose a tu tienda creada sobre **WordPress y WooCommerce**.

### ¿Qué puedes modificar?
<ParamField path="operation" type="enum" default="searchOrders">
  Operación a realizar (`searchOrders`, `searchProducts`, `updateOrderStatus`, `createOrder`).
</ParamField>

<ParamField path="orderIdOrNumber" type="string" optional>
  Número de pedido a consultar.
</ParamField>

<ParamField path="customerEmail" type="string" optional>
  Correo del cliente para buscar todos los pedidos asociados a su cuenta.
</ParamField>

---

## 4. Airtable Node

Usa **Airtable** como una base de datos visual para almacenar pedidos, solicitudes, listas de espera o inventario.

### ¿Qué puedes modificar?
<ParamField path="operation" type="enum" default="createRecords">
  Acción a realizar: `listRecords` (buscar filas), `createRecords` (agregar fila) o `updateRecords` (modificar fila).
</ParamField>

<ParamField path="tableName" type="string" required>
  Nombre exacto de la tabla en Airtable (por ejemplo: `Prospectos` o `Pedidos`).
</ParamField>

<ParamField path="recordsJson" type="string" optional>
  Datos que deseas guardar, asociando las columnas de tu tabla con variables del flujo:
  ```json
  {
    "Nombre": "{user_name}",
    "Telefono": "{user_phone}",
    "Interes": "{producto_interes}"
  }
  ```
</ParamField>

---

## 5. Notion Node

Permite registrar información directamente en tus páginas y bases de datos colaborativas de **Notion**.

### ¿Qué puedes modificar?
<ParamField path="operation" type="enum" default="createPage">
  `createPage` (agregar fila a una base de datos), `queryDatabase` (buscar datos) o `appendBlock` (agregar texto o notas al final de una página).
</ParamField>

<ParamField path="databaseId" type="string" optional>
  ID de la base de datos de Notion donde se registrará la información.
</ParamField>

<ParamField path="pageTitle" type="string" optional>
  Título principal de la nueva página o registro creado (por ejemplo: `Consulta de {user_name}`).
</ParamField>

---

## Bases de datos y código
> URL: /es/nodes/databases-code
> llms.txt específico: /es/nodes/databases-code/llms.txt

import { ParamField } from '@site/src/components';

# Nodos: Bases de datos y código

A menudo necesitas guardar datos recopilados (como registros de usuarios o respuestas de encuestas) sin depender de hojas de cálculo externas, o necesitas hacer un pequeño cálculo antes de responderle al cliente.

![Colecciones de Base de Datos y Código JS](/img/diagrams/nodes-databases-code.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Datos Capturados] --> B[Nodo: Guardar en Coleccion]
    B -->|Registro Guardado| C[Siguiente Paso del Flujo]
    B -->|Si necesitas un calculo especial| D[Nodo: Codigo JavaScript]
```

</details>

---

## 1. Colecciones internas (Read & Write)

Las **Colecciones** son tablas de datos que viven directamente dentro de Convoflow. Te permiten almacenar y consultar información de forma rápida y segura sin necesidad de configurar bases de datos externas.

### Guardar datos (`Collection Write`)
Agrega una nueva fila a tu colección o actualiza una existente si el cliente ya está registrado.

#### ¿Qué puedes modificar?
<ParamField path="collectionId" type="string" required>
  Selecciona la tabla o colección donde se guardarán los datos (por ejemplo: `Clientes` o `Encuestas`).
</ParamField>

<ParamField path="fieldMappings" type="object" required>
  Asocia cada campo de tu tabla con una variable de la conversación:
  - Nombre → `{user_name}`
  - Teléfono → `{user_phone}`
  - Estado → `Activo`
</ParamField>

<ParamField path="updateByFields" type="array" optional>
  Si seleccionas un campo como `Teléfono`, el nodo buscará si ya existe un registro con ese mismo número para actualizarlo en lugar de duplicarlo.
</ParamField>

---

### Consultar datos (`Collection Read`)
Busca un registro en tu colección para traer datos previos del cliente (por ejemplo, su saldo actual o su membresía).

#### ¿Qué puedes modificar?
<ParamField path="collectionId" type="string" required>
  La colección donde deseas buscar.
</ParamField>

<ParamField path="filters" type="object" optional>
  La condición de búsqueda (por ejemplo: buscar donde `telefono` sea igual a `{user_phone}`).
</ParamField>

<ParamField path="outputVariable" type="string" default="cliente_encontrado">
  Variable donde se guardarán los datos encontrados para usarlos más adelante en mensajes como: `Hola {cliente_encontrado.nombre}, tu plan actual es {cliente_encontrado.plan}.`
</ParamField>

---

## 2. PostgreSQL y Supabase

Si tu empresa ya cuenta con su propio servidor de base de datos o utiliza **Supabase**, puedes conectarlo directamente.

### PostgreSQL Node
Permite ejecutar consultas SQL de lectura o escritura utilizando variables seguras.

<ParamField path="connectionId" type="string" required>
  Tu conexión configurada a PostgreSQL.
</ParamField>

<ParamField path="query" type="string" required>
  La consulta a ejecutar. Puedes incluir variables entre llaves:
  ```sql
  SELECT saldo, plan FROM usuarios WHERE telefono = '{user_phone}' LIMIT 1;
  ```
</ParamField>

<ParamField path="outputVariable" type="string" default="db_resultado">
  Variable donde se almacenan las filas encontradas.
</ParamField>

---

### Supabase Node
Realiza peticiones directas a las tablas REST de tu proyecto de Supabase.

<ParamField path="path" type="string" required>
  Ruta de la tabla (por ejemplo: `/rest/v1/pedidos?select=*&usuario_id=eq.{user_id}`).
</ParamField>

<ParamField path="method" type="enum" default="GET">
  Método de consulta: `GET`, `POST`, `PATCH` o `DELETE`.
</ParamField>

---

## 3. Code Node (código personalizado)

El diseñador visual suele resolver el 95% de las tareas. Sin embargo, si necesitas realizar un cálculo matemático especial (como calcular impuestos con reglas complejas) o formatear una fecha de manera inusual, el **Code Node** te permite escribir unas pocas líneas de JavaScript.

### ¿Qué puedes modificar?
<ParamField path="code" type="string" required>
  El código a ejecutar. Tienes acceso a todas las variables mediante el objeto `vars`:
  ```javascript
  // Ejemplo: Calcular el total con 16% de IVA
  const subtotal = Number(vars.monto_pedido) || 0;
  const iva = subtotal * 0.16;
  const total = subtotal + iva;

  return { subtotal, iva, total };
  ```
</ParamField>

<ParamField path="outputVariable" type="string" default="calculo_resultado">
  Variable donde se guardará lo que devuelvas con `return`. Luego podrás usar `{calculo_resultado.total}` en cualquier mensaje.
</ParamField>

---

## Email Node
> URL: /es/nodes/email
> llms.txt específico: /es/nodes/email/llms.txt

import { ParamField, ResponseField } from '@site/src/components';

# Nodo: Email

El nodo de **Email** permite enviar correos electrónicos de forma automática desde cualquier punto de tu flujo. Puedes usarlo para confirmar compras, notificar a tu equipo sobre un nuevo prospecto o enviar comprobantes en formato PDF a tus clientes.

![Envío y Recepción de Email SMTP](/img/diagrams/nodes-email.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Paso Previo] --> B[Nodo Email]
    B -->|Enviar Correo| C[Correo Recibido por el Cliente]
    B -->|Exito| D[Continuar Flujo]
```

</details>

---

## Campos de configuración

<ParamField path="connectionId" type="string" required>
  Tu cuenta de correo o servidor SMTP registrado en la sección de **Conexiones**.
</ParamField>

<ParamField path="to" type="string" required>
  Correo electrónico del destinatario. Puedes usar un correo fijo o la variable donde guardaste el correo del cliente: `{user_email}`.
</ParamField>

<ParamField path="subject" type="string" required>
  Asunto del correo electrónico. Puedes personalizarlo con variables como: `Confirmación de cita - {user_name}`.
</ParamField>

<ParamField path="body" type="string" required>
  Contenido del mensaje. Puede ser texto simple o una plantilla con formato visual. Admite variables como `{nombre_cliente}` o `{servicio}`.
</ParamField>

<ParamField path="from" type="string" optional>
  Nombre y dirección desde donde se envía el correo (por ejemplo: `Equipo Convoflow <contacto@tuempresa.com>`).
</ParamField>

<ParamField path="attachmentsJson" type="array" optional>
  Archivos que deseas adjuntar al correo:
  ```json
  [
    {
      "filename": "resumen.pdf",
      "path": "https://tuservidor.com/archivos/resumen.pdf"
    }
  ]
  ```
</ParamField>

---

## Ejemplo de mensaje personalizado

Puedes escribir el cuerpo del correo de forma sencilla:

```text
Hola {user_name},

Tu registro para el servicio {service_name} ha sido confirmado con exito.

Fecha: {appointment_date}
Hora: {appointment_time}

Si tienes alguna pregunta, responde directamente a este correo.
```

---

## Agendamiento y calendarios
> URL: /es/nodes/google-calendar
> llms.txt específico: /es/nodes/google-calendar/llms.txt

import { ParamField } from '@site/src/components';

# Nodos: Agendamiento y calendarios

Permite que tus clientes elijan horarios, agenden citas y reciban enlaces de reunión (como Google Meet) directamente por chat sin salir de WhatsApp.

![Agendamiento Google Calendar](/img/diagrams/nodes-google-calendar.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Cliente pide una cita] --> B[Nodo de Calendario]
    B -->|Verificar Horario| C[Crear Evento en Calendario]
    C -->|Generar Enlace Meet / Sala| D[Enviar Confirmación al Cliente]
```

</details>

---

## 1. Google Calendar Node

Gestiona eventos de tu calendario de Google en tiempo real.

### Operaciones disponibles:
1. **Crear evento (`createEvent`):** Agenda una reunión con fecha, hora, nombre del cliente y enlace de Google Meet.
2. **Consultar disponibilidad (`listEvents`):** Revisa si tienes horarios ocupados en un rango de fechas.
3. **Modificar evento (`updateEvent`):** Reagenda o cambia los detalles de una cita existente.
4. **Cancelar evento (`deleteEvent`):** Elimina la cita del calendario.

### ¿Qué puedes modificar?
<ParamField path="connectionId" type="string" required>
  Tu cuenta o servicio de **Google Calendar** configurado.
</ParamField>

<ParamField path="calendarId" type="string" default="primary">
  Usa `primary` para tu calendario principal, o el correo de un calendario de equipo (ej. `citas@tuempresa.com`).
</ParamField>

<ParamField path="operation" type="enum" default="createEvent">
  Acción a realizar (`createEvent`, `listEvents`, `deleteEvent`, `updateEvent`).
</ParamField>

<ParamField path="title" type="string" optional>
  Título del evento (por ejemplo: `Asesoría con {user_name}`).
</ParamField>

<ParamField path="start" type="string" optional>
  Fecha y hora de inicio en formato estándar (por ejemplo: `{fecha_inicio}`).
</ParamField>

<ParamField path="end" type="string" optional>
  Fecha y hora de fin de la cita (por ejemplo: `{fecha_fin}`).
</ParamField>

<ParamField path="conferenceMeet" type="boolean" default="true">
  Genera automáticamente una sala virtual de **Google Meet**.
</ParamField>

<ParamField path="attendees" type="array" optional>
  Correos de los invitados que recibirán la invitación formal de Google:
  ```json
  [
    { "email": "{user_email}", "displayName": "{user_name}" }
  ]
  ```
</ParamField>

---

## 2. Cal.com Calendar Node

Si utilizas **Cal.com** para gestionar tus tipos de reuniones y disponibilidad de equipo, este nodo permite consultar espacios libres y reservar de inmediato.

### ¿Qué puedes modificar?
<ParamField path="connectionId" type="string" required>
  Tu conexión de Cal.com con clave API.
</ParamField>

<ParamField path="operation" type="enum" default="createBooking">
  Acción: `getAvailableSlots` (ver horarios libres), `createBooking` (agendar cita), `rescheduleBooking` o `cancelBooking`.
</ParamField>

<ParamField path="eventTypeId" type="string" optional>
  El tipo de evento o reunión configurado en tu cuenta de Cal.com.
</ParamField>

<ParamField path="attendeeName" type="string" optional>
  Nombre del asistente (por ejemplo: `{user_name}`).
</ParamField>

<ParamField path="attendeeEmail" type="string" optional>
  Correo del cliente que reserva la reunión.
</ParamField>

---

## 3. Agentic Calendar (asistente de calendario autónomo)

A diferencia de los nodos anteriores que requieren fechas fijas, el **Agentic Calendar** utiliza Inteligencia Artificial para negociar la cita con el cliente en lenguaje cotidiano (*"¿Tienes algún espacio el próximo jueves por la tarde?"*), consultar tu calendario y confirmar la mejor opción disponible.

<ParamField path="query" type="string" required>
  La solicitud del cliente o instrucción a interpretar (por ejemplo: `{user_message}`).
</ParamField>

<ParamField path="timeZone" type="string" default="America/Mexico_City">
  Zona horaria para calcular los horarios disponibles.
</ParamField>

---

## Google Docs Node
> URL: /es/nodes/google-docs
> llms.txt específico: /es/nodes/google-docs/llms.txt

import { ParamField, ResponseField } from '@site/src/components';

# Nodo: Google Docs

El nodo de **Google Docs** te permite leer el contenido de tus documentos, agregar notas al final de un archivo o generar contratos y cotizaciones reemplazando automáticamente etiquetas de texto.

![Generación Dinámica de Google Docs](/img/diagrams/nodes-google-docs.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Datos Capturados en el Chat] --> B[Nodo Google Docs]
    B -->|Reemplazar Etiquetas| C[Contrato o Propuesta Lista]
    B -->|Exito| D[Enviar Enlace al Cliente]
```

</details>

---

## Qué puedes hacer con este nodo

1. **Leer documento (`readDocument`):** Extrae el texto de un documento de Google para que tu asistente de IA pueda analizarlo o responder preguntas sobre él.
2. **Agregar texto (`appendText`):** Escribe nuevas notas, bitácoras o resúmenes al final de un documento existente.
3. **Reemplazar texto (`replaceText`):** Busca palabras clave en una plantilla (como `[CLIENTE]`) y las sustituye por los datos reales de la conversación.

---

## Campos de configuración

<ParamField path="connectionId" type="string" required>
  Tu conexión configurada de **Google Service Account**.
</ParamField>

<ParamField path="documentId" type="string" required>
  El identificador único de tu documento. Lo obtienes de la URL en tu navegador:
  `https://docs.google.com/document/d/`**`195j9eDD3thA495vD0KKC508YPNjFOO0GX64Zo2PP3hM`**`/edit`
</ParamField>

<ParamField path="operation" type="enum" default="replaceText">
  La acción a realizar: `readDocument` (Leer), `appendText` (Agregar texto) o `replaceText` (Reemplazar texto).
</ParamField>

<ParamField path="searchText" type="string" optional>
  La etiqueta que colocaste en tu plantilla de Google Docs, por ejemplo: `NOMBRE_CLIENTE` o `[NOMBRE_CLIENTE]`.
</ParamField>

<ParamField path="replaceText" type="string" optional>
  El valor real con el que se sustituirá la etiqueta, por ejemplo: `{user_name}`.
</ParamField>

<ParamField path="text" type="string" optional>
  Texto que deseas añadir al final del archivo si usas la operación `appendText`.
</ParamField>

<ParamField path="outputVariable" type="string" default="docs_resultado">
  Nombre de la variable donde se guardará el resultado de la operación.
</ParamField>

---

## Cómo crear documentos personalizados paso a paso

1. **Crea tu plantilla en Google Docs:** Escribe tu contrato o propuesta e inserta etiquetas fáciles de identificar, por ejemplo `[NOMBRE_CLIENTE]`, `[PRECIO]` y `[FECHA]`.
2. **Comparte el documento:** Haz clic en el botón **Compartir** en Google Docs y agrega el correo de tu cuenta de servicio de Google con rol de **Editor**.
3. **Configura el nodo:** Añade los nodos necesarios en tu flujo para sustituir cada etiqueta con la información recogida del usuario.
4. **Envía el resultado:** Notifica a tu cliente por WhatsApp o correo que su documento está listo.

---

## Google Sheets Node
> URL: /es/nodes/google-sheets
> llms.txt específico: /es/nodes/google-sheets/llms.txt

import { ParamField, ResponseField } from '@site/src/components';

# Nodo: Google Sheets

El nodo de **Google Sheets** permite que tu asistente guarde información de clientes, consulte datos existentes (como inventarios o estados de pedidos) y actualice registros en tus hojas de cálculo automáticamente.

![Hojas de Cálculo Google Sheets](/img/diagrams/nodes-google-sheets.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Datos del Cliente] --> B[Nodo Google Sheets]
    B -->|Guardar Fila| C[Hoja de Calculo Actualizada]
    B -->|Exito| D[Siguiente Paso del Flujo]
```

</details>

---

## Qué puedes hacer con este nodo

1. **Buscar filas (`findRows`):** Encuentra información de un cliente buscando por su teléfono, correo o número de orden.
2. **Insertar filas (`insertRows`):** Agrega un nuevo registro al final de tu hoja con los datos recogidos en la conversación.
3. **Actualizar filas (`updateRows`):** Cambia el valor de una columna (por ejemplo, cambiar el estado a "Atendido").
4. **Eliminar filas (`deleteRows`):** Remueve filas que cumplan una condición específica.

---

## Campos de configuración

<ParamField path="connectionId" type="string" required>
  Selecciona tu cuenta conectada de **Google Service Account**.
</ParamField>

<ParamField path="spreadsheetId" type="string" required>
  El identificador único de tu hoja de cálculo. Lo encuentras en la barra de direcciones de tu navegador:
  `https://docs.google.com/spreadsheets/d/`**`1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms`**`/edit`
</ParamField>

<ParamField path="worksheetName" type="string" optional>
  Nombre de la pestaña dentro del archivo (por ejemplo: `Prospectos`, `Ventas` o `Hoja 1`).
</ParamField>

<ParamField path="operation" type="enum" default="insertRows">
  La acción a realizar: `findRows` (Buscar), `insertRows` (Insertar), `updateRows` (Actualizar) o `deleteRows` (Eliminar).
</ParamField>

<ParamField path="rowsJson" type="array" optional>
  Datos que deseas agregar a la hoja. Las etiquetas deben coincidir con los nombres de tus columnas:
  ```json
  [
    {
      "Fecha": "{current_date}",
      "Nombre": "{user_name}",
      "Telefono": "{user_phone}",
      "Servicio": "{servicio_interes}"
    }
  ]
  ```
</ParamField>

<ParamField path="filtersJson" type="object" optional>
  Criterio de búsqueda para encontrar una fila específica:
  ```json
  {
    "Telefono": "{user_phone}"
  }
  ```
</ParamField>

<ParamField path="outputVariable" type="string" default="sheets_resultado">
  Nombre de la variable donde se guardará la respuesta para usarla en los siguientes bloques.
</ParamField>

---

## Ejemplos prácticos

### Ejemplo 1: Guardar un nuevo contacto desde WhatsApp
Cuando un usuario termina de registrar sus datos en el chat, el nodo agrega una nueva fila en tu hoja:

- **Operación:** `insertRows`
- **ID de la Hoja:** Tu ID de Google Sheets
- **Pestaña:** `Prospectos`
- **Datos a insertar:**
  ```json
  [
    {
      "Fecha": "{current_date}",
      "Nombre": "{user_name}",
      "Telefono": "{user_phone}",
      "Estado": "Nuevo"
    }
  ]
  ```

---

### Ejemplo 2: Consultar el estado de un pedido
Para responder a un cliente sobre el estado de su entrega:

1. Buscas la fila con su número de guía:
   ```json
   {
     "NumeroGuia": "{numero_guia}"
   }
   ```
2. En el mensaje siguiente respondes:
   ```text
   Hola {sheets_resultado.rows.0.values.Nombre}, el estado de tu pedido es: {sheets_resultado.rows.0.values.Estado}.
   ```

---

## Permiso importante en Google Drive

:::important Compartir la hoja con tu cuenta de servicio
Para que Convoflow pueda escribir o leer en tu hoja, abre el archivo en Google Sheets, haz clic en el botón **Compartir** y agrega el correo de tu cuenta de servicio (con terminación `@...gserviceaccount.com`) con rol de **Editor**.
:::

---

## HTTP y peticiones a sistemas
> URL: /es/nodes/http
> llms.txt específico: /es/nodes/http/llms.txt

import { ParamField, ResponseField } from '@site/src/components';

# Nodo: HTTP y conexión a sistemas

El nodo **HTTP** te permite comunicar Convoflow con tus propios sistemas, tiendas en línea (Shopify, WooCommerce), plataformas de pago o sistemas de gestión (CRM, ERP).

---

## Campos de configuración

<ParamField path="url" type="string" required>
  La dirección web de la API o sistema a consultar (por ejemplo: `https://api.tuempresa.com/pedidos/{id_pedido}`).
</ParamField>

<ParamField path="method" type="enum" default="GET">
  El tipo de acción:
  - `GET`: Para consultar y obtener datos.
  - `POST`: Para enviar o registrar nuevos datos.
  - `PUT` / `PATCH`: Para actualizar información existente.
  - `DELETE`: Para eliminar un registro.
</ParamField>

<ParamField path="connectionId" type="string" optional>
  Si tu sistema requiere credenciales guardadas de forma segura, selecciona tu conexión de [Webhooks y HTTP APIs](/es/connections/webhooks-http).
</ParamField>

<ParamField path="bodyJson" type="string | object" optional>
  Datos que enviarás al sistema (para métodos `POST` o `PUT`):
  ```json
  {
    "cliente": "{user_name}",
    "telefono": "{user_phone}",
    "total": "{total_pedido}"
  }
  ```
</ParamField>

<ParamField path="outputVariable" type="string" default="resultado_sistema">
  Variable donde se guardará la respuesta que devuelva tu sistema.
</ParamField>

---

## Atención humana y equipos
> URL: /es/nodes/human-handoff
> llms.txt específico: /es/nodes/human-handoff/llms.txt

import { ParamField } from '@site/src/components';

# Nodos: Atención humana y equipos

La Inteligencia Artificial es excelente para resolver dudas frecuentes, pero hay momentos donde un cliente necesita hablar con una persona de tu equipo, o donde una acción delicada requiere la autorización de un supervisor.

![Transferencia a Asesor Humano](/img/diagrams/nodes-human-handoff-transfer.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Cliente pide ayuda compleja] --> B[Nodo: Human Handoff]
    B -->|Pausa el bot| C[Asesor responde en el CRM]
    C -->|Opcional: Reanudar| D[Bot retoma la conversación]
```

</details>

---

## 1. Human Handoff (transferencia a asesor)

Pausa la automatización del bot y deja la conversación en la bandeja de entrada de tu equipo humano dentro del CRM de Convoflow.

### ¿Cuándo usarlo?
- Cuando el cliente escribe *"quiero hablar con una persona"*.
- Si el usuario presenta una queja o un reclamo urgente.
- Cuando la IA detecta que no tiene información suficiente para resolver el problema.

### ¿Qué puedes modificar?
<ParamField path="message" type="string" optional>
  Mensaje de despedida o espera que verá el cliente antes de la transferencia (por ejemplo: *Te estoy comunicando con uno de nuestros asesores, por favor espera un momento*).
</ParamField>

<ParamField path="notifyChannel" type="enum" default="none">
  Canal donde avisar a tu equipo de la nueva transferencia:
  - `slack`: Envía una alerta a un canal de Slack.
  - `whatsapp`: Envía una alerta a un número de WhatsApp del equipo.
  - `email`: Notifica por correo electrónico.
  - `none`: Solo marca la conversación en el CRM sin enviar alertas externas.
</ParamField>

<ParamField path="notifyTarget" type="string" optional>
  El destino de la notificación (por ejemplo `#soporte-urgente`, `asesor@empresa.com` o `+52155...`).
</ParamField>

<ParamField path="notifyMessage" type="string" optional>
  Texto de la alerta para tu equipo (por ejemplo: `Nuevo cliente transferido: {user_name} necesita ayuda con {tema_consulta}`).
</ParamField>

<ParamField path="resumeOnReply" type="boolean" default="false">
  Si activas esta opción, cuando el asesor humano envíe su mensaje desde el CRM, el flujo se reactivará automáticamente para continuar con los siguientes pasos.
</ParamField>

---

## 2. Approval Node (aprobación por supervisor)

Detiene temporalmente el flujo para que un gerente o supervisor autorice una acción importante antes de que se ejecute (por ejemplo: un descuento mayor al 20% o una devolución de dinero).

![Aprobación Humana de Solicitudes](/img/diagrams/nodes-human-handoff-approval.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph TD
    A[Solicitud de Descuento] --> B[Nodo de Aprobacion]
    B -->|Aprobado| C[Aplicar Descuento y Notificar]
    B -->|Rechazado| D[Informar al Cliente amablemente]
```

</details>

### Salidas en el lienzo:
- **Aprobado (`approved`):** El camino que sigue si el supervisor responde que sí o aprueba la solicitud.
- **Rechazado (`rejected`):** El camino si el supervisor deniega la petición.

### ¿Qué puedes modificar?
<ParamField path="approvalRole" type="string" default="manager">
  El rol o departamento que debe autorizar la acción (por ejemplo: `supervisor`, `gerente_ventas`, `administrador`).
</ParamField>

<ParamField path="prompt" type="string" optional>
  Pregunta o detalle que se le mostrará al supervisor para que decida (por ejemplo: `¿Autorizas el descuento especial de {monto_descuento} para {user_name}?`).
</ParamField>

<ParamField path="outputVariable" type="string" default="approval_resultado">
  Variable donde se registra la respuesta exacta o comentario del supervisor.
</ParamField>

---

## 3. Assign Role (asignar rol en CRM)

Etiqueta la conversación para que aparezca asignada a un departamento específico dentro del CRM (como Ventas, Soporte Técnico, Cobranzas o Facturación).

### ¿Qué puedes modificar?
<ParamField path="role" type="string" required>
  El nombre del rol o equipo al que pertenecerá la conversación (por ejemplo: `ventas`, `soporte`, `facturacion`).
</ParamField>

<ParamField path="outputVariable" type="string" optional>
  Nombre de la variable opcional donde se guardará el rol asignado.
</ParamField>

---

## Catálogo de nodos
> URL: /es/nodes
> llms.txt específico: /es/nodes/llms.txt

import { Card, CardGrid } from '@site/src/components';

# Nodos y bloques de construcción

Los **Nodos** son los bloques visuales que arrastras y conectas en el lienzo de Convoflow para crear la experiencia de tus usuarios. Cada nodo realiza una tarea puntual: enviar un mensaje, hacer una pregunta, consultar una base de datos, cobrar con tarjeta o tomar una decisión con Inteligencia Artificial.

![Panorama General de Nodos](/img/diagrams/nodes-overview.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Mensaje Entrante] --> B[Preguntar Nombre]
    B --> C[Asistente IA]
    C -->|Agendar| D[Crear Cita en Calendar]
    D -->|Exito| E[Confirmar por WhatsApp]
    D -->|Si no hay cupo| F[Enviar Correo a Asesor]
```

</details>

---

## Cómo funcionan los nodos en el Designer

### 1. El diseñador como aliado visual
El **Designer** de Convoflow te permite diseñar y armar flujos conversacionales de forma rápida y visual. Esta documentación sirve como **guía de referencia** para que conozcas qué hace cada nodo y qué campos puedes modificar cuando abras el panel lateral de propiedades.

### 2. Reutilizar datos de la conversación
Cualquier dato capturado en un paso anterior (nombre del cliente, correo, saldo, etc.) se puede insertar en mensajes o correos usando llaves `{}`:

```text
Hola {user_name}, confirmamos tu cita para el {fecha_cita} a las {hora_cita}.
```

### 3. Rutas de éxito y rutas de respaldo
Cada bloque cuenta con salidas visuales en el lienzo:
- **Ruta principal (Éxito):** Se ejecuta cuando la acción se completa correctamente.
- **Ruta de respaldo (Error o Fallo):** Te permite definir qué mensaje enviar o qué camino tomar si algo no sale como se esperaba (por ejemplo, si un servicio externo no responde).

---

## Catálogo completo de nodos

<CardGrid cols={2}>
  <Card title="Inicio, fin y disparadores" icon="start" to="/nodes/triggers" badge="Flujo">
    Aprende cómo arranca y termina tu flujo, y cómo activarlo por WhatsApp, correo o calendario.
  </Card>
  <Card title="WhatsApp y mensajes" icon="whatsapp" to="/nodes/whatsapp" badge="Canales">
    Envía mensajes de texto, fotos, audios y botones interactivos oficiales de WhatsApp.
  </Card>
  <Card title="Pregunta, espera y variables" icon="question" to="/nodes/question" badge="Entrada">
    Pide datos al usuario con validación automática y gestiona variables del flujo.
  </Card>
  <Card title="Asistente IA y agentes" icon="bot" to="/nodes/agent" badge="IA">
    Asistente autónomo con memoria, capacidad de razonar y herramientas visuales subflujo.
  </Card>
  <Card title="Base de conocimiento y documentos" icon="brain" to="/nodes/knowledge" badge="Documentos">
    Responde dudas usando manuales en PDF, investiga en la web o procesa facturas con Document AI.
  </Card>
  <Card title="Lógica, decisiones y reglas" icon="logic" to="/nodes/logic" badge="Control">
    Dirige al usuario por diferentes caminos según condiciones, intenciones con IA o menús de opciones.
  </Card>
  <Card title="Atención humana y equipos" icon="help" to="/nodes/human-handoff" badge="Equipo">
    Transfiere conversaciones a asesores humanos, solicita aprobaciones y asigna roles en el CRM.
  </Card>
  <Card title="Slack y Discord" icon="chat" to="/nodes/team-chat" badge="Alertas">
    Envía avisos de nuevos prospectos, notificaciones de compras y alertas a canales internos.
  </Card>
  <Card title="Pagos y cobros" icon="key" to="/nodes/payments" badge="Comercio">
    Cobra productos y servicios con Stripe y Recurrente con botón interactivo de WhatsApp.
  </Card>
  <Card title="Verificación y seguridad" icon="check" to="/nodes/verification" badge="Seguridad">
    Envía códigos de verificación OTP por SMS y valida identidades oficiales con KYC biométrico.
  </Card>
  <Card title="Agendamiento y calendarios" icon="calendar" to="/nodes/google-calendar" badge="Citas">
    Revisa horarios disponibles y agenda citas en Google Calendar, Cal.com o con agentes inteligentes.
  </Card>
  <Card title="Google Sheets" icon="sheets" to="/nodes/google-sheets" badge="Google">
    Lee, agrega, edita o elimina filas en tus hojas de cálculo en tiempo real.
  </Card>
  <Card title="Google Docs" icon="docs" to="/nodes/google-docs" badge="Google">
    Genera contratos y cotizaciones reemplazando plantillas de texto automáticamente.
  </Card>
  <Card title="Email y correo" icon="email" to="/nodes/email" badge="Correo">
    Envía correos automáticos personalizados con plantillas de diseño y archivos adjuntos.
  </Card>
  <Card title="CRM y tiendas online" icon="cpu" to="/nodes/crm-ecommerce" badge="Integraciones">
    Sincroniza datos con HubSpot CRM, pedidos de Shopify, tiendas WooCommerce, Airtable y Notion.
  </Card>
  <Card title="Bases de datos y código" icon="database" to="/nodes/databases-code" badge="Datos">
    Guarda información en tablas internas de Convoflow, conecta PostgreSQL, Supabase o ejecuta JavaScript.
  </Card>
  <Card title="HTTP y APIs" icon="http" to="/nodes/http" badge="Sistemas">
    Conecta tu flujo con cualquier sistema, CRM o base de datos externa mediante llamadas REST.
  </Card>
</CardGrid>

---

## Base de conocimiento y documentos
> URL: /es/nodes/knowledge
> llms.txt específico: /es/nodes/knowledge/llms.txt

import { ParamField } from '@site/src/components';

# Nodos: Conocimiento y análisis de documentos

Tu asistente de IA necesita responder con información verídica y específica de tu negocio. Con estos nodos puedes conectarlo a tus manuales corporativos, permitirle investigar en la web o extraer datos de archivos que los clientes te envíen.

![Base de Conocimiento y RAG Vectorial](/img/diagrams/nodes-knowledge-rag.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Pregunta o Archivo del Cliente] --> B[Nodo de Conocimiento / Documentos]
    B -->|Buscar informacion precisa| C[Fragmentos encontrados]
    C --> D[Respuesta certera del Asistente]
```

</details>

---

## 1. Knowledge RAG (base de conocimiento)

Permite buscar respuestas dentro de documentos que hayas subido a Convoflow (archivos PDF, manuales de servicio, políticas de garantía o catálogos).

### ¿Cómo funciona?
Cuando el usuario hace una pregunta, este nodo busca únicamente en tus documentos y extrae los fragmentos más relevantes para que el asistente responda con datos exactos y sin inventar información.

### ¿Qué puedes modificar?
<ParamField path="query" type="string" required>
  La pregunta o tema a buscar (generalmente `{user_message}` o la duda del cliente).
</ParamField>

<ParamField path="collection" type="string" optional>
  Nombre de la colección o grupo de documentos donde deseas buscar.
</ParamField>

<ParamField path="topK" type="number" default="4">
  Cantidad de fragmentos o párrafos relevantes que se extraerán para formular la respuesta.
</ParamField>

<ParamField path="outputVariable" type="string" default="conocimiento_resultado">
  Variable donde se guarda la información encontrada para alimentar al asistente en los siguientes pasos.
</ParamField>

---

## 2. Document AI (lectura de documentos y facturas)

Utiliza modelos de visión artificial para leer y extraer texto estructurado de archivos que te envían tus clientes (como comprobantes de pago, cotizaciones en PDF o imágenes de contratos).

### ¿Cuándo usarlo?
- Cuando un cliente te envía una foto de un recibo o depósito bancario y necesitas extraer el monto y la fecha.
- Para procesar formularios escaneados automáticamente.

### ¿Qué puedes modificar?
<ParamField path="inputFilesVariable" type="string" required>
  Variable donde se guardó el archivo o imagen enviado por el usuario.
</ParamField>

<ParamField path="processorId" type="string" optional>
  El identificador del procesador de documentos (por ejemplo para facturas, recibos o formularios).
</ParamField>

<ParamField path="outputVariable" type="string" default="documento_extraido">
  Variable con el texto y datos ordenados que se extrajeron del archivo.
</ParamField>

---

## 3. Web Search (búsqueda e investigación web)

Permite que el flujo busque información pública en internet o rastree páginas web específicas para recopilar datos frescos.

### ¿Qué puedes modificar?
<ParamField path="searchQuery" type="string" optional>
  Término de búsqueda o pregunta a investigar en la web.
</ParamField>

<ParamField path="startUrls" type="string" optional>
  Direcciones web iniciales que deseas que el bot examine (por ejemplo: `https://tusitio.com/precios`).
</ParamField>

<ParamField path="outputVariable" type="string" default="web_resultado">
  Variable donde se almacena el contenido encontrado.
</ParamField>

---

## Lógica, decisiones y reglas
> URL: /es/nodes/logic
> llms.txt específico: /es/nodes/logic/llms.txt

import { ParamField } from '@site/src/components';

# Nodos: Lógica, decisiones y reglas

No todas las conversaciones son iguales: un cliente nuevo necesita una bienvenida diferente a la de un usuario registrado, y una consulta sobre precios toma un rumbo distinto a un reclamo urgente. Estos nodos te permiten crear bifurcaciones y verificar reglas de negocio.

![Decisión Condicional y Bifurcación](/img/diagrams/nodes-logic-decision.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph TD
    A[Pregunta del Cliente] --> B{Nodo de Decision}
    B -->|Camino 1: Consulta General| C[Responder con Precios]
    B -->|Camino 2: Cliente Molesto| D[Pasar a Asesor Humano]
```

</details>

---

## 1. Condition Node (condición sí / no)

Evalúa una regla fija basada en los datos de la conversación y divide el camino en dos salidas: **Sí (True)** o **No (False)**.

### ¿Cuándo usarlo?
- Si el monto es mayor a $100: ofrecer envío gratis.
- Si el país es México: mostrar precios en Pesos; en caso contrario, mostrar Dólares.

### Salidas en el lienzo:
- **True (Verdadero):** Camino que sigue si la condición se cumple.
- **False (Falso):** Camino alternativo si la condición no se cumple.

### ¿Qué puedes modificar?
<ParamField path="condition" type="string" required>
  La regla a evaluar usando variables entre comillas y llaves:
  - `"{saldo}" > 0`
  - `"{pais}" === "Mexico"`
  - `"{edad}" >= 18`
</ParamField>

---

## 2. Smart Condition Node (condición inteligente con IA)

A diferencia de la condición matemática simple, la **Smart Condition** utiliza Inteligencia Artificial para entender el tono, intención o sentimiento del cliente cuando escribe con sus propias palabras.

### Ejemplos de uso:
- *¿El usuario está expresando molestia o quejas?*
- *¿El cliente está listo para comprar o solo tiene curiosidad?*
- *¿El usuario prefiere atención virtual o presencial?*

### ¿Qué puedes modificar?
<ParamField path="condition" type="string" required>
  La pregunta o criterio en lenguaje natural que la IA debe evaluar (por ejemplo: *¿El cliente tiene urgencia médica inmediata?*).
</ParamField>

<ParamField path="contextVariables" type="array" optional>
  Variables que la IA debe leer para tomar la decisión (por ejemplo: `user_message`, `historial_chat`).
</ParamField>

---

## 3. Switch Node (menú de varias opciones)

Compara el valor de una variable contra múltiples opciones fijas y crea una salida en el lienzo para cada opción.

![Switch Multiruta de Menú](/img/diagrams/nodes-logic-switch.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    SW[Switch: Opcion de Menu] -->|Caso: 1| V[Ruta de Ventas]
    SW -->|Caso: 2| S[Ruta de Soporte]
    SW -->|Caso: 3| F[Ruta de Facturacion]
    SW -->|Default| D[Opcion no reconocida]
```

</details>

### ¿Qué puedes modificar?
<ParamField path="switchVariable" type="string" required>
  La variable a examinar (por ejemplo: `{opcion_seleccionada}`).
</ParamField>

<ParamField path="switchCases" type="array" required>
  Lista de casos posibles (por ejemplo: `ventas`, `soporte`, `pagos`). Cada caso creará un conector individual en el bloque.
</ParamField>

<ParamField path="switchDefaultEnabled" type="boolean" default="true">
  Habilita una salida de respaldo (*Default*) para cuando el valor no coincida con ninguna de las opciones anteriores.
</ParamField>

---

## 4. Policy Gate (puerta de validación y políticas)

Verifica que el usuario haya cumplido con una serie de requisitos antes de permitirle avanzar a un paso crítico (como contratar un servicio o solicitar un préstamo).

### ¿Qué puedes modificar?
<ParamField path="requiredVariables" type="array" optional>
  Lista de datos que **obligatoriamente** deben estar llenos (por ejemplo: `user_name`, `user_email`, `documento_id`).
</ParamField>

<ParamField path="minProgressPercent" type="number" optional>
  Porcentaje mínimo de avance requerido en el proceso (por ejemplo: `80%`).
</ParamField>

---

## 5. Checkpoint Node (punto de control y calificación)

Mide qué tan completo está el perfil de un cliente a medida que avanza en el flujo y calcula un porcentaje de calificación (Lead Qualification).

<ParamField path="checkpointName" type="string" optional>
  Nombre identificador del hito (por ejemplo: `calificacion_prospecto`).
</ParamField>

<ParamField path="trackedVariables" type="array" optional>
  Las variables que suman puntos al completarse (nombre, correo, empresa, presupuesto).
</ParamField>

---

## 6. Await Resume Node (Pausa a la espera de un sistema externo)

Detiene la conversación y espera a que un sistema externo envíe una notificación por webhook para continuar. Ideal para procesos que tardan varios minutos u horas (como la validación manual de un crédito o una aprobación bancaria).

---

## Pagos y cobros
> URL: /es/nodes/payments
> llms.txt específico: /es/nodes/payments/llms.txt

import { ParamField } from '@site/src/components';

# Nodos: Pagos y cobros (Stripe y Recurrente)

Los nodos de pago permiten que tu asistente cobre productos, servicios o anticipos directamente dentro de la conversación. Además, pueden pausar el flujo mientras el cliente realiza el pago y reanudarlo al instante cuando la pasarela confirma la transacción.

![Pasarelas de Pago Stripe y Recurrente](/img/diagrams/nodes-payments.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Cliente confirma pedido] --> B[Nodo de Pago: Stripe / Recurrente]
    B -->|Boton CTA en WhatsApp| C[Cliente paga con tarjeta]
    C -->|Webhook confirma pago| D[Continuar Flujo: Entregar Pedido]
    C -->|Si cancela o falla| E[Ofrecer alternativa de pago]
```

</details>

---

## 1. Stripe Payment Node

Genera una sesión segura de **Stripe Checkout** para pagos internacionales con tarjeta de crédito, débito, Apple Pay o Google Pay.

### ¿Cómo funciona en WhatsApp?
Si activas la opción **Esperar Pago (`waitForPayment`)**, el asistente enviará un botón interactivo de WhatsApp (*"Pagar Ahora"*). Al tocarlo, se abre una ventana segura de pago. Una vez que el cliente paga, el flujo continúa automáticamente sin intervención manual.

### ¿Qué puedes modificar?
<ParamField path="connectionId" type="string" required>
  Tu cuenta conectada de Stripe.
</ParamField>

<ParamField path="productName" type="string" required>
  Nombre del concepto o producto que aparecerá en la pantalla de cobro (por ejemplo: `Reserva de Cita - {user_name}`).
</ParamField>

<ParamField path="amountInCents" type="number" required>
  El precio expresado en **centavos** (por ejemplo: para cobrar `$25.00`, escribe `2500`; para `$100.00`, escribe `10000`).
</ParamField>

<ParamField path="currency" type="string" default="usd">
  Código de la moneda en minúsculas (por ejemplo: `usd`, `mxn`, `eur`).
</ParamField>

<ParamField path="waitForPayment" type="boolean" default="true">
  - **Activado (Recomendado):** El flujo se detiene temporalmente y espera a que Stripe confirme el pago para continuar hacia la rama de éxito.
  - **Desactivado:** Solo genera el enlace de pago y continúa de inmediato sin esperar la confirmación.
</ParamField>

<ParamField path="buttonText" type="string" default="Pagar Ahora">
  Texto del botón que verá el cliente en WhatsApp (máximo 20 caracteres).
</ParamField>

<ParamField path="paymentMessage" type="string" optional>
  Mensaje que acompaña al botón de pago (por ejemplo: *Aquí tienes el enlace seguro para confirmar tu pedido:*).
</ParamField>

---

## 2. Recurrente Payment Node

Diseñado para procesar pagos locales en **Guatemala y Centroamérica** (en Quetzales `GTQ` o Dólares `USD`) mediante la plataforma Recurrente.

### ¿Qué puedes modificar?
<ParamField path="connectionId" type="string" required>
  Tu cuenta conectada de Recurrente.
</ParamField>

<ParamField path="action" type="enum" default="create_one_time_checkout">
  Tipo de cobro:
  - `create_one_time_checkout`: Cobro único puntual (por ejemplo un producto o servicio).
  - `create_checkout`: Cobro sobre un producto ya registrado en tu catálogo de Recurrente.
</ParamField>

<ParamField path="amountInCents" type="number" required>
  Monto en centavos (por ejemplo: `10000` para Q100.00 o $100.00).
</ParamField>

<ParamField path="currency" type="enum" default="GTQ">
  Moneda de cobro: `GTQ` (Quetzales) o `USD` (Dólares).
</ParamField>

<ParamField path="waitForPayment" type="boolean" default="true">
  Pausa la conversación hasta recibir la confirmación de pago por webhook.
</ParamField>

<ParamField path="successVariable" type="string" default="pago_resultado">
  Variable donde se guardará el comprobante y los datos de la transacción exitosa.
</ParamField>

---

## Pregunta, espera y variables
> URL: /es/nodes/question
> llms.txt específico: /es/nodes/question/llms.txt

import { ParamField } from '@site/src/components';

# Nodos: Preguntas, captura y variables

Para brindar una atención personalizada necesitas pedir datos al cliente (como su nombre, correo o fecha deseada), pausar el flujo hasta que responda y guardar esos datos en variables que puedas reutilizar después.

![Pregunta y Captura de Variables](/img/diagrams/nodes-question.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Preguntar Nombre] -->|Espera respuesta| B[Guardar en {user_name}]
    B --> C[Mensaje de Confirmación]
```

</details>

---

## 1. Question Node (hacer pregunta al cliente)

Hace una pregunta al usuario y guarda automáticamente su respuesta en una variable. Además, la Inteligencia Artificial se encarga de entender la respuesta aunque el usuario responda con rodeos o frases largas.

### ¿Qué puedes modificar?
<ParamField path="question" type="string" required>
  La pregunta que se formulará al usuario (por ejemplo: *¿A qué correo te enviamos la confirmación?*).
</ParamField>

<ParamField path="variableName" type="string" required>
  El nombre de la variable donde se guardará el dato (por ejemplo: `user_email`).
  > **Extracción múltiple:** Si preguntas *"Dime tu nombre, correo y teléfono"*, puedes escribir `nombre, correo, telefono` en este campo y la IA separará los tres datos automáticamente.
</ParamField>

<ParamField path="verbatimQuestion" type="boolean" default="false">
  - **Desactivado (Recomendado):** La IA adapta la redacción de la pregunta de manera cordial y fluida según el contexto de la conversación.
  - **Activado:** Envía la pregunta exactamente con las palabras que escribiste, sin refrasear.
</ParamField>

<ParamField path="validations" type="array" optional>
  Reglas que debe cumplir la respuesta (por ejemplo: *Debe ser un correo electrónico válido* o *Debe ser un número de teléfono de 8 a 10 dígitos*). Si el usuario escribe algo incorrecto, la IA le pedirá amablemente que lo corrija.
</ParamField>

<ParamField path="immediateText" type="string" optional>
  Mensaje de agradecimiento o confirmación que se envía inmediatamente después de recibir el dato (por ejemplo: *¡Gracias por la información!*).
</ParamField>

---

## 2. Wait Input Node (pausa y espera de mensaje)

Detiene la ejecución del flujo y queda a la espera de que el usuario envíe su siguiente mensaje en el chat. Cuando el mensaje llega, lo guarda en una variable y continúa al siguiente bloque.

### ¿Qué puedes modificar?
<ParamField path="variableName" type="string" required>
  Variable donde se guardará el mensaje escrito por el usuario (por ejemplo: `mensaje_esperado`).
</ParamField>

<ParamField path="waitPrompt" type="string" optional>
  Mensaje opcional que se muestra mientras el sistema espera la respuesta del usuario.
</ParamField>

---

## 3. Set Variable (asignar o modificar variable)

Crea una variable nueva o cambia el valor de una existente sin necesidad de interactuar con el usuario.

### ¿Cuándo usarlo?
- Marcar el estado de un lead: `estado_cliente = "calificado"`.
- Asignar una fecha por defecto: `origen = "campaña_facebook"`.
- Limpiar o reiniciar un valor antes de un nuevo proceso.

### ¿Qué puedes modificar?
<ParamField path="setVariableName" type="string" required>
  Nombre de la variable a crear o modificar (por ejemplo: `tipo_cliente`).
</ParamField>

<ParamField path="setVariableValue" type="string" required>
  El valor que deseas asignarle. Puede ser un texto fijo o incluir otras variables: `VIP - {plan_elegido}`.
</ParamField>

---

## 4. Connector Node (atajo visual en el lienzo)

Cuando tienes un flujo grande, conectar dos nodos que están muy lejos en el lienzo puede crear líneas cruzadas difíciles de leer. El **Connector Node** funciona como un "portal": seleccionas el nodo de destino de una lista desplegable y el flujo saltará directamente hacia allá.

---

## Slack y Discord
> URL: /es/nodes/team-chat
> llms.txt específico: /es/nodes/team-chat/llms.txt

import { ParamField } from '@site/src/components';

# Nodos: Slack y Discord (alertas internas)

Mantener al equipo informado en tiempo real es clave. Con los nodos de **Slack** y **Discord**, tu flujo puede avisar al canal de ventas cuando un lead calificado completa el formulario, o alertar a soporte si un cliente reporta una incidencia.

![Notificaciones a Slack y Discord](/img/diagrams/nodes-team-chat.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Cliente agenda cita o compra] --> B[Nodo Slack o Discord]
    B -->|Mensaje Enviado| C[Canal interno de tu equipo]
    B -->|Si ocurre un error| D[Camino de Respaldo]
```

</details>

---

## 1. Slack Node

Envía un mensaje formateado a cualquier canal público o privado de tu espacio de trabajo en Slack.

### ¿Cuándo usarlo?
- Avisar a `#leads-nuevos` cuando alguien deja sus datos en WhatsApp.
- Notificar a `#pagos` cuando una compra se completa con éxito.
- Enviar un resumen de la conversación a un hilo específico (`thread`).

### Salidas en el lienzo:
- **Salida principal (Éxito):** Continúa normalmente cuando el mensaje se publicó en Slack.
- **Salida de error:** Te permite definir qué hacer si el canal no existe o la conexión falló.

### ¿Qué puedes modificar?
<ParamField path="connectionId" type="string" optional>
  Tu conexión registrada de Slack en la sección de Conexiones.
</ParamField>

<ParamField path="channel" type="string" required>
  El nombre del canal (por ejemplo: `#ventas`) o el ID interno del canal de Slack.
</ParamField>

<ParamField path="text" type="string" required>
  El mensaje que verá tu equipo. Puedes usar formato con asteriscos (`*negrita*`) y variables del flujo:
  ```text
  🚀 *Nuevo Lead Calificado*
  - Nombre: {user_name}
  - Teléfono: {user_phone}
  - Interés: {plan_seleccionado}
  ```
</ParamField>

<ParamField path="thread_ts" type="string" optional>
  Si deseas responder dentro de un hilo existente, coloca aquí el identificador del mensaje principal.
</ParamField>

---

## 2. Discord Node

Envía alertas a un canal de Discord mediante tu Bot o mediante un enlace de Webhook.

### ¿Qué puedes modificar?
<ParamField path="channelId" type="string" optional>
  El ID del canal de Discord donde deseas publicar (cuando usas un Bot conectado).
</ParamField>

<ParamField path="webhookUrl" type="string" optional>
  Si prefieres no usar un bot, puedes pegar directamente la URL de un Webhook de Discord.
</ParamField>

<ParamField path="content" type="string" required>
  El texto del mensaje que se publicará en el servidor. Admite variables como `{user_name}` y emojis.
</ParamField>

<ParamField path="username" type="string" optional>
  Nombre visible con el que aparecerá el bot en Discord (por ejemplo: `Convoflow Bot`).
</ParamField>

---

## Inicio, fin y disparadores
> URL: /es/nodes/triggers
> llms.txt específico: /es/nodes/triggers/llms.txt

import { ParamField } from '@site/src/components';

# Nodos: Inicio, fin y disparadores

Todo flujo en Convoflow necesita un punto de partida y un punto de llegada. Además de iniciar conversaciones manualmente o por chat, puedes hacer que tus flujos se activen solos mediante **Disparadores (Triggers)** cuando ocurre un evento externo.

![Disparadores y Triggers de Flujo](/img/diagrams/nodes-triggers.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Disparador: Mensaje de WhatsApp] --> B[Nodo de Inicio]
    B --> C[Pasos de tu Asistente...]
    C --> D[Nodo de Fin]
```

</details>

---

## 1. Start Node (nodo de inicio)

Es el bloque que marca dónde empieza a correr la conversación. Cuando un usuario interactúa con tu asistente, el flujo arranca desde este nodo y sigue la línea conectada.

### ¿Qué puedes modificar?
- **Etiqueta (Label):** Un nombre descriptivo para identificarlo en tu lienzo (por ejemplo, *Inicio de atención al cliente*).

> **Consejo de diseño:** Solo necesitas **un nodo de inicio** por flujo principal. Conéctalo al primer bloque que debe hablar con el usuario (como un saludo o una pregunta).

---

## 2. End Node (nodo de fin)

Marca la conclusión definitiva del flujo. Cuando la conversación llega a este nodo, el sistema da por terminado el proceso actual.

### ¿Cuándo usarlo?
- Al despedir al usuario tras completar una compra o agendar una cita.
- Al transferir al cliente a un asesor humano.
- En cualquier rama donde ya no sea necesario realizar más acciones.

---

## 3. WhatsApp Trigger (disparador por WhatsApp)

Permite que el flujo despierte automáticamente cuando entra un mensaje a tu número de WhatsApp. 

### ¿Qué puedes modificar?
<ParamField path="connectionId" type="string" optional>
  Selecciona la cuenta de WhatsApp que escuchará los mensajes entrantes. Si tienes un solo número conectado, el designer lo asociará por defecto.
</ParamField>

<ParamField path="textContains" type="string" optional>
  Palabra clave o frase que debe contener el mensaje para activar este flujo (por ejemplo: *hola*, *info*, *precios*). Si lo dejas vacío, se activará con cualquier mensaje.
</ParamField>

<ParamField path="messageVariable" type="string" default="incoming_message">
  Nombre de la variable donde se guardará el texto que escribió el usuario, para que puedas leerlo en los siguientes nodos usando `{incoming_message}`.
</ParamField>

<ParamField path="fromVariable" type="string" default="user_phone">
  Variable donde se guardará el número de teléfono del cliente que te escribió.
</ParamField>

---

## 4. Email Trigger (disparador por correo)

Inicia el flujo de forma automática cuando recibes un correo electrónico que cumple ciertas reglas o filtros.

### ¿Cuándo usarlo?
- Para responder automáticamente a consultas que llegan a `ventas@tuempresa.com`.
- Para extraer datos de facturas o notificaciones por correo y guardarlos en una hoja de cálculo.

### ¿Qué puedes modificar?
<ParamField path="fromFilter" type="string" optional>
  Filtra correos que provengan de un remitente específico o dominio (por ejemplo: `@proveedor.com`).
</ParamField>

<ParamField path="subjectContains" type="string" optional>
  Texto que debe estar presente en el asunto del correo (por ejemplo: *Solicitud de cotización*).
</ParamField>

<ParamField path="subjectVariable" type="string" default="email_subject">
  Variable donde se guarda el asunto del correo recibido.
</ParamField>

<ParamField path="bodyVariable" type="string" default="email_body">
  Variable donde se guarda el contenido del mensaje recibido.
</ParamField>

---

## 5. Schedule Trigger (disparador programado)

Permite ejecutar un flujo de forma periódica en un horario definido, sin que un usuario tenga que escribirte primero.

### ¿Cuándo usarlo?
- Para enviar recordatorios de pago todas las mañanas a las 9:00 AM.
- Para generar un reporte semanal de ventas y enviarlo a tu equipo por Slack o correo.

### ¿Qué puedes modificar?
<ParamField path="scheduleType" type="enum" default="daily_time">
  Modalidad de programación:
  - **Diario a una hora (`daily_time`):** Elige una hora fija todos los días (por ejemplo `09:00`).
  - **Cada X minutos (`interval_minutes`):** Se ejecuta cada 15, 30 o 60 minutos.
  - **Avanzado (`cron`):** Expresión de calendario para reglas más específicas (por ejemplo, solo de lunes a viernes).
</ParamField>

<ParamField path="timeZone" type="string" default="America/Mexico_City">
  Tu zona horaria local para que las horas coincidan con tu país.
</ParamField>

---

## Verificación de identidad y OTP
> URL: /es/nodes/verification
> llms.txt específico: /es/nodes/verification/llms.txt

import { ParamField } from '@site/src/components';

# Nodos: Verificación y seguridad

Cuando tu negocio maneja operaciones financieras, contratación de servicios o acceso a cuentas privadas, necesitas asegurarte de que el usuario es quien dice ser. Estos nodos gestionan todo el ciclo de validación de forma guiada y automática.

![Verificación OTP e Identidad](/img/diagrams/nodes-verification.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Usuario solicita trámite sensible] --> B[Nodo de Verificación]
    B -->|Verificado| C[Continuar Trámite Seguro]
    B -->|Intentos agotados| D[Bloquear o enviar a revisión]
    B -->|Usuario cancela| E[Volver al menú principal]
```

</details>

---

## 1. OTP Verification (código por SMS)

Envía un código numérico de 6 dígitos por mensaje de texto (SMS) al teléfono del cliente y le pide que lo escriba en el chat para confirmar su identidad.

### ¿Cómo se comporta en la conversación?
1. El nodo genera un código seguro y lo envía por SMS.
2. Le pide amablemente al cliente que lo ingrese en el chat.
3. Si el usuario se equivoca, le indica cuántos intentos le quedan y le permite solicitar un reenvío.
4. Si ingresa el código correcto, el flujo avanza por la rama **Verificado**.

### Salidas en el lienzo:
- **Éxito (Verificado):** Continúa cuando el código ingresado coincide.
- **Fallido:** Se activa si el usuario supera el límite máximo de intentos erróneos.
- **Cancelado:** Si el usuario decide cancelar la verificación.

### ¿Qué puedes modificar?
<ParamField path="connectionId" type="string" required>
  Tu proveedor de mensajería SMS configurado.
</ParamField>

<ParamField path="phoneVariable" type="string" required>
  La variable que contiene el teléfono al que se enviará el SMS (por ejemplo: `{user_phone}`).
</ParamField>

<ParamField path="askOtpMessage" type="string" optional>
  Mensaje para solicitar el código (por ejemplo: *Te acabamos de enviar un código de 6 dígitos por SMS. Por favor escríbelo aquí para continuar:*).
</ParamField>

<ParamField path="maxAttempts" type="number" default="3">
  Cantidad máxima de intentos permitidos antes de marcar la verificación como fallida.
</ParamField>

<ParamField path="maxResends" type="number" default="3">
  Número máximo de veces que el usuario puede solicitar que le reenvíen el código SMS.
</ParamField>

---

## 2. KYC Verification (identidad oficial con Didit)

Inicia un proceso de **Conoce a tu Cliente (KYC)** donde el usuario valida su documento oficial de identidad (DPI, INE, Cédula o Pasaporte) y se toma una selfie biométrica con la cámara de su teléfono.

### ¿Cuándo usarlo?
- Apertura de cuentas de crédito o préstamos.
- Firma de contratos legales o notariales.
- Validación de antecedentes y prevención de fraudes.

### ¿Qué puedes modificar?
<ParamField path="connectionId" type="string" required>
  Tu conexión de Convoflow KYC.
</ParamField>

<ParamField path="workflowId" type="string" required>
  El identificador del flujo de verificación definido en tu plataforma de identidad.
</ParamField>

<ParamField path="sendAsButton" type="boolean" default="true">
  En WhatsApp, envía un botón interactivo (*"Verificar identidad"*) que abre el proceso sin que el usuario tenga que salir de su conversación.
</ParamField>

<ParamField path="buttonText" type="string" default="Verificar identidad">
  Texto del botón (máximo 20 caracteres).
</ParamField>

<ParamField path="verificationMessage" type="string" optional>
  Instrucciones para el cliente (por ejemplo: *Para continuar con tu solicitud, por favor completa esta breve verificación con tu documento de identidad y una selfie:*).
</ParamField>

---

## WhatsApp y mensajes al usuario
> URL: /es/nodes/whatsapp
> llms.txt específico: /es/nodes/whatsapp/llms.txt

import { ParamField } from '@site/src/components';

# Nodos: Mensajes y WhatsApp

La forma en que tu asistente le habla a los usuarios debe ser clara, atractiva y rápida. En Convoflow cuentas con dos bloques principales para enviar mensajes: el **Message Node** y el **WhatsApp Node**.

![Mensajería Interactiva de WhatsApp](/img/diagrams/nodes-whatsapp.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Flujo activo] --> B[Nodo: Mensaje / WhatsApp]
    B -->|Texto / Imagen / Botones| C[Usuario recibe el mensaje]
    B -->|Continuar| D[Siguiente paso del flujo]
```

</details>

---

## 1. Message Node (mensaje universal)

Es el bloque más común para responderle al usuario en cualquier canal (WhatsApp, Webchat, etc.).

### ¿Cómo personalizar el texto?
Puedes combinar texto libre con datos guardados usando llaves `{}`:
```text
¡Hola {user_name}! Con gusto te ayudamos con tu pedido #{numero_pedido}.
```

### ¿Qué puedes modificar?
<ParamField path="message" type="string" required>
  El texto que se enviará al chat. Puedes dar formato usando `*negritas*` o `_cursivas_`.
</ParamField>

<ParamField path="messageImageUrl" type="string" optional>
  Si deseas adjuntar una imagen ilustrativa, pega aquí la dirección URL pública de la imagen (por ejemplo: `https://tusitio.com/banner-promocion.jpg`).
</ParamField>

---

## 2. WhatsApp Node (interactivo para WhatsApp)

Diseñado específicamente para aprovechar las funciones nativas de **WhatsApp Business Cloud API**, como botones de respuesta rápida o envíos a números específicos.

### Tipos de mensajes:
- **Texto:** Mensaje directo a un número de teléfono de destino.
- **Botones Interactivos:** Muestra hasta 3 botones para que el cliente seleccione una opción con un solo toque (ideal para evitar errores de escritura).
- **Multimedia:** Enviar imágenes o archivos PDF (como cotizaciones o recibos).

### ¿Qué puedes modificar?
<ParamField path="to" type="string" required>
  Número de teléfono del destinatario en formato internacional (por ejemplo: `{user_phone}` o `+52155...`).
</ParamField>

<ParamField path="text" type="string" required>
  Cuerpo principal del mensaje o pie de foto.
</ParamField>

<ParamField path="connectionId" type="string" optional>
  La línea de WhatsApp oficial con la que responderás al usuario.
</ParamField>

---


# SECCIÓN 3: CONEXIONES (CONNECTIONS)

## Bases de datos
> URL: /es/connections/database
> llms.txt específico: /es/connections/database/llms.txt

import { ParamField } from '@site/src/components';

# Conexión: Bases de datos

Esta conexión permite que tus asistentes consulten bases de datos para revisar catálogos de productos, comprobar inventarios o guardar registros de clientes.

---

## 1. Supabase

<ParamField path="supabaseUrl" type="string" required>
  La dirección web de tu proyecto Supabase (por ejemplo: `https://xyzproject.supabase.co`).
</ParamField>

<ParamField path="serviceRoleKey" type="string" required>
  Tu clave secreta de API (`service_role` o `anon`) obtenida en la configuración de API de tu proyecto Supabase.
</ParamField>

---

## 2. PostgreSQL directo

Permite conectar cualquier base de datos PostgreSQL estándar.

<ParamField path="connectionString" type="string" required>
  Dirección de conexión de tu base de datos:
  ```text
  postgresql://usuario:password@host.dominio.com:5432/nombre_bd?sslmode=require
  ```
</ParamField>

---

## 3. Airtable

<ParamField path="personalAccessToken" type="string" required>
  Token de acceso personal generado en la sección de desarrolladores de Airtable.
</ParamField>

<ParamField path="baseId" type="string" optional>
  El identificador único de tu base de Airtable (inicia con `app...`).
</ParamField>

---

## Email y SMTP
> URL: /es/connections/email-smtp
> llms.txt específico: /es/connections/email-smtp/llms.txt

import { ParamField } from '@site/src/components';

# Conexión: Email y servidores SMTP

Esta conexión permite que Convoflow envíe correos electrónicos automáticos a tus clientes o notificaciones a tu equipo de trabajo.

---

## Campos de configuración

<ParamField path="host" type="string" required>
  Dirección del servidor de correo (por ejemplo: `smtp.gmail.com`, `smtp.sendgrid.net` o `smtp.resend.com`).
</ParamField>

<ParamField path="port" type="number" required default="465">
  Puerto de comunicación seguro:
  - `465`: Conexión segura recomendada (SSL).
  - `587`: Conexión alternativa (TLS/STARTTLS).
</ParamField>

<ParamField path="auth.user" type="string" required>
  Tu correo de usuario o identificador de cuenta (por ejemplo: `notificaciones@tuempresa.com` o `apikey` en el caso de SendGrid).
</ParamField>

<ParamField path="auth.pass" type="string" required>
  Tu contraseña de aplicación o clave de API generada por tu proveedor de correo.
</ParamField>

<ParamField path="fromDefault" type="string" optional>
  Nombre y correo del remitente que verán tus clientes (por ejemplo: `Atención Convoflow <contacto@tuempresa.com>`).
</ParamField>

---

## Configuración con proveedores populares

### 1. Gmail o Google Workspace
- **Servidor (Host):** `smtp.gmail.com`
- **Puerto:** `465`
- **Usuario:** Tu correo de Google (por ejemplo: `tu_correo@gmail.com`).
- **Contraseña:** Una **Contraseña de Aplicación** de 16 letras generada desde la configuración de seguridad de tu cuenta de Google.

:::tip Cómo generar una contraseña de aplicación en Google
Entra a [myaccount.google.com/apppasswords](https://myaccount.google.com/apppasswords) con tu cuenta de Google, escribe un nombre como "Convoflow", genera la contraseña de 16 caracteres y pégala en el campo de contraseña.
:::

### 2. Resend
- **Servidor (Host):** `smtp.resend.com`
- **Puerto:** `465`
- **Usuario:** `resend`
- **Contraseña:** Tu API Key de Resend.

### 3. SendGrid
- **Servidor (Host):** `smtp.sendgrid.net`
- **Puerto:** `465` o `587`
- **Usuario:** `apikey`
- **Contraseña:** Tu API Key de SendGrid.

---

## Google Service Account
> URL: /es/connections/google-service-account
> llms.txt específico: /es/connections/google-service-account/llms.txt

import { ParamField } from '@site/src/components';

# Conexión: Google Service Account

La conexión **Google Service Account** permite que tus flujos interactúen directamente con tus herramientas de Google:
- **Google Sheets:** Guardar nuevos prospectos, actualizar inventarios y leer datos.
- **Google Docs:** Generar contratos o documentos completando plantillas.
- **Google Calendar:** Consultar horarios libres y agendar citas con enlace de Google Meet.

![Conexión Google Service Account y Workspace](/img/diagrams/connections-google.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    A[Convoflow] -->|Conexion Segura| B[Google Cloud]
    B --> C[Google Sheets]
    B --> D[Google Docs]
    B --> E[Google Calendar]
```

</details>

---

## Parámetros de configuración

<ParamField path="serviceAccountJson" type="textarea" required>
  Pega aquí el contenido completo del archivo `.json` que descargas de Google Cloud (contiene la clave privada y el correo de servicio).
</ParamField>

<ParamField path="impersonateEmail" type="email" optional>
  (Opcional) Correo electrónico corporativo de Google Workspace en cuyo nombre deseas que se creen los eventos o documentos.
</ParamField>

---

## Guía paso a paso para conectar Google

### 1. Entrar a Google Cloud Console
1. Ingresa a la [Consola de Google Cloud](https://console.cloud.google.com/).
2. Inicia sesión con tu cuenta de Google y crea un proyecto nuevo (por ejemplo: *Automatizaciones Convoflow*).

### 2. Activar las herramientas de Google (APIs)
En el buscador superior de Google Cloud, busca y haz clic en **Habilitar (Enable)** para cada una de estas herramientas:
- **Google Sheets API** (para hojas de cálculo).
- **Google Docs API** (para documentos).
- **Google Calendar API** (para agendamiento de citas).
- **Google Drive API** (para permisos de archivos).

### 3. Crear una cuenta de servicio (Service Account)
1. Ve a la sección **IAM y administración > Cuentas de servicio**.
2. Haz clic en **Crear cuenta de servicio**.
3. Escribe un nombre identificador (por ejemplo: `convoflow-asistente`) y haz clic en **Listo**.

### 4. Descargar la clave JSON
1. En la lista de cuentas de servicio, haz clic sobre el correo que se acaba de crear (tendrá un formato similar a: `convoflow-asistente@tu-proyecto.iam.gserviceaccount.com`).
2. Ve a la pestaña **Claves (Keys)**.
3. Haz clic en **Agregar clave > Crear clave nueva**.
4. Elige el formato **JSON** y presiona **Crear**. Se descargará un archivo en tu computadora.
5. Abre ese archivo con cualquier editor de texto, copia todo su contenido y pégalo en el campo **Service Account JSON** dentro de Convoflow.

### 5. Dar acceso a tus documentos y calendarios
Este es el paso más importante para que todo funcione:

- **Para Google Sheets y Google Docs:** Abre tu hoja o documento, haz clic en el botón **Compartir**, pega el correo de la cuenta de servicio (el que termina en `...iam.gserviceaccount.com`) y otórgale permisos de **Editor**.
- **Para Google Calendar:** Abre Google Calendar en tu computadora, entra a la configuración del calendario que usarás, ve a **Compartir con personas específicas** y agrega el correo de la cuenta de servicio con permisos para *Realizar cambios en eventos*.

---

## Preguntas frecuentes y soluciones

:::note Error de permisos ("The caller does not have permission")
**Causa:** No has compartido la hoja de cálculo o calendario con el correo de servicio.  
**Solución:** Copia el correo `client_email` de tu archivo JSON y compártelo con permisos de Editor en tu archivo de Google Drive.
:::

:::note Error de API no habilitada
**Causa:** Falta activar la API en Google Cloud.  
**Solución:** Ve a la biblioteca de APIs en Google Cloud y presiona **Habilitar** en *Google Sheets API* o *Google Calendar API*.
:::

---

## Introducción a conexiones
> URL: /es/connections
> llms.txt específico: /es/connections/llms.txt

import { Card, CardGrid } from '@site/src/components';

# Conexiones centralizadas

Las **Conexiones** en Convoflow te permiten guardar y administrar de forma segura las contraseñas, llaves de API y credenciales necesarias para que tus asistentes interactúen con servicios externos.

![Mapa de Conexiones Seguras](/img/diagrams/connections-map.png)

<details style={{display: 'none'}}>
<summary>Mermaid</summary>

```text
graph LR
    subgraph Convoflow
        F[Tus Flujos de Atencion]
        A[Tus Asistentes IA]
    end
    
    subgraph Conexiones Seguras
        C1[Google Workspace]
        C2[Cuentas de Correo SMTP]
        C3[WhatsApp Business API]
        C4[Proveedores de IA]
        C5[Bases de Datos]
    end
    
    F --> C1 & C2 & C3
    A --> C4 & C5
```

</details>

---

## Ventajas de usar conexiones

1. **Mayor Seguridad:** Tus contraseñas y llaves de acceso se guardan encriptadas. Tus flujos solo hacen referencia al nombre de la conexión sin exponer claves.
2. **Configuración Única:** Configuras tu cuenta una sola vez (por ejemplo, tu cuenta de Google o WhatsApp) y la reutilizas en todos los flujos que necesites.
3. **Prueba Inmediata:** Puedes presionar el botón **Probar Conexión** para confirmar que tus claves funcionan correctamente antes de publicar.
4. **Mantenimiento Fácil:** Si cambias una contraseña, solo la actualizas en la conexión central y todos tus flujos seguirán funcionando sin tener que editarlos uno por uno.

---

## Tipos de conexiones disponibles

<CardGrid cols={2}>
  <Card title="Google Service Account" icon="key" to="/connections/google-service-account" badge="Google">
    Conexión segura para gestionar Google Sheets, Google Docs y Google Calendar.
  </Card>
  <Card title="Email y servidores SMTP" icon="email" to="/connections/email-smtp" badge="Correo">
    Configura envíos desde Gmail Workspace, SendGrid, Resend o tu propio servidor de correo.
  </Card>
  <Card title="WhatsApp Cloud API" icon="whatsapp" to="/connections/whatsapp" badge="Canales">
    Conecta números oficiales de WhatsApp Business a través de la plataforma de Meta.
  </Card>
  <Card title="Modelos de IA y LLMs" icon="brain" to="/get-started/ai-providers" badge="IA">
    Modelos de inteligencia artificial disponibles para potenciar tus agentes en Convoflow.
  </Card>
  <Card title="Bases de datos" icon="database" to="/connections/database" badge="Datos">
    Conecta bases de datos PostgreSQL, proyectos de Supabase o bases de Airtable.
  </Card>
  <Card title="Webhooks y HTTP APIs" icon="http" to="/connections/webhooks-http" badge="Sistemas">
    Configura autenticación para conectarte con tus propios sistemas y APIs.
  </Card>
</CardGrid>

---

## Estados de tus conexiones

En el panel de Convoflow verás el estado de cada cuenta conectada:

| Estado | Significado |
| :--- | :--- |
| <span className="badge-tag" style={{ color: '#10b981', borderColor: 'rgba(16, 185, 129, 0.25)', background: 'rgba(16, 185, 129, 0.08)' }}>Activo</span> | La conexión funciona correctamente y está lista para usarse. |
| <span className="badge-tag" style={{ color: '#ef4444', borderColor: 'rgba(239, 68, 68, 0.25)', background: 'rgba(239, 68, 68, 0.08)' }}>Error</span> | Las credenciales son incorrectas o expiraron. Revisa la clave ingresada. |
| <span className="badge-tag" style={{ color: '#8b87a0', borderColor: 'rgba(139, 135, 160, 0.25)', background: 'rgba(139, 135, 160, 0.08)' }}>Inactivo</span> | La conexión fue pausada manualmente por un administrador. |

---

## Webhooks y HTTP APIs
> URL: /es/connections/webhooks-http
> llms.txt específico: /es/connections/webhooks-http/llms.txt

import { ParamField } from '@site/src/components';

# Conexión: Webhooks y HTTP APIs

Esta conexión te permite guardar de manera centralizada los datos de acceso para conectarte con tus propios sistemas o aplicaciones web sin exponer contraseñas en cada flujo.

---

## Campos de configuración

<ParamField path="authType" type="enum" required>
  El tipo de autenticación requerido por tu sistema:
  - `none`: Peticiones públicas sin clave.
  - `bearer`: Token de autorización (Bearer Token).
  - `apiKey`: Llave de acceso enviada en los encabezados.
  - `basic`: Usuario y contraseña estándar.
</ParamField>

<ParamField path="baseUrl" type="string" optional>
  Dirección principal de tu API (por ejemplo: `https://api.tuempresa.com/v1`).
</ParamField>

<ParamField path="defaultHeaders" type="object" optional>
  Encabezados fijos que se incluirán en cada consulta:
  ```json
  {
    "Content-Type": "application/json",
    "X-App-ID": "convoflow"
  }
  ```
</ParamField>

---

## WhatsApp Cloud API
> URL: /es/connections/whatsapp
> llms.txt específico: /es/connections/whatsapp/llms.txt

import { ParamField } from '@site/src/components';

# Conexión: WhatsApp Cloud API

La conexión de **WhatsApp Cloud API** vincula tus números oficiales de WhatsApp con Convoflow para responder mensajes de clientes de manera automática con texto, botones interactivos y archivos multimedia.

---

## Campos de configuración

<ParamField path="wabaId" type="string" required>
  Identificador de la cuenta de WhatsApp Business (WABA ID) obtenido en tu panel de Meta Business Manager.
</ParamField>

<ParamField path="phoneNumberId" type="string" required>
  Identificador del número de teléfono asignado en tu aplicación de Meta Developers.
</ParamField>

<ParamField path="accessToken" type="string" required>
  Token de acceso permanente generado en la sección de Usuarios del Sistema en Meta.
</ParamField>

<ParamField path="webhookVerifyToken" type="string" required>
  Una palabra o código secreto que tú eliges para validar que los mensajes que llegan a Convoflow provienen legítimamente de Meta.
</ParamField>

---

## Configuración del webhook en Meta

1. Entra a [developers.facebook.com](https://developers.facebook.com/) y abre tu aplicación de WhatsApp.
2. En el menú lateral ve a **WhatsApp > Configuración**.
3. En la sección de Webhooks, pega la dirección de webhook que te proporciona Convoflow:
   ```text
   https://api.convoflow.ai/api/webhooks/whatsapp/{workspace_id}
   ```
4. Escribe tu **Webhook Verify Token** y haz clic en **Verificar y Guardar**.
5. En la lista de suscripciones, activa la casilla **messages**.

---