Webhook ve entegrasyon

n8n

n8n, ZenWapp'i diğer sistemlerinize kod yazmadan bağlamanın en pratik yoludur. External API standart REST olduğu için hazır HTTP Request düğümü yeterlidir.

1. Kimlik bilgisi tanımlayın

n8n'de Credentials → Header Auth ile yeni bir kimlik bilgisi oluşturun:

Name: Authorization
Value: Bearer wa_live_...

Böylece anahtar tek yerde durur; her düğüme tek tek yazmanız gerekmez.

2. Mesaj gönderen düğüm

HTTP Request düğümünü ekleyin ve şu şekilde ayarlayın:

Method: POST
URL: https://api.zenwapp.com/api/v1/whatsapp/external/messages/send
Authentication: yukarıda tanımladığınız Header Auth
Body Content Type: JSON

{
  "to": "={{ $json.phone }}",
  "message": "={{ $json.text }}"
}

3. Gelen mesajı yakalayın

n8n'de bir Webhook düğümü oluşturun ve ürettiği URL'i ZenWapp'e kaydedin:

curl -X POST "https://api.zenwapp.com/api/v1/whatsapp/external/webhooks" \
  -H "Authorization: Bearer $ZENWAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://n8n.sizinsirketiniz.com/webhook/zenwapp",
    "events": ["message.received"]
  }'

n8n webhook'unu da doğrulayın

n8n webhook URL'iniz internete açıktır. Akışın başına bir Function veya Code düğümü koyup X-Zenwapp-Signature başlığını doğrulayın. Yöntem için webhook rehberine bakın.

Örnek akışlar

Form → WhatsApp: web sitenizden gelen form kaydını anında WhatsApp mesajına dönüştürün.
Sipariş durumu: e-ticaret sisteminizde durum değiştiğinde müşteriye şablonlu mesaj gönderin.
Gelen mesaj → CRM: yeni bir müşteri yazdığında CRM'de kayıt açın.
Randevu hatırlatma: takvim kaydından bir gün önce zamanlanmış mesaj oluşturun.

İpuçları

Toplu gönderimde döngü kurmak yerine broadcast ucunu kullanın; tempo yönetimini ZenWapp üstlenir.
Gönderim uçları 202 döner — bu teslimat değil, kuyruğa alma onayıdır. Teslimatı ayrı bir message.status akışıyla izleyin.
429 yanıtına karşı düğümde yeniden deneme ve bekleme ayarlayın.