Écouter les webhooks
Utilisez lomi listen pour recevoir les webhooks sandbox via relais cloud sans ngrok.
lomi listen ouvre une connexion Server-Sent Events (SSE) vers l'API lomi. et diffuse les événements webhook vers votre machine. Vous pouvez optionnellement les transférer vers un handler HTTP local.
Nécessite un lomi login avec un profil sandbox (recommandé).
Usage
# Afficher les événements dans le terminal
lomi listen
# Transférer vers votre handler webhook local
lomi listen http://localhost:3000/api/webhooksOptions
| Option | Description |
|---|---|
FORWARD_URL | URL optionnelle pour POST des charges webhook signées |
--allow-production | Écouter sur un profil production (requiert CLI_LISTEN_ALLOW_PRODUCTION=true côté API) |
Parcours
Se connecter (sandbox)
lomi login --profile sandbox
lomi switch sandboxDémarrer l'écoute
lomi listen http://localhost:3000/webhooksÀ la connexion, le CLI affiche votre organisation et LOMI_WEBHOOK_SECRET. Ajoutez le secret dans .env :
LOMI_WEBHOOK_SECRET=whsec_...Déclencher un événement test
lomi webhooks list
lomi webhooks test <webhook-id>Les événements apparaissent dans le terminal et sont transférés vers votre URL locale avec les en-têtes production (X-Lomi-Signature, X-Lomi-Event).
Comparaison avec lomi dev
lomi listen | lomi dev | |
|---|---|---|
| Reçoit de vrais événements sandbox | Oui | Seulement si le tableau de bord pointe vers localhost/ngrok |
| Nécessite ngrok | Non | Souvent oui en E2E |
| Lance un serveur HTTP local | Non (transfert optionnel) | Oui (:4242/webhook) |
Utilisez lomi listen comme chemin d'intégration principal. lomi dev quand vous n'avez besoin que d'un récepteur local.