CRM y marketing
Del lead a la venta: contactos, oportunidades, pipeline y métricas comerciales.
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.
-
/api/v1/crm/funnelsObtienes los ids del embudo -
/api/v1/crm/opportunitiesEntra el lead -
/api/v1/crm/opportunities/{id}/closeSe gana o se pierde con motivo
Endpoints del área 10
/api/v1/crm/contacts
/api/v1/crm/opportunities
/api/v1/crm/funnels
/api/v1/crm/opportunities
/api/v1/crm/dashboard
/api/v1/crm/loss-reasons
/api/v1/crm/opportunities/{id}/close
/api/v1/crm/opportunities/{id}/stage
/api/v1/crm/opportunities/search
/api/v1/crm/opportunities/{id}/notes
Todos estos endpoints comparten el mismo formato de llamada, autenticación por API key y envelope de respuesta: los tienes en Primeros pasos.