Genel bakış
Netgsm müşterisi, kendi Netgsm kullanıcı adı ve şifresiyle WhatsApp numarasından mesaj gönderir.
Genel
| Adres | https://whatsappapi.netgsm.com.tr/v1/netgsm/whatsapp |
| Kimlik | Authorization: Basic <kullanıcı adı:şifre> — Netgsm kullanıcı adı ve şifresi |
| Gönderen numara | Kullanıcının WhatsApp numarası, kendiliğinden seçilir. Birden fazla numara varsa from alanıyla seçilir (908501110077, +90 850 111 00 77) |
Alıcı (to) | Telefon numarası (905321112233) ya da numarasını gizlemiş kişide WhatsApp kimliği (TR.1000000000000003) |
| Biçim | JSON; dosya gönderiminde multipart |
Örneklerde auth: "Basic kullanıcı:şifre": Netgsm kullanıcı adı ve şifresi Authorization başlığında Basic olarak gönderilir (Postman'de Authorization → Basic Auth). Gövdeye kullanıcı adı / şifre konmaz.
İşlemler
Yollar adresin (https://whatsappapi.netgsm.com.tr/v1/netgsm/whatsapp) sonuna eklenir; örneğin metin mesajı POST https://whatsappapi.netgsm.com.tr/v1/netgsm/whatsapp/messages/text.
| Yöntem | Yol | İşlem | Sayfa |
|---|---|---|---|
POST | /messages/text | Metin mesajı | Mesaj gönderme |
POST | /messages/template | Şablon mesajı (OTP dahil) | Mesaj gönderme |
POST | /messages/image | Görsel | Mesaj gönderme |
POST | /messages/video | Video | Mesaj gönderme |
POST | /messages/document | Belge | Mesaj gönderme |
POST | /messages/audio | Ses | Mesaj gönderme |
POST | /messages/location | Konum | Mesaj gönderme |
POST | /messages/replyReaction | Mesaja tepki (emoji) | Mesaj gönderme |
POST | /messages/markAsRead | Gelen mesajı okundu işaretleme | Mesaj gönderme |
POST | /twoStepVerification | İki adımlı doğrulama PIN'i | Mesaj gönderme |
POST | /messages/list | Mesaj geçmişi (gelen ve giden, durumlarıyla) | Şablonlar ve mesaj geçmişi |
GET | /template/list | Şablon listesi | Şablonlar ve mesaj geçmişi |
POST | /template/create | Şablon oluşturma | Şablonlar ve mesaj geçmişi |
POST | /template/update | Şablon düzenleme | Şablonlar ve mesaj geçmişi |
POST | /template/remove | Şablon silme | Şablonlar ve mesaj geçmişi |
GET | /profile/setting | İşletme profilini okuma | İşletme profili |
POST | /profile/setting | İşletme profilini güncelleme | İşletme profili |
POST | /profile/image | Profil görseli | İşletme profili |
Gönderilen mesajlar, mesaj durumları ve gelen mesajlar, portaldan tanımlanan adrese bildirim olarak da iletilir: Bildirimler (webhook).
Kurulum
Numara bir kez kurulum ekranından bağlanır; sonrasında gönderim, mesaj geçmişi, şablon ve profil işlemleri kullanıcı adı ve şifreyle yapılır.
- Numarası olmayan kullanıcı kurulum ekranındaki adımları izleyerek kurulumu tamamlar. Onay sayfası açılır pencerede açılabilir; tarayıcı engellerse ekranda "yeniden aç" bağlantısı çıkar.
- Kurulum bitince numara kullanıcıya bağlanır; kullanıcı hemen sonraki sayfalardaki uçlarla gönderim yapabilir. Şablonlar ve profil hem bu uçlarla hem aynı kurulum ekranından yönetilir; çalışma saatleri ve numarayı kaldırma yalnız kurulum ekranındadır.