> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lekalao.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecteurs

> n8n, Zapier, Make et WordPress : Lekalao dans les outils que vous utilisez déjà.

Chaque connecteur parle la même [API](/fr/developers/introduction) et reçoit les mêmes [webhooks](/fr/developers/webhooks) signés. Ils vivent dans le dépôt de l'application, sous `integrations/`.

| Outil                       | Ce qui existe                                                                                            |
| --------------------------- | -------------------------------------------------------------------------------------------------------- |
| **n8n**                     | Un nœud et un déclencheur (`n8n-nodes-lekalao`) — le compagnon naturel d'une installation auto-hébergée. |
| **Zapier**                  | Six déclencheurs instantanés, trois actions.                                                             |
| **Make**                    | Pas encore d'application : les modules génériques de Make font le travail, ci-dessous.                   |
| **WordPress + WooCommerce** | Une extension : formulaires, clients, commandes et paniers abandonnés.                                   |

Tous demandent deux choses : l'**adresse de l'API** de votre installation, sans `/v1`, et un **jeton d'API** doté du droit d'**écriture** (**Paramètres → Jetons d'API**). Le test de connexion appelle [`GET /v1/me`](/fr/api-reference/introduction).

## n8n

**Lekalao** (actions) : ajouter ou mettre à jour un abonné — jamais de doublon —, étiqueter, désabonner ; enregistrer un [événement](/fr/developers/events) ; envoyer un e-mail transactionnel. **Lekalao Trigger** : quelqu'un s'est abonné, a confirmé, s'est désabonné, a été étiqueté ; une campagne a été envoyée ; un e-mail a rebondi ; quelqu'un s'est plaint — pour toutes les listes ou pour une seule.

Activer un workflow enregistre un webhook dans votre équipe ; le désactiver le retire. Chaque appel est signé, et un appel dont la signature ne correspond pas ne démarre rien.

```bash theme={null}
cd integrations/n8n && npm install && npm run build
```

Installez-le dans n8n depuis **Settings → Community nodes**, ou montez `dist` dans `~/.n8n/custom`.

## Zapier

Déclencheurs : nouvel abonné, inscription confirmée, désabonnement, tag ajouté, e-mail rebondi, campagne envoyée. Actions : ajouter ou mettre à jour un abonné, enregistrer un événement, envoyer un e-mail transactionnel. Chaque utilisateur donne l'adresse de **son** Lekalao : une seule application sert le cloud et toute installation auto-hébergée joignable depuis Internet.

```bash theme={null}
cd integrations/zapier && npm install
npx zapier login && npx zapier register "Lekalao"   # une fois
npm test && npm run validate && npm run push
```

## Make

1. **Pour démarrer un scénario** : un module *Webhooks → Custom webhook* ; collez son adresse dans **Paramètres → Webhooks sortants → Ajouter**, avec les événements voulus. Pour vérifier la signature, ajoutez un filtre comparant l'en-tête `X-Lekalao-Signature` à `sha256(corps; secret)`.
2. **Pour agir dans Lekalao** : un module *HTTP → Make a request* avec `Authorization: Bearer <jeton>` — par exemple `POST /v1/lists/{list}/subscribers` avec `{"email": "…"}`, ou `POST /v1/events`. Ajoutez `Idempotency-Key: {{uuid}}` : un scénario rejoué n'abonne pas deux fois.

## WordPress et WooCommerce

Déposez `integrations/wordpress/lekalao` dans `wp-content/plugins/`, activez l'extension, puis **Réglages → Lekalao** : l'adresse de l'API, le jeton, la liste.

* **Un formulaire n'importe où** : `[lekalao_form]`, ou `[lekalao_form list="…" names="yes" button="S'abonner"]`. Le formulaire est posté à votre propre site, qui parle à Lekalao : le jeton n'atteint jamais le navigateur d'un visiteur.
* **À la commande** : une case pour s'abonner, dont le libellé est le vôtre.
* **Les commandes** : une commande payée est envoyée comme événement `order`, avec son montant — compté comme revenu de l'e-mail qui l'a gagné — et le numéro de commande pour référence : elle compte une fois.
* **Les paniers abandonnés** : un panier que personne n'a touché depuis une heure, dont on connaît le propriétaire (un client connecté, ou l'adresse saisie à la commande), est envoyé comme `cart.abandoned` avec ses articles, son total et un lien de retour.

Ce sont les événements dont partent les parcours prêts à l'emploi **Après un achat** et **Panier abandonné** : voir [Automatisations](/fr/automations/overview#parcours-prets-a-lemploi).

## Ce sur quoi s'appuient les connecteurs

| Appel                              | Pour                                                                                                                                  |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `GET /v1/me`                       | À qui est ce jeton, dans quelle équipe, avec quels droits : le test de connexion.                                                     |
| `POST /v1/webhooks`                | Enregistre un webhook et renvoie son `secret` **une seule fois**. Voir [Webhooks](/fr/developers/webhooks#enregistrer-par-programme). |
| `DELETE /v1/webhooks/{id}`         | Le retire, quand le workflow est désactivé.                                                                                           |
| `GET /v1/webhooks/samples/{event}` | La forme exacte d'un appel, faite du dernier abonné réel de l'équipe quand il y en a.                                                 |
