Saltar al contenido principal
El paquete comunitario n8n-nodes-famulor ofrece 533 acciones nativas, 32 eventos por consulta y cinco opciones de eventos webhook firmados para la API actual de los espacios de trabajo Famulor.

Famulor en n8n

Abre la ficha oficial de la integración n8n y las instrucciones de configuración.

n8n-nodes-famulor en npm

Consulta el paquete y las versiones para instalaciones n8n autoalojadas.
El código fuente y las notas de versión del conector están disponibles en GitHub. La versión 2.5.0 añade el campo opcional replace_payment_id a Create Platform Custom Payment para reemplazar un enlace de pago sin usar en el mismo espacio del cliente.

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.3.0 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. A partir de la versión 2.7.0, Bookings → Permanently delete bookings acepta los identificadores de reservas nativas finalizadas o canceladas. Revisa los identificadores antes de ejecutar la acción. El resultado muestra por separado los identificadores eliminados y omitidos. A partir de la versión 2.9.0, Campaigns → Launch a campaign inicia una campaña en borrador ahora o en un start_at fijo. Pon compliance_attestation en true para confirmar que la campaña cumple todas las leyes y normas de consentimiento aplicables a sus contactos, y copia sequence_hash sin cambios desde Get a campaign para que el inicio se detenga si la secuencia de llamadas cambió. También están Pause a campaign, Resume a campaign, Cancel a campaign’s schedule y Get campaign analytics, además de las herramientas de acciones de apps, las comprobaciones do-not-call de EE. UU. y las cuentas de Cal.com con sus tipos de evento. Los nodos Start a campaign guardados siguen enviando la solicitud sin cuerpo. 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.

Receptores manuales existentes

Los nodos webhook guardados de versiones 2 y 3 conservan sus parámetros y el modo manual. Los nuevos nodos de acciones usan la versión 3; los nuevos nodos webhook usan la versión 4 con registro automático. Para migrar, añade la clave API y el secreto a las credenciales y selecciona Automatic Subscription. Conserva las credenciales anteriores hasta actualizar los flujos dependientes. Receptores manuales existentes

Workflows existentes

Los nodos webhook guardados de versiones 2 y 3 conservan sus parámetros y el modo manual. Los nuevos nodos de acciones usan la versión 3; los nuevos nodos webhook usan la versión 4 con registro automático. Para migrar, añade la clave API y el secreto a las credenciales y selecciona Automatic Subscription. Conserva las credenciales anteriores hasta actualizar los flujos 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

Opciones de widgets del tema de Shopify

Con el conector 2.3.0 o posterior, elige Shopify → Read Shopify widget choices o Shopify → Synchronize Shopify widget choices y selecciona la tienda vinculada. Estas acciones están incluidas en las 485 acciones nativas descritas anteriormente. La publicación pública de nombres está desactivada de forma predeterminada. La sincronización la activa explícitamente y publica los nombres aptos como datos públicos de la tienda en Shopify, sin solicitar permisos adicionales de Shopify. Las actualizaciones en segundo plano conservan esa elección. Selecciona el widget y guarda el tema en Shopify. La sincronización no activa ningún tema. Para desactivarla, utiliza la configuración descrita en la guía de Shopify. Ambas acciones requieren acceso de propietario/administrador y Assistants: Read. La lectura también requiere Integrations: Read; la sincronización requiere Integrations: Write. Si tu conector no incluye estas acciones, utiliza un nodo HTTP Request con las mismas credenciales Header Auth: POST no lleva cuerpo. Los comandos CLI equivalentes son famulor get-shopify-widget-picker STORE_ID y famulor synchronize-shopify-widget-picker STORE_ID. Consulta la guía de Shopify para las herramientas MCP y métodos SDK correspondientes. La lista de tiendas también requiere Integrations: Read. Utiliza By ID si tus credenciales de sincronización solo tienen permiso de escritura para integraciones.

Avatares de IA privados

En Avatars, consulta el precio, prepara la carga de la foto, confirma la creación con consentimiento explícito y comprueba el estado. Crear y eliminar avatares requiere una clave API vinculada a un usuario del espacio de trabajo. Envía los bytes de la foto a la URL firmada con un nodo HTTP Request, sin credenciales de Famulor para esa carga. Reutiliza el mismo ID tras una respuesta incierta. El coste único de creación es independiente del uso; puede aplicarse una regla de recarga automática guardada. Consulta Avatar de IA para el flujo de API, CLI y SDK.

Suscripciones webhook firmadas

Los nuevos nodos Famulor Trigger del paquete 2.3.0 utilizan el registro automático. Añade la clave API del espacio y tu secreto en Famulor Webhook API, selecciona un evento y activa el flujo. Al desactivarlo solo se elimina la suscripción de ese nodo. Los nodos guardados de versión 2/3 siguen siendo manuales hasta elegir Automatic Subscription. Los destinos existentes no cambian. Suscripciones webhook firmadas

Remitentes de empresa y RCS

El paquete comunitario 2.6.0 o posterior añade a SMS solicitudes de remitente, actualización de estado, imágenes de marca y envío desde una conexión SMS. Los nodos Send SMS existentes conservan su número; modo de entrega, contenido enriquecido y texto alternativo son opcionales. Send SMS from a connection admite remitentes sin número. Los eventos SMS incluyen RCS. Actualiza el paquete después de publicarse; distribución npm y aprobación del directorio n8n son independientes. Desde 2.8.0, List company senders for SMS and RCS muestra los países de destino disponibles, la sugerencia del espacio de trabajo y los países cuya configuración está pendiente. Introduce uno o varios códigos de país disponibles en Countries al crear o actualizar un borrador. Book company sender setup también puede recibir la fecha de actualización del borrador revisado para detectar cambios simultáneos.