Launch-Angebot: −50 % auf deine erste Zahlung, bis 30. November.Zum Angebot →
webhook·toolkit
Twilio

Twilio-Webhook lokal testen

Einen Twilio-Handler (SMS oder eingehender Anruf) zu validieren, ohne echte kostenpflichtige Nachrichten zu versenden: Das ist möglich. Generiere einen signierten Twilio-Request (X-Twilio-Signature, HMAC-SHA1) im form-urlencoded-Format, bearbeite die Parameter (From, To, Body) und sende ihn an deinen lokalen Server.

Generiere die Signatur, um die Headers, den Body und den fertig kopierbaren cURL-Befehl zu sehen.

Signatur serverseitig prüfen

handler.js (Node)
const twilio = require('twilio');
const valid = twilio.validateRequest(
  process.env.TWILIO_AUTH_TOKEN,
  req.headers['x-twilio-signature'],
  fullUrl,            // muss mit der oben verwendeten Ziel-URL übereinstimmen
  req.body            // POST-Parameter
);

Um einen echten Twilio-Webhook auf deiner Maschine zu empfangen, richte die Nummer auf deinen Relay-Tunnel aus.

Signature coming back invalid? This page signs. The Twilio signature validator does the opposite: paste the signature Twilio actually sent and it tells you which URL variant matches — which is to say, which line of your code is lying.

Häufige Fragen

Wie teste ich eine eingehende Twilio-SMS lokal?

Wähle das Event 'Incoming SMS', trage deinen Auth Token und die exakte URL deines Handlers ein (die Twilio-Signatur hängt von der URL ab) und sende. Der X-Twilio-Signature-Header wird in HMAC-SHA1 über URL + sortierte Parameter berechnet, genau wie Twilio es macht.

Warum muss ich die Ziel-URL angeben?

Die Twilio-Signatur bezieht die vollständige Webhook-URL in die HMAC-Berechnung ein. Ohne die richtige URL ist die Signatur serverseitig nicht gültig. Deshalb ist das Feld Ziel-URL bei Twilio Pflicht.

Ist das Format wirklich form-urlencoded?

Ja. Anders als Stripe oder GitHub (JSON) sendet Twilio application/x-www-form-urlencoded. Der Generator erzeugt den richtigen Content-Type und kodiert die Parameter korrekt.

Ist Twilio im Gratis-Plan enthalten?

Nein: Alle Signer-Anbieter, auch Twilio, sind kostenlos. Der 7-Tage-Pass (5 €) und Pro (9 €/Monat) bringen KI-Erklärungen, 25 permanente URLs, 30 Tage Verlauf und den Relay-Tunnel, der dein lokales TwiML an Twilio zurückgibt.

Launch-Angebot · −50 %

Debuggst du diese Woche eine Webhook-Integration?

Der 7-Tage-Pass schaltet KI-Erklärungen und fertigen Handler-Code frei, dazu 25 dauerhafte URLs, 30 Tage Verlauf und den Relay-Tunnel zu localhost. Einmal zahlen, kein Abo.

5 € 2,50 € einmalig
Einmalzahlung · kein Abo · 14 Tage Geld-zurück · Launch-Preis bis 30. November
Twilio-Webhook lokal testen — gültige X-Twilio-Signature · Webhook Toolkit