Integración con n8n

n8n es una herramienta de automatización de flujos de trabajo que puede usar en n8n Cloud o alojar usted mismo. Conectarla a Personyze le permite crear flujos sobre su cuenta — sincronizar contactos, segmentos, compras y leads captados — con la opción de mantenerlo todo dentro de su propia infraestructura.

Personyze no ofrece una app dedicada para n8n — se conecta con el módulo genérico de solicitudes HTTP de n8n y una clave de API de Personyze. Parece más trabajo del que es: cada endpoint de Personyze es una llamada HTTPS normal con autenticación Basic, así que una sola conexión configurada le da acceso a toda la API.

En el panel: Configuración › Integraciones › n8n.

Obtener una clave

1. Abra Configuración › Integraciones y haga clic en Configurar en la tarjeta de n8n.
2. Haga clic en Generar nueva clave y copie el valor.
3. Guárdela bien — cualquiera que tenga una clave puede actuar como su cuenta. Revocar una clave aquí detiene de inmediato todo lo que aún la use.

Son las mismas claves que las de API completa y Zapier. Una clave generada en cualquiera de esas tarjetas aparece en todas y autentica cualquier endpoint. Aun así, conviene generar una clave distinta para cada automatización, para poder revocar una sin romper las demás.

Conectar en n8n

Añada un nodo HTTP Request y cree una credencial Basic Auth:

• Authentication: Basic auth
• Username: api
• Password: la clave que ha generado
• Base URL: https://app.personyze.com/rest/

Algunas herramientas prefieren las credenciales incrustadas en la URL, lo que también funciona:

https://api:YOUR_API_KEY@app.personyze.com/rest/users/where/email=john@example.com

Guárdela como credencial reutilizable en n8n para que todos los nodos HTTP Request del flujo puedan seleccionarla, en lugar de pegar la clave en cada nodo.

Nota sobre el alojamiento propio. Personyze no necesita llegar a su instancia de n8n para estas llamadas — es su flujo el que llama a Personyze, así que un n8n alojado por usted detrás de un cortafuegos funciona sin ningún acceso entrante. Eso solo cambia si más adelante añade un webhook de Personyze que apunte a n8n, que sí necesita una URL accesible.

Qué puede llamar

Cualquier cosa de la API REST. Las formas de automatización habituales:

• Enviar un contacto a Personyze — POST /rest/users con un email. Reenviar el mismo email fusiona en lugar de duplicar, así que un flujo que se ejecuta repetidamente sigue siendo seguro.
• Añadir a alguien a un segmento — POST /rest/user_list_users por user_list_id y user_email.
• Notificar una compra — POST /rest/products_interactions.
• Sacar los leads captados — GET /rest/forms, paginando por time.
• Obtener los resultados de las campañas — GET /rest/summary_actions.

Referencia completa: descripción general de la API REST, parámetros de ruta y errores, límites y reintentos. La guía de integración cubre los comportamientos que conviene conocer antes de construir un bucle de sincronización.

Dos cosas que, si no, le darán problemas

• Identifique a sus usuarios por email. Es el identificador que coincide con un perfil existente. Un flujo que use su propio internal_id crea un usuario nuevo en cada ejecución.
• Las respuestas de error son texto plano, no JSON. Un módulo configurado para interpretar todas las respuestas como JSON fallará con el error y ocultará el mensaje real. Compruebe el código de estado: 400 significa que la solicitud es incorrecta y reintentar no servirá de nada; 503 merece un reintento con espera progresiva.

Relacionado

• Integración con Make
• Integración con Zapier
• API completa