POST
/
api
/
user
/
sms
{
  "from": 12345,
  "to": "+4915123456789",
  "body": "Hallo! Dies ist eine Test-SMS von Famulor."
}
{
  "message": "SMS sent successfully",
  "data": {
    "sms_id": "SMS_67890",
    "from": "+4912345678",
    "to": "+4915123456789",
    "body": "Hallo! Dies ist eine Test-SMS von Famulor.",
    "segments": 1,
    "cost": 0.05,
    "currency": "EUR",
    "status": "sent"
  }
}
Dieser Endpunkt ermöglicht es Ihnen, SMS-Nachrichten über Ihre erworbenen Telefonnummern zu senden. Die SMS wird über Twilio versendet und die Kosten werden automatisch von Ihrem Kontoguthaben abgezogen.

Anfrage-Body

from
integer
required
Die ID Ihrer Telefonnummer, von der die SMS gesendet werden soll (muss SMS-fähig sein)
to
string
required
Die Telefonnummer des Empfängers im internationalen Format (z.B. “+4915123456789”)
body
string
required
Der SMS-Nachrichteninhalt (max. 300 Zeichen)

Antwort-Felder

message
string
Erfolgsmeldung, die bestätigt, dass die SMS gesendet wurde
data
object
Zusätzliche Daten zur gesendeten SMS

Fehler-Antworten

400 Bad Request
object
500 Internal Server Error
object

Hinweise

  • Die Absender-Telefonnummer muss dem authentifizierten Benutzer gehören
  • Die Absender-Telefonnummer muss SMS-fähig sein
  • Das Telefonnummer-Abonnement muss aktiv sein (nicht abgelaufen)
  • Ausreichendes Kontoguthaben ist erforderlich, um die SMS-Kosten zu decken
  • Telefonnummern werden automatisch in das E.164-Format formatiert
  • SMS-Kosten variieren je nach Zielland und werden pro Segment berechnet
  • Lange Nachrichten können in mehrere Segmente aufgeteilt werden, was die Kosten erhöht
  • Die Empfänger-Telefonnummer muss den internationalen Standards entsprechen
{
  "from": 12345,
  "to": "+4915123456789",
  "body": "Hallo! Dies ist eine Test-SMS von Famulor."
}
{
  "message": "SMS sent successfully",
  "data": {
    "sms_id": "SMS_67890",
    "from": "+4912345678",
    "to": "+4915123456789",
    "body": "Hallo! Dies ist eine Test-SMS von Famulor.",
    "segments": 1,
    "cost": 0.05,
    "currency": "EUR",
    "status": "sent"
  }
}