Naar inhoud springen

n8n Integratie

Met n8n kunt u aankomende inzameldatums automatisch verwerken – bijvoorbeeld voor pushmeldingen, Slack- of Matrix-berichten, smart home-acties of aangepaste workflows. De integratie werkt via het webhookmechanisme van müll.io: müll.io stuurt dagelijks om 18:00 uur een HTTP POST naar uw n8n-workflow wanneer een inzameling gepland is in het geconfigureerde aantal dagen.

1. API-sleutel aanmaken

Om webhooks aan te maken, heeft u eerst een API-sleutel nodig.

Gratis API-sleutel aanvragen

2. Webhook Trigger aanmaken in n8n

Voeg een Webhook trigger node toe als eerste node in uw n8n-workflow:

Activeer de workflow (schakel "Active" rechtsboven in) zodat n8n de inkomende URL verstrekt. De volledige webhook-URL is:

https://<deine-n8n-instanz>/webhook/muell-abfuhr

3. Webhook registreren bij müll.io

Registreer de n8n webhook-URL via de müll.io API:

curl -X POST https://müll.io/api/webhook \
  -H "Authorization: API-KEY <dein-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://<deine-n8n-instanz>/webhook/muell-abfuhr",
    "daysBeforeCollection": 1,
    "street": "Musterstraße",
    "houseNumber": "1a",
    "zip": "12345",
    "city": "Musterstadt",
    "country": "DE"
  }'

Het antwoord bevat een geheim dat u nodig heeft voor optionele handtekeningverificatie.

4. Payload verwerken

Wanneer een inzameling gepland is, stuurt müll.io een POST met de volgende body naar uw n8n-webhook:

{
  "event": "upcoming_collection",
  "sent_at": "2024-01-14T18:00:00+00:00",
  "days_until": 1,
  "address": {
    "street": "Musterstraße",
    "houseNumber": "1a",
    "zip": "12345",
    "city": "Musterstadt",
    "country": "DE"
  },
  "collections": [
    { "type": "Restmüll", "date": "2024-01-15" },
    { "type": "Papier",   "date": "2024-01-15" }
  ]
}

In n8n zijn de velden rechtstreeks beschikbaar via de webhook node. Verbind daarna eventuele actienodes – zoals E-mail verzenden, Slack, Telegram, ntfy of een HTTP Request node voor aangepaste systemen.

5. Optioneel: Handtekeningverificatie

Elk inkomend verzoek bevat de header X-Muell-Signature: sha256=<hmac>. Om te zorgen dat het verzoek echt afkomstig is van müll.io, kunt u voor uw acties in n8n een Code node toevoegen om de handtekening te controleren:

const crypto = require('crypto');
const secret = '<dein-webhook-secret>';
const body = JSON.stringify($input.first().json);
const sig = $input.first().headers['x-muell-signature'];
const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(body).digest('hex');
if (sig !== expected) throw new Error('Invalid signature');
return $input.all();

Meer details over de volledige webhook API vindt u in de webhook integratiedocumentatie. Webhook-Integrationsdokumentation.

← Overzicht integraties  ·  Volledige API-documentatie