Telefon Numarası Oluştur

Yeni bir telefon numarası ekleyin ve SIP yapılandırması yapın

Endpoint

POST/phone-numbers

Hesabınıza yeni bir telefon numarası ekler ve SIP yapılandırması yapar.

İstek Gövdesi

numberstring (required)

E.164 formatında telefon numarası (örn: +905551234567)

namestring (optional)

Telefon numarasının görünen adı

sipDomainstring (required)

SIP sunucu domaini (örn: sip.verimor.com.tr)

sipUsernamestring (required*)

SIP kullanıcı adı (*IP trunk kullanmıyorsanız gerekli)

sipPasswordstring (required*)

SIP şifresi (*IP trunk kullanmıyorsanız gerekli)

assistantIdstring (optional)

Bu numaraya atanacak asistan ID'si

sipTransportstring (optional)

SIP transport protokolü: "udp", "tcp", veya "tls" (varsayılan: "udp")

sipPortnumber (optional)

SIP port numarası (varsayılan: 5060)

registerboolean (optional)

SIP kaydı yapılsın mı (varsayılan: true)

isIpTrunkboolean (optional)

IP trunk modu (IP whitelist kullanılıyorsa true, varsayılan: false)

İstek Örneği

cURL - Standart SIP Kaydı

curl -X POST https://api.wespoke.ai/api/v1/phone-numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "+905551234567",
    "name": "Müşteri Hizmetleri Hattı",
    "sipDomain": "sip.verimor.com.tr",
    "sipUsername": "user123",
    "sipPassword": "secure_password_123",
    "assistantId": "ast_9876543210"
  }'

cURL - IP Trunk (Kimlik Bilgisi Olmadan)

curl -X POST https://api.wespoke.ai/api/v1/phone-numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "+905551234567",
    "name": "IP Trunk Hattı",
    "sipDomain": "sip.provider.com",
    "isIpTrunk": true,
    "assistantId": "ast_9876543210"
  }'

Yanıt Örneği

201 Created

{
  "success": true,
  "data": {
    "id": "clxxx1234567890",
    "number": "+905551234567",
    "name": "Müşteri Hizmetleri Hattı",
    "sipDomain": "sip.verimor.com.tr",
    "sipUsername": "user123",
    "sipTransport": "udp",
    "sipPort": 5060,
    "register": true,
    "active": true,
    "isIpTrunk": false,
    "assistantId": "ast_9876543210",
    "userId": "usr_1234567890",
    "createdAt": "2025-02-15T10:30:00.000Z",
    "updatedAt": "2025-02-15T10:30:00.000Z"
  }
}

Hata Yanıtları

400 Bad Request - Eksik Alan

{
  "success": false,
  "error": {
    "message": "Invalid request data",
    "code": "VALIDATION_ERROR",
    "details": [
      {
        "code": "invalid_type",
        "expected": "string",
        "received": "undefined",
        "path": ["sipDomain"],
        "message": "Required"
      }
    ]
  }
}

400 Bad Request - Numara Zaten Mevcut

{
  "success": false,
  "error": {
    "message": "Phone number already exists",
    "code": "DUPLICATE_NUMBER"
  }
}

400 Bad Request - IP Trunk Dışında Kimlik Bilgisi Gerekli

{
  "success": false,
  "error": {
    "message": "Invalid request data",
    "code": "VALIDATION_ERROR",
    "details": [
      {
        "code": "custom",
        "message": "SIP username and password are required for non-IP trunk numbers",
        "path": ["sipUsername"]
      }
    ]
  }
}

Numara Detayı Numara Güncelleme