# 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](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-mesaj-gonderme.md) |
| `POST` | `/messages/template` | Şablon mesajı (OTP dahil) | [Mesaj gönderme](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-mesaj-gonderme.md) |
| `POST` | `/messages/image` | Görsel | [Mesaj gönderme](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-mesaj-gonderme.md) |
| `POST` | `/messages/video` | Video | [Mesaj gönderme](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-mesaj-gonderme.md) |
| `POST` | `/messages/document` | Belge | [Mesaj gönderme](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-mesaj-gonderme.md) |
| `POST` | `/messages/audio` | Ses | [Mesaj gönderme](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-mesaj-gonderme.md) |
| `POST` | `/messages/location` | Konum | [Mesaj gönderme](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-mesaj-gonderme.md) |
| `POST` | `/messages/replyReaction` | Mesaja tepki (emoji) | [Mesaj gönderme](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-mesaj-gonderme.md) |
| `POST` | `/messages/markAsRead` | Gelen mesajı okundu işaretleme | [Mesaj gönderme](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-mesaj-gonderme.md) |
| `POST` | `/twoStepVerification` | İki adımlı doğrulama PIN'i | [Mesaj gönderme](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-mesaj-gonderme.md) |
| `POST` | `/messages/list` | Mesaj geçmişi (gelen ve giden, durumlarıyla) | [Şablonlar ve mesaj geçmişi](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-sablonlar.md) |
| `GET` | `/template/list` | Şablon listesi | [Şablonlar ve mesaj geçmişi](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-sablonlar.md) |
| `POST` | `/template/create` | Şablon oluşturma | [Şablonlar ve mesaj geçmişi](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-sablonlar.md) |
| `POST` | `/template/update` | Şablon düzenleme | [Şablonlar ve mesaj geçmişi](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-sablonlar.md) |
| `POST` | `/template/remove` | Şablon silme | [Şablonlar ve mesaj geçmişi](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-sablonlar.md) |
| `GET` | `/profile/setting` | İşletme profilini okuma | [İşletme profili](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-isletme-profili.md) |
| `POST` | `/profile/setting` | İşletme profilini güncelleme | [İşletme profili](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-isletme-profili.md) |
| `POST` | `/profile/image` | Profil görseli | [İşletme profili](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-isletme-profili.md) |

Gönderilen mesajlar, mesaj durumları ve gelen mesajlar, portaldan tanımlanan adrese bildirim olarak da iletilir: [Bildirimler (webhook)](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-webhook.md).

## 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.