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