Was du bauen wirst

In dieser Anleitung baust du einen vollständig funktionsfähigen WhatsApp-Chatbot, der Nachrichten über einen Webhook empfängt und intelligent antwortet. Anders als bei Drag-and-Drop-Buildern hast du mit diesem Ansatz vollständige Kontrolle über die Konversationslogik — verbinde beliebige KI-Modelle, CRMs oder Datenbanken.

Voraussetzungen

Vor dem Start benötigst du:

  • Ein SocialHook-Konto mit verbundener WhatsApp Business API
  • Node.js 18+ und grundlegende Kenntnisse in Express
  • Eine öffentliche URL für deinen Webhook (verwende ngrok für die lokale Entwicklung)

Schritt 1: Webhook-Server einrichten

Erstelle zunächst einen einfachen Express-Server, der Webhook-Payloads von SocialHook empfängt. Jedes Mal, wenn ein Kunde eine WhatsApp-Nachricht an deine Geschäftsnummer sendet, wird SocialHook ein JSON-Payload per POST an diesen Endpunkt senden.

Schritt 2: Payload-Signaturen verifizieren

Verifiziere immer, dass eingehende Anfragen tatsächlich von SocialHook stammen. Jede Zustellung enthält einen X-SocialHook-Signature-Header mit einem HMAC-SHA256-Hash des Payload-Body, signiert mit deinem geheimen Schlüssel.

Lehne jede Anfrage ab, bei der die Signatur nicht übereinstimmt — dies schützt deinen Server vor gefälschten Webhook-Aufrufen.

Schritt 3: Payload parsen

Ein typisches WhatsApp-Nachrichten-Payload sieht so aus:

{"platform":"whatsapp","event":"message.received","from":"+1555001234","message":{"type":"text","body":"Hallo!"}}

Das platform-Feld wird für WhatsApp-Nachrichten immer whatsapp sein. Das event-Feld teilt dir mit, ob dies eine neue Nachricht oder ein neuer Konversationsstart ist.

Schritt 4: Geschäftslogik hinzufügen

Jetzt der spaßige Teil. Du kannst jeden Dienst verbinden, um auf Nachrichten zu antworten. Für einen einfachen Keyword-Bot überprüfe message.body auf Triggerwörter. Für einen KI-gestützten Bot leite die Nachricht an deine bevorzugte LLM-API weiter und sende die Antwort zurück.

Schritt 5: Bereitstellen und testen

Sobald dein Server lokal funktioniert, stelle ihn bei einem Node.js-Hosting-Anbieter bereit — Railway, Render, Fly.io oder deinem eigenen VPS. Aktualisiere deine SocialHook-Webhook-URL auf deinen Produktionsendpunkt und sende eine Testnachricht von WhatsApp, um zu überprüfen, ob alles von Ende zu Ende funktioniert.