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.
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.
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
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
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
Payload:
{
"phoneNumber": "EMPFÄNGER_TELEFONNUMMER",
"templateId": "VORLAGEN_ID"
}
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"
}'
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);
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())
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.
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
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}}"
}
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;
});
So erkennen Sie API-Fehler und unerwartete Änderungen sofort.
Schritt 4: Szenarien aufbauen
Erweitern Sie auf Workflows:
- Nachricht senden
-
messageIdspeichern - Status abfragen (falls unterstützt)
- 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"
}
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:
- Vorlagen-IDs als Umgebungsvariablen speichern
- Jede Vorlage nach Zweck, Sprache, Status kennzeichnen
- Test- von Live-Vorlagen trennen
- 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:
- Roher Body lesen
- Signatur prüfen (vor dem Parsen)
- Abgelaufene Zeitstempel ablehnen
- Ereignisse idempotent verarbeiten
- 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);
});
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
- API-Schlüssel niemals im Frontend speichern.
-
messageIdimmer loggen und für Support-Workflows nutzen. - Staging- und Produktionsvorlagen strikt trennen.
- Webhooks immer verifizieren.
- Apidog-Umgebungen nutzen, um Test- und Live-Geheimnisse zu trennen.
Häufige Fehler vermeiden
- HTTP
200als endgültige Zustellung interpretieren (Lifecycle beachten!) - Vorlagen-IDs fest codieren
- Absenderidentität zu spät einrichten
- Telefonnummern nicht normalisieren
- Mit echten Schlüsseln in Ad-hoc-Skripten testen
Fehlerbehebung
Checkliste bei Problemen:
- Ist der
x-api-keygültig? - Stimmt die Endpunktversion?
- Ist
x-sender-iderforderlich? - Ist die Vorlage genehmigt und für den Kanal verfügbar?
- 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)