# n8n-nodes-netgsm-unofficial

![n8n.io - Workflow Automation](https://raw.githubusercontent.com/n8n-io/n8n/master/assets/n8n-logo.png)

NetGSM API entegrasyonu için n8n community node'u. Bu node ile NetGSM üzerinden SMS ve sesli mesaj gönderebilirsiniz.

[n8n](https://n8n.io/) workflow otomasyon platformu için geliştirilmiş bir topluluk node'udur.

## Kurulum

### Community Nodes Panel Üzerinden (Önerilen)

1. n8n arayüzünde **Settings** > **Community Nodes** bölümüne gidin
2. **Install** butonuna tıklayın
3. Package name alanına `n8n-nodes-netgsm-unofficial` yazın
4. **Install** butonuna tıklayın

### NPM ile Manuel Kurulum

n8n self-hosted kurulumunuzda:

```bash
npm install n8n-nodes-netgsm-unofficial
```

Docker ile n8n kullanıyorsanız:

```bash
docker exec -it n8n_container npm install n8n-nodes-netgsm-unofficial
# Ardından n8n'i yeniden başlatın
```

## Kullanım

### 1. NetGSM API Kimlik Bilgilerini Ayarlama

Node'u kullanabilmek için önce NetGSM API kimlik bilgilerinizi ayarlamanız gerekir:

1. [NetGSM Web Portal](https://portal.netgsm.com.tr) üzerinden giriş yapın
2. **Abonelik İşlemleri** > **Alt Kullanıcı Hesapları** bölümüne gidin
3. **Yeni Kayıt** butonuna tıklayarak API için özel bir alt kullanıcı oluşturun
4. n8n'de NetGSM node'unu ekledikten sonra credentials bölümünde:
   - **Username**: Alt kullanıcı adınız
   - **Password**: Alt kullanıcı şifreniz
   - **App Name**: İsteğe bağlı (varsayılan: "n8n")

### 2. SMS Gönderme

1. **Operation** olarak "Send SMS" seçin
2. Gerekli alanları doldurun:
   - **Message Header**: Gönderen adı (örn: "SIRKETIM")
   - **Phone Number**: Alıcı telefon numarası (90 olmadan, örn: "5551234567")
   - **Message**: Gönderilecek mesaj
   - **Encoding**: Türkçe karakterler için "TR", İngilizce için "EN"

### 3. Sesli Mesaj Gönderme

1. **Operation** olarak "Send Voice Message" seçin
2. Gerekli alanları doldurun:
   - **Message Header**: Gönderen adı
   - **Phone Number**: Alıcı telefon numarası
   - **Message**: Okunacak metin (sesli mesaj)

## Özellikler

- ✅ SMS gönderme
- ✅ Sesli mesaj gönderme
- ✅ Türkçe karakter desteği
- ✅ Hata yönetimi
- ✅ NetGSM API yanıt kodları kontrolü

## API Yanıt Kodları

NetGSM API'den dönen temel yanıt kodları:

- `00`: Mesaj gönderildi
- `01`: Mesaj gönderildi
- `02`: Mesaj gönderildi
- `20`: Mesaj metninde problem var
- `30`: Geçersiz kullanıcı adı/şifre
- `40`: Kredi/paket yetersiz

## Örnek Workflow

```json
{
  "nodes": [
    {
      "parameters": {
        "operation": "sendSms",
        "msgheader": "SIRKETIM",
        "phoneNumber": "5551234567",
        "message": "Merhaba! Bu bir test mesajıdır.",
        "encoding": "TR"
      },
      "type": "n8n-nodes-netgsm-unofficial.netgsm",
      "typeVersion": 1,
      "position": [820, 300]
    }
  ]
}
```

## Gereksinimler

- n8n sürüm 0.175.0 veya üzeri
- Node.js 20.15 veya üzeri
- Aktif NetGSM hesabı ve API erişimi

## Destek

Sorularınız veya sorunlarınız için:

- [NetGSM Teknik Destek](mailto:teknikdestek@netgsm.com.tr)

## Katkıda Bulunma

1. Repository'yi fork edin
2. Feature branch oluşturun (`git checkout -b feature/amazing-feature`)
3. Değişikliklerinizi commit edin (`git commit -m 'Add amazing feature'`)
4. Branch'ınızı push edin (`git push origin feature/amazing-feature`)
5. Pull Request oluşturun

## Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için [LICENSE](LICENSE) dosyasına bakın.

## Linkler

- [NetGSM](https://www.netgsm.com.tr/)
- [NetGSM API Dokümantasyonu](https://www.netgsm.com.tr/dokuman/)
- [n8n](https://n8n.io/)
- [n8n Community Nodes](https://docs.n8n.io/integrations/community-nodes/)

---

**Not**: Bu node resmi NetGSM ürünü değildir. Topluluk tarafından geliştirilmiş bir entegrasyondur.