n8n

Installez le nœud communautaire, créez l'identifiant, construisez un premier workflow et comprenez la limite du webhook unique avant d'ajouter un déclencheur.

WASync propose un nœud communautaire pour n8n, publié sur npm sous le nom n8n-nodes-wasync. Il s'appuie sur la même API REST que celle décrite dans cette documentation : tout ce que fait le nœud, vous pouvez aussi le faire avec curl — et tout ce qu'il ne fait pas encore, vous le pouvez aussi.

Avant de commencer : un compte et un numéro connecté

Le nœud communique avec votre compte WASync. Si vous n'en avez pas encore, créez-le d'abord — cela prend une minute et c'est gratuit :

Créer un compte développeur gratuit

Rendez-vous sur developers.wasync.app/register — nom, e-mail, mot de passe. Chaque nouveau compte est fourni avec son propre espace de travail : l'endroit où se trouvent vos numéros WhatsApp et vos clés API.

Ajouter un numéro WhatsApp à cet espace de travail

Deux situations :

Vous utilisez déjà WASync dans Bitrix24 — connectez-vous avec l'adresse e-mail que vous utilisez dans Bitrix24. Votre portail apparaît comme un espace de travail et ses numéros connectés sont prêts à l'emploi. L'envoi via l'API nécessite l'add-on API sur ce numéro (12 $ par numéro et par mois ; sans lui, l'étape d'envoi du nœud répond addon_required).
Vous découvrez WASync — connectez un numéro à votre propre espace de travail avec un seul appel API qui renvoie un QR code (ou un code d'appairage à saisir dans WhatsApp). Les étapes détaillées se trouvent dans Connecter un numéro WhatsApp. Chaque numéro démarre avec un essai gratuit de 7 jours ; les formules sont WAPP 19 $ ou WABA 29 $ par numéro et par mois, en USD.

Créer une API key

Deux méthodes :

Vous utilisez déjà WASync dans Bitrix24 ? Allez dans Settings → API & Agents → API keys, nommez l'intégration et cliquez sur Create key. Il faut une connexion avec l'add-on API actif ; la clé est créée avec les scopes dont ce workflow a besoin (whatsapp.read whatsapp.send) — ignorez la liste de scopes ci-dessous.
Sinon, connectez-vous et ouvrez developers.wasync.app/keys. Choisissez l'espace de travail, donnez un nom à la clé, cochez les scopes ci-dessous, puis créez-la.

Dans les deux cas, copiez la clé immédiatement : elle n'est affichée qu'une seule fois. C'est la valeur que demande l'identifiant n8n.

Un compte, plusieurs numéros

L'opération Connection → List du nœud affiche tous les numéros accessibles avec la clé. Si la liste est vide, l'espace de travail n'a encore aucun numéro connecté : retournez à l'étape 2.

1. Installer le nœud communautaire

Vérifié par n8n (7 sept. 2026)

n8n-nodes-wasync est un nœud communautaire vérifié : il porte le badge de vérification partout où n8n en affiche un.

Deux méthodes d'installation, selon l'endroit où vous exécutez n8n :

n8n Cloud ou auto-hébergé — via le panneau des nœuds. Ouvrez le panneau des nœuds, recherchez « WASync » et ajoutez-le. Les nœuds vérifiés s'installent directement à partir de là, sans configuration supplémentaire.
Auto-hébergé uniquement — paramètres Community Nodes. Allez dans Settings → Community nodes → Install, saisissez le nom du paquet et confirmez :
```
n8n-nodes-wasync
```
Cette méthode fonctionne sur toute instance auto-hébergée, vérifiée ou non.

Après l'installation, les nœuds WASync et WASync Trigger apparaissent dans le panneau des nœuds.

Des points de départ prêts à l'emploi : les modèles de workflow gratuits couvrent les cas les plus courants — importez-en un et ajustez les champs plutôt que de partir d'un canevas vide.

2. Créer l'identifiant

Ajoutez un identifiant de type WASync API. Il ne comporte qu'un seul champ : votre API key, envoyée sous la forme Authorization: Bearer ….

Collez la clé que vous avez créée plus haut (voir Avant de commencer) : elle n'est affichée qu'une seule fois. Donnez-lui uniquement les scopes dont le workflow a besoin :

lister les connexions et lire les messages → whatsapp.read
envoyer et marquer comme lu → whatsapp.send
le déclencheur → whatsapp.events

Voir Scopes.

3. Votre premier workflow

Le workflow utile le plus simple comporte deux nœuds : un déclencheur manuel et un envoi.

Trouvez l'identifiant de la connexion. Ajoutez un nœud WASync, choisissez la ressource Connection → l'opération List, puis exécutez-le. Copiez l'id du numéro à partir duquel vous voulez envoyer.

Envoyez un message. Ajoutez un second nœud WASync, ressource Message → opération Send. Renseignez :

Champ	Valeur
`connectionId`	l'id que vous venez de copier
`to`	chiffres au format international, sans `+` — p. ex. `40712345678`
`text`	le corps du message

Exécutez. Le nœud renvoie l'identifiant du message, que vous pourrez utiliser ensuite pour faire des jointures — voir les deux identifiants.

Opérations prises en charge par le nœud

Ressource	Opération	Paramètres
Connection	List	—
Message	Send	`connectionId`, `to`, `text`
Message	Get Many	`connectionId`, `limit`
Message	Mark as Read	—

Envoi de texte uniquement. L'envoi d'un modèle WhatsApp et la vérification de la présence d'un numéro sur WhatsApp ne sont pas disponibles via l'API aujourd'hui ; le nœud ne les propose donc pas — ne construisez pas de workflow qui suppose leur existence.

4. Le déclencheur

WASync Trigger lance un workflow lorsqu'un événement se produit sur votre compte. Il prend en charge quatre événements :

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

Les payloads sont exactement ceux du guide des webhooks : mêmes champs, mêmes identifiants, même timestamp en millisecondes.

Un seul emplacement de webhook par compte — un déclencheur le déplace

L'API n'offre qu'une seule URL de webhook par compte (PUT /webhook, POST /webhook/rotate, et aucune suppression). Activer un WASync Trigger dirige cet unique emplacement vers n8n.

Concrètement : si votre propre backend recevait déjà des webhooks, il cesse d'en recevoir dès que le déclencheur prend le relais. Et deux WASync Trigger ne peuvent pas occuper l'emplacement en même temps : le second l'emporte. Si vous avez besoin des événements à plusieurs endroits, recevez-les une seule fois et redistribuez-les vous-même : laissez n8n occuper l'emplacement et retransmettez depuis un workflow, ou laissez votre backend l'occuper et appelez un nœud Webhook de n8n.

Les URL de déclencheur de test et de production sont différentes ; passer de l'une à l'autre déplace donc aussi l'emplacement.

Comme les envois sont abandonnés après trois tentatives échouées, conservez un mécanisme de réconciliation, même dans n8n : un workflow planifié appelant Message → Get Many toutes les 30 à 60 secondes récupère tout ce que le déclencheur a manqué pendant le redémarrage de l'instance.

Quand le nœud ne suffit pas

Le nœud couvre le cas courant. Pour les envois de médias, les codes d'appairage, le provisionnement de connexions, la gestion de Idempotency-Key ou tout autre point de la référence de l'API, utilisez le nœud HTTP Request de n8n avec le même identifiant : URL de base https://developers.wasync.app/api/v1, en-tête Authorization: Bearer <key>.

Cette page vous a-t-elle été utile ?

On this page