Sent.dm API ile Daha Hızlı SMS ve WhatsApp Mesajları Nasıl Gönderilir?

TL;DR / Hızlı Cevap

Sent.dm API'si, SMS ve WhatsApp üzerinden iş mesajlaşması için tek bir entegrasyon noktası sunar. Sent'i Apidog ile eşleştirirseniz, kimlik bilgilerinizi ortamlarda depolayabilir, tek kullanımlık betikler yazmadan istekleri test edebilir, webhook yüklerini doğrulayabilir ve mesajlaşma iş akışınızı tek bir yerde belgeleyebilirsiniz.

Giriş

Çoğu mesajlaşma projesi aynı yerde yavaşlar: API'nin kendisi zor değildir, ancak operasyonel detaylar hızla birikir. API anahtarlarına, bir gönderen kimliğine, şablon kimliklerine, webhook güvenliğine, kanal kurallarına ve tüm bunları gerçek mesajları körü körüne göndermeden test etmek için temiz bir yola ihtiyacınız vardır.

İşte tam da bu yüzden Sent.dm ilgi çekicidir. Sent, SMS ve WhatsApp gibi uygulama tabanlı kanallar için tek bir birleşik mesajlaşma API'si olarak konumlanmıştır ve yönlendirme ile teslimat mantığı, geliştiriciye yönelik tek bir arayüzün arkasında ele alınır. Sent'in 26 Mart 2026'da incelenen genel belgelerine göre, platform hesap doğrulaması, kanal kurulumu, şablon tabanlı gönderme, kişiler, webhook olayları ve test için bir gösterge paneli oyun alanı içerir.

Sent.dm API'si Ne Çözüyor?

Sent.dm, her sağlayıcı için ayrı entegrasyonları sürdürmeden birden fazla mesajlaşma kanalında kullanıcılara ulaşmak isteyen ekipler için oluşturulmuştur. SMS API'lerini, WhatsApp katılımını, kanala özel yük biçimlerini ve teslimat izlemeyi kendi başınıza bir araya getirmek yerine, Sent bu karmaşıklığı tek bir platformda soyutlar.

Resmi belgelere göre, ürün hikayesi oldukça basittir:

• Mesajlaşma iş akışları için tek bir API temel URL'si
• x-api-key ile başlık tabanlı kimlik doğrulama
• x-sender-id kullanan bir gönderen kimliği modeli
• Şablon tabanlı giden mesajlaşma
• Kişiler ve hedef kitle yönetimi
• Teslimat ve şablon olayları için webhook'lar
• Platform katmanında akıllı yönlendirme ve hata durumunda yedekleme kavramları

Bu kombinasyon önemlidir çünkü mesajlaşma sistemleri nadiren sadece "metin gönder ve devam et" şeklindedir. Ayrıca şunlara da ihtiyacınız vardır:

• Tutarlı bir yük yapısı
• Şablonları yeniden kullanmak için güvenli bir yol
• Teslim edilen, başarısız olan veya kuyruğa alınan mesajlar için olay takibi
• Sırları ön uç kodundan uzak tutan bir test iş akışı
• Geliştiricilerinizin ve QA ekip arkadaşlarınızın gerçekten kullanabileceği belgeler

Uygulamada daha büyük zorluk şudur:

Application -> Message API -> Channel Rules -> Delivery Events -> Retry / Status Logic

Her parça farklı bir araçta yaşarsa, hata ayıklama yavaşlar. Bunun olmasını engellemenin en kolay yollarından biri, tüm akışı ilk günden itibaren Apidog gibi bir API platformunda modellemektir.

Sent.dm API'si Nasıl Çalışır?

Sent'in genel belgeleri, platformu uygulamanız ile alt akış mesajlaşma kanalları arasında akıllı bir ara katman olarak tanımlar. Vaat basittir: uygulamanız bir istek gönderir ve Sent, yönlendirme mantığına, alıcı bağlamına ve kanal kullanılabilirliğine göre en iyi teslimat yolunu seçer.

Geliştiriciler için en önemli kısımlar kurulum sırası ve kimlik bilgileri modelidir.

1. Hesap ve uyumluluk kurulumu

Resmi başlangıç akışı hesap oluşturma, KYC doğrulaması ve işletme kurulumu ile başlar. Bu isteğe bağlı bir iş değildir. Mesajlaşma ürünleri uyumluluk kurallarına, gönderen itibarına ve bölgesel kısıtlamalara dokunur, bu nedenle Sent hesap doğrulamasını katılım yolunun bir parçası haline getirir.

2. Kanal kurulumu

Sent'in belgeleri, bir telefon numarası seçme ve WhatsApp Business'ı bağlama konusunda size rehberlik eder. Belgeler, SMS ve WhatsApp için aynı numarayı kullanmanızı önerir, böylece marka kimliğiniz kanallar arasında tutarlı kalır.

3. Şablonlar

Şablonlar, iş akışının temel bir parçasıdır. Başlangıç kılavuzunda, Sent ilk API isteğinizi göndermeden önce bir şablon oluşturmanızı sağlar. Bu, şablon tabanlı mesajlaşmanın burada bir kenar durum olmadığını iyi bir şekilde gösterir. Varsayılan yolun bir parçasıdır.

4. API kimlik bilgileri

Belgeler iki kimlik bilgisi gösteriyor:

x-sender-id: YOUR_SENDER_ID
x-api-key: YOUR_API_KEY

v3 API referansı, x-api-key'i gerekli kimlik doğrulama başlığı olarak vurgular. Başlangıç örnekleri ayrıca mesaj istekleri için x-sender-id'yi içerir. Bunu üretimde uyguladığınızda, mevcut çalışma alanınız ve Sent kontrol panelindeki uç nokta sürümünüze karşı tam başlık gereksinimlerini doğrulayın, çünkü belgeler hem v3 referans görünümünü hem de v2 mesaj örneklerini sunar.

5. Mesaj isteği

Başlangıç kılavuzu şuraya bir istek gösteriyor:

POST https://api.sent.dm/v2/messages/phone

şuna benzer bir JSON yükü ile:

{
 "phoneNumber": "RECIPIENT_PHONE_NUMBER",
 "templateId": "TEMPLATE_ID"
}

Bu size ilk uygulama hedefi hakkında önemli bir şey söyler: en hızlı yol, devasa bir çok kanallı orkestrasyon hizmeti kurmak değildir. Bu, şablon tabanlı gönderimleri doğru bir şekilde kurmak, ardından istek ve teslimat davranışını güvenilir bir şekilde gözlemleyebildiğinizde iş akışını genişletmektir.

İlk Sent.dm API İsteğinizi Gönderin

İlk isteği test etmesi kolay ve bakımı kolay bir şekilde oluşturalım.

cURL örneği

curl -X POST "https://api.sent.dm/v2/messages/phone" \
 -H "x-sender-id: YOUR_SENDER_ID" \
 -H "x-api-key: YOUR_API_KEY" \
 -H "Content-Type: application/json" \
 -d '{
 "phoneNumber": "RECIPIENT_PHONE_NUMBER",
 "templateId": "TEMPLATE_ID"
 }'

JavaScript örneği

const response = await fetch("https://api.sent.dm/v2/messages/phone", {
 method: "POST",
 headers: {
 "x-sender-id": process.env.SENT_SENDER_ID,
 "x-api-key": process.env.SENT_API_KEY,
 "Content-Type": "application/json"
 },
 body: JSON.stringify({
 phoneNumber: process.env.TEST_PHONE_NUMBER,
 templateId: process.env.SENT_TEMPLATE_ID
 })
});

if (!response.ok) {
 throw new Error(`Sent request failed: ${response.status}`);
}

const data = await response.json();
console.log(data);

Python örneği

import os
import requests

response = requests.post(
 "https://api.sent.dm/v2/messages/phone",
 headers={
 "x-sender-id": os.environ["SENT_SENDER_ID"],
 "x-api-key": os.environ["SENT_API_KEY"],
 "Content-Type": "application/json",
 },
 json={
 "phoneNumber": os.environ["TEST_PHONE_NUMBER"],
 "templateId": os.environ["SENT_TEMPLATE_ID"],
 },
 timeout=30,
)

response.raise_for_status()
print(response.json())

Başlangıç belgelerine göre, başarılı bir yanıt HTTP 200 ve bir messageId döndürür. Bu messageId, Apidog testlerinde, uygulama günlüklerinde, destek iş akışlarında ve webhook mutabakatında yakalamak istediğiniz değerdir.

Sent.dm API'sini Apidog'da Test Edin

Burada Apidog, bir istek çalıştırıcısından daha fazlası haline gelir. Mesajlaşma API'leri, istek, değişkenler, test iddiaları, belgeler ve ekip devri bir arada olduğunda çalışmak daha kolaydır.

Adım 1: Bir Sent ortamı oluşturun

Apidog'da, şuna benzer değişkenlerle bir ortam oluşturun:

base_url = https://api.sent.dm
sender_id = YOUR_SENDER_ID
api_key = YOUR_API_KEY
template_id = YOUR_TEMPLATE_ID
test_phone = RECIPIENT_PHONE_NUMBER

Ortam değişkenlerini kullanmak size üç anında fayda sağlar:

1. Örneklerde üretim sırlarını sabit kodlamaktan kaçınırsınız.
2. Koruma alanı, hazırlık ve canlı hesaplar arasında daha hızlı geçiş yapabilirsiniz.
3. Ekip arkadaşları aynı koleksiyonu kendi güvenli değerleriyle yeniden kullanabilir.

Adım 2: İsteği bir kez oluşturun

Apidog'da yeni bir istek oluşturun:

- x-sender-id: {{sender_id}} - x-api-key: {{api_key}} - Content-Type: application/json

• Metot: POST
• URL: {{base_url}}/v2/messages/phone
• Başlıklar:
• Gövde:

{
 "phoneNumber": "{{test_phone}}",
 "templateId": "{{template_id}}"
}

Bu, tek seferlik terminal testlerinden zaten daha iyidir, çünkü ekibiniz tam yük şeklini, kimlik doğrulama modelini ve beklenen yanıtı tek bir yerde inceleyebilir.

Adım 3: İddialar ekleyin

Apidog'da, başarı yolunu doğrulayan testler ekleyin.

Örnek kontroller:

pm.test("Status is 200", function () {
 pm.response.to.have.status(200);
});

pm.test("Response contains a messageId", function () {
 const json = pm.response.json();
 pm.expect(json.messageId).to.exist;
});

Bu kontroller, küçük hataları hızla yakalamanıza yardımcı olur. Bir API değişikliği, kimlik bilgisi rotasyonu veya şablon sorunu sonrasında istek bir mesaj kimliği döndürmeyi durdurursa, bunu hemen görürsünüz.

Adım 4: Bir senaryoya dönüştürün

Tek bir isteğin ötesine geçip bir iş akışına geçtiğinizde Apidog daha da kullanışlı hale gelir:

1. Bir mesaj gönderin
2. Dönen messageId'yi saklayın
3. Kurulumunuz bu akışı açığa çıkarıyorsa alt akış durumunu sorgulayın
4. Webhook'lar aracılığıyla alınan mesaj olaylarını karşılaştırın

Bu, mesajlaşma sistemleri için doğru API testi düzeyidir, çünkü tek bir başarılı POST iş akışınızın sağlıklı olduğu anlamına gelmez. Ayrıca onayları, teslimatı, yeniden denemeleri ve olay tutarlılığını da önemsersiniz.

Adım 5: Webhook örneklerini aynı koleksiyona ekleyin

Gönderme isteğiniz çalıştıktan sonra, ekibinizin almayı beklediği webhook olayları için kaydedilmiş örnekler ekleyin. Bu size giden istekleri ve gelen olay işlemeyi kapsayan tek bir koleksiyon sağlar.

Örneğin, bir webhook yükü örneği kaydedebilir ve şu gibi alanları belgeleyebilirsiniz:

{
 "field": "message.status",
 "messageId": "msg_123",
 "status": "delivered",
 "channel": "whatsapp"
}

Bu hızla karşılığını verir. Arka uç mühendisleri canlı yükleri kaydedilmiş örnekle karşılaştırabilir, QA olay işleme mantığını doğrulayabilir ve destek ekipleri günlükleri incelemeye gerek kalmadan mesaj durumlarının ne anlama geldiğini anlayabilir.

Adım 6: Dahili belgeleri yayınlayın

Ekibinizde aynı mesajlaşma akışına dokunan arka uç mühendisleri, QA, destek ve ürün paydaşları varsa, Apidog'un belgeleme katmanı zaman kazandırır. Sohbette dağınık bir cURL kod parçacıkları kümesi paylaşmak yerine, şunları içeren temiz bir dahili referans yayınlayabilirsiniz:

• Gerekli başlıklar
• Örnek yükler
• Hata yanıtları
• Webhook olay örnekleri
• Ortam notları

Bu, "bu betiği çalıştır ve bana ne olduğunu söyle" demekten çok daha güçlü bir devirdir.

Şablonları, Kişileri ve Webhook'ları Doğru Şekilde Yönetin

İlk isteğin 200 döndürmesini sağlamak sadece başlangıçtır. Gerçek üretim çalışması bundan sonra başlar.

Şablonlar

Sent'in katılım akışı, özellikle WhatsApp ile ilgili mesajlaşma için şablonlara büyük önem verir. Bu, API uygulamanızın şablonları, bir dosyaya bir kez kopyalanıp unutulan kimlikler olarak değil, sürüm kontrollü içerik olarak ele alması gerektiği anlamına gelir.

Pratik bir desen şudur:

1. Şablon kimliklerini ortam değişkenlerinde veya yapılandırmada saklayın
2. Her şablonu amaç, yerel ayar ve onay durumuna göre etiketleyin
3. Test şablonlarını canlı kampanya şablonlarından ayırın
4. Hangi şablonların hangi kullanıcı yolculuklarına eşleştiğini belgeleyin

Apidog burada yardımcı olur çünkü onaylanmış her şablon için örnek istekler oluşturabilir ve bunları daha geniş API koleksiyonunuzla birlikte saklayabilirsiniz.

Kişiler

Sent belgeleri, kişileri birinci sınıf bir özellik alanı olarak sunar. Uygulamanız zaten kullanıcıları dahili olarak depolasa bile, bir mesajlaşma platformundaki kişi nesneleri hedef kitle düzeyinde işlemler, şablon hedeflemesi ve iletişim geçmişi için faydalıdır.

Kişi senkronizasyon mantığı oluşturursanız, bu kuralları erken belgeleyin:

• Hangi sistem doğruluk kaynağıdır
• Telefon numaraları nasıl normalleştirilir
• Katılım veya onay durumu nasıl saklanır
• Bir kişi kanal değiştirdiğinde ne olur

Bunlar daha sonra temizlenecek detaylar değildir. Teslim edilebilirliği ve uyumluluğu baştan etkilerler.

Webhook'lar

Sent'in webhook belgeleri, gerçek üretim kullanımı için platformun en önemli parçalarından biridir. Belgeler, aşağıdakiler dahil başlıklarla HMAC-SHA256 imza doğrulamasını açıklar:

• x-webhook-signature
• x-webhook-id
• x-webhook-timestamp

Belgeler ayrıca imza formatını v1,{base64_signature} olarak açıklar ve beş dakikalık bir zaman damgası penceresi ile tekrar oynatma koruması önerir.

Bu size temiz bir üretim kontrol listesi sunar:

1. Ham istek gövdesini okuyun
2. Ayrıştırmadan önce imzayı doğrulayın
3. Eski zaman damgalarını reddedin
4. Olayları değişmez bir şekilde işleyin
5. Hızla onaylayın ve yoğun işleri arka plan işlerine taşıyın

İşte kompakt bir Express örneği:

import crypto from "crypto";
import express from "express";

const app = express();

app.post("/webhooks/sent", express.raw({ type: "*/*" }), (req, res) => {
 const signature = req.header("x-webhook-signature");
 const webhookId = req.header("x-webhook-id");
 const timestamp = req.header("x-webhook-timestamp");
 const secret = process.env.SENT_WEBHOOK_SECRET;
 const rawBody = req.body.toString("utf8");

 const signedContent = `${webhookId}.${timestamp}.${rawBody}`;
 const expected = crypto
 .createHmac("sha256", Buffer.from(secret.replace(/^whsec_/, ""), "base64"))
 .update(signedContent)
 .digest("base64");

 if (signature !== `v1,${expected}`) {
 return res.status(401).send("Unauthorized");
 }

 const event = JSON.parse(rawBody);
 console.log("Received webhook event:", event.field);

 return res.sendStatus(200);
});

Webhook örnek yüklerini depolamak ve beklenen olayları belgelemek için Apidog'u kullanın. Bu, ön uç, arka uç ve QA ekiplerinin aynı mesaj yaşam döngüsü etrafında hizalanmasını kolaylaştırır.

Apidog Bu İş Akışına Neden Uyar?

Sent.dm size mesajlaşma katmanını verir. Apidog ise bu mesajlaşma katmanının etrafındaki iş akışı katmanını sunar.

İşte pratik fark:

Ekibiniz uygulama mesajlaşması için Sent'i değerlendiriyorsa, Apidog Sent'in olmaya çalışmadığı katmanı kapsar: işbirliğine dayalı API tasarımı, test, hata ayıklama, taklit planlaması ve tek bir çalışma alanında belgeleme.

Bu en az üç durumda faydalıdır:

• Birden fazla geliştiriciyi işe alıyorsunuz ve paylaşılabilir bir istek koleksiyonuna ihtiyacınız var
• QA'nın özel betikler yazmadan mesajlaşma API'lerini doğrulaması istiyorsunuz
• Sürüm değişikliklerini, yeni şablonları veya webhook yüklerini test etmek için tekrarlanabilir bir yere ihtiyacınız var

Sent.dm isteklerini test etmek, mesajlaşma ortamlarını güvenli bir şekilde depolamak ve ilk başarılı API çağrınızı yeniden kullanılabilir bir ekip iş akışına dönüştürmek için Apidog'u ücretsiz indirin.

Gelişmiş İpuçları ve Sık Yapılan Hatalar

Temel akış çalıştıktan sonra, bu uygulamalar entegrasyonu daha güvenilir hale getirir.

En iyi uygulamalar

1. Kimlik bilgilerini yalnızca sunucu tarafında tutun. Sent'in belgeleri, API anahtarlarını istemci tarafı kodunda ifşa etmeye karşı açıkça uyarır.
2. Uygulama günlüklerinizde ve destek araçlarınızda messageId'yi izleyin.
3. Hazırlık ve üretim şablonlarını ayırın.
4. Her webhook'u işlemeden önce doğrulayın.
5. Canlı kimlik bilgilerini test kimlik bilgilerinden ayırmak için Apidog ortamlarını kullanın.

Kaçınılması gereken yaygın hatalar

1. 200 yanıtını olay yaşam döngüsünün başlangıcı yerine nihai teslimat sonucu olarak ele almak
2. Birden fazla hizmette şablon kimliklerini sabit kodlamak
3. Gönderen kimliği kurulumunu dağıtımın sonlarına kadar görmezden gelmek
4. Telefon numaralarını tutarlı bir şekilde normalleştirmeyi unutmak
5. Başka kimsenin inceleyemeyeceği geçici betiklerde gerçek kimlik bilgileriyle test yapmak

Sorun giderme ipuçları

Bir istek çalışmıyorsa, bunları sırayla kontrol edin:

1. x-api-key geçerli ve aktif mi?
2. Çağırdığınız uç nokta, Sent çalışma alanınızda gösterilen sürümle eşleşiyor mu?
3. Bu istek yolu için x-sender-id gerekli mi?
4. Şablon onaylı ve seçilen kanal için kullanılabilir mi?
5. Doğru formatta bir telefon numarasına mı gönderiyorsunuz?

Apidog burada yardımcı olur çünkü başarısız bir isteği, bilinen iyi kaydedilmiş bir istekle saniyeler içinde karşılaştırabilirsiniz.

Sent.dm Alternatifleri ve Karşılaştırmaları

Sent.dm'yi değerlendiriyorsanız, muhtemelen doğrudan sağlayıcı entegrasyonlarına, daha geniş iletişim platformlarına veya günlük testler için Postman gibi tanıdık bir API istemcisine de bakıyorsunuzdur. Temel fark kontrol ile basitlik arasındadır ve test katmanı teslimat katmanı kadar önemlidir.

Geliştirici hızını önemseyen ekipler için en iyi kurulum genellikle "her şey için tek bir araç seçin" değildir. Bu, teslimat platformunu güçlü bir API işbirliği katmanıyla eşleştirmektir. Zaten Postman kullanıyorsanız, Apidog'a burada bakmanın en güçlü nedeni temel istek gönderme değildir. Ortamları, kaydedilmiş belgeleri, iddiaları, taklit planlamayı ve ekip devrini tek bir çalışma alanında bulundurmaktır.

Sonuç

Sent.dm, ayrı kanal entegrasyonları yerine SMS ve WhatsApp için tek bir platform isteyen ekipler için faydalı bir mesajlaşma API'sidir. En büyük kazanç sadece mesaj gönderebilmeniz değildir. Şablonlar, gönderen kimliği, kişiler ve webhook'lar etrafında daha yapılandırılmış bir şekilde test ve geliştirme yapabilmenizdir.

Daha hızlı ilerlemek istiyorsanız, Apidog'da ilk Sent isteğini oluşturarak başlayın, messageId için iddialar ekleyin, ardından webhook sözleşmenizi aynı çalışma alanında belgeleyin. Bu, dağınık betiklere ve aşiret bilgisine güvenmekten daha temiz bir prototipten üretime geçiş yolu sağlar.

SSS

Sent.dm API'si ne için kullanılır?

Sent.dm API'si, SMS ve WhatsApp gibi kanallar arasında tek bir entegrasyon aracılığıyla iş mesajlaşması için kullanılır. Resmi belgelere göre, gönderen kurulumunu, şablonları, kişileri ve webhook tabanlı olay işlemeyi destekler.

Sent.dm, WhatsApp ve SMS'i tek bir API'de destekliyor mu?

Evet. Sent, platformu kanal özelindeki karmaşıklığı tek bir geliştirici entegrasyonunun arkasında soyutlayan birleşik bir mesajlaşma API'si olarak konumlandırıyor. Katılım belgeleri ayrıca SMS ve WhatsApp genelinde aynı telefon numarasını kullanmanızı öneriyor.

Sent.dm API istekleri için hangi başlıklara ihtiyacım var?

Genel belgeler x-api-key'i temel kimlik doğrulama başlığı olarak gösterir ve başlangıç mesajı örnekleri de x-sender-id kullanır. Belgeler hem v3 hem de v2 referanslarını sunduğu için üretim dağıtımından önce Sent hesabınızdaki tam uç nokta sürümünü kontrol edin.

Sent.dm ile mesaj göndermeden önce şablonlara ihtiyacım var mı?

Başlangıç akışı için evet. Sent'in katılım kılavuzu, bir şablon oluşturma ve ardından ilk mesajı bir templateId ile gönderme konusunda size rehberlik eder.

Sent.dm API'sini özel betikler yazmadan nasıl test ederim?

Apidog bunun için iyi bir seçimdir. Sent kimlik bilgilerinizi ortam değişkenleri olarak depolayabilir, mesaj isteklerini kaydedebilir, iddialar ekleyebilir, çok adımlı senaryolar oluşturabilir, webhook yüklerini belgeleyebilir ve ekibinizin geri kalanı için dahili API belgelerini yayınlayabilirsiniz.

Sent.dm webhoook'larını nasıl güvenli hale getirmeliyim?

HMAC imzasını doğrulayın, zaman damgasını onaylayın ve olayları değişmez bir şekilde işleyin. Sent'in belgeleri doğrulama için x-webhook-signature, x-webhook-id ve x-webhook-timestamp gibi başlıkları açıklar.

Sent.dm, ekip API iş akışları için tek başına yeterli mi?

Mesajlaşma platformunun kendisini kapsar, ancak çoğu ekip hala test, belgeleme ve tekrarlanan doğrulama için işbirliğine dayalı bir API aracına ihtiyaç duyar. İşte Apidog'un değer kattığı yer burasıdır.