Saltearse al contenido
Nappai Documentation

Holded CRM Component

El componente Holded CRM Component te permite interactuar con la plataforma Holded para gestionar recursos de CRM como Funnels, Leads, Events y Bookings directamente desde tu dashboard de Nappai. Puedes listar, crear o obtener información de estos recursos sin salir de la interfaz visual.

¿Cómo funciona?

Cuando configuras el componente, seleccionas el recurso que quieres manejar (Funnels, Leads, Events o Bookings) y la operación que deseas realizar (List, Create o Get). El componente utiliza la API Key de Holded que has guardado en la credencial Holded Task API para autenticarse con el servicio. Internamente, el componente llama a la función correspondiente de Holded (por ejemplo, holded_funnels_execute) y devuelve la respuesta de la API como un objeto Message. Si el componente se conecta a un agente de IA, también puede exportar la operación como una herramienta (Tool) que el agente puede invocar.

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado Mapping Mode. Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada Mapping Data y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

  • Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
  • Resource: Selecciona el tipo de recurso de Holded que quieres gestionar (Funnels, Leads, Events o Bookings).
  • Operation: Define la acción que quieres ejecutar sobre el recurso seleccionado (List, Create o Get).
  • Tool Name: El nombre que aparecerá ante el agente cuando el componente se use como herramienta.
  • Tool Description: Una descripción detallada de lo que hace esta herramienta para que el agente la comprenda correctamente.
  • Tools arguments metadata: Define los metadatos de los argumentos que la herramienta aceptará.

Nota sobre credenciales
Este componente necesita una credencial de tipo Holded Task API.

  1. Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada Holded Task API.
  2. En el campo Credential del componente, selecciona la credencial que acabas de crear.
  3. La credencial debe contener la Holded Api Key (password).
  4. No incluyas la clave directamente en los campos de entrada; la credencial se gestiona de forma segura por Nappai.

Salidas

  • Response: Devuelve la respuesta de la API de Holded como un objeto Message. Puedes usar esta salida para analizar datos, mostrar resultados o pasar la información a otros componentes.
  • Tool: Exporta la operación como una herramienta (Tool) que puede ser utilizada por agentes de IA. Esta salida se genera automáticamente cuando el componente se conecta a un agente.

Ejemplo de Uso

  1. Listar Funnels

    • Activa Mapping Mode si quieres procesar varios registros.
    • Selecciona Resource = Funnels.
    • Selecciona Operation = List.
    • Conecta la salida Response a un componente de visualización (por ejemplo, un gráfico de barras) para mostrar la cantidad de funnels activos.

  2. Crear un Lead

    • Desactiva Mapping Mode si solo creas un lead.
    • Selecciona Resource = Leads.
    • Selecciona Operation = Create.
    • Proporciona los campos necesarios (nombre, email, etc.) mediante entradas fijas o mapeadas.
    • La salida Response mostrará la información del lead recién creado.

Componentes Relacionados

  • Holded API Connector – Conecta directamente con la API de Holded sin usar el flujo de herramientas.
  • Nappai Credential Manager – Administra todas las credenciales de API de forma segura.
  • Data Mapper – Permite transformar y mapear datos entre componentes antes de enviarlos a Holded.

Consejos y Mejores Prácticas

  • Reutiliza credenciales: Crea una sola credencial Holded Task API y úsala en todos los componentes que necesiten acceder a Holded.
  • Prueba en modo de mapeo: Cuando trabajes con grandes volúmenes de datos, activa el modo de mapeo para procesar registros en lote y ahorrar tiempo.
  • Maneja errores: Conecta la salida Response a un componente de manejo de errores para capturar y registrar fallos de la API.
  • Documenta tus flujos: Añade notas descriptivas a cada nodo para que otros usuarios entiendan rápidamente qué hace cada operación.

Consideraciones de Seguridad

  • La API Key de Holded se almacena de forma cifrada en la credencial Holded Task API; nunca la expongas en los campos de entrada.
  • Limita el acceso a la credencial solo a usuarios que necesiten interactuar con Holded.
  • Revisa los logs de la API para detectar accesos no autorizados o patrones sospechosos.