Skip to main content
El paquete comunitario n8n-nodes-famulor ofrece 423 acciones nativas, 32 eventos por consulta y cinco opciones de eventos webhook firmados para la API actual de los espacios de trabajo Famulor.

Famulor para n8n

Instrucciones de instalación, versiones y código fuente del conector.

​
Instalar y conectar

  1. En tu instancia de n8n autoalojada, abre Settings → Community Nodes como propietario o administrador.
  2. Instala n8n-nodes-famulor o actualiza el paquete existente. Esta guía corresponde a la versión 2.1.1 o posterior.
  3. En Famulor, selecciona el espacio que quieres automatizar y crea una clave en Settings → API & MCP con los permisos necesarios.
  4. En n8n, crea una credencial Famulor API e introduce la clave API. El host se elige automáticamente; no necesitas introducir una Base URL. Los hosts guardados anteriormente siguen siendo compatibles.
  5. Añade una acción Famulor o un Famulor Polling Trigger y selecciona esa credencial.
La clave determina el espacio de trabajo. Famulor comprueba API Access, permisos, funciones disponibles y créditos. Guarda la clave en las credenciales de n8n; solo se muestra una vez al crearla.
La ficha del directorio n8n puede mostrar otra versión del conector. n8n Cloud admite nodos comunitarios verificados; la instalación npm está disponible en instancias autoalojadas. Si faltan las operaciones nativas siguientes, actualiza el conector donde sea posible o utiliza el ejemplo HTTP Request.
Consulta la guía de instalación n8n.

​
Credenciales

Las operaciones personales como Account → Get low-credit warning preferences requieren una credencial vinculada a un usuario. Una clave de cuenta de servicio no tiene usuario asociado, incluso con todos los permisos. Gestiona los avisos personales de saldo en los ajustes de Famulor cuando utilices esta clave. Account → Get current credential muestra el tipo de credencial y el espacio.

​
Acciones nativas

Añade Famulor, elige Resource → Operation y completa los campos obligatorios. Las operaciones abarcan asistentes, llamadas, campañas, contactos, números, SMS, conversaciones, conocimiento, reservas, herramientas, automatizaciones, misiones, voces, widgets, ajustes y administración de espacios. Para una primera prueba de lectura, utiliza Account → Get current credential o Calls → List calls. En la lista de llamadas, añade Limit en Optional Fields y establece 10.
  • Las referencias permiten From List o By ID. Puedes usar IDs de nodos anteriores.
  • Los campos opcionales se omiten hasta que los añades. Se conservan los valores explícitos false, 0, arrays vacíos, textos vacíos y valores null compatibles.
  • Las listas devuelven un item n8n por registro. Utiliza limit y offset para las páginas siguientes. Las vistas previas de audio devuelven datos binarios.
  • Cada item de entrada ejecuta una solicitud. Las escrituras no se reintentan automáticamente. Calls → Start an outbound call, SMS, compras y otras escrituras realizan operaciones reales y pueden consumir créditos.

​
Disparadores por consulta

Añade Famulor Polling Trigger y selecciona tu credencial Famulor API, evento y frecuencia. Los eventos de leads de campaña también requieren un ID de campaña. Las 32 opciones abarcan llamadas, conversaciones, contactos, campañas y leads, asistentes, números, conocimiento, herramientas, automatizaciones, misiones, segmentos, exclusiones, reservas y devoluciones de llamada. Utiliza Phone Call Completed para llamadas terminadas y Conversation Completed para conversaciones de mensajería terminadas. La primera consulta activa establece un estado inicial sin emitir registros históricos. Las pruebas manuales devuelven ejemplos recientes sin cambiar ese estado. Una llamada que ya estaba en curso al activar el workflow puede emitir el evento de finalización cuando termine. Las consultas comprueban los registros y estados observados. Una transición entre consultas puede perderse. Las fuentes temporales releen una ventana de diez minutos y eliminan duplicados; pueden faltar registros que aparezcan después de esa ventana. Utiliza IDs de evento o recurso para evitar escrituras duplicadas. Los conjuntos grandes requieren más lecturas API; las consultas fallidas o incompletas no avanzan el estado.

​
Webhooks de reservas firmados

Utiliza Famulor Trigger con credenciales Famulor Webhook API para entregas firmadas. Las opciones son booking.created, booking.cancelled, booking.rescheduled, call.completed y conversation.ended. Para reservas:
  1. Selecciona el evento de reserva en n8n y copia la Production URL.
  2. En Famulor, edita el tipo de reserva y abre Advanced → Webhook URL.
  3. Pega la URL y guarda. Al configurarlo por primera vez, Famulor muestra un Webhook signing secret generado. Cópialo en Webhook Secret de la credencial n8n.
  4. Activa el workflow n8n. Utiliza la Test URL solo mientras n8n espera un evento de prueba; usa la Production URL para un workflow activo.
El disparador verifica la firma antes de devolver datos. Las firmas ausentes o incorrectas devuelven HTTP 401. El evento seleccionado debe coincidir con la entrega. El filtro opcional de asistente se aplica a llamadas y conversaciones.
La URL Automations → Call completed del asistente y las URLs de fin de conversación de los conectores de mensajería envían eventos sin firma. No pueden usar este disparador firmado. Utiliza los eventos por consulta anteriores, salvo que ya tengas una entrega firmada configurada. No existe una página global Settings → Webhooks del espacio.
La firma por sí sola no evita que se repita un evento. Elimina duplicados por ID antes de las escrituras posteriores. El conector nunca modifica automáticamente los destinos webhook de Famulor. Consulta la guía webhook de n8n.

​
Workflows existentes

Los nodos de acción y webhook guardados en versión 2 conservan definiciones y parámetros. Los nodos nuevos utilizan versión 3. Para migrar, selecciona la operación nativa, asigna sus campos y prueba antes de activar. Guarda el secreto de firma en Famulor Webhook API. Conserva las credenciales antiguas hasta actualizar todos los workflows dependientes.

​
Alternativa HTTP Request

Añade HTTP Request y selecciona Authentication → Generic Credential Type → Header Auth. Guarda el valor de la cabecera en una credencial. Utiliza el array data de la respuesta en el siguiente paso. Esta solicitud lee llamadas. Consulta la documentación HTTP Request de n8n.

​
Resolver errores

  • 401: comprueba la clave API guardada o el secreto del disparador webhook.
  • 403: comprueba permisos y acceso al espacio y a las funciones. Las operaciones personales también requieren una credencial de usuario.
  • 402: comprueba créditos y acceso al plan del espacio.
  • Sin salida por consulta: el estado inicial omite registros antiguos; comprueba evento y campaña.
  • Sin salida webhook: comprueba URL, escucha o workflow activo, evento y filtro de asistente.

​
API y CLI

La misma lista de llamadas está disponible mediante GET /api/v1/calls y la CLI Famulor:
Consulta la referencia API para autenticación y operaciones.

​
Más integraciones