Base URL https://api.afer.pro Referencia aferapp.com Reservar demo
Referencia de la API

CRM y marketing

Del lead a la venta: contactos, oportunidades, pipeline y métricas comerciales.

8 endpoints GET · 4 POST · 2 PUT · 2

Cubre las dos mitades del CRM: meter datos (un formulario web que crea el contacto y su oportunidad) y leer cómo va (el embudo, las tasas y el rendimiento del equipo).

Antes de crear nada, pide el catálogo a listarFunnels: de ahí salen los identificadores de funnel, etapa y canal. Después, crearOportunidad mete el lead en el embudo y moverOportunidadEtapa y cerrarOportunidad lo hacen avanzar hasta ganarlo o perderlo con su motivo. Para medir, consultarOportunidades da el pipeline ligero y consultarCRM el dashboard completo de un funnel: win rate, ciclo medio, tasas de contacto y reunión, puntos de dolor y playbooks.

Flujo típico

Un recorrido habitual por esta área, de principio a fin.

  1. /api/v1/crm/funnels Obtienes los ids del embudo
  2. /api/v1/crm/opportunities Entra el lead
  3. /api/v1/crm/opportunities/{id}/close Se gana o se pierde con motivo

Endpoints del área 8

POST /api/v1/crm/contacts
Crear contacto
Da de alta un contacto en el CRM, o lo actualiza si ya existe uno con el mismo email o móvil.
POST /api/v1/crm/opportunities
Crear oportunidad
Crea una oportunidad en un funnel del CRM, resolviendo o creando el contacto asociado por email o móvil.
GET /api/v1/crm/funnels
Listar funnels
El catálogo del CRM: funnels con sus etapas, canales de captación, motivos de pérdida y tipos de acción.
GET /api/v1/crm/opportunities
Pipeline del CRM
Las oportunidades abiertas por funnel y etapa (número y valor) y, con un rango de fechas, las creadas, ganadas y perdidas con su win rate.
GET /api/v1/crm/dashboard
Dashboard del CRM
El dashboard comercial completo de un funnel: KPIs, rates de actividad, embudo por etapas, motivos de pérdida, puntos de dolor, playbooks, canales, comerciales y evolución.
GET /api/v1/crm/loss-reasons
Listar motivos de pérdida
Los motivos de pérdida de tu CRM y, opcionalmente, cuánto se usa cada uno en un funnel concreto.
PUT /api/v1/crm/opportunities/{id}/close
Ganar o perder oportunidad
Marca una oportunidad como ganada o perdida (con motivo y comentarios), o la reabre.
PUT /api/v1/crm/opportunities/{id}/stage
Mover oportunidad de etapa
Mueve una oportunidad a otra etapa del embudo — o a otro embudo distinto.
Antes de empezar

Todos estos endpoints comparten el mismo formato de llamada, autenticación por API key y envelope de respuesta: los tienes en Primeros pasos.