Plataformas de automatización
Integración con n8n
El nodo comunitario de arteemis para n8n (n8n-nodes-arteemis) aporta dos nodos: arteemis Trigger, que inicia un workflow con los eventos de arteemis, y arteemis, que crea o actualiza contactos, los encuentra, los añade a listas, los inscribe en campañas, los mueve en el pipeline y abre tareas. Se conecta con una clave de tu espacio de trabajo de arteemis.
Qué hace
arteemis Trigger
- Uno o varios eventos: New Reply, Contact Status Changed, Lead Entered Campaign, Lead Left Campaign, Message Sent, LinkedIn Invitation Accepted, New Task, Pipeline Stage Changed, Background Job Finished.
- Verify Signature, activado por defecto, comprueba cada llamada con el secreto que arteemis devuelve para el webhook, y responde 401 a todo lo demás.
Nodo arteemis
- Contact: Create or Update: se identifica por email y, si no, por perfil de LinkedIn; empresa, lista y campos personalizados opcionales.
- Contact: Find: por email o URL del perfil de LinkedIn.
- List: Add Contact.
- Campaign: Enroll Contact.
- Pipeline: Add or Move Contact: al añadirlo, terminan las secuencias en curso del contacto.
- Task: Create: una llamada o una tarea pendiente.
arteemis solo llama a direcciones https en un host público: un n8n en http://localhost no puede recibir eventos. Usa n8n Cloud, o un n8n autoalojado con una dirección https pública (WEBHOOK_URL).
Requisitos
- Una instancia de n8n que pueda instalar nodos comunitarios.
- Una clave del espacio de trabajo de arteemis, creada por un propietario o un administrador en Ajustes > MCP & API. El token personal de un miembro también sirve para las acciones, con su propio rol; el disparador requiere una clave del espacio de trabajo o el rol de administrador.
- Para el disparador, una dirección https pública para tu n8n y un webhook disponible (un espacio de trabajo admite 50 como máximo).
Configuración
Instalar el nodo
- 1En n8n, abre Settings > Community Nodes, elige Install e introduce n8n-nodes-arteemis.
Crear una clave del espacio de trabajo
- 1Inicia sesión en arteemis y abre Ajustes > MCP & API.
- 2En la sección de la API, ponle un nombre a una clave y elige Crear clave. Cópiala enseguida: solo se muestra una vez. Empieza por art_key_.
Conectar en n8n
- 1En n8n, crea una credencial arteemis API y pega la clave como su API Key. Deja Base URL en https://api.arteemis.xyz/api/v1.
- 2Añade arteemis Trigger o arteemis a un workflow y elige esa credencial. Las listas, campañas y etapas se ofrecen en menús desplegables.
- 3Activa el workflow: el disparador registra su webhook en arteemis, y lo quita cuando el workflow se desactiva.
Datos intercambiados
| Datos | Sentido | Detalles |
|---|---|---|
| Eventos | De arteemis a n8n | El identificador, el tipo y la hora del evento, el contacto (nombre, dirección de email, perfil de LinkedIn, cargo, empresa, estado, tipo de respuesta, campos personalizados) y, según el evento, el mensaje, la campaña, la inscripción, la tarea, la etapa o el proceso. |
| Resultados | De arteemis a n8n | El contacto encontrado o escrito, la lista, la inscripción, la oportunidad o la tarea. |
| Menús desplegables | De arteemis a n8n | Nombres de tus listas, campañas y etapas del pipeline. |
| Contactos | De n8n a arteemis | Creados o actualizados por el nodo: nombre, email, perfil de LinkedIn, empresa, cargo, teléfono, campos personalizados. |
| Listas, campañas, pipeline, tareas | De n8n a arteemis | Un contacto añadido a una lista, inscrito en una campaña, añadido o movido en el pipeline; una tarea abierta. |
| Webhooks | De n8n a arteemis | La dirección del disparador, guardada mientras el workflow esté activo. |
Desconexión
- Desactiva el workflow: su webhook se quita de arteemis.
- Para cortar todo acceso de una vez, revoca la clave en Ajustes > MCP & API: a partir de entonces se rechaza cada llamada hecha con ella.
- arteemis no guarda nada de n8n aparte de las direcciones de webhook de los disparadores activos.
Solución de problemas
- El disparador no recibe nada
- Tu n8n debe ser accesible por https en una dirección pública: configura WEBHOOK_URL en un n8n autoalojado. arteemis llama en el minuto siguiente al evento.
- El disparador no se puede activar: requiere el rol de administrador
- La credencial contiene un token personal de un miembro que no es administrador. Usa una clave del espacio de trabajo.
- El mismo evento ha llegado dos veces
- Un envío se reintenta durante unas 21 horas hasta que tiene éxito. Usa el identificador del evento para descartar un duplicado.
- Las llamadas responden 401
- La clave se ha revocado o se ha copiado mal. Crea una nueva y actualiza la credencial.
Ayuda
romain@arteemis.xyz
¿Una pregunta sobre esta integración, o algo que no funciona como se describe aquí? Escríbenos. Recibes una respuesta en un día laborable como máximo, en francés o en inglés.
Enviar un email