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

CRM y marketing

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

10 endpoints GET · 5 POST · 3 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 trabajarlo día a día —también desde un asistente de voz—, buscarOportunidad encuentra una oportunidad por como la nombra una persona (la empresa, el contacto, el título) y anotarOportunidad deja apuntado lo que ha pasado y el siguiente paso. 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 10

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.
GET /api/v1/crm/opportunities/search
Buscar una oportunidad
Encuentra una oportunidad por como la nombra una persona: la empresa, el contacto o el título.
POST /api/v1/crm/opportunities/{id}/notes
Anotar en una oportunidad
Apunta lo que ha pasado en una oportunidad y, si se sabe, deja planificado el siguiente paso.
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.