n8n

Instale el nodo de la comunidad, cree la credencial, construya un primer workflow y entienda la limitación del webhook único antes de añadir un trigger.

WASync incluye un nodo de la comunidad para n8n, publicado en npm como n8n-nodes-wasync. Envuelve la misma API REST que describen estos documentos, así que todo lo que hace el nodo también puede hacerlo con curl, y lo que el nodo aún no hace, también.

Antes de empezar: una cuenta y un número conectado

El nodo se comunica con su cuenta de WASync. Si aún no tiene una, créela primero: toma un minuto y no cuesta nada:

Cree una cuenta de desarrollador gratuita

Vaya a developers.wasync.app/register — nombre, email, contraseña. Cada cuenta nueva incluye su propio workspace: el lugar donde viven sus números de WhatsApp y sus API keys.

Lleve un número de WhatsApp a ese workspace

Hay dos situaciones:

Ya usa WASync dentro de Bitrix24: inicie sesión con el mismo email que usa en Bitrix24. Su portal aparece como un workspace y sus números conectados están listos para usarse. Enviar mediante la API requiere el complemento de API en ese número (12 USD por número al mes; sin él, el paso de envío del nodo responde addon_required).
Es nuevo en WASync: conecte un número a su propio workspace con una sola llamada a la API que devuelve un código QR (o un código de emparejamiento que escribe en WhatsApp). Los pasos exactos están en Conectar un número de WhatsApp. Cada número comienza con una prueba gratuita de 7 días; los planes son WAPP 19 USD o WABA 29 USD por número al mes.

Cree una API key

Hay dos formas de hacerlo:

¿Ya usa WASync dentro de Bitrix24? Vaya a Ajustes → API y agentes → API keys, ponga nombre a la integración y haga clic en Crear clave. Necesita una conexión con el complemento de API activo, y viene con los scopes que necesita este workflow (whatsapp.read whatsapp.send): omita la lista de scopes que aparece más abajo.
En caso contrario, inicie sesión y abra developers.wasync.app/keys. Elija el workspace, dé un nombre a la clave, marque los scopes indicados abajo y créela.

En cualquier caso, copie la clave de inmediato: se muestra una sola vez. Es el valor que pide la credencial de n8n.

Una cuenta, muchos números

La operación Connection → List del nodo muestra todos los números a los que la clave puede acceder. Si la lista está vacía, el workspace aún no tiene ningún número conectado: vuelva al paso 2.

1. Instale el nodo de la comunidad

Verificado por n8n (7 sep 2026)

n8n-nodes-wasync es un nodo de la comunidad verificado: lleva la insignia de verificado dondequiera que n8n muestre una.

Hay dos formas de instalarlo, según dónde ejecute n8n:

n8n Cloud o autoalojado: busque en el panel de nodos. Abra el panel de nodos, busque "WASync" y añádalo. Los nodos verificados se instalan directamente desde ahí, sin configuración adicional.
Solo autoalojado: ajustes de Community Nodes. Vaya a Settings → Community nodes → Install, escriba el nombre del paquete y confirme:
```
n8n-nodes-wasync
```
Este método funciona en cualquier instancia autoalojada, verificada o no.

Tras la instalación, los nodos WASync y WASync Trigger aparecen en el panel de nodos.

Puntos de partida listos para usar: las plantillas de workflow gratuitas cubren los flujos más comunes: importe una y ajuste los campos en lugar de empezar con un lienzo en blanco.

2. Cree la credencial

Añada una credencial de tipo WASync API. Solo tiene un campo: su API key, que se envía como Authorization: Bearer ….

Pegue la clave que creó antes (vea Antes de empezar): se muestra una sola vez. Otórguele únicamente los scopes que necesita el workflow:

listar conexiones y leer mensajes → whatsapp.read
enviar y marcar como leído → whatsapp.send
el trigger → whatsapp.events

Vea Scopes.

3. Su primer workflow

El workflow útil más simple tiene dos nodos: un trigger manual y un envío.

Encuentre el id de la conexión. Añada un nodo WASync, elija el recurso Connection → operación List y ejecútelo. Copie el id del número desde el que quiere enviar.

Envíe un mensaje. Añada un segundo nodo WASync, recurso Message → operación Send. Complete:

Campo	Valor
`connectionId`	el id que acaba de copiar
`to`	dígitos internacionales, sin `+`, p. ej. `40712345678`
`text`	el cuerpo del mensaje

Ejecute. El nodo devuelve el id del mensaje con el que podrá cruzar datos después; vea los dos ids.

Operaciones que admite el nodo

Recurso	Operación	Parámetros
Connection	List	—
Message	Send	`connectionId`, `to`, `text`
Message	Get Many	`connectionId`, `limit`
Message	Mark as Read	—

Solo envío de texto. Enviar una plantilla de WhatsApp y comprobar si un número está en WhatsApp no están disponibles hoy mediante la API, por lo que el nodo no los ofrece: no construya un workflow que suponga que existen.

4. El trigger

WASync Trigger inicia un workflow cuando ocurre algo en su cuenta. Admite cuatro eventos:

message.received
message.status
connection.connected
connection.disconnected

Los payloads son exactamente los de la guía de webhooks: los mismos campos, los mismos ids y el mismo timestamp en milisegundos.

Un solo espacio de webhook por cuenta: un trigger lo mueve

La API tiene una única URL de webhook por cuenta (PUT /webhook, POST /webhook/rotate, y no hay forma de eliminarla). Al activar un WASync Trigger, ese único espacio apunta a n8n.

Por lo tanto: si su propio backend ya recibía webhooks, deja de recibirlos en el momento en que el trigger toma el control. Y dos WASync Triggers no pueden ocupar el espacio a la vez: el segundo gana. Si necesita los eventos en más de un lugar, recíbalos una vez y distribúyalos usted mismo: deje que n8n tenga el espacio y reenvíe desde un workflow, o deje que su backend lo tenga y llame a un nodo Webhook de n8n.

Las URL del trigger de prueba y de producción son distintas, así que alternar entre ellas también mueve el espacio.

Como las entregas se descartan tras tres intentos fallidos, mantenga una vía de conciliación también en n8n: un workflow programado que llame a Message → Get Many cada 30–60 segundos recoge lo que el trigger haya perdido mientras la instancia se reiniciaba.

Cuando el nodo no basta

El nodo cubre el camino común. Para envíos de medios, códigos de emparejamiento, aprovisionamiento de conexiones, manejo de Idempotency-Key o cualquier otra cosa de la referencia de la API, use el nodo HTTP Request de n8n con la misma credencial: URL base https://developers.wasync.app/api/v1, encabezado Authorization: Bearer <key>.

¿Le resultó útil esta página?

On this page