Telefon santrali ve SMS

SMS gönder

Tek SMS. kind: info bilgilendirme (sipariş, sevkiyat, randevu, ödeme — kampanya içermez) · tacir şirketin kurumsal hattına ticari ileti · bireysel İYS onaylı bireysel alıcıya ticari ileti. Ticari iletinin sonuna çalışma alanının kimlik ve ret satırı eklenir; ret listesindeki numaraya ticari ileti gitmez. Bilgilendirmede kampanya sözcüğü (indirim, kampanya, %…) ya da ret listesindeki numara varsa 409 confirm + need_confirm: true — kullanıcı onaylarsa confirm: 1 ile yeniden gönderin. Değişkenler: {ad} {kişi} {firma} {sorumlu} {sorumlu_tel} {gönderen} {tarih}. Firmaya not düşer.

POST/api/v1/sms/send

Yetkilendirme

Authorizationheaderzorunlu

Bearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).

Modül: MüşterilerKapsam: crm.write

Gövde application/json

textstringzorunlu

Metin (en çok 6 SMS).

kindstringisteğe bağlıvarsayılan: info

İleti türü.

Değerlerinfotacirbireysel

contact_idintegeristeğe bağlı

Kişi (numara ondan).

customer_idintegeristeğe bağlı

Firma (kişi yoksa firma telefonu).

tostringisteğe bağlı

Numara (kayıttaki yerine).

confirmintegeristeğe bağlı

Uyarıyı onayla.

Değerler1

Hatalar

HTTP	error	Anlamı
`400`	`sms`	v67: SMS gönderilemedi (`message`: bağlantı yok, ret listesinde, ticari ileti satırı yok, sağlayıcı hatası).
`409`	`confirm`	v67: onay gerekiyor (`need_confirm: true`) — bilgilendirme metninde kampanya sözcüğü ya da ret listesindeki numara; `confirm: 1` ile yeniden gönderin.
`403`	`plan`	plan
`403`	`module`	Modül lisansta ya da kullanıcının izinlerinde kapalı.

İstek

curl -X POST https://ornek.solk.app/api/v1/sms/send \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/sms/send", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
  },
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/sms/send",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())

Yanıt