Zum Hauptinhalt springen
POST
https://app.autocalls.ai/api/
/
user
/
sms
SMS senden
curl --request POST \
  --url https://app.autocalls.ai/api/user/sms \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": 123,
  "to": "<string>",
  "body": "<string>"
}
'
{
  "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"
  }
}
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

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. “+1234567890”)
body
string
required
Der SMS-Nachrichteninhalt (max. 300 Zeichen)

Antwort

message
string
Erfolgsmeldung, die bestätigt, dass die SMS gesendet wurde
data
object

Fehlerantworten

400 Bad Request
500 Internal Server Error
{
  "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"
  }
}

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