Nippy API Platform

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.

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.

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.

string

requerido

Nombre del flow.

string

requerido

Slug único en kebab-case (e.g. "campana-mayo-2026"). Debe ser globalmente único.

string

requerido

Tipo de redirect al completar el registro. Debe ser uno de: "roulette", "course", "survey", "event", "url".

string

predeterminado:"''"

ID del target del redirect. Requerido si redirect_type es "roulette", "course", "survey" o "event".

string

predeterminado:"''"

URL del redirect. Requerido si redirect_type es "url".

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.

string

predeterminado:"''"

UTM source para tracking de campaña.

string

predeterminado:"''"

UTM medium para tracking de campaña.

string

predeterminado:"''"

UTM campaign para tracking de campaña.

string

predeterminado:"''"

UTM content para tracking de campaña.

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.

string

requerido

Slug del flow a actualizar.

string

Nuevo nombre del flow.

boolean

Activar o desactivar el flow.

string

Nuevo tipo de redirect.

string

Nuevo ID del target de redirect.

string

Nueva URL de redirect.

array

Nueva lista de campos de registro (reemplaza los existentes).

string

Nuevo UTM source.

string

Nuevo UTM medium.

string

Nuevo UTM campaign.

string

Nuevo UTM content.

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}

Detalles técnicos (avanzado)

Referencias de esquemas para el agente:

URI	Nombre	Descripción
`nippy://flows/schema/schemas`	`flows_schemas`	Campos de flows
`nippy://flows/schema/glossary`	`flows_glossary`	Términos de negocio y mapeos
`nippy://flows/skill`	`flows_skill`	Instrucciones para el agente

Checklist post-creación

Después de crear un flow con MCP, completa estos pasos desde la Consola:

Subir documentos requeridos (cédula, licencia, etc.)
Configurar Palenca si se requiere validación bancaria
Agregar redirects adicionales (survey, event, url) si aplica
Ajustar authType si no es WhatsApp (Google, ambos)
Probar el flow end-to-end antes de compartir el link público

Inicio

SDK

MCP

Flows

Ejemplos de lo que puedes preguntarle a tu agente

Tools de lectura

`flows_list_flows`

`flows_get_flow_stats`

`flows_get_flow_by_slug`

Tools de escritura — Creación

`flows_propose_create_flow`

`flows_approve_create_flow`

Tools de escritura — Actualización

`flows_propose_update_flow`

`flows_approve_update_flow`

Checklist post-creación

​Ejemplos de lo que puedes preguntarle a tu agente

​Tools de lectura

​flows_list_flows

​flows_get_flow_stats

​flows_get_flow_by_slug

​Tools de escritura — Creación

​flows_propose_create_flow

​flows_approve_create_flow

​Tools de escritura — Actualización

​flows_propose_update_flow

​flows_approve_update_flow

​Checklist post-creación

Ejemplos de lo que puedes preguntarle a tu agente

Tools de lectura

`flows_list_flows`

`flows_get_flow_stats`

`flows_get_flow_by_slug`

Tools de escritura — Creación

`flows_propose_create_flow`

`flows_approve_create_flow`

Tools de escritura — Actualización

`flows_propose_update_flow`

`flows_approve_update_flow`

Checklist post-creación