netsantral-js v1.0.4

netsantral-js

Netgsm'in bir ürünü olan gelişmiş bulut santral hizmeti sunan Netsantral için bir npm paketi.

Paketi kullanmaya başlamadan önce resmi dökümanı incelemeniz faydalı olacaktır. https://www.netgsm.com.tr/netsantraldokuman

Kurulum

netsantral-js paketini npm kullanarak kurabilirsiniz:

npm i netsantral-js

netsantral-js paketini projenize dahil edin.

import * as netsantral from 'netsantral-js';

Not: Netgsm hesap ayarları bölümünden Alt Kullanıcı Hesabı oluşturarak username ve password değerlerini elde edebilirsiniz.

Santral Yönetimi

Çağrı süreçlerini yönetmek için bir Call instance oluşturun.

const call = new netsantral.Call({
  username: '850XXXXXXX',
  password: '*********',
});

Santraliniz üzerinden bir dış arama başlatmanızı sağlar.

await call.start({
  customer_num: '5XXXXXXXXX',
  internal_num: '104',
  trunk: '850XXXXXXX',
});

Spesifik bir çağrıyı sonlandırır. unique_id ve crm_id verileri bir çağrı başlattığınızda dönen response içerisinde bulunmaktadır.

await call.end({ unique_id: 'sip-xxxx-xxxx-xxxx' crm_id: 1});

Sadece gelen sesleri kapat.

await call.mute({ direction: 'in' });

Sadece giden sesleri kaapt

await call.mute({ direction: 'out' });

await call.unMute({ direction: 'out' });

Katılımlı transfer (atxfer - Attended Transfer)

atxfer transferde, çağrıyı transfer eden kişi önce çağrıyı hedefe aktaracağı kişiyle (yeni alıcı) konuşur ve ardından transferi gerçekleştirir. Transfer işlemi sırasında çağrıyı transfer eden kişi, görüşme başlatmadan önce durumu açıklama fırsatına sahiptir.

await call.transfer({ exten: '104', type: 'atxfer' });

Bir dış arama başlatarak bu aramayı dinamik olarak kuyruğa, anonsa veya ivr yönlendirebilirsiniz.

await call.dynamicRedirect({
    called: "5XXXXXXXXX",
    redirect_menu: "ivrtest",
    redirect_type: "ivr",
    trunk: "850XXXXXXX",
});

Kuyruk Yönetimi

Kuyruk süreçlerini yönetmek için bir Queue instance oluşturun.

const queue = new netsantral.Queue({
  username: '850XXXXXXX',
  password: '*********',
});

"paused: 0" Kuyruğa aktarılan dahili müsait olarak aktarılır.

await queue.addInternal({
  queue: '{{queueName}}',
  exten: '{{internal}}',
  paused: 1,
});

Gelecek Hedefler

Aşağıda, gelecek sürümler için planlanan özellikler ve iyileştirmeler bulunmaktadır:

• 🟢 Kuyruğa Dış Numara Ekleme: Kuyruk yönetimi içerisine kuyruğa dış numara ekleme işlemi.
• 🟢 Dinamik Yönlendirme: Santral yönetimi içerisine dinaimik çağrı yönlendireme özelliği ekleme.
• 🟠 Otomatik Arama: Otomatik arama modülünün entegrasyonu.
• 🟠 Webhook Santral Dinleme: Webhook özelliği entegrasyonu.
• 🟠 Rapor: CDR ve Gelene Çağrı istatistik mödülleri entegrasyonu.

Fikirlerinizi veya iyileştirme önerilerinizi belirtmek için bir issue açmaktan veya doğrudan katkıda bulunmaktan çekinmeyin!