VOIS for n8n
VOIS'i n8n iş akışlarınıza bağlayın: çağrı bitince tabloya satır yazın, cevapsız çağrıyı ekibinize bildirin, ses kayıtlarını arşivleyin, formdan gelen adayı VOIS CRM'e alın ve SMS gönderin. Kendi sunucunuzda çalışan n8n'e kurulur.
n8n-nodes-vois
npm sayfası
n8n 1.x/2.x, VOIS API anahtarı gerekir.
n8n'de Settings › Community Nodes › Install ekranında paket adı olarak n8n-nodes-vois yazmanız yeterli. Kurulumda yardım isterseniz destek@vois.com.tr adresine yazın.
n8n'e 4 adımda bağlayın
Kendi sunucunuzda çalışan n8n'e kurulur.
- n8n 1.x ya da 2.x (Cloud ya da kendi sunucunuz)
- VOIS panel girişiniz (API anahtarı için)
- Tetikleyiciler için n8n'in internetten erişilen bir https adresi
- VOIS panelinde API anahtarı oluşturun. Ayarlar › Entegrasyonlar › REST API & Webhook sayfasında anahtara bir ad verin, kullanacağınız özelliklere göre (aşağıdaki yetki tablosu) yetkilerini işaretleyip oluşturun. Anahtar yalnız bir kez gösterilir; hemen kopyalayın.
- Paketi kurun. n8n'de Settings › Community Nodes › Install, paket adı
n8n-nodes-vois. Paket npm'de görünene kadar erken erişim için bize yazın. - Kimlik bilgisini ekleyin. İş akışına VOIS düğümünü ekleyin, Credential › Create new ile anahtarı yapıştırın.
- Tetikleyiciyi açın. VOIS Trigger düğümünde olayları seçin ve iş akışını Active yapın.
Düğümler, güvenlik ve örnek iş akışları aşağıda.
Neler var
| Tür | Adı | Ne yapar |
|---|---|---|
| Tetikleyici | VOIS Trigger | Çağrı çalınca, cevaplanınca, bitince; müşteri, fırsat, fatura, teklif, proforma, sözleşme ve abonelik olaylarında anında çalışır. Birden çok olay seçilebilir. |
| Eylem | Call › Start / Hang Up | Tıkla-ara: önce dahiliyi çaldırır, açınca numarayı arar. Süren çağrıyı kapatır. |
| Eylem | Call › Get / Get Many / Get Active | Çağrı geçmişi (tarih, yön, sonuç, dahili, numara filtresi) ve süren çağrılar. |
| Eylem | Call › Download Recording | Ses kaydını dosya olarak indirir; Google Drive, e-posta gibi düğümlere verilebilir. |
| Eylem | SMS › Send | Onaylı gönderen başlığınızla SMS gönderir (Türkçe karakter ve numara biçimi otomatik). |
| Eylem | Lead › Create / Get / Get Many | VOIS CRM'de fırsat (aday) oluşturur ve arar. |
| Eylem | Customer, Invoice, Extension | Müşteri ve fatura getirme/arama, dahili listesi. |
Düğüm n8n'in yapay zekâ ajanlarında araç (tool) olarak da kullanılabilir.
Kurulum
- API anahtarı oluşturun. VOIS panelinde Ayarlar › Entegrasyonlar › REST API & Webhook sayfasında yeni anahtar oluşturun. Kullanacağınız özelliklere göre yetkileri işaretleyin (aşağıdaki tablo). Anahtarı kopyalayın; bir daha gösterilmez.
- Paketi kurun. n8n'de Settings › Community Nodes › Install, paket adı
n8n-nodes-vois. (Docker'da kendi kurulumunuzsaN8N_COMMUNITY_PACKAGES_ENABLEDkapalı olmamalı.) - Kimlik bilgisini ekleyin. İş akışına VOIS düğümünü ekleyin › Credential › Create new › anahtarı yapıştırın. API Base URL alanını değiştirmeyin. "Connection tested successfully" görünmelidir.
- Tetikleyici için: VOIS Trigger düğümünü ekleyip olayları seçin ve iş akışını Active yapın. n8n, VOIS'te bildirimi kendisi oluşturur; iş akışını kapatınca siler.
Önemli: VOIS bildirimleri yalnızca internetten erişilen https:// adreslere gönderir. Kendi sunucunuzdaki n8n'de WEBHOOK_URL ortam değişkeni n8n'in dışarıdan erişilen https adresine ayarlı olmalıdır (ters vekil sunucu ya da tünel).
Hangi yetki ne için
| Kullanım | Paneldeki yetkiler |
|---|---|
| Çağrı tetikleyicileri | Webhook yönetimi + Ses: okuma |
| Müşteri, fırsat, fatura tetikleyicileri | Webhook yönetimi + Okuma |
| Çağrı başlatma ve kapatma | Ses: arama başlat/kapat + Ses: okuma (dahili listesi için) |
| Çağrı geçmişi, süren çağrılar, dahililer | Ses: okuma |
| Ses kaydı indirme | Ses: kayıt indir |
| SMS gönderme | SMS: gönder + SMS: rapor/okuma (başlık listesi için) |
| Müşteri, fırsat, fatura okuma | Okuma |
| Fırsat oluşturma | Yazma |
Güvenlik
- Tetikleyici, her bildirimin
X-VOIS-Signatureimzasını (gövdenin HMAC-SHA256'sı) doğrular. İmzası tutmayan istek401ile reddedilir ve iş akışını başlatmaz. - 10 dakikadan eski imzalı olaylar tekrar gönderime karşı yok sayılır (süre düğüm seçeneklerinden değiştirilebilir).
- Anahtar n8n'de şifreli saklanır ve hata mesajlarında görünmez. Anahtarı iptal ederseniz o anahtarla oluşturulan bildirimler de durur.
Örnek iş akışları
- Cevapsız çağrıya bildirim: VOIS Trigger (Call Ended) → IF
status=no_answer→ Slack / Telegram / e-posta. - Çağrı kaydı tablosu: VOIS Trigger (Call Ended) → Google Sheets: satır ekle (tarih, arayan, dahili, süre, sonuç).
- Ses kaydı arşivi: VOIS Trigger (Call Ended) → IF
recording_available→ VOIS: Call › Download Recording → Google Drive: yükle. - Formdan CRM'e: Webhook / Typeform / Facebook Lead Ads → VOIS: Lead › Create.
- Yeni adayı hemen arama: VOIS Trigger (Lead Created) → VOIS: Call › Start (satış temsilcisinin dahilisi,
phonenumber). - Randevu hatırlatma: Schedule → Google Calendar → VOIS: SMS › Send.
Sık karşılaşılanlar
| Mesaj | Ne yapmalı |
|---|---|
| Bu işlem için API anahtarında '…' yetkisi gerekli | Panelde o yetkiyle yeni bir anahtar oluşturun ve bağlantıyı yeni anahtarla güncelleyin. |
| Your VOIS API key is invalid or revoked | Anahtar iptal edilmiş ya da hatalı. Yeni anahtar oluşturup bağlantıyı yenileyin. |
| https_required / url_not_allowed | VOIS bildirimleri yalnızca internetten erişilen https:// adreslere (443 ya da 80 portu) gönderir. Yerel ya da iç ağ adresi kabul edilmez. |
| Bu hesapta SMS hizmeti tanımlı değil | SMS hizmeti açtırmak için bize ulaşın. |
| Dahiliye bağlı telefon yok | Seçtiğiniz dahilinin telefonu açık ve bağlı olmalı. |
Panelde API & Webhook Yönetimi sayfasında n8n'in eklediği webhook'lar "API ile" etiketiyle görünür. Kaynak kod ve ayrıntılı İngilizce açıklama paketin README dosyasındadır.