VOISDokümantasyon

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.

Paket adı: 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.

Hızlı başlangıç

n8n'e 4 adımda bağlayın

Kendi sunucunuzda çalışan n8n'e kurulur.

Başlamadan önce
  • 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
  1. 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.
  2. 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.
  3. Kimlik bilgisini ekleyin. İş akışına VOIS düğümünü ekleyin, Credential › Create new ile anahtarı yapıştırın.
  4. 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ürAdıNe yapar
TetikleyiciVOIS 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.
EylemCall › Start / Hang UpTıkla-ara: önce dahiliyi çaldırır, açınca numarayı arar. Süren çağrıyı kapatır.
EylemCall › Get / Get Many / Get ActiveÇağrı geçmişi (tarih, yön, sonuç, dahili, numara filtresi) ve süren çağrılar.
EylemCall › Download RecordingSes kaydını dosya olarak indirir; Google Drive, e-posta gibi düğümlere verilebilir.
EylemSMS › SendOnaylı gönderen başlığınızla SMS gönderir (Türkçe karakter ve numara biçimi otomatik).
EylemLead › Create / Get / Get ManyVOIS CRM'de fırsat (aday) oluşturur ve arar.
EylemCustomer, Invoice, ExtensionMüşteri ve fatura getirme/arama, dahili listesi.

Düğüm n8n'in yapay zekâ ajanlarında araç (tool) olarak da kullanılabilir.

Kurulum

  1. 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.
  2. Paketi kurun. n8n'de Settings › Community Nodes › Install, paket adı n8n-nodes-vois. (Docker'da kendi kurulumunuzsa N8N_COMMUNITY_PACKAGES_ENABLED kapalı olmamalı.)
  3. 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.
  4. 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ımPaneldeki yetkiler
Çağrı tetikleyicileriWebhook yönetimi + Ses: okuma
Müşteri, fırsat, fatura tetikleyicileriWebhook yönetimi + Okuma
Çağrı başlatma ve kapatmaSes: arama başlat/kapat + Ses: okuma (dahili listesi için)
Çağrı geçmişi, süren çağrılar, dahililerSes: okuma
Ses kaydı indirmeSes: kayıt indir
SMS göndermeSMS: gönder + SMS: rapor/okuma (başlık listesi için)
Müşteri, fırsat, fatura okumaOkuma
Fırsat oluşturmaYazma

Güvenlik

Örnek iş akışları

Sık karşılaşılanlar

MesajNe yapmalı
Bu işlem için API anahtarında '…' yetkisi gerekliPanelde o yetkiyle yeni bir anahtar oluşturun ve bağlantıyı yeni anahtarla güncelleyin.
Your VOIS API key is invalid or revokedAnahtar iptal edilmiş ya da hatalı. Yeni anahtar oluşturup bağlantıyı yenileyin.
https_required / url_not_allowedVOIS 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ğilSMS hizmeti açtırmak için bize ulaşın.
Dahiliye bağlı telefon yokSeç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.