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.
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
- En tu instancia de n8n autoalojada, abre Settings → Community Nodes como propietario o administrador.
- Instala n8n-nodes-famulor o actualiza el paquete existente. Esta guía corresponde a la versión 2.3.0 o posterior.
- En Famulor, selecciona el espacio que quieres automatizar y crea una clave en Settings → API & MCP con los permisos necesarios.
- 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.
- Añade una acción Famulor o un Famulor Polling Trigger y selecciona esa credencial.
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.
Credenciales
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 unstart_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 valoresnullcompatibles. - 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 existentesWorkflows 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 medianteGET /api/v1/calls y la CLI Famulor:
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.