Uygulamanızdan SMS gönderimini otomatikleştirin.
WaMessage SMS API ile işlem mesajlarını ve uygun koşullardaki OTP senaryolarını kendi yazılımınızdan tetikleyin. Operasyon ekibinin panelden gönderdiği SMS ile geliştirici API kullanımını birbirine karıştırmayın.
{
"api_key": "YOUR_API_KEY",
"sender": "SMS TEST",
"message_type": "normal",
"message": "Dogrulama kodunuz: 482913",
"phones": ["905551112233"]
}
// API anahtarı WaMessage panelinden alınır
SMS API, CRM, ERP, e-ticaret veya özel yazılımların WaMessage üzerinden programatik SMS göndermesini sağlar. API anahtarı WaMessage panelinden alınır; mesaj koşullarına göre OTP veya standart SMS gönderim yöntemi kullanılabilir.
OTP ile standart SMS kurallarını ayrı değerlendirin.
Ürün kuralınız gereği 1 SMS boyunda ve standart/Latin karakterli içerik OTP koşulunu karşılıyorsa sistem OTP kanalını otomatik değerlendirebilir.
Tek kullanımlık doğrulama mesajlarını otomatik tetikleyin.
Mesaj 1 SMS uzunluğunda ve standart/Latin karakterli OTP yapısındaysa sistem OTP kanalına uygunluğu otomatik değerlendirebilir.
{
"to": "905xxxxxxxxx",
"message": "Dogrulama kodunuz: 482913"
}
SMS API kullanımını geliştirici gözüyle sade tutun.
API anahtarı WaMessage panelinden alınır ve tüm SMS API işlemlerinde yetkilendirme için kullanılır.
API anahtarını alın
WaMessage panelinden hesabınıza ait API anahtarını oluşturun.
İsteği hazırlayın
Alıcı ve mesaj içeriğini uygulamanızdan API isteğine ekleyin.
Mesaj kuralını kontrol edin
OTP koşullarına uyan mesajlar sistem tarafından uygun kanalda değerlendirilir.
Sonucu işleyin
API yanıtını uygulamanızda kayıt ve işlem akışınızla ilişkilendirin.
cURL, PHP, Node.js ve Python ile aynı istek.
Aşağıdaki örneklerin tamamı /1toN endpointine aynı JSON gövdesini gönderir; kopyalayıp YOUR_API_KEY değerini değiştirmeniz yeterli.
curl -X POST "https://api.toplusms.app/api/v1/1toN" \
-H "Content-Type: application/json" \
-d '{
"api_key":"YOUR_API_KEY",
"sender":"SMS TEST",
"message_type":"normal",
"message_content_type":"bilgi",
"message":"WaMessage test mesajıdır.",
"phones":["905551112233"],
"add_cancel_link":true
}'SDK zorunluluğu yok — REST + JSON kullandığı için C#, Java, Go dahil HTTP isteği atabilen her dil bağlanır. Test için Postman koleksiyonunu indirin veya geliştirici dokümanına (PDF) bakın.
Tüm uç noktalar ve alanlar.
Gönderimden kara listeye 12 uç noktanın tamamı; her alanın açıklaması ve gerçek istek/yanıt örnekleriyle.
Gönderim
Tek kullanımlık şifre ve hızlı bilgilendirme kanalı. Mesaj 1 SMS uzunluğunda ve Türkçe karakter içermiyorsa sistem gönderimi otomatik olarak OTP kanalına yönlendirir; doğrulama kodları için en hızlı yol budur.
| Alan | Zorunlu | Açıklama |
|---|---|---|
api_key | Evet | Panelden alınan API anahtarı |
sender | Evet | Onaylı gönderici başlığı (/senders yanıtından) |
message_type | Evet | Mesaj tipi; örneklerde normal |
message | Evet | Gönderilecek mesaj içeriği |
phones | Evet | Alıcı numara listesi, örn. ["905551112233"] |
add_cancel_link | Hayır | true ise mesaja iptal linki eklenir |
{
"api_key": "YOUR_API_KEY",
"sender": "SMS TEST",
"message_type": "normal",
"message": "Dogrulama kodunuz: 482913",
"phones": ["905551112233"],
"add_cancel_link": false
}{
"id": 3411916,
"code": 200,
"status": "success",
"description": "SMS gönderimi başarıyla tamamlandı.",
"quantity": 982,
"numberCount": 1,
"amount": 1
}Tek mesaj, çok numara: aynı içeriği listedeki tüm numaralara gönderir. Kampanya ve toplu bilgilendirme için temel endpointtir. OTP koşullarını karşılayan mesajlar otomatik olarak hızlı kanala yönlendirilir.
| Alan | Zorunlu | Açıklama |
|---|---|---|
api_key | Evet | API anahtarı |
sender | Evet | Onaylı gönderici başlığı |
message_type | Evet | Mesaj tipi; örneklerde normal |
message_content_type | Evet | İçerik tipi; örneklerde bilgi |
message | Evet | Tüm alıcılara gidecek ortak mesaj |
phones | Evet | Alıcı numara listesi |
add_cancel_link | Hayır | Ticari iletilerde iptal linki ekler |
{
"api_key": "YOUR_API_KEY",
"sender": "SMS TEST",
"message_type": "normal",
"message_content_type": "bilgi",
"message": "Hafta sonuna özel %20 indirim!",
"phones": ["905551112233", "905554445566"],
"add_cancel_link": true
}{
"id": 3411916,
"code": 200,
"status": "success",
"description": "SMS gönderimi başarıyla tamamlandı.",
"quantity": 982,
"numberCount": 1,
"amount": 1
}Numaraya özel mesaj: her alıcıya farklı içerik gönderir (isim, sipariş no, randevu saati...). send_time alanıyla ileri tarihli gönderim planlanır.
| Alan | Zorunlu | Açıklama |
|---|---|---|
api_key | Evet | API anahtarı |
sender | Evet | Onaylı gönderici başlığı |
message_type | Evet | Mesaj tipi |
send_time | Hayır | İleri tarih; format YYYY-MM-DD HH:mm:ss, boşsa hemen gönderilir |
phones | Evet | Her öğesi {"phone": "...", "message": "..."} olan liste |
add_cancel_link | Hayır | İptal linki ekleme seçeneği |
{
"api_key": "YOUR_API_KEY",
"sender": "SMS TEST",
"message_type": "normal",
"send_time": "2026-12-17 13:15:00",
"phones": [
{"phone": "905551112233", "message": "Sayın Ali Bey, randevunuz yarın 14.00"},
{"phone": "905554445566", "message": "Sayın Ayşe Hanım, siparişiniz kargoda"}
],
"add_cancel_link": true
}{
"id": 3411916,
"code": 200,
"status": "success",
"description": "SMS gönderimi başarıyla tamamlandı.",
"quantity": 982,
"numberCount": 1,
"amount": 1
}Hesap
Hesabınıza tanımlı onaylı gönderici başlıklarını listeler.
| Alan | Zorunlu | Açıklama |
|---|---|---|
api_key | Evet | API anahtarı |
{
"api_key": "YOUR_API_KEY"
}{
"data": [
{
"id": 13230,
"sender": "SMS TEST",
"status": "1",
"description": "1 Günlük Gönderici Adı",
"created_at": "2026-08-06 09:28:06"
}
],
"status": 200
}Hesap bilgilerinizi ve kalan kredinizi döndürür; credit alanı kalan SMS kredisidir.
| Alan | Zorunlu | Açıklama |
|---|---|---|
api_key | Evet | API anahtarı |
{
"api_key": "YOUR_API_KEY"
}{
"code": 200,
"status": "success",
"data": {
"id": 7895,
"username": "firma_kullanicisi",
"phone": "+905551112233",
"email": "[email protected]",
"cancel_link_end_date": "2027-02-24",
"require_login_otp": false,
"credit": 981
}
}Raporlama
Belirli bir gönderimin alıcı bazlı teslimat detayını döndürür: her numara için durum açıklaması ve iletim zamanı.
| Alan | Zorunlu | Açıklama |
|---|---|---|
api_key | Evet | API anahtarı |
report_id | Evet | Gönderim yanıtındaki kimlik |
{
"api_key": "YOUR_API_KEY",
"report_id": 16535
}{
"code": 200,
"status": "success",
"data": [
{
"id": 31359598,
"phone": "905551112233",
"message": "test",
"status_description": "İletim başarılı.",
"result_time": "2026-08-06 09:30:11",
"created_at": "2026-08-06 09:29:59"
}
]
}İki tarih arasındaki tüm gönderimlerin özet raporlarını döndürür.
| Alan | Zorunlu | Açıklama |
|---|---|---|
api_key | Evet | API anahtarı |
start_date | Evet | Başlangıç; YYYY-MM-DD HH:mm:ss |
end_date | Evet | Bitiş; YYYY-MM-DD HH:mm:ss |
{
"api_key": "YOUR_API_KEY",
"start_date": "2026-07-01 00:00:00",
"end_date": "2026-08-01 00:00:00"
}{
"code": 200,
"status": "success",
"data": [
{
"id": 3412025,
"message": "merhabalar",
"sender": "SMS TEST",
"credit_before": 982,
"count": 1,
"success": 1,
"fail": 0,
"created_at": "2026-08-06 09:33:43",
"completed_at": "2026-08-06 09:33:45"
}
]
}Tek bir gönderimin özet raporunu döndürür: toplam alıcı, başarılı/başarısız sayısı ve tamamlanma zamanı.
| Alan | Zorunlu | Açıklama |
|---|---|---|
api_key | Evet | API anahtarı |
report_id | Evet | Gönderim yanıtındaki kimlik |
{
"api_key": "YOUR_API_KEY",
"report_id": 16589
}{
"code": 200,
"status": "success",
"data": {
"id": 3411758,
"message": "test",
"sender": "SMS TEST",
"credit_before": 984,
"count": 1,
"success": 1,
"fail": 0,
"created_at": "2026-08-06 09:29:59",
"completed_at": "2026-08-06 09:30:05"
}
}Yönetim
Henüz gönderilmemiş, send_time ile planlanmış ileri tarihli bir gönderimi iptal eder.
| Alan | Zorunlu | Açıklama |
|---|---|---|
api_key | Evet | API anahtarı |
id | Evet | Planlanan gönderimin kimliği |
{
"api_key": "YOUR_API_KEY",
"id": 16589
}Kara listenizdeki numaraları listeler; bu numaralara gönderim yapılmaz.
| Alan | Zorunlu | Açıklama |
|---|---|---|
api_key | Evet | API anahtarı |
{
"api_key": "YOUR_API_KEY"
}{
"code": 200,
"status": "success",
"data": [
{
"id": 468079,
"phone": 5551112233,
"country_code": "90",
"added_type": "Panel üzerinden eklendi.",
"created_at": "2026-08-06 09:51:17"
}
]
}Bir numarayı kara listeye ekler; iptal talebi gelen alıcıları programatik olarak engelleyin.
| Alan | Zorunlu | Açıklama |
|---|---|---|
api_key | Evet | API anahtarı |
phone | Evet | Engellenecek numara |
{
"api_key": "YOUR_API_KEY",
"phone": "905551112233"
}{
"code": 200,
"status": "success",
"data": "Girdiğiniz telefon numarası başarıyla kara listenize eklendi."
}Bir numarayı kara listeden çıkarır.
| Alan | Zorunlu | Açıklama |
|---|---|---|
api_key | Evet | API anahtarı |
phone | Evet | Listeden çıkarılacak numara |
{
"api_key": "YOUR_API_KEY",
"phone": "905551112233"
}{
"code": 200,
"status": "success",
"data": "Girdiğiniz telefon numarası başarıyla kara listenizden kaldırıldı."
}Gönderim yanıt alanları
| Alan | Açıklama |
|---|---|
id | Gönderim kimliği; rapor sorgularında report_id olarak kullanılır |
code | Yanıt kodu; başarılı isteklerde 200 |
status | Başarılı isteklerde success |
description | İşlem açıklaması |
quantity | Gönderim sonrası kalan kredi |
numberCount | Alıcı sayısı |
amount | Bu gönderimde harcanan kredi |
Aynı API ile doğrulamadan kampanyaya.
OTP, işlem bildirimi ve toplu duyuru senaryolarının tamamı aynı API anahtarıyla çalışır.
OTP / Doğrulama Kodu
Üyelik, giriş ve işlem onaylarında tek kullanımlık şifreyi /otp ile saniyeler içinde iletin; kısa ve Türkçe karaktersiz mesajlar otomatik hızlı kanaldan gider.
Sipariş ve Kargo Bildirimi
E-ticaret altyapınızdan /NtoN ile her müşteriye kendi sipariş numarası ve kargo takip bilgisini gönderin.
Kampanya Duyurusu
/1toN ile tüm listeye tek istekte ulaşın; add_cancel_link ile ticari iletilere otomatik iptal linki ekleyin.
Randevu Hatırlatma
send_time ile SMS'leri randevudan bir gün önceye planlayın; plan değişirse /cancel/future-sms ile iptal edin.
Alarm ve Sistem Bildirimi
Sunucu, ödeme veya stok uyarılarını nöbetçi ekibin telefonuna anında düşürün; teslimatı raporla doğrulayın.
Üyelik ve Bilgilendirme
Şifre sıfırlama, fatura hatırlatma, sözleşme bilgilendirmesi gibi işlemsel mesajları uygulamanızdan otomatik gönderin.
Yazılımınıza nasıl bağlanır?
SDK zorunluluğu yok — HTTP isteği atabilen her platform bağlanır.
Kendi yazılımınız
Backend'inize (PHP, Node.js, Python, C#, Java, Go...) yukarıdaki kod örnekleriyle doğrudan bağlanın; test için Postman koleksiyonunu kullanın.
E-ticaret ve CRM
Sipariş, üyelik ve destek olaylarınızı tetikleyici yapıp SMS gönderimini iş akışınıza ekleyin; her olayda tek bir POST isteği yeterli.
SMS + WhatsApp birlikte
Aynı panelde WaMessage Geliştirici API'si ve WhatsApp Business API ile çok kanallı bildirim kurun: kritik mesajı SMS, zengin içeriği WhatsApp taşısın.
SMS gitmediyse önce bunları kontrol edin.
Çoğu gönderim sorunu bu altı kontrolden biriyle çözülür.
SMS API hakkında.
Panel kullanıcıları için SMS hazır; geliştiriciler için API de hazır.
İşletme operasyonunu panelden, otomatik sistem mesajlarını SMS API üzerinden yönetin.
SMS API entegrasyonunda önce mesaj tipini ve yönlendirme kuralını netleştirin.
WaMessage SMS API, geliştiricilerin uygulama, CRM, ERP, web sitesi veya diğer yazılımlardan SMS işlemlerini tetiklemesi için kullanılır. API anahtarı kullanıcı tarafından WaMessage panelinden alınır ve tüm API işlemlerinin yetkilendirilmesinde kullanılır. Entegrasyonda temel karar, mesajın OTP/doğrulama mesajı mı yoksa standart/toplu bilgilendirme mesajı mı olduğudur.
WaMessage kuralında bir mesajın OTP kanalına uygun sayılması için içerik tek SMS boyunda olmalı ve standart/Latin karakter yapısına uygun olmalıdır. Bu koşulları karşılayan doğrulama mesajı OTP kanalından işlenebilir; koşulu karşılamayan içerik standart mesaj olarak değerlendirilir. Uygulama tarafında yalnız endpoint seçmek yerine metnin gerçekten doğrulama amacı taşıdığını ve uzunluk/karakter kurallarına uyduğunu test etmek gerekir.
API anahtarı
Panelden alınır; kaynak kod deposuna, frontend JavaScript dosyasına veya herkese açık loglara yazılmamalıdır.
/otp
Tek SMS boyunda ve standart/Latin karakter kurallarına uyan OTP/doğrulama kullanımını temsil eder.
/1toN
Standart veya birden fazla alıcıya mesaj gönderimi için dokümantasyondaki gönderim modelini temsil eder.
Raporlama
İstek kabul edildi mi sorusu ile operatör/teslim sonucu aynı şey değildir; uygulama rapor durumlarını ayrı ele almalıdır.
Sağlam bir SMS API istemcisi nasıl tasarlanır?
API entegrasyonunda yalnız başarılı örnek isteği çalıştırmak yeterli değildir. Üretim ortamında ağ kesintisi, zaman aşımı, yetkisiz anahtar, hatalı numara, geçersiz karakter veya aynı isteğin iki kez gönderilmesi gibi durumlar oluşur. İstemci bu durumları öngörerek tasarlanmalıdır.
- Kimlik doğrulama katmanı: API anahtarını sunucu tarafında güvenli secret olarak tutun ve ortamlar arasında ayrı yönetin.
- Girdi doğrulama: telefon numarası formatını, boş mesajı, mesaj türünü ve gerekli alanları API çağrısından önce doğrulayın.
- Zaman aşımı: HTTP isteğinin sonsuza kadar beklemesine izin vermeyin; makul timeout ve yeniden deneme politikası uygulayın.
- Tekrar deneme: her hatayı körlemesine tekrar göndermeyin. Geçici ağ/5xx sorunları ile kalıcı 4xx doğrulama hatalarını ayırın.
- Tekilleştirme: ödeme, giriş veya kritik işlemde aynı OTP'nin istemeden iki kez tetiklenmesini engelleyecek uygulama anahtarı/işlem ID mantığı kullanın.
- Log: mesaj içeriğini ve kişisel veriyi gereksiz loglamak yerine işlem ID, endpoint, durum ve hata kodunu izleyin.
OTP entegrasyonunda güvenlik ve kullanıcı deneyimi birlikte ele alınmalı.
OTP mesajı yalnız SMS gönderimi değildir; giriş, işlem onayı veya hesap doğrulama gibi güvenlik akışının parçasıdır. Kodun geçerlilik süresi, kaç kez denenebileceği ve yeniden SMS isteme aralığı uygulama tarafında belirlenmelidir. Çok kısa aralıklarla sınırsız OTP gönderimi hem maliyet hem kötüye kullanım riski yaratır.
| Kontrol | Önerilen yaklaşım | Amaç |
|---|---|---|
| Kod süresi | İşlem riskine uygun kısa ve tanımlı süre | Eski kodların uzun süre kullanılmasını önlemek |
| Deneme limiti | Belirli sayıda yanlış denemeden sonra yeni akış | Brute-force riskini azaltmak |
| Tekrar gönderim | Kısa süre içinde sınırsız talebi engellemek | Spam/maliyet ve kötüye kullanımı azaltmak |
| İşlem bağı | OTP'yi belirli giriş/işlem oturumuna bağlamak | Başka işlemde yeniden kullanım riskini azaltmak |
| Mesaj metni | Kod + marka/işlem bağlamı; gereksiz pazarlama metni yok | Kullanıcının mesaj amacını hızlı anlaması |
OTP kodunu veritabanında açık metin halinde gereksiz tutmamak, hata loglarına yazmamak ve destek personelinin kodu kullanıcıdan istemeyeceği süreç tasarlamak da uygulama güvenliğinin parçasıdır. SMS sağlayıcısı kodu taşır; kod doğrulamasının asıl güvenlik kuralları uygulama tarafında kalır.
Standart SMS ve toplu gönderimde operasyonel dayanıklılık
Standart SMS entegrasyonunda müşteri listesini tek seferde mümkün olan en büyük istekle göndermek yerine dokümantasyondaki limitlere uygun parçalara bölmek ve her parçanın sonucunu takip etmek daha güvenlidir. Gönderim süreci asenkron raporlama kullanıyorsa API'nin ilk “kabul edildi” cevabı ile nihai teslim durumunu ayrı veri alanlarında saklayın.
Uygulamanızın mesaj geçmişinde en azından işlem kimliği, hedef numara için güvenli referans, mesaj tipi, gönderim zamanı, API sonucu ve varsa rapor durumu bulunmalıdır. Böylece müşteri “mesaj gelmedi” dediğinde aynı mesajı körlemesine tekrar göndermek yerine önce mevcut işlemin durumu kontrol edilebilir.
Dokümantasyon önceliği: Bu sayfadaki mimari öneriler entegrasyon standardıdır. Zorunlu request alanları, endpoint parametreleri, gerçek hata kodları ve güncel limitlerde WaMessage panelindeki/geliştirici dokümantasyonundaki API sözleşmesi kaynak kabul edilmelidir; belgede tanımlanmayan alan veya davranış varsayılmamalıdır.
Canlı kullanım için operasyon standardı
Bu bölüm, canlı uygulamada içeriğin yalnız teorik kalmaması için operasyon kontrolünü tamamlar. sms api konusu işletmenin gerçek müşteri yolculuğuyla eşleştirilirken sahiplik, test, ölçüm ve güncelleme sorumluluğu açık biçimde tanımlanmalıdır. Sürecin hangi ekip tarafından yönetileceği, değişikliklerin kim tarafından onaylanacağı ve sorun olduğunda hangi kayıtların inceleneceği baştan belirlenirse sonraki optimizasyonlar daha güvenli yapılır.
- Gerçek bir müşteri senaryosunu başlangıçtan sonuca kadar yazın ve sayfadaki önerilerle eşleştirin.
- Canlıya almadan önce küçük test grubu veya test kayıtlarıyla uçtan uca doğrulama yapın.
- Başarı kriterini yalnız hacim üzerinden değil, kullanıcı sonucu ve ekip operasyonu üzerinden tanımlayın.
- Yetki, veri, izin ve güvenlik gereksinimlerini ürün ayarlarından bağımsız kontrol edin.
- İlk canlı haftadan sonra başarısız veya gereksiz adımları kaldırıp süreci sadeleştirin.
Bu yaklaşım, bir özelliğin sadece teknik olarak çalışmasını değil, işletmenin tekrar edilebilir bir standardı haline gelmesini hedefler. Özellikle ekip, CRM veya entegrasyon bulunan yapılarda süreç dokümantasyonu çalışan değişikliklerinde bilgi kaybını da azaltır.
Başarıyı nasıl ölçmeli ve içeriği nasıl güncel tutmalısınız?
SMS API entegrasyonu bir defa kurulup unutulacak bir özellik gibi yönetilmemelidir. Canlı kullanım başladıktan sonra kullanıcı davranışı, ekip geri bildirimi ve başarısız senaryolar düzenli olarak incelenmelidir. Sayfada anlatılan ideal süreç ile gerçek müşteri konuşmaları arasında fark varsa önce bu farkın nedeni bulunmalı, ardından içerik veya ürün kuralı güncellenmelidir.
Ölçümde yalnız hacme bakmak çoğu zaman yanıltıcıdır. Daha fazla mesaj, daha fazla chatbot cevabı veya daha fazla görüşme her zaman daha iyi müşteri sonucu anlamına gelmez. İlgili senaryoya göre ilk cevap süresi, tamamlanma oranı, tekrar iletişim, insan devri, hata oranı, ret oranı, satış sonucu veya müşteri tarafından yarıda bırakılan adımlar gibi göstergeler birlikte değerlendirilmelidir.
- Sahip belirleyin: süreçteki metin, kural, entegrasyon veya izin listesinin kim tarafından güncelleneceği belli olsun.
- Değişiklik kaydı tutun: performans değiştiğinde hangi kuralın veya içeriğin ne zaman değiştiği görülebilsin.
- Gerçek örnekleri inceleyin: yalnız başarılı konuşmaları değil, müşterinin yanlış anladığı veya yarıda bıraktığı örnekleri de değerlendirin.
- Kademeli iyileştirin: aynı anda çok sayıda değişiklik yapmak yerine tek değişkeni test ederek etkisini izleyin.
Bu operasyon disiplini, SEO içeriğinin de güncel kalmasına yardımcı olur. Ürün davranışı değiştiğinde sayfadaki örnek ve açıklamalar gerçek kullanımla birlikte revize edilir; böylece içerik yalnız arama motoru için yazılmış statik metne dönüşmez.
Uygulama sahipliği, güvenlik ve bakım planı
Sms api entegrasyonu için teknik veya operasyonel sorumluluk tek bir kişide olmak zorunda değildir; ancak kimin hangi alanı yönettiği açık olmalıdır. Pazarlama ekibi mesaj içeriğini, satış/destek ekipleri müşteri senaryosunu, teknik ekip entegrasyon ve erişim güvenliğini, yönetim ise başarı kriterini sahiplenebilir. Bu roller tanımlanmadığında küçük değişiklikler bile birbirinden habersiz ekipler tarafından yapılabilir.
Canlı sistemlerde erişim yetkileri de düzenli gözden geçirilmelidir. İşten ayrılan kullanıcıların erişimi kapatılmalı, API anahtarları gerektiğinde yenilenmeli ve gereksiz yönetici yetkileri azaltılmalıdır. Müşteri verisinin hangi panelde tutulduğu, hangi entegrasyona aktarıldığı ve ne kadar süre saklandığı da operasyon dokümantasyonunda yer almalıdır.
Son olarak her kritik süreç için basit bir geri dönüş planı oluşturmak faydalıdır. Yeni kural veya entegrasyon beklenmeyen sonuç üretirse eski çalışan duruma nasıl dönüleceği, kimin karar vereceği ve müşterilere gerekiyorsa nasıl bilgi verileceği önceden belirlenmelidir. Bu yaklaşım özellikle API, CRM, doğrulama ve yüksek hacimli iletişim senaryolarında canlı geçiş riskini azaltır.
Numara ve mesaj doğrulamasını API çağrısından önce yapın.
SMS entegrasyonlarında sağlayıcıya gönderilen her hatalı istek yalnız teknik hata üretmez; kuyrukların gereksiz dolmasına ve hata takibinin zorlaşmasına da neden olabilir. Bu nedenle uygulama telefon numarasını beklenen ülke formatına dönüştürmeli, boş veya yalnız boşluk içeren mesajları reddetmeli ve OTP olarak işaretlenen içeriğin tek SMS boyu ile standart/Latin karakter koşulunu çağrıdan önce kontrol etmelidir.
İstek kabul edilmediğinde kullanıcıya ham API hatasını göstermek yerine uygulama kendi anlaşılır hata katmanını kullanmalıdır. Geliştirici logunda işlem referansı ve teknik neden saklanırken son kullanıcıya “telefon numarasını kontrol edin” veya “bir süre sonra yeniden deneyin” gibi güvenli ve eyleme dönük mesaj gösterilebilir. Bu ayrım destek taleplerini de daha kolay sınıflandırır.