n8n-nodes-colibly 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Colibly
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,69 @@
-# Temporary Holding Version
+# n8n-nodes-colibly
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Nodos de [n8n](https://n8n.io) para [Colibly](https://colibly.com), el CRM para WhatsApp: contactos, conversaciones, mensajes, plantillas y automatizaciones, más un disparador por webhook firmado.
+
+*English below.*
+
+## Instalación
+
+En tu n8n (self-hosted): **Settings → Community Nodes → Install** y escribe `n8n-nodes-colibly`.
+
+## Credencial
+
+1. En Colibly, ve a **Configuración → API** y crea una API key. Activa los permisos de lo que vas a usar:
+   | Permiso | Para |
+   |---|---|
+   | `contacts:read` / `contacts:write` | Buscar, crear y actualizar contactos y etiquetas |
+   | `conversations:read` / `conversations:write` | Leer conversaciones y mensajes; cambiar estado y asignación |
+   | `messages:send` | Enviar mensajes |
+   | `automations:run` | Iniciar automatizaciones manuales |
+   | `webhooks:manage` | El nodo **Colibly Trigger** |
+2. En n8n crea una credencial **Colibly API** con esa key. La URL se queda en `https://app.colibly.com`.
+
+## Nodo «Colibly»
+
+| Recurso | Operaciones |
+|---|---|
+| Contact | Get, Get Many (búsqueda y filtros), Create or Get (solo cuentas de WhatsApp), Update (nombre, etapa, valor del trato, fecha de cierre, campos), Add Tag, Remove Tag |
+| Conversation | Get, Get Many, Get Messages, Update (estado, persona asignada, equipo) |
+| Message | Send (texto, botones, plantilla, imagen, documento, audio, video por URL), Get |
+| Automation | Get Many, Run (automatizaciones con disparador «manual», con variables) |
+| Workspace | Cuentas, etiquetas, usuarios, equipos, plantillas e identidad de la key |
+
+- Los envíos y las ejecuciones de automatizaciones llevan `Idempotency-Key`: reintentar el flujo no manda el mensaje dos veces.
+- Texto, botones y archivos solo se pueden enviar dentro de la ventana de 24 h del cliente; fuera de ella usa una plantilla aprobada.
+- Se puede usar como herramienta del **AI Agent** de n8n.
+
+## Nodo «Colibly Trigger»
+
+Elige los eventos (mensaje recibido, contacto nuevo, cambio de etapa, etiqueta, conversación asignada o resuelta, citas, lead calificado…) y, si quieres, las cuentas. Al **activar** el flujo, el nodo crea su webhook en Colibly; al **desactivarlo**, lo borra. Cada entrega se verifica con la firma `X-Colibly-Signature` (HMAC-SHA256, 5 minutos de tolerancia); sin firma válida responde 401 y no dispara.
+
+La URL de tu n8n debe ser **pública por HTTPS** (Colibly no entrega a direcciones privadas). Con n8n en tu computadora usa un túnel.
+
+## Ejemplos
+
+- **Lead nuevo → Google Sheets**: Colibly Trigger (`contact.created`) → Google Sheets (Append).
+- **Etiqueta VIP → plantilla**: Colibly Trigger (`tag.added`) → IF (`data.tagName` = VIP) → Colibly (Message → Send, tipo Template).
+- **Respuesta con IA**: Colibly Trigger (`message.received`) → AI Agent → Colibly (Message → Send, tipo Text, a la conversación).
+
+Documentación completa de la API: <https://app.colibly.com/docs/api>.
+
+---
+
+## English
+
+n8n community nodes for Colibly (WhatsApp CRM). Install `n8n-nodes-colibly` from **Settings → Community Nodes**, create a **Colibly API** credential with an API key from Colibly (**Configuración → API**) and use:
+
+- **Colibly** — contacts, tags, conversations, messages (text, buttons, templates, media by URL) and manual automations. Sends are idempotent.
+- **Colibly Trigger** — registers its own webhook in Colibly when the workflow is activated, verifies `X-Colibly-Signature` on every delivery and removes the webhook when deactivated. Requires the `webhooks:manage` scope and a public HTTPS n8n URL.
+
+## Desarrollo
+
+```bash
+npm ci
+npm run lint     # reglas de n8n para nodos de la comunidad
+npm run build
+npm test         # firma de los webhooks
+```
+
+Licencia MIT.

package/dist/credentials/ColiblyApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import type { IAuthenticateGeneric, Icon, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class ColiblyApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: Icon;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/ColiblyApi.credentials.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ColiblyApi = void 0;
+class ColiblyApi {
+    constructor() {
+        this.name = 'coliblyApi';
+        this.displayName = 'Colibly API';
+        this.icon = { light: 'file:colibly.svg', dark: 'file:colibly.dark.svg' };
+        this.documentationUrl = 'https://app.colibly.com/docs/api';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                required: true,
+                default: '',
+                placeholder: 'sk_live_...',
+                description: 'Créala en Colibly → Configuración → API. Activa los permisos de lo que vas a usar (contactos, conversaciones, mensajes, webhooks, automatizaciones).',
+            },
+            {
+                displayName: 'URL de Colibly',
+                name: 'baseUrl',
+                type: 'string',
+                required: true,
+                default: 'https://app.colibly.com',
+                description: 'Cámbiala solo si usas otra instalación de Colibly',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl.replace(/\\/$/, "")}}',
+                url: '/api/v1/me',
+            },
+        };
+    }
+}
+exports.ColiblyApi = ColiblyApi;
+//# sourceMappingURL=ColiblyApi.credentials.js.map

package/dist/credentials/colibly.dark.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><rect width="32" height="32" rx="9" fill="#0E7490"/><path fill="#FFFFFF" fill-rule="evenodd" d="M21.57 20.68A8.26 8.26 0 1 1 21.57 10.52L18.86 12.63A4.82 4.82 0 1 0 18.86 18.57ZM22.26 13.79L25.18 15.47L22.26 17.16Z"/></svg>

package/dist/credentials/colibly.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><rect width="32" height="32" rx="9" fill="#0E7490"/><path fill="#FFFFFF" fill-rule="evenodd" d="M21.57 20.68A8.26 8.26 0 1 1 21.57 10.52L18.86 12.63A4.82 4.82 0 1 0 18.86 18.57ZM22.26 13.79L25.18 15.47L22.26 17.16Z"/></svg>

package/dist/nodes/Colibly/Colibly.node.d.ts

@@ -0,0 +1,18 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+import { getAccounts, getAllTemplates, getRunnableAutomations, getTags, getTeams, getTemplates, getUsers, getWhatsappAccounts } from './GenericFunctions';
+export declare class Colibly implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getAccounts: typeof getAccounts;
+            getWhatsappAccounts: typeof getWhatsappAccounts;
+            getTags: typeof getTags;
+            getUsers: typeof getUsers;
+            getTeams: typeof getTeams;
+            getTemplates: typeof getTemplates;
+            getAllTemplates: typeof getAllTemplates;
+            getRunnableAutomations: typeof getRunnableAutomations;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}