Ana içeriğe atla
POST
/
user
/
sms
SMS Gönder
curl --request POST \
  --url https://app.whattalk.ai/api/user/sms \
  --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"
  }
}
Bu endpoint, satın aldığınız telefon numaralarını kullanarak SMS mesajları göndermenizi sağlar. SMS, Twilio aracılığıyla gönderilir ve maliyetler otomatik olarak hesap bakiyenizden düşülür.

İstek Gövdesi

from
integer
gerekli
SMS’in gönderileceği telefon numaranızın kimliği (SMS özellikli olmalıdır)
to
string
gerekli
Alıcının uluslararası formattaki telefon numarası (ör. “+1234567890”)
body
string
gerekli
SMS mesaj içeriği (maksimum 300 karakter)

Yanıt

message
string
SMS’in gönderildiğini onaylayan başarı mesajı
data
object

Hata Yanıtları

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"
  }
}

Notlar

  • Gönderen telefon numarası kimliği doğrulanmış kullanıcıya ait olmalıdır
  • Gönderen telefon numarası SMS özellikli olmalıdır
  • Telefon numarası aboneliği aktif olmalıdır (süresi dolmamış)
  • SMS maliyetlerini karşılamak için yeterli hesap bakiyesi gereklidir
  • Telefon numaraları otomatik olarak E.164 formatına dönüştürülür
  • SMS maliyetleri hedef ülkeye göre değişir ve segment başına ücretlendirilir
  • Uzun mesajlar birden fazla segmente bölünebilir, bu da maliyeti artırır
  • Alıcı telefon numarası uluslararası standartlara göre geçerli olmalıdır