Hoppa till innehåll

n8n-integration

Med n8n kan du automatiskt bearbeta kommande hämtningsdatum – till exempel för push-aviseringar, Slack- eller Matrix-meddelanden, åtgärder i smarta hem eller egna arbetsflöden. Integrationen fungerar via binables webhook-mekanism: binable skickar en daglig HTTP POST till ditt n8n-arbetsflöde kl. 18:00 när en hämtning är på gång inom det konfigurerade antalet dagar.

1. Skapa API-nyckel

För att skapa webhooks behöver du först en API-nyckel.

Skaffa gratis API-nyckel

2. Skapa Webhook Trigger i n8n

Lägg till en Webhook-triggernod som första nod i ditt n8n-arbetsflöde:

Aktivera arbetsflödet (växla "Active" uppe till höger) så att n8n tillhandahåller den inkommande URL:en. Den fullständiga webhook-URL:en är:

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

3. Registrera webhook hos binable

Registrera n8n-webhook-URL:en via binable-API:et:

curl -X POST https://binable.app/api/webhook \
  -H "Authorization: ApiKey <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"
  }'

Svaret innehåller en secret som du behöver för valfri signaturverifiering.

4. Bearbeta payload

När en hämtning är på gång skickar binable en POST med följande body till din 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" }
  ]
}

I n8n är fälten direkt tillgängliga via webhook-noden. Anslut valfria åtgärdsnoder efteråt – till exempel Send Email, Slack, Telegram, ntfy eller en HTTP Request-nod för egna system.

5. Valfritt: Signaturverifiering

Varje inkommande förfrågan innehåller headern X-Muell-Signature: sha256=<hmac>. För att säkerställa att förfrågan verkligen kommer från binable kan du lägga till en Code-nod före dina åtgärder i n8n för att kontrollera signaturen:

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();

Mer information om det fullständiga webhook-API:et finns i dokumentationen för webhook-integrationen. Webhook-Integrationsdokumentation.

← Översikt över integrationer  ·  Fullständig API-dokumentation