Skip to main content
POST
/
user
/
sms
Изпращане на SMS
curl --request POST \
  --url https://call.aiployees.com/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"
  }
}
Този endpoint ви позволява да изпращате SMS съобщения, използвайки закупените от вас телефонни номера. SMS-ът ще бъде изпратен чрез Twilio и разходите ще бъдат автоматично приспаднати от баланса на вашия акаунт.

​
Request Body

​
from
integer
required
ID-то на вашия телефонен номер, от който да изпратите SMS-а (трябва да поддържа SMS)
​
to
string
required
Телефонният номер на получателя в международен формат (например “+1234567890”)
​
body
string
required
Съдържанието на SMS съобщението (макс. 300 знака)

​
Response

​
message
string
Съобщение за успех, потвърждаващо че SMS-ът е изпратен
​
data
object

​
Грешни Отговори

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

​
Забележки

  • Телефонният номер на подателя трябва да принадлежи на удостоверения потребител
  • Телефонният номер на подателя трябва да поддържа SMS
  • Абонаментът за телефонния номер трябва да бъде активен (не изтекъл)
  • Необходим е достатъчен баланс по акаунта за покриване на разходите за SMS
  • Телефонните номера се форматират автоматично в E.164 формат
  • Разходите за SMS варират според държавата на получателя и се таксуват за сегмент
  • Дълги съобщения могат да бъдат разделени на няколко сегмента, увеличавайки цената
  • Телефонният номер на получателя трябва да бъде валиден според международните стандарти