Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.nippy.la/llms.txt

Use this file to discover all available pages before exploring further.

​
Ejemplos de lo que puedes preguntarle a tu agente

  • “Crea una landing page para la campaña de mayo, que pida nombre, email y teléfono”
  • “Quiero que al registrarse los mande a la ruleta de bienvenida”
  • “¿Cuánta gente ha completado el registro en mis flows?”
  • “¿Cuál es mi tasa de conversión en todas las landing pages?”
  • “Ponle UTM source=whatsapp y campaign=lanzamiento-mayo al flow de esta campaña”
Flows te deja crear páginas de registro para tus campañas directamente desde el chat. Le dices qué datos capturar, a dónde redirigir después del registro (una ruleta, un curso, un link) y tu agente arma todo. Lo que creas por MCP es un scaffold — después puedes terminar de configurarlo en la Consola.
El flow creado por MCP es un scaffold. Después de la creación, se requiere configuración adicional desde la Consola (subir documentos, configurar Palenca, agregar redirects adicionales, etc.).

​
Tools de lectura

​
flows_list_flows

Lista los flows de este negocio.
​
limit
integer
predeterminado:"100"
Número máximo de flows a retornar.
Respuesta incluye: slug, name, isActive, completedCount, uniqueVisitCount, totalVisitCount, conversionRate, publicUrl 
{
  "name": "flows_list_flows",
  "arguments": {
    "limit": 20
  }
}

​
flows_get_flow_stats

Obtiene estadísticas agregadas de todos los flows del negocio. Sin parámetros. Respuesta: totalFlows, activeFlows, inactiveFlows, totalCompletions, totalVisits, uniqueVisits, conversionRate 
{
  "name": "flows_get_flow_stats",
  "arguments": {}
}

​
flows_get_flow_by_slug

Obtiene información detallada de un flow específico por su slug.
​
slug
string
predeterminado:"''"
requerido
Slug del flow a consultar.
Respuesta: documento completo incluyendo registrationFields, configuración de redirect, métricas y publicUrl. 
{
  "name": "flows_get_flow_by_slug",
  "arguments": {
    "slug": "campana-mayo-2026"
  }
}

​
Tools de escritura — Creación

​
flows_propose_create_flow

Genera un preview del scaffold del flow. No escribe a la base de datos. Valida que el slug sea único y que el target de redirect exista y pertenezca al negocio.
​
name
string
requerido
Nombre del flow.
​
slug
string
requerido
Slug único en kebab-case (e.g. "campana-mayo-2026"). Debe ser globalmente único.
​
redirect_type
string
requerido
Tipo de redirect al completar el registro. Debe ser uno de: "roulette", "course", "survey", "event", "url".
​
redirect_target_id
string
predeterminado:"''"
ID del target del redirect. Requerido si redirect_type es "roulette", "course", "survey" o "event".
​
redirect_url
string
predeterminado:"''"
URL del redirect. Requerido si redirect_type es "url".
​
registration_fields
array
Lista de campos de registro. Cada campo es un objeto con:
  • text (string): etiqueta visible del campo
  • value (string): identificador interno
  • type (string): tipo de campo ("text", "email", "select", "phone", etc.)
  • placeholder (string): texto placeholder
  • isRequired (boolean): si es obligatorio
Si se omite, se usan campos por defecto: Nombre, Apellido, País.
​
source
string
predeterminado:"''"
UTM source para tracking de campaña.
​
medium
string
predeterminado:"''"
UTM medium para tracking de campaña.
​
campaign
string
predeterminado:"''"
UTM campaign para tracking de campaña.
​
content
string
predeterminado:"''"
UTM content para tracking de campaña.
​
is_palenca_required
boolean
predeterminado:"false"
Si el flow requiere validación bancaria con Palenca.
{
  "name": "flows_propose_create_flow",
  "arguments": {
    "name": "Campaña Mayo 2026",
    "slug": "campana-mayo-2026",
    "redirect_type": "roulette",
    "redirect_target_id": "664f1a2b3c4d5e6f7a8b9c0d",
    "registration_fields": [
      {
        "text": "Nombre completo",
        "value": "fullName",
        "type": "text",
        "placeholder": "Tu nombre completo",
        "isRequired": true
      },
      {
        "text": "Correo electrónico",
        "value": "email",
        "type": "email",
        "placeholder": "tucorreo@ejemplo.com",
        "isRequired": true
      },
      {
        "text": "WhatsApp",
        "value": "phone",
        "type": "phone",
        "placeholder": "+52 55 1234 5678",
        "isRequired": true
      },
      {
        "text": "País",
        "value": "country",
        "type": "select",
        "placeholder": "Selecciona país",
        "isRequired": true
      }
    ],
    "source": "whatsapp",
    "medium": "cpc",
    "campaign": "lanzamiento-mayo-2026",
    "content": "banner_01",
    "is_palenca_required": false
  }
}

​
flows_approve_create_flow

Crea el scaffold del flow en la base de datos. Mismos parámetros que propose_create_flow.
Solo llama esta tool después de mostrar al usuario el preview de propose_create_flow y recibir confirmación explícita.
Respuesta: {"_id": "...", "slug": "campana-mayo-2026", "publicUrl": "https://console.nippy.la/flow/campana-mayo-2026", "status": "created", "message": "Flow scaffold created. Additional Console configuration may be needed."}

​
Tools de escritura — Actualización

​
flows_propose_update_flow

Genera un preview de los cambios a aplicar sobre un flow existente. No escribe a la base de datos. Solo los campos no-None se aplican.
​
slug
string
requerido
Slug del flow a actualizar.
​
name
string
Nuevo nombre del flow.
​
is_active
boolean
Activar o desactivar el flow.
​
redirect_type
string
Nuevo tipo de redirect.
​
redirect_target_id
string
Nuevo ID del target de redirect.
​
redirect_url
string
Nueva URL de redirect.
​
registration_fields
array
Nueva lista de campos de registro (reemplaza los existentes).
​
source
string
Nuevo UTM source.
​
medium
string
Nuevo UTM medium.
​
campaign
string
Nuevo UTM campaign.
​
content
string
Nuevo UTM content.
​
is_palenca_required
boolean
Si se requiere validación Palenca.
{
  "name": "flows_propose_update_flow",
  "arguments": {
    "slug": "campana-mayo-2026",
    "is_active": true,
    "campaign": "lanzamiento-mayo-2026-v2"
  }
}

​
flows_approve_update_flow

Aplica los cambios al flow. Mismos parámetros que propose_update_flow.
Solo llama esta tool después de mostrar al usuario el preview de propose_update_flow y recibir confirmación explícita.
Respuesta: {"slug": "campana-mayo-2026", "updated": true}
Referencias de esquemas para el agente:
URINombreDescripción
nippy://flows/schema/schemasflows_schemasCampos de flows
nippy://flows/schema/glossaryflows_glossaryTérminos de negocio y mapeos
nippy://flows/skillflows_skillInstrucciones para el agente

​
Checklist post-creación

Después de crear un flow con MCP, completa estos pasos desde la Consola:
  1. Subir documentos requeridos (cédula, licencia, etc.)
  2. Configurar Palenca si se requiere validación bancaria
  3. Agregar redirects adicionales (survey, event, url) si aplica
  4. Ajustar authType si no es WhatsApp (Google, ambos)
  5. Probar el flow end-to-end antes de compartir el link público