n8n entegrasyonu

n8n iş akışlarınızdan WhatsApp mesajları gönderin. Örneğin bir webhook'tan gelen yeni bir potansiyel müşteriye mesaj gönderin, mağazanızdan gelen bir siparişi onaylayın veya bir kontrol başarısız olduğunda uyarı gönderin.

Bağlanmanın iki yolu vardır:

• Wbiztool topluluk node'u (n8n-nodes-wbiztool): her seçenek için alanları olan hazır node'lar.
• Yerleşik HTTP Request node'u: her n8n kurulumunda çalışır ve tüm API endpoint'lerine erişim sağlar. Bkz. HTTP Request node ile kullanım.

Başlamadan önce#

• WhatsApp ayarları sayfasında bağlı bir WhatsApp numarası olan bir Wbiztool hesabı.
• Ayarlar → API anahtarları sayfasından Client ID ve API anahtarınız.
• WhatsApp ayarları sayfasında gösterilen, gönderim yapılacak numaranın WhatsApp Client ID değeri.

Topluluk node'unu kurun#

1. Topluluk node'larını açın

   n8n'de Settings → Community Nodes bölümüne gidin ve Install'a tıklayın.

2. Paket adını girin

   n8n-nodes-wbiztool girin, onaylayın ve kurun. Node'lar görünmezse n8n'i yeniden başlatın.

Kendi sunucunuzda barındırılan bir kurulumda paketi n8n özel node'lar klasörünüzde npm ile de kurabilirsiniz:

npm install n8n-nodes-wbiztool

Kimlik bilgisini oluşturun#

WbizTool API türünde yeni bir kimlik bilgisi (credential) ekleyin:

Kaydettiğinizde n8n kimlik bilgisini Kimlik bilgilerini kontrol etme endpoint'ine karşı test eder.

Node'lar#

Paket şu node'ları ekler. Her biri bir Wbiztool API endpoint'ini çağırır ve API yanıtını çıktı olarak verir.

WbizTool Send Message#

Node, messageId (API'den gelen msg_id) çıktısını verir. Durumu kontrol etmek veya mesajı daha sonra iptal etmek istiyorsanız bunu kaydedin.

Örnek iş akışı#

1. Webhook node'u phone ve name içeren yeni bir potansiyel müşteri alır.
2. WbizTool Send Message: Phone Number değerini {{ $json.phone }}, Message Text değerini Hi {{ $json.name }}, thanks for signing up! olarak ayarlayın.
3. IF node'u: CRM'inizi güncellemek gibi bir sonraki adımla devam etmek için {{ $json.messageId }} değerinin boş olmadığını kontrol edin.

Başarılı bir WbizTool Send Message şuna benzer bir öğe çıktısı verir:

{
  "success": true,
  "messageId": 9817263,
  "status": 1,
  "message": "Created",
  "response": { "status": 1, "message": "Created", "msg_id": 9817263 }
}

Öğe ayrıca node'un gönderdiği değerleri içeren bir input nesnesi de içerir. API bir hata döndürürse node durur ve API'nin message değerini gösterir. Bunun yerine success: false ve error metni içeren bir öğe almak için Continue On Fail ayarını açın.

WbizTool WhatsApp Client Status için General Status kontrol yöntemini kullanın. Status by ID yöntemi, o API endpoint'indeki bir hata nedeniyle her numara için hata döndürür. General Status ile bağlı olmayan bir numara da node'u Disconnected hatasıyla durdurur; sonuca göre dallanmak istiyorsanız node'un Continue On Fail ayarını açın.

HTTP Request node ile kullanım#

Bir HTTP Request node'u ekleyin ve şöyle yapılandırın:

Ardından şuna benzer bir gövde yapıştırın ve değerleri önceki node'lardan ifadelerle eşleyin:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "{{ $json.phone }}",
  "msg": "Hi {{ $json.name }}, thanks for signing up!"
}

Başarılı bir çağrı {"status": 1, "message": "Created", "msg_id": 9817263} döndürür. Tüm alanlar ve hata mesajları Mesaj gönderme sayfasındadır.

Diğer endpoint'leri çağırmak için URL'yi ve gövdeyi değiştirin. Örneğin bir mesajı zamanlamak için https://wbiztool.com/api/v1/schedule_msg/ kullanın ve DD/MM/YYYY biçiminde date, HH:MM biçiminde time ve timezone ekleyin. Bkz. Mesaj zamanlama.

Aynı mesajı tek çağrıda birkaç numaraya veya gruba göndermek için https://wbiztool.com/api/v1/send_msg/multi/ kullanın ve alıcıları phone içine virgülle ayrılmış tek bir metin olarak yazın. Bkz. Birden çok numaraya gönderme.

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 1,
  "country_code": "91",
  "phone": "{{ $json.phones }}",
  "img_url": "https://example.com/offers/diwali-sale.jpg",
  "msg": "Our Diwali sale starts tomorrow!"
}

Her numaraya yalnızca rakam yazın. 98765 43210 gibi tam sayı olmayan her şey grup adı olarak gönderilir.

n8n ifadeleri her metin alanında çalışır. Örneğin günün saatine bağlı bir selamlama veya sipariş toplamına bağlı bir metin:

{
  "msg": "Good {{ $now.hour < 12 ? 'morning' : 'evening' }} {{ $json.name }}, your order total is {{ $json.total }}.{{ $json.total > 1000 ? ' Delivery is free.' : '' }}"
}

$now iş akışının saat dilimini (Workflow settings → Timezone) kullanır; "morning"in ne zaman biteceğini belirlemek için bunu ayarlayın.

Bir mesaj gönderildiğinde bildirim alın#

1. Bir webhook iş akışı oluşturun

   HTTP yöntemi POST olan bir Webhook node'u ekleyin ve üretim (production) URL'sini kopyalayın.

2. Gönderirken URL'yi iletin

   Bu URL'yi node'un Webhook URL seçeneğine veya HTTP istek gövdenizin webhook alanına yazın.

3. Sonucu okuyun

   Wbiztool, mesaj gönderildiğinde veya başarısız olduğunda URL'yi çağırır. Gövde form kodludur ve yalnızca msg_id ile SENT veya FAILED değerindeki status alanını içerir.

Yeniden denemeler ve zaman aşımları için bkz. Webhook.

Sorun giderme#