DEV Community

Cover image for SMS und WhatsApp Nachrichten schneller senden mit Sent.dm API
Emre Demir
Emre Demir

Posted on • Originally published at apidog.com

SMS und WhatsApp Nachrichten schneller senden mit Sent.dm API

TL;DR / Kurze Antwort

Die Sent.dm API bietet einen einzigen Integrationspunkt für Geschäftsnachrichten via SMS und WhatsApp. In Kombination mit Apidog können Sie Anmeldeinformationen sicher als Umgebungen speichern, Anfragen testen (ohne Wegwerf-Skripte), Webhook-Payloads validieren und Ihren gesamten Messaging-Workflow dokumentieren.

Teste Apidog noch heute

Einführung

Die meisten Messaging-Projekte scheitern nicht an der API selbst, sondern an den operativen Details: Sie brauchen API-Schlüssel, Absenderidentität, Vorlagen-IDs, Webhook-Sicherheit, Kanalregeln und eine strukturierte Teststrategie – ohne dabei echte Nachrichten unkontrolliert zu verschicken.

Sent.dm löst dieses Problem mit einer einheitlichen API für SMS und WhatsApp. Die Plattform übernimmt Routing und Zustelllogik hinter einer einzigen Schnittstelle. Laut den Sent-Dokumenten (Stand: 26.03.2026) umfasst das Angebot Kontoverifizierung, Kanaleinrichtung, vorlagenbasierten Versand, Kontaktmanagement, Webhook-Events und einen Dashboard-Spielplatz.

💡 Tipp: Mit Apidog wird die Einrichtung noch effizienter. Importieren Sie die Sent API-Referenz, legen Sie Umgebungen für x-api-key und x-sender-id an, entwickeln Sie Tests für Nachrichtenerstellung & Webhook-Verarbeitung und teilen Sie Ihre Sammlung im Team. Apidog jetzt kostenlos herunterladen.

Was die Sent.dm API löst

Sent.dm ist für Teams gedacht, die über mehrere Messaging-Kanäle kommunizieren, ohne für jeden Anbieter individuelle Integrationen pflegen zu müssen. Statt SMS- und WhatsApp-APIs, kanalspezifische Payloads und Zustellüberwachung selbst zu verknüpfen, abstrahiert Sent alles in einer Plattform.

Ein Screenshot des Sent.dm Plattform-Dashboards, der verschiedene Nachrichtenstatistiken und Konfigurationsoptionen zeigt.

Die offiziellen Dokumente beschreiben:

  • Eine API-Basis-URL für Messaging-Workflows
  • Header-basierte Authentifizierung mit x-api-key
  • Absenderidentität via x-sender-id
  • Vorlagenbasierte Nachrichten
  • Kontakt- und Zielgruppenmanagement
  • Webhooks für Zustell- und Vorlagenereignisse
  • Intelligentes Routing & Failover

Sie profitieren von:

  • Konsistenten Payloads
  • Sicheren, wiederverwendbaren Vorlagen
  • Ereignisverfolgung für Zustellung und Fehler
  • Testworkflows ohne Geheimnisse im Frontend
  • Nutzbare Dokumentation für Entwickler und QA

Workflow-Schema:

Anwendung -> Nachrichten-API -> Kanalregeln -> Zustellungsereignisse -> Wiederholungs-/Statuslogik
Enter fullscreen mode Exit fullscreen mode

Modellieren Sie diesen kompletten Ablauf von Anfang an in einer API-Plattform wie Apidog, um Debugging zu vereinfachen.

Wie die Sent.dm API funktioniert

Sent agiert als Middleware zwischen Ihrer App und verschiedenen Messaging-Kanälen. Ihre App stellt eine Anfrage, Sent entscheidet über das Routing und wählt den besten Zustellungspfad.

Für Entwickler sind folgende Schritte entscheidend:

1. Konto- und Compliance-Einrichtung

Starten Sie mit Kontoerstellung, KYC-Verifizierung und Geschäftseinrichtung – verpflichtender Teil wegen Compliance und regionaler Vorgaben.

2. Kanaleinrichtung

Wählen Sie eine Telefonnummer und verbinden Sie WhatsApp Business. Empfehlung: eine Nummer für beide Kanäle nutzen, um die Markenidentität zu wahren.

3. Vorlagen

Erstellen Sie Vorlagen vor der ersten API-Anfrage. Vorlagen sind zentral, besonders für WhatsApp.

4. API-Anmeldeinformationen

Sie benötigen:

x-sender-id: IHRE_SENDER_ID
x-api-key: IHR_API_KEY
Enter fullscreen mode Exit fullscreen mode

Nutzen Sie immer die aktuelle Referenz und überprüfen Sie die Endpunktversion im Sent-Dashboard.

5. Nachrichtenanfrage

Der Einstieg erfolgt so:

POST https://api.sent.dm/v2/messages/phone
Enter fullscreen mode Exit fullscreen mode

Payload:

{
  "phoneNumber": "EMPFÄNGER_TELEFONNUMMER",
  "templateId": "VORLAGEN_ID"
}
Enter fullscreen mode Exit fullscreen mode

Praxis-Tipp: Starten Sie stets mit einem soliden, vorlagenbasierten Flow, bevor Sie komplexe Orchestrierung bauen.

Senden Sie Ihre erste Sent.dm API-Anfrage

So testen Sie Nachrichtenversand effizient und nachvollziehbar.

cURL-Beispiel

curl -X POST "https://api.sent.dm/v2/messages/phone" \
 -H "x-sender-id: IHRE_SENDER_ID" \
 -H "x-api-key: IHR_API_KEY" \
 -H "Content-Type: application/json" \
 -d '{
   "phoneNumber": "EMPFÄNGER_TELEFONNUMMER",
   "templateId": "VORLAGEN_ID"
 }'
Enter fullscreen mode Exit fullscreen mode

JavaScript-Beispiel

const response = await fetch("https://api.sent.dm/v2/messages/phone", {
  method: "POST",
  headers: {
    "x-sender-id": process.env.SENT_SENDER_ID,
    "x-api-key": process.env.SENT_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    phoneNumber: process.env.TEST_PHONE_NUMBER,
    templateId: process.env.SENT_TEMPLATE_ID
  })
});

if (!response.ok) {
  throw new Error(`Sent request failed: ${response.status}`);
}

const data = await response.json();
console.log(data);
Enter fullscreen mode Exit fullscreen mode

Python-Beispiel

import os
import requests

response = requests.post(
  "https://api.sent.dm/v2/messages/phone",
  headers={
    "x-sender-id": os.environ["SENT_SENDER_ID"],
    "x-api-key": os.environ["SENT_API_KEY"],
    "Content-Type": "application/json",
  },
  json={
    "phoneNumber": os.environ["TEST_PHONE_NUMBER"],
    "templateId": os.environ["SENT_TEMPLATE_ID"],
  },
  timeout=30,
)

response.raise_for_status()
print(response.json())
Enter fullscreen mode Exit fullscreen mode

Eine erfolgreiche Antwort liefert HTTP 200 und eine messageId. Diese ID sollten Sie für Tests, Logs und Webhook-Abgleich speichern.

Testen Sie die Sent.dm API in Apidog

Mit Apidog wird Ihre API-Testumgebung wiederverwendbar und teamfähig.

Ein Screenshot der Apidog-Benutzeroberfläche, der eine Anfrage zeigt, die mit Umgebungsvariablen, Headern und einem JSON-Body konfiguriert wird.

Schritt 1: Sent-Umgebung anlegen

Legen Sie in Apidog eine Umgebung mit Variablen wie an:

base_url    = https://api.sent.dm
sender_id   = IHRE_SENDER_ID
api_key     = IHR_API_KEY
template_id = IHRE_TEMPLATE_ID
test_phone  = EMPFÄNGER_TELEFONNUMMER
Enter fullscreen mode Exit fullscreen mode

Vorteile: Keine Hardcodierung von Geheimnissen, leichter Umgebungswechsel, sichere Teamweitergabe.

Schritt 2: Anfrage einmalig definieren

  • Methode: POST
  • URL: {{base_url}}/v2/messages/phone
  • Header:
    • x-sender-id: {{sender_id}}
    • x-api-key: {{api_key}}
    • Content-Type: application/json
  • Body:
{
  "phoneNumber": "{{test_phone}}",
  "templateId": "{{template_id}}"
}
Enter fullscreen mode Exit fullscreen mode

Schritt 3: Assertions hinterlegen

Fügen Sie Apidog-Tests hinzu:

pm.test("Status is 200", function () {
  pm.response.to.have.status(200);
});

pm.test("Response contains a messageId", function () {
  const json = pm.response.json();
  pm.expect(json.messageId).to.exist;
});
Enter fullscreen mode Exit fullscreen mode

So erkennen Sie API-Fehler und unerwartete Änderungen sofort.

Schritt 4: Szenarien aufbauen

Erweitern Sie auf Workflows:

  1. Nachricht senden
  2. messageId speichern
  3. Status abfragen (falls unterstützt)
  4. Webhook-Ereignisse abgleichen

Nur so testen Sie den kompletten Nachrichten-Lebenszyklus.

Schritt 5: Webhook-Beispiele anlegen

Speichern Sie typische Webhook-Payloads und dokumentieren Sie Felder wie:

{
  "field": "message.status",
  "messageId": "msg_123",
  "status": "delivered",
  "channel": "whatsapp"
}
Enter fullscreen mode Exit fullscreen mode

Damit beschleunigen Sie Debugging und Onboarding.

Schritt 6: Interne Dokumente veröffentlichen

Nutzen Sie Apidog, um eine teaminterne Referenz mit:

  • Headern
  • Beispiel-Payloads
  • Fehlerantworten
  • Webhook-Beispielen
  • Umgebungshinweisen

zu publizieren. Das sichert Wissen und beschleunigt Übergaben.

Vorlagen, Kontakte und Webhooks richtig handhaben

Vorlagen

Behandeln Sie Vorlagen als versionierten Content. Praktische Vorgehensweise:

  1. Vorlagen-IDs als Umgebungsvariablen speichern
  2. Jede Vorlage nach Zweck, Sprache, Status kennzeichnen
  3. Test- von Live-Vorlagen trennen
  4. Dokumentation: Welche Vorlage für welchen Use Case?

Mit Apidog können Sie für jede Vorlage eigene Beispiele anlegen.

Kontakte

Auch wenn Sie User intern speichern: Kontaktdaten in Sent sind wichtig für Zielgruppen, Vorlagen-Targeting und Verlauf.

Dokumentieren Sie:

  • Wo die Wahrheit liegt (Source of Truth)
  • Telefonnummern-Normalisierung
  • Opt-in/Opt-out-Status
  • Verhalten bei Kanalwechsel

Diese Regeln wirken sich direkt auf Zustellbarkeit und Compliance aus.

Webhooks

Nutzen Sie HMAC-SHA256-Verifizierung (Header: x-webhook-signature, x-webhook-id, x-webhook-timestamp). Sent empfiehlt ein 5-Minuten-Fenster als Replay-Schutz.

Checkliste:

  1. Roher Body lesen
  2. Signatur prüfen (vor dem Parsen)
  3. Abgelaufene Zeitstempel ablehnen
  4. Ereignisse idempotent verarbeiten
  5. Schnell bestätigen, Verarbeitung asynchron

Express.js-Beispiel:

import crypto from "crypto";
import express from "express";

const app = express();

app.post("/webhooks/sent", express.raw({ type: "*/*" }), (req, res) => {
  const signature = req.header("x-webhook-signature");
  const webhookId = req.header("x-webhook-id");
  const timestamp = req.header("x-webhook-timestamp");
  const secret = process.env.SENT_WEBHOOK_SECRET;
  const rawBody = req.body.toString("utf8");

  const signedContent = `${webhookId}.${timestamp}.${rawBody}`;
  const expected = crypto
    .createHmac("sha256", Buffer.from(secret.replace(/^whsec_/, ""), "base64"))
    .update(signedContent)
    .digest("base64");

  if (signature !== `v1,${expected}`) {
    return res.status(401).send("Unauthorized");
  }

  const event = JSON.parse(rawBody);
  console.log("Received webhook event:", event.field);

  return res.sendStatus(200);
});
Enter fullscreen mode Exit fullscreen mode

Verwenden Sie Apidog zum Speichern und Testen von Beispiel-Payloads sowie zur Dokumentation der erwarteten Events.

Warum Apidog zu diesem Workflow passt

Sent.dm liefert die Messaging-Schicht. Apidog bringt Kollaboration, Testautomatisierung, Mocking und Dokumentation.

Aufgabe Sent.dm Apidog
SMS- und WhatsApp-Nachrichten senden Ja Nein, aber testet die API
Vorlagen und Absendereinrichtung verwalten Ja Dokumentiert & validiert Requests
Authentifizierte Anfragen testen Basis-Playground Starke Umgebungen, Assertions, Szenarien
API-Dokumente mit dem Team teilen Plattform-Doku Team-Sammlungen, generierte Dokumente
Anfrage-/Antwortfluss debuggen Partiell Wiederholbare Inspektion, Kollaboration
End-to-End-Testszenarien erstellen Messaging-fokussiert Mehrstufige API-Workflows

Koppeln Sie Sent mit Apidog, wenn Sie:

  • Mehrere Entwickler onboarden möchten
  • QA-Tests ohne Skripte brauchen
  • Änderungen, Vorlagen oder Webhook-Payloads wiederholbar testen wollen

Erweiterte Tipps und häufige Fehler

Best Practices

  1. API-Schlüssel niemals im Frontend speichern.
  2. messageId immer loggen und für Support-Workflows nutzen.
  3. Staging- und Produktionsvorlagen strikt trennen.
  4. Webhooks immer verifizieren.
  5. Apidog-Umgebungen nutzen, um Test- und Live-Geheimnisse zu trennen.

Häufige Fehler vermeiden

  1. HTTP 200 als endgültige Zustellung interpretieren (Lifecycle beachten!)
  2. Vorlagen-IDs fest codieren
  3. Absenderidentität zu spät einrichten
  4. Telefonnummern nicht normalisieren
  5. Mit echten Schlüsseln in Ad-hoc-Skripten testen

Fehlerbehebung

Checkliste bei Problemen:

  1. Ist der x-api-key gültig?
  2. Stimmt die Endpunktversion?
  3. Ist x-sender-id erforderlich?
  4. Ist die Vorlage genehmigt und für den Kanal verfügbar?
  5. Ist die Telefonnummer korrekt formatiert?

Mit Apidog vergleichen Sie Problemfälle schnell mit funktionierenden Requests.

Sent.dm Alternativen und Vergleiche

Option Stärke Kompromiss
Direkte SMS- & WhatsApp-Anbieter Maximale Kontrolle Mehr Integrations- und Wartungsaufwand
Kommunikations-Stack (Twilio) Großes Ökosystem Komplexere Multi-Kanal-Orchestrierung
Sent.dm Einheitlicher Messaging-Workflow Abhängigkeit von Plattformkonventionen
Sent.dm + Postman Vertraute Request-Tests Kollaborations- und Doku-Workflows fragmentiert
Sent.dm + Apidog Starke API-Tests, Doku & Kollaboration Zwei Tools statt einem

Die Kombination aus Sent und Apidog liefert Geschwindigkeit und Wiederholbarkeit im Team. Besonders Apidog punktet mit Umgebungen, Doku, Assertions und Workflow-Management in einem Tool.

Fazit

Sent.dm ist eine zentrale Messaging-API für SMS & WhatsApp. Der größte Mehrwert: Sie können Vorlagen, Absender, Kontakte und Webhooks strukturiert testen und produktionsreif dokumentieren.

Starten Sie, indem Sie die erste Sent-Anfrage in Apidog abbilden, Assertions für messageId hinterlegen und Webhooks im selben Workspace dokumentieren – das beschleunigt Ihren Weg vom Prototyp zur Produktion.

FAQ

Wofür wird die Sent.dm API verwendet?

Für Geschäftsnachrichten via SMS und WhatsApp über eine einzige Integration. Unterstützt Absender, Vorlagen, Kontakte und Webhooks.

Unterstützt Sent.dm WhatsApp und SMS in einer API?

Ja, eine einheitliche API abstrahiert beide Kanäle. Empfehlung: eine Nummer für beide Kanäle nutzen.

Welche Header benötige ich für Sent.dm API-Anfragen?

x-api-key (Pflicht), x-sender-id (für Nachrichten). Prüfen Sie die Endpunktversion vor Produktionseinsatz.

Benötige ich Vorlagen, bevor ich Nachrichten mit Sent.dm sende?

Ja. Onboarding verlangt das Anlegen einer Vorlage und Versand mit templateId.

Wie teste ich die Sent.dm API, ohne benutzerdefinierte Skripte zu schreiben?

Mit Apidog speichern Sie Anmeldeinformationen als Umgebungsvariablen, speichern Anfragen, fügen Assertions hinzu, bauen Szenarien, dokumentieren Webhooks und veröffentlichen interne Dokus.

Wie sollte ich Sent.dm Webhooks sichern?

HMAC-Signatur prüfen, Zeitstempel validieren, Ereignisse idempotent verarbeiten. Verwenden Sie die Header x-webhook-signature, x-webhook-id, x-webhook-timestamp.

Reicht Sent.dm allein für Team-API-Workflows aus?

Für Messaging ja, aber für kollaborative API-Tests, Dokumentation und Validierung empfiehlt sich zusätzlich ein Tool wie Apidog.

Top comments (0)