WhatsApp ürünleri · Bağlı cihaz · API

Kendi yazılımınızdan WhatsApp mesajı gönderin

WASMS, SMS servisinin WhatsApp üzerinde çalışan hâlidir. Panel değil, API: CRM’iniz, e-ticaret altyapınız veya kampanya sisteminiz bir HTTP isteği atar; mesaj, kurumunuza tanımlı WhatsApp hattından müşterinin telefonuna düşer. Metin, görsel, video, doküman, ses, konum ve kişi kartı gönderilir; durum aynı API’den sorgulanır.

Hat, QR ile bağlanan bir numaradır. Evrak ve Meta onayı gerekmez; karşılığında resmî API’nin doğrulanmış rozeti ve güvencesi de yoktur. İkisini de bu sayfada açık yazıyoruz.

Kimler için

Gönderimi yazılımın tetiklediği işler

İnsanın panel açıp mesaj yazmadığı, olayın sistemde gerçekleştiği anda bildirimin gitmesi gereken her yer.

İşlem bildirimleri ve doğrulama

E-ticaret, finans ve lojistikte sipariş, kargo, randevu ve doğrulama bildirimleri mevcut sistemden tek çağrıyla WhatsApp’a taşınır.

Belge iletimi

Fatura, dekont ve sözleşme gibi dosyalar, dosya adıyla birlikte müşteriye doğrudan iletilir. Müşteri için hepsi aynı konuşmanın parçasıdır.

İzinli listelere bilgilendirme

Onay vermiş müşteri listelerine metin, görsel veya dokümanla bilgilendirme gönderilir. Toplu ve istenmeyen gönderimin numarayı riske attığını aşağıda ayrıca yazıyoruz.

İçerik türleri

Ne gönderebilirsiniz?

Altı içerik türü yayında; buton listesi de yayındadır. Anket ve buton mesajı deneyseldir, üretimde kullanmadan önce Tecmony ile teyit edilir.

Metin

Bildirim, doğrulama ve bilgilendirme akışları için serbest metin.

Görsel ve video

Kampanya görselleri, ürün tanıtımları, kısa videolar.

Doküman

Fatura, dekont, sözleşme ve benzeri dosyalar; dosya adıyla birlikte.

Ses

Sesli bilgilendirme ve hatırlatmalar.

Kişi kartı

İlgili temsilcinin veya birimin iletişim bilgisi.

Konum

Şube, mağaza veya buluşma noktası koordinatı.

Nasıl çalışır

Bir mesaj dört durakta gider

Üçüncü durak sizin numaranız; WASMS onu bir servis gibi kullanır.

Kendi sisteminizCRM, e-ticaret veya kampanya sisteminiz bir POST isteği gönderir.
WASMS APIToken doğrulanır; mesaj tipine göre ilgili uç çalışır ve bir message_id döner.
Kurumunuza tanımlı WhatsApp hattıQR ile bağlanmış, doğrulanmış numaranız mesajı iletir.
MüşterinizMesaj WhatsApp’ta işletmenizin numarasından görünür. Durum aynı API’den message_id ile sorgulanır.

Ekranlar

Müşterinin telefonunda böyle görünür

Müşteri tarafı

Aynı hat, üç farklı iş

Kargo bildirimi, fatura ve doğrulama kodu tek entegrasyonla, tek numaradan gider. Müşteri cevap yazarsa konuşma aynı hat üzerinde devam eder; cevapları bir ekipçe karşılamak istiyorsanız aynı numarayı WADesk’e de bağlayabilirsiniz.

Bildirim: sipariş, kargo, randevu
Belge: fatura, dekont, sözleşme
Doğrulama: tek kullanımlık kod

API

Entegrasyon için gereken her şey

Aşağıdaki örneklerde YOUR_API_TOKEN, YOUR_PHONE_ID ve YOUR_PIN yerine Tecmony’nin size ilettiği değerleri koyun. Yanıtlar status, code ve data alanlarını taşıyan ortak bir zarf kullanır.

1. Kimlik doğrulama: token alma

Size verilen phone_id ve PIN ile bir token alırsınız. Bu token sonraki bütün çağrılarda token başlığında taşınır; başlık eksik, hatalı veya süresi geçmişse istek reddedilir ve yeni token alınır.

curl -X GET \
  "https://wasms.tecmony.cloud/api/v1/whatsapp/token?phone_id=YOUR_PHONE_ID&pin=YOUR_PIN"

Yanıt:

{
  "status": true,
  "code": 200,
  "data": {
    "phone_id": "9085XXXXXXXX",
    "token": "YOUR_API_TOKEN"
  }
}

2. Metin mesajı gönderme

curl -X POST \
  "https://wasms.tecmony.cloud/api/v1/whatsapp/message/text" \
  -H "token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "905XXXXXXXXX",
    "message": "Siparişiniz kargoya verildi."
  }'

3. Doküman gönderme

curl -X POST \
  "https://wasms.tecmony.cloud/api/v1/whatsapp/message/document" \
  -H "token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "905XXXXXXXXX",
    "filename": "fatura-2026-04187.pdf",
    "content": "https://ornek.com/fatura.pdf"
  }'

Uç listesi

Metot	Uç	Gövde alanları	Durum
GET	`/api/v1/whatsapp/token`	Sorgu: `phone_id`, `pin`	Yayında
POST	`/api/v1/whatsapp/message/text`	`phone_number`, `message`	Yayında
POST	`/api/v1/whatsapp/message/image`	`phone_number`, `content`	Yayında
POST	`/api/v1/whatsapp/message/video`	`phone_number`, `content`	Yayında
POST	`/api/v1/whatsapp/message/document`	`phone_number`, `filename`, `content`	Yayında
POST	`/api/v1/whatsapp/message/audio`	`phone_number`, `content`	Yayında
POST	`/api/v1/whatsapp/message/location`	`phone_number`, `lat`, `lon`, `title`	Yayında
POST	`/api/v1/whatsapp/message/contact`	`phone_number`, `contact_name`, `contact_number`	Yayında
POST	`/api/v1/whatsapp/message/button/list`	`phone_number`, `title`, `description`, `button_text`, `rows_title`, `rows[]`	Yayında
POST	`/api/v1/whatsapp/message/poll`	`phone_number`, `poll_title`, `poll_options[]`	Deneysel
POST	`/api/v1/whatsapp/message/button`	`phone_number`, `media_file`, `media_message`, buton tanımları	Deneysel
GET	`/api/v1/whatsapp/message/{message_id}`	Gönderilen mesajın durum sorgusu	Yayında

Tüm uçlar https://wasms.tecmony.cloud/api/v1/ altındadır. Deneysel: üretimde kullanmadan önce Tecmony ile teyit edilir.

Hata durumları

200: istek karşılandı; status alanı true döner ve message_id verilir.
400 “Must be connected”: hattın WhatsApp oturumu düşmüş demektir. Numara sahibinin telefonundan QR yeniden okutulur; sonra çağrılar normale döner.
Token hatası: token başlığı eksik, hatalı veya süresi geçmiş. Token ucundan yeniden alın.
502: çoğunlukla kurum ağınızdan kaynaklanan erişim engelidir. Aynı isteği farklı bir internet bağlantısından tekrarlayın; servisin ayakta olduğunu https://wasms.tecmony.cloud/ adresine yapılan bir istekle doğrulayın, sağlıklı yanıt 200 döner.

Hata kodlarının tam listesi, alan bazında doğrulama kuralları ve Postman koleksiyonu için Tecmony destek ekibine yazın.

Kurulum

Numara bildiriminden ilk çağrıya dört adım

Numara doğrulanmadan hesap açılmaz; hizmet sözleşmesi de bu adımdan önce imzalanır.

Numara bildirimiGönderimde kullanacağınız numarayı Tecmony’ye iletirsiniz. Numaranın yurt dışından çağrı veya SMS alabiliyor olması gerekir; bazı operatörler bu trafiği kapatır.
DoğrulamaEkibimiz numaraya bir çağrı veya SMS yönlendirir; doğrulama kodunu bize iletirsiniz.
Hesap açılışıNumara doğrulandıktan sonra phone_id ve PIN bilginiz paylaşılır; hat QR ile bağlanır.
EntegrasyonToken ucundan oturum alıp mesaj uçlarını çağırırsınız. Örnek Postman koleksiyonu destek ekibimizden temin edilir.

Sınırlar

WASMS’in yapmadıkları ve bilmeniz gerekenler

Bağlı cihaz yolunun getirdiği sınırlar. Eski sitemizde de yazıyordu, burada da yazıyor.

Resmî WhatsApp Business API değildir. Müşteri yalnızca numarayı ve numaranın kendi profilini görür; doğrulanmış işletme rozeti alınmaz. Rozet ve resmî teslim raporu gerekiyorsa WaSend’e bakın.
WhatsApp numarayı kısıtlayabilir veya kapatabilir. Hizmet sözleşmemizin 7. maddesi: bir cihazın WhatsApp hesabına bağlanarak çalışan üründe WhatsApp kendi politikalarına göre numarayı kısıtlayabilir; müşteri bu riski bilerek hizmeti seçer. Toplu ve istenmeyen gönderim riski belirgin biçimde artırır.
Bağlantı düşerse istekler “Must be connected” döner. Telefon tarafındaki oturum kapanırsa QR yeniden okutulana kadar gönderim durur. Gönderim akışınızda bu hatayı yakalayıp uyarı üretin.
Cep numarası dışında bir numara kullanılamaz. Sabit hat veya sanal numara bu yola uymaz; numaranın telefonda WhatsApp’a bağlı olması gerekir.
Anket ve buton mesajı deneyseldir. Üretimde kullanmadan önce Tecmony ile teyit edilir; sözleşme kapsamına girmez.
İzin toplamaz. Bir kişiye mesaj başlatmak için o kişinin, işletmenizin adını belirten bir izni önceden vermiş olması gerekir; iznin alınması ve mevzuata uygunluğu müşterinin sorumluluğudur.
Hassas veri kanalı değildir. Ödeme kartı numarası, finansal hesap bilgisi ve kimlik numarası bu kanaldan paylaşılmamalı, müşterilerden istenmemelidir.

Sık sorulanlar

Entegrasyondan önce sorulanlar

Burada olmayan bir soru için bize yazın. Başka bir yol daha uygunsa: gelen yazışmayı ekipçe karşılamak için WADesk, onaylı şablonla toplu kampanya için WaSend, salt-okunur arşiv için WAGEM. Karşılaştırma WhatsApp Ürünleri sayfasında.

WASMS ile SMS servisi arasındaki fark nedir?

WASMS, konvansiyonel SMS servisinin WhatsApp üzerinde çalışan hâlidir. Kendi uygulamanız, CRM’iniz veya kampanya sisteminiz API’ye bağlanır; fark, mesajın SMS yerine kurumunuza tanımlı WhatsApp hattından gitmesi ve metin dışında görsel, video, doküman, ses, kişi kartı ve konum gönderebilmenizdir.

WASMS ile WaSend arasındaki fark nedir?

Altyapı. WASMS QR ile bağlanan bir numara üzerinden çalışır: evrak yok, Meta onayı yok, ama doğrulanmış rozet de yok ve WhatsApp numarayı kapatabilir. WaSend resmî WhatsApp Business API üzerinden çalışır: işletme doğrulaması ve şablon onayı gerekir, Meta görüşme ücreti ödenir, karşılığında doğrulanmış profil ve resmî teslim raporu alınır.

Hangi mesaj türleri yayında, hangileri deneysel?

Metin, görsel, video, doküman, ses, konum, kişi kartı ve buton listesi uçları yayındadır. Anket ve buton mesajı deneyseldir; üretimde kullanmayı planlıyorsanız önce Tecmony ile teyit edin.

Token ne kadar geçerli?

Token, phone_id ve PIN ile alınır ve sonraki bütün çağrılarda token başlığında taşınır. Başlık eksik, hatalı veya süresi geçmişse istek reddedilir; bu durumda token ucundan yeniden alırsınız.

İstek 502 dönüyorsa ne yapmalıyım?

Bu genellikle kurum ağınızdan kaynaklanan bir erişim engelidir. Aynı isteği farklı bir internet bağlantısından tekrarlayın. Servisin ayakta olduğunu wasms.tecmony.cloud adresine yapılan bir istekle de doğrulayabilirsiniz; sağlıklı yanıt 200 kodu ile döner.

“Must be connected” hatası ne demek?

Hattın telefon tarafındaki WhatsApp oturumu düşmüş demektir. Numara sahibi telefondaki WhatsApp’tan Bağlı cihazlar adımıyla yeni QR’ı okutur; bağlantı kurulunca istekler normale döner. Bu, bağlı cihaz yolunun doğasında olan bir durumdur.

Gönderilen mesajın durumunu sorgulayabilir miyim?

Evet. GET /api/v1/whatsapp/message/{message_id} ucu gönderilen mesajın durumunu döner. Yanıtlar status, code ve data alanlarını taşıyan ortak zarfı kullanır.

Mesaj göndermek için müşteriden izin gerekir mi?

Evet. WASMS, WhatsApp LLC’nin kuralları çerçevesinde çalışır: bir kişiye mesaj başlatabilmek için o kişinin, işletmenizin adını açıkça belirten bir izni önceden vermiş olması gerekir. İznin alınma yöntemi ve mevzuata uygunluğu müşterinin sorumluluğundadır.

İlk çağrıyı bugün yapın

Numaranızı bildirin; doğrulama sonrası phone_id ve PIN ile dakikalar içinde ilk mesajınızı gönderirsiniz.

Demo Talep Edin

Ya da doğrudan ulaşın: +90 (216) 912 00 79[email protected]