Wie leite ich SMS an einen Webhook-API-Endpunkt weiter?

Anleitung 5 Min. Lesezeit
Link kopieren Teilen

Schnelle Antwort: Forward SMS kann Ihre Textnachrichten als JSON-Webhook an jeden HTTP-Endpunkt senden. Erstellen Sie ein Webhook-Ziel in der App, geben Sie Ihre Endpunkt-URL ein und richten Sie eine Kurzbefehle-Automatisierung ein. Ihr Endpunkt erhält eine POST-Anfrage mit dem Nachrichteninhalt, Absender und Zeitstempel.

Was ist Webhook-SMS-Weiterleitung?

Webhook-SMS-Weiterleitung sendet Ihre Textnachrichten automatisch an jeden HTTP-Endpunkt, den Sie kontrollieren. Im Gegensatz zu plattformspezifischen Integrationen (Slack, Discord, Teams) geben Ihnen Webhooks vollständige Kontrolle darüber, wie Nachrichten verarbeitet werden. Dies ist ideal für Entwickler, die benutzerdefinierte Integrationen, Protokollierungssysteme oder Automatisierungs-Workflows erstellen.

Wenn eine Nachricht ankommt, sendet Forward SMS eine POST-Anfrage an Ihren Endpunkt mit einer strukturierten JSON-Nutzlast, die den Nachrichteninhalt, Absenderinformationen und Metadaten enthält.

Warum Webhooks verwenden

Webhooks bieten Flexibilität, die vorgefertigte Integrationen nicht bieten können:

  • Benutzerdefinierte Automatisierung: Lösen Sie jeden Workflow aus, wenn Sie eine SMS erhalten - aktualisieren Sie Datenbanken, senden Sie Benachrichtigungen, führen Sie Skripte aus oder integrieren Sie mit jedem Dienst
  • Datenprotokollierung: Speichern Sie alle eingehenden Nachrichten in Ihrer eigenen Datenbank für Compliance, Analysen oder Backup-Zwecke
  • Multi-Service-Routing: Verarbeiten Sie Nachrichten mit Ihrer eigenen Logik, um sie basierend auf Inhalt oder Absender an verschiedene Ziele weiterzuleiten
  • Interne Tools: Integrieren Sie SMS-basierte Funktionen in Ihre internen Dashboards und Tools
  • IoT-Integration: Verbinden Sie SMS-Benachrichtigungen mit Ihren IoT-Systemen, Heimautomatisierung oder Überwachungsinfrastruktur

Webhook-Nutzlastformat

Wenn eine Nachricht weitergeleitet wird, erhält Ihr Endpunkt eine POST-Anfrage mit der folgenden JSON-Nutzlast:

{
  "timestamp": "2025-01-31T14:30:00Z",
  "content": "Your verification code is 123456",
  "sender": "+1234567890",
  "contact": "Bank of Example"
}

Nutzlastfelder

| Feld | Typ | Beschreibung | |------|-----|--------------| | timestamp | string | ISO 8601 formatierter Zeitstempel, wann die Nachricht weitergeleitet wurde | | content | string | Der Textnachrichteninhalt | | sender | string | Telefonnummer des Absenders (falls verfügbar) | | contact | string | Kontaktname aus Ihrem Adressbuch (falls zugeordnet) |

Webhook-Weiterleitung einrichten

Schritt 1: Forward SMS herunterladen

Laden Sie Forward SMS aus dem App Store herunter.

Schritt 2: Ein Webhook-Ziel erstellen

Öffnen Sie die App, tippen Sie auf "Ziel hinzufügen" und wählen Sie "Webhook". Geben Sie Ihre Endpunkt-URL ein. Die URL muss aus Sicherheitsgründen HTTPS sein.

Schritt 3: Ihren Endpunkt testen

Verwenden Sie die Schaltfläche "Testnachricht senden", um zu überprüfen, ob Ihr Endpunkt den Webhook korrekt empfängt. Überprüfen Sie Ihre Server-Logs, um zu bestätigen, dass die Nutzlast angekommen ist.

Schritt 4: Kurzbefehle-Automatisierung einrichten

Folgen Sie unserer Kurzbefehle-Einrichtungsanleitung, um die Automatisierung zu erstellen, die die Nachrichtenweiterleitung auslöst.

Implementierungsbeispiele

Hier sind Beispiele für die Webhook-Verarbeitung in verschiedenen Sprachen:

Node.js (Express)

const express = require('express');
const app = express();

app.use(express.json());

app.post('/webhook/sms', (req, res) => {
  const { timestamp, content, sender, contact } = req.body;

  console.log(`Received SMS from ${sender}: ${content}`);

  // Process the message (save to database, trigger automation, etc.)

  res.status(200).json({ received: true });
});

app.listen(3000);

Python (Flask)

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/webhook/sms', methods=['POST'])
def handle_sms():
    data = request.json

    sender = data['sender']
    content = data['content']

    print(f"Received SMS from {sender}: {content}")

    # Process the message

    return jsonify({'received': True}), 200

if __name__ == '__main__':
    app.run(port=3000)

PHP

<?php
$payload = json_decode(file_get_contents('php://input'), true);

$sender = $payload['sender'];
$content = $payload['content'];
$timestamp = $payload['timestamp'];

error_log("Received SMS from $sender: $content");

// Process the message

http_response_code(200);
echo json_encode(['received' => true]);
?>

Ruby (Sinatra)

require 'sinatra'
require 'json'

post '/webhook/sms' do
  payload = JSON.parse(request.body.read)

  sender = payload['sender']
  content = payload['content']

  puts "Received SMS from #{sender}: #{content}"

  # Process the message

  content_type :json
  { received: true }.to_json
end

Sicherheitsüberlegungen

HTTPS verwenden

Verwenden Sie immer HTTPS-Endpunkte, um die Webhook-Nutzlast während der Übertragung zu verschlüsseln. Forward SMS erfordert HTTPS für Webhook-URLs.

Fehler elegant behandeln

Ihr Endpunkt sollte einen 2xx-Statuscode zurückgeben, um den Empfang zu bestätigen. Wenn Forward SMS eine Fehlerantwort erhält, wird der Fehler protokolliert.

Fehlerbehebung

Webhook empfängt keine Nachrichten

  • URL überprüfen: Stellen Sie sicher, dass Ihre Endpunkt-URL korrekt und aus dem Internet zugänglich ist
  • HTTPS verifizieren: Die URL muss HTTPS verwenden, nicht HTTP
  • Firewall-Regeln prüfen: Ihr Server muss eingehende POST-Anfragen akzeptieren
  • Endpunkt testen: Verwenden Sie die Test-Schaltfläche in der App, um die Konnektivität zu überprüfen

Nachrichten kommen langsam an

  • Kurzbefehle-Automatisierung prüfen: Stellen Sie sicher, dass die Automatisierung ohne Bestätigungsanforderung ausgeführt wird
  • Hintergrundaktualisierung: Aktivieren Sie diese für Forward SMS in den iOS-Einstellungen
  • Netzwerkprobleme: Sowohl Ihr iPhone als auch Ihr Server benötigen stabile Internetverbindungen

Nutzlast wird nicht analysiert

  • Content-Type: Die Anfrage verwendet Content-Type: application/json
  • JSON-Parsing: Stellen Sie sicher, dass Ihr Server den JSON-Body korrekt analysiert
  • Zeichenkodierung: Nachrichten sind UTF-8 kodiert

FAQ

Kann ich an mehrere Webhook-Endpunkte weiterleiten?

Ja, erstellen Sie mehrere Webhook-Ziele in Forward SMS. Jedes Ziel kann eine andere Endpunkt-URL haben, und alle erhalten die weitergeleiteten Nachrichten.

Was passiert, wenn mein Endpunkt nicht erreichbar ist?

Wenn Ihr Endpunkt einen Fehler zurückgibt oder nicht erreichbar ist, schlägt die Nachrichtenweiterleitung fehl. Die App protokolliert diese Fehler zur Fehlerbehebung. Erwägen Sie die Implementierung eines Fallback- oder Überwachungssystems.

Gibt es ein Ratenlimit für Webhooks?

Es gibt kein künstliches Ratenlimit von Forward SMS. Nachrichten werden so schnell weitergeleitet, wie sie ankommen und Ihr Endpunkt sie verarbeiten kann.

Kann ich filtern, welche Nachrichten weitergeleitet werden?

Derzeit werden alle Nachrichten, die die Kurzbefehle-Automatisierung auslösen, weitergeleitet. Sie können Filterlogik in Ihrem Webhook-Endpunkt implementieren, um unerwünschte Nachrichten zu ignorieren.

Kann ich HTTP anstelle von HTTPS verwenden?

Nein, aus Sicherheitsgründen erfordert Forward SMS HTTPS-Endpunkte. Dies stellt sicher, dass Ihre Nachrichtendaten während der Übertragung verschlüsselt sind.

Forward SMS Icon

Forward SMS

Automatische SMS-Weiterleitung an E-Mail, Slack, Teams und Discord

Im App Store laden