Skip to main content

​
¿Qué es el Funnel de Whaapy?

El funnel de Whaapy te permite organizar tus contactos en etapas de tu proceso de ventas. Cada negocio tiene un único funnel con múltiples etapas personalizables. 
┌─────────┐    ┌───────────┐    ┌──────────┐    ┌─────────┐
│  Lead   │ → │ Qualified │ → │ Proposal │ → │ Closed  │
│  (120)  │    │   (45)    │    │   (20)   │    │  (30)   │
└─────────┘    └───────────┘    └──────────┘    └─────────┘

​
Conceptos Clave

Cada etapa representa un paso en tu proceso de ventas. Las etapas tienen:
  • Nombre: Identificador visible (ej: “Lead”, “Qualified”)
  • Posición: Orden en el funnel (0 = primera)
  • Color: Color hex para visualización (#6366f1)
  • Contactos: Número de contactos en esa etapa
Los contactos pueden moverse entre etapas:
  • Manualmente vía API
  • Automáticamente vía webhooks de sistemas externos
  • Un contacto solo puede estar en una etapa a la vez
  • stage_id: null quita al contacto de todas las etapas
Cada acción dispara webhooks para sincronización:
  • funnel_stage.created - Nueva etapa creada
  • funnel_stage.updated - Etapa modificada
  • funnel_stage.deleted - Etapa eliminada
  • contact.stage_changed - Contacto movido de etapa

​
Autenticación

Todos los endpoints requieren autenticación con API Key: 
Authorization: Bearer wha_TU_API_KEY
Obtén tu API Key en Dashboard → Configuración → API

​
Scopes Requeridos

EndpointScope
GET (listar, obtener)funnels:read
POST, PATCH, DELETEfunnels:write

​
Endpoints Disponibles

Listar Etapas

GET /funnel/v1/stages

Obtener Etapa

GET /funnel/v1/stages/:id

Crear Etapa

POST /funnel/v1/stages

Actualizar Etapa

PATCH /funnel/v1/stages/:id

Eliminar Etapa

DELETE /funnel/v1/stages/:id

Reordenar Etapas

PATCH /funnel/v1/stages/reorder

Mover Contacto

POST /funnel/v1/contacts/:id/move

​
Casos de Uso Comunes

​
Sincronización con CRM

// Cuando un lead cambia de etapa en tu CRM, actualiza Whaapy
await fetch('https://api.whaapy.com/funnel/v1/contacts/uuid/move', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wha_xxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    stage_id: 'qualified-stage-uuid'
  })
});

​
Automatización con n8n/Zapier

  1. Trigger: Webhook contact.stage_changed de Whaapy
  2. Filter: Si new_stage.name === "Qualified"
  3. Action: Crear deal en tu CRM con datos del contacto

​
Reportes de Pipeline

// Obtener vista de pipeline con conteos
const response = await fetch('https://api.whaapy.com/funnel/v1/stages', {
  headers: { 'Authorization': 'Bearer wha_xxx' }
});
const { stages } = await response.json();

// stages = [
//   { name: "Lead", contact_count: 120 },
//   { name: "Qualified", contact_count: 45 },
//   ...
// ]

​
Límites y Consideraciones

  • Máximo 50 etapas por negocio
  • No puedes eliminar una etapa con contactos (muévelos primero)
  • Reordenar actualiza todas las posiciones en una transacción

​
Próximos Pasos

Listar Etapas

Empieza listando las etapas existentes

Mover Contacto

Aprende a mover contactos entre etapas