We
Docs
CLI

WeSender CLI

Verstuur e-mails, beheer domeinen en bekijk logs vanuit de terminal. Ideaal voor snelle tests, scripts en CI/CD-pipelines.

Installatie

De WeSender CLI is beschikbaar via GitHub Packages. Je hebt een gratis GitHub-account nodig voor de eenmalige setup.

Stap 1: GitHub Packages instellen

Voeg de WeSender registry eenmalig toe aan je npm-configuratie. Genereer een GitHub Personal Access Token met de scope read:packages.

# Eénmalig: voeg de nljerry registry toe aan je npm-config
echo "@nljerry:registry=https://npm.pkg.github.com" >> ~/.npmrc

# Genereer een GitHub Personal Access Token (PAT) op:
# https://github.com/settings/tokens → New token → read:packages
echo "//npm.pkg.github.com/:_authToken=JOUW_GITHUB_TOKEN" >> ~/.npmrc

Stap 2: CLI installeren

npm install -g @nljerry/wesender-cli

Eerste instelling

Stel je API-key en standaard afzenderadres in. Je API-key vind je in het dashboard onder API-keys. Het afzenderadres moet een geverifieerd domein zijn.

# 1. API-key instellen
wesender config set-key ws_live_...

# 2. Standaard afzender instellen (geverifieerd domein)
wesender config set-from noreply@mail.joudomein.nl

# 3. Verbinding controleren
wesender doctor

E-mail versturen

Gebruik wesender send om een e-mail te versturen. Zonder --from wordt het standaard adres uit je configuratie gebruikt.

# Eenvoudig versturen
wesender send \
  --to klant@bedrijf.nl \
  --subject "Welkom bij ons platform" \
  --html "<h1>Welkom!</h1>"

# Met expliciete afzender
wesender send \
  --from "Wesender <noreply@mail.joudomein.nl>" \
  --to klant@bedrijf.nl \
  --subject "Welkom" \
  --html "<p>Bedankt voor je registratie.</p>"

# JSON-output voor scripts
wesender send --to x@y.nl --subject "Test" --html "<p>x</p>" --json

Domeinen

Voeg verzendende domeinen toe en controleer de DNS-verificatiestatus.

# Alle domeinen bekijken
wesender domains list

# Nieuw domein toevoegen (toont DNS-records)
wesender domains add mail.joudomein.nl

# DNS-status controleren
wesender domains verify mail.joudomein.nl

Logs

Bekijk recent verstuurde e-mails. Met --follow wordt de weergave elke 3 seconden vernieuwd.

# Laatste 50 e-mails
wesender logs

# Live streamen (Ctrl+C om te stoppen)
wesender logs --follow

# Filteren op status
wesender logs --status bounced --limit 100

API-keys

Beheer de API-keys van je account.

# Lijst van API-keys
wesender api-keys list

# Nieuwe key aanmaken
wesender api-keys create "Productie key"

# Key verwijderen
wesender api-keys delete key_id_hier

Diagnostics

wesender doctor controleert je configuratie, API-verbinding en DNS-status van je domeinen.

wesender doctor

# Voorbeeld output:
# WeSender CLI — Diagnostics
# Configuratie
#   ✓ API-key geconfigureerd  ws_live_abc123...
#   ✓ Base URL ingesteld  https://api.wesender.nl
# API-verbinding
#   ✓ Verbinding met API
#   ✓ API-key geldig
# Domeinen
#   ✓ mail.joudomein.nl  Volledig geverifieerd
# ✓ Alles ziet er goed uit!

Commando-overzicht

CommandoBeschrijving
wesender config set-key <key> API-key opslaan
wesender config set-from <adres> Standaard afzender instellen
wesender config show Huidige configuratie tonen
wesender send E-mail versturen
wesender domains list Alle domeinen tonen
wesender domains add <domein> Domein toevoegen + DNS-records tonen
wesender domains verify <domein> DNS-status controleren
wesender emails list Recente e-mails tonen
wesender emails get <id> E-mail detail opvragen
wesender logs Logboek tonen
wesender logs --follow Live logstream
wesender api-keys list API-keys tonen
wesender api-keys create <naam> Nieuwe API-key aanmaken
wesender api-keys delete <id> API-key verwijderen
wesender doctor Diagnostics uitvoeren

Volgende stappen