n8n

Topluluk düğümünü kurun, kimlik bilgisini oluşturun, ilk iş akışınızı hazırlayın ve tetikleyici eklemeden önce tek webhook kısıtını öğrenin.

WASync, n8n için bir topluluk düğümüyle birlikte gelir. Düğüm npm'de n8n-nodes-wasync adıyla yayımlanır. Bu dokümanlarda anlatılan REST API'yi sarmalar; yani düğümün yaptığı her şeyi curl ile de yapabilirsiniz. Düğümün henüz yapmadığı şeyleri de yapabilirsiniz.

Başlamadan önce: bir hesap ve bağlı bir numara

Düğüm WASync hesabınızla konuşur. Henüz hesabınız yoksa önce onu oluşturun. Bir dakika sürer ve ücretsizdir:

Ücretsiz bir geliştirici hesabı oluşturun

developers.wasync.app/register adresine gidin ve ad, e-posta ve parola girin. Her yeni hesap kendi çalışma alanıyla gelir: WhatsApp numaralarınızın ve API key'lerinizin bulunduğu yer.

Bu çalışma alanına bir WhatsApp numarası ekleyin

İki durum söz konusu:

WASync'i zaten Bitrix24 içinde kullanıyorsunuz. Bitrix24'te kullandığınız e-posta ile oturum açın. Portalınız bir çalışma alanı olarak görünür ve bağlı numaraları kullanıma hazırdır. API üzerinden göndermek için o numarada API eklentisi gerekir (numara başına ayda 12 $; eklenti yoksa düğümün gönderme adımı addon_required yanıtı verir).
WASync'e yenisiniz. Bir QR kodu (veya WhatsApp'a gireceğiniz bir eşleştirme kodu) döndüren tek bir API çağrısıyla kendi çalışma alanınıza bir numara bağlayın. Adımların tamamı WhatsApp numarası bağlama sayfasında. Her numara 7 günlük ücretsiz denemeyle başlar; planlar numara başına ayda WAPP 19 $ veya WABA 29 $'dır (USD).

Bir API key oluşturun

Bunu iki yolla yapabilirsiniz:

WASync'i zaten Bitrix24 içinde mi kullanıyorsunuz? Settings → API & Agents → API keys bölümüne gidin, entegrasyona bir ad verin ve Create key'e tıklayın. API eklentisi etkin bir bağlantı gerekir ve anahtar bu iş akışının ihtiyaç duyduğu kapsamlarla (whatsapp.read whatsapp.send) gelir. Aşağıdaki kapsam listesini atlayın.
Aksi halde oturum açın ve developers.wasync.app/keys adresini açın. Çalışma alanını seçin, anahtara bir ad verin, aşağıdaki kapsamları işaretleyin ve oluşturun.

Hangi yolu seçerseniz seçin, anahtarı hemen kopyalayın; yalnızca bir kez gösterilir. n8n kimlik bilgisi bu değeri ister.

Tek hesap, birçok numara

Düğümün Connection → List işlemi, anahtarın erişebildiği tüm numaraları gösterir. Liste boşsa çalışma alanında henüz bağlı bir numara yok demektir; 2. adıma dönün.

1. Topluluk düğümünü kurun

n8n tarafından doğrulandı (7 Eyl 2026)

n8n-nodes-wasync doğrulanmış bir topluluk düğümüdür. n8n'in doğrulama rozeti gösterdiği her yerde bu rozeti taşır.

n8n'i nerede çalıştırdığınıza bağlı olarak iki kurulum yolu var:

n8n Cloud veya kendi sunucunuz: düğüm panelinde arayın. Düğüm panelini açın, "WASync" diye aratın ve ekleyin. Doğrulanmış düğümler doğrudan buradan kurulur, ek ayar gerekmez.
Yalnızca kendi sunucunuz: Community Nodes ayarları. Settings → Community nodes → Install bölümüne gidin, paket adını girin ve onaylayın:
```
n8n-nodes-wasync
```
Bu yol, doğrulanmış olsun olmasın her kendi sunucunuzda çalışır.

Kurulumdan sonra WASync ve WASync Trigger düğümleri düğüm panelinde görünür.

Hazır başlangıç noktaları: ücretsiz iş akışı şablonları en yaygın akışları kapsar. Boş bir tuvalden başlamak yerine birini içe aktarın ve alanları uyarlayın.

2. Kimlik bilgisini oluşturun

WASync API türünde bir kimlik bilgisi ekleyin. Tek bir alanı vardır: API key'iniz. Bu anahtar Authorization: Bearer … olarak gönderilir.

Yukarıda oluşturduğunuz anahtarı yapıştırın (bkz. Başlamadan önce); yalnızca bir kez gösterilir. Ona yalnızca iş akışının ihtiyaç duyduğu kapsamları verin:

bağlantıları listelemek ve mesajları okumak → whatsapp.read
göndermek ve okundu olarak işaretlemek → whatsapp.send
tetikleyici → whatsapp.events

Bkz. Kapsamlar.

3. İlk iş akışınız

En basit işe yarar iş akışı iki düğümden oluşur: bir manuel tetikleyici ve bir gönderme.

Bağlantı kimliğini bulun. Bir WASync düğümü ekleyin, kaynak olarak Connection, işlem olarak List seçin ve çalıştırın. Mesaj göndermek istediğiniz numaranın id değerini kopyalayın.

Mesaj gönderin. İkinci bir WASync düğümü ekleyin, kaynak Message → işlem Send. Şunları doldurun:

Alan	Değer
`connectionId`	az önce kopyaladığınız kimlik
`to`	uluslararası biçimde rakamlar, `+` olmadan, örn. `40712345678`
`text`	mesaj metni

Çalıştırın. Düğüm, daha sonra eşleştirme yapabileceğiniz mesaj kimliğini döndürür. Bkz. iki kimlik.

Düğümün desteklediği işlemler

Kaynak	İşlem	Parametreler
Connection	List	—
Message	Send	`connectionId`, `to`, `text`
Message	Get Many	`connectionId`, `limit`
Message	Mark as Read	—

Yalnızca metin gönderimi desteklenir. WhatsApp şablonu göndermek ve bir numaranın WhatsApp'ta olup olmadığını denetlemek bugün API üzerinden mümkün değildir; bu yüzden düğüm bunları sunmaz. Var olduklarını varsayan bir iş akışı kurmayın.

4. Tetikleyici

WASync Trigger, hesabınızda bir şey olduğunda iş akışını başlatır. Dört olayı destekler:

message.received
message.status
connection.connected
connection.disconnected

Yükler, Webhook'lar kılavuzundakilerle birebir aynıdır: aynı alanlar, aynı kimlikler, milisaniye cinsinden aynı timestamp.

Hesap başına tek webhook yuvası: tetikleyici onu taşır

API'de hesap başına tek bir webhook URL'si vardır (PUT /webhook, POST /webhook/rotate ve silme yok). Bir WASync Trigger'ı etkinleştirmek bu tek yuvayı n8n'e yönlendirir.

Yani kendi arka ucunuz webhook alıyorsa, tetikleyici devreye girdiği anda almayı durdurur. İki WASync Trigger de yuvayı aynı anda tutamaz; ikincisi kazanır. Olayları birden fazla yerde istiyorsanız bir kez alın ve kendiniz dağıtın: yuvayı n8n'de tutup bir iş akışından iletin ya da arka ucunuzda tutup bir n8n Webhook düğümünü çağırın.

Test ve üretim tetikleyici URL'leri farklıdır; bu yüzden aralarında geçiş yapmak da yuvayı taşır.

İletimler üç başarısız denemeden sonra bırakıldığı için n8n'de de bir uzlaştırma yolu bulundurun: her 30–60 saniyede bir Message → Get Many çağıran zamanlanmış bir iş akışı, örnek yeniden başlarken tetikleyicinin kaçırdığı her şeyi yakalar.

Düğüm yetmediğinde

Düğüm yaygın yolu kapsar. Medya gönderimi, eşleştirme kodları, bağlantı oluşturma, Idempotency-Key yönetimi veya API başvurusundaki başka her şey için n8n'in HTTP Request düğümünü aynı kimlik bilgisiyle kullanın: temel URL https://developers.wasync.app/api/v1, başlık Authorization: Bearer <key>.

Bu sayfa yardımcı oldu mu?

On this page