Holded CRM Component

Holded CRM Component conecta tu flujo con el CRM de tu cuenta de Holded. Con un solo componente puedes trabajar con cuatro tipos de datos: los embudos de venta, las oportunidades (leads) que avanzan por ellos, los eventos y las reservas de citas.

Es útil cuando los contactos comerciales llegan por otros canales, como un formulario web, un chat o un agente de IA, y quieres que entren en tu CRM sin teclearlos a mano.

Cuándo usarlo

Cada solicitud de presupuesto de tu web debe convertirse en una oportunidad dentro de un embudo de ventas.
Quieres un informe periódico con las oportunidades abiertas de tu equipo comercial.
Un agente de IA atiende a tus clientes y debe consultar huecos libres y reservar citas.
Un cliente cancela por correo y quieres anular su reserva automáticamente.

Configuración

Necesitas una credencial Holded Task API con la clave de API de tu cuenta de Holded. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Holded Task API con la que se accede a tu cuenta.
Resource	El tipo de dato con el que trabajas: `Funnels`, `Leads`, `Events` o `Bookings`. Por defecto, `Funnels`.
Operation	Lo que haces con ese dato. La lista cambia según el Resource elegido. Ver Recursos y operaciones.

Al elegir el recurso y la operación, el componente muestra solo los campos que esa operación necesita. Todos son obligatorios.

Recursos y operaciones

Funnels (embudos de venta)

Operación	Qué hace	Campos
`List`	Trae todos los embudos.
`Create`	Crea un embudo.	Funnel Name
`Get`	Trae un embudo.	Funnel ID
`Update`	Cambia el nombre de un embudo.	Funnel ID, Funnel Name
`Delete`	Elimina un embudo.	Funnel ID

Leads (oportunidades)

Operación	Qué hace	Campos
`List`	Trae todas las oportunidades.
`Create`	Crea una oportunidad para un contacto dentro de un embudo.	Contact Id, Funnel Id, Lead Name
`Get`	Trae una oportunidad.	Lead ID
`Update`	Cambia el nombre de una oportunidad.	Lead ID, Lead Name
`Delete`	Elimina una oportunidad.	Lead ID

Events (eventos)

Operación	Qué hace	Campos
`List`	Trae todos los eventos.
`Create`	Crea un evento.	Event Name
`Get`	Trae un evento.	Event ID
`Update`	Cambia el nombre de un evento.	Event ID, Event Name
`Delete`	Elimina un evento.	Event ID

Bookings (reservas)

Operación	Qué hace	Campos
`List Locations`	Trae los lugares donde se pueden hacer reservas.
`Get available slots for location`	Trae los huecos libres de un lugar y un servicio en el día de la fecha indicada.	Location Id, Service Id, Booking Date
`List Bookings`	Trae todas las reservas.
`Create Booking`	Reserva un servicio en un lugar a la fecha y hora indicadas.	Location Id, Service Id, Booking Date, Booking Fields (JSON)
`Get Booking`	Trae una reserva.	Booking ID
`Update Booking`	Cambia el lugar, el servicio o la fecha de una reserva.	Booking ID, Location Id, Service Id, Booking Date, Booking Fields (JSON)
`Cancel Booking`	Anula una reserva.	Booking ID

Booking Fields (JSON) lleva los datos de quien reserva que pide el formulario de reserva del servicio, por ejemplo {"name": "Ana", "email": "ana@example.com"}.

Resultado

La salida Response devuelve en texto la respuesta de Holded: los datos del elemento con el que has trabajado, la lista de elementos en las operaciones que listan, o una confirmación en las que eliminan o anulan.

Puedes conectar el resultado a un agente para que lo interprete, o a un componente que extraiga los datos que necesites. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo crear oportunidades o reservar citas. Ver Tool Mode.

Ejemplo

Una academia quiere que cada solicitud de información de su web entre en el CRM.

El formulario llega al flujo con el contacto ya creado en Holded y el curso que le interesa.
Añade Holded CRM Component con el recurso Leads y la operación Create.
En Contact Id pon el identificador del contacto, en Funnel Id el del embudo “Matrículas” y en Lead Name el nombre del curso.
Conecta Response a un componente de correo que avise al equipo comercial.

Buenas prácticas

Los identificadores de embudos, contactos, lugares y servicios se consultan con las operaciones que listan (List, List Locations). Guárdalos para no buscarlos en cada ejecución.
Para crear una oportunidad, el contacto tiene que existir antes en Holded. Puedes crearlo con Holded Invoice Component, recurso Contacts.

Componentes relacionados

Holded Invoice Component: contactos, productos y documentos de venta.
Holded Projects Component: proyectos y tareas.
Holded Team Component: empleados y fichajes.
Holded Accounting Component: contabilidad.