> ## Documentation Index
> Fetch the complete documentation index at: https://docs.web-wb.de/llms.txt
> Use this file to discover all available pages before exploring further.

# SMS senden

> Eine SMS-Nachricht mit Ihrer Telefonnummer senden

Dieser Endpunkt ermöglicht es Ihnen, SMS-Nachrichten mit Ihren gekauften Telefonnummern zu senden. Die SMS wird über Twilio gesendet und die Kosten werden automatisch von Ihrem Kontoguthaben abgezogen.

### Anfragekörper

<ParamField body="from" type="integer" required>
  Die ID Ihrer Telefonnummer, von der die SMS gesendet werden soll (muss SMS-fähig sein)
</ParamField>

<ParamField body="to" type="string" required>
  Die Telefonnummer des Empfängers im internationalen Format (z. B. "+1234567890")
</ParamField>

<ParamField body="body" type="string" required>
  Der SMS-Nachrichteninhalt (max. 300 Zeichen)
</ParamField>

### Antwort

<ResponseField name="message" type="string">
  Erfolgsmeldung, die bestätigt, dass die SMS gesendet wurde
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="Eigenschaften">
    <ResponseField name="id" type="integer">
      Die eindeutige Kennung des SMS-Datensatzes
    </ResponseField>

    <ResponseField name="phone_number_id" type="integer">
      Die ID der zum Senden der SMS verwendeten Telefonnummer
    </ResponseField>

    <ResponseField name="to" type="string">
      Die Telefonnummer des Empfängers im E.164-Format
    </ResponseField>

    <ResponseField name="body" type="string">
      Der SMS-Nachrichteninhalt
    </ResponseField>

    <ResponseField name="user_id" type="integer">
      Die ID des Benutzers, der die SMS gesendet hat
    </ResponseField>

    <ResponseField name="segments" type="integer">
      Anzahl der SMS-Segmente (für Abrechnungszwecke)
    </ResponseField>

    <ResponseField name="segment_price" type="number">
      Kosten pro SMS-Segment
    </ResponseField>

    <ResponseField name="total_cost" type="number">
      Gesamtkosten der SMS (segment\_price \* segments)
    </ResponseField>

    <ResponseField name="status" type="string">
      Der aktuelle Status der SMS
    </ResponseField>

    <ResponseField name="sms_sid" type="string">
      Twilio-SMS-SID zur Nachverfolgung
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Datum und Uhrzeit der Erstellung der SMS
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Datum und Uhrzeit der letzten Aktualisierung der SMS
    </ResponseField>
  </Expandable>
</ResponseField>

### Fehlerantworten

<ResponseField name="400 Bad Request">
  <Expandable title="Fehlerantwort">
    <ResponseField name="message" type="string">
      Fehlermeldung, die das Problem beschreibt (ungültige Telefonnummer, unzureichendes Guthaben usw.)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="500 Internal Server Error">
  <Expandable title="Fehlerantwort">
    <ResponseField name="message" type="string">
      Fehlermeldung, die anzeigt, dass das Senden der SMS fehlgeschlagen ist
    </ResponseField>

    <ResponseField name="error" type="string">
      Detaillierte Fehlerinformationen
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 201 Erfolgsantwort theme={null}
  {
    "message": "SMS sent successfully",
    "data": {
      "id": 456,
      "phone_number_id": 78,
      "to": "+1234567890",
      "body": "Hello! This is a test message from Your Company. How can we help you today?",
      "user_id": 1,
      "segments": 1,
      "segment_price": 0.0075,
      "total_cost": 0.0075,
      "status": "sent",
      "sms_sid": "SM1234567890abcdef1234567890abcdef",
      "created_at": "2025-08-04 15:30:00",
      "updated_at": "2025-08-04 15:30:02"
    }
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "message": "From number not found"
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "message": "Invalid to phone number"
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "message": "Insufficient balance"
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "message": "From number is not SMS capable"
  }
  ```

  ```json 500 Interner Serverfehler theme={null}
  {
    "message": "Failed to send SMS",
    "error": "Twilio API error details"
  }
  ```
</ResponseExample>

### Hinweise

* Die Absender-Telefonnummer muss dem authentifizierten Benutzer gehören
* Die Absender-Telefonnummer muss SMS-fähig sein
* Das Telefonnummern-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, wodurch die Kosten steigen
* Die Empfänger-Telefonnummer muss den internationalen Standards entsprechen