Download the PHP package netgsm/netsantral without Composer

On this page you can find all versions of the php package netgsm/netsantral. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of netgsm/netsantral

Informations about the package netsantral

Netgsm Netsantral Composer Package (symfony & laravel entegration)

NetSantral paket aboneliği bulunan kullanıcılarımız için composer paketidir. alt text

İçindekiler

İletişim & Destek

Netgsm API Servisi ile alakalı tüm sorularınızı ve önerilerinizi [email protected] adresine iletebilirsiniz.

Supported

Supported Laravel Versions

Laravel 6.x, Laravel 7.x, Laravel 8.x, Laravel 9.x, Laravel 10.x,

Supported Lumen Versions

Lumen 6.x, Lumen 7.x, Lumen 8.x, Lumen 9.x,

Supported Symfony Versions

Symfony 4.x, Symfony 5.x, Symfony 6.x

Supported Php Versions

PHP 7.2.5 ve üzeri

Kurulum

composer require netgsm/netsantral

.env dosyası içerisinde NETGSM ABONELİK bilgileriniz tanımlanması zorunludur.

NETGSM_USERCODE=""
NETGSM_PASSWORD=""

Doküman

API Servisi için hazırlanmış kapsamlı dokümana ve farklı yazılım dillerinde örnek amaçlı hazırlanmış örnek kodlamalara https://www.netgsm.com.tr/netsantraldokuman/#netsantral-api adresinden ulaşabilirsiniz.

Santral Yönetimi

Çağrı işlemleri (başlatma, sonlandırma, sessize alma, bağlama, transfer), Kuyruk işlemleri (durum sorgulama, dahili ekleme/çıkarma, dış numara ekleme/çıkarma, dinamik yönlendirme) olayları gerçekleştirilebilir.

Çağrı Başlatma

Bu servis, santral numaranızdan (312xxxxxxx,850xxxxxxx) santralinizdeki register olan bir dahilden dış arama yapmak için veya santralinizdeki register olan diğer bir dahiliye arama yapmak için kullanılır.

Değişken Anlamı
customer_num Arama yapılacak dış numara bilgisi, dahilinizin aramak istediği GSM numara bilgisidir. Eğer originate order if yapılırsa önce dahiliniz of yapılırsa önce cep numarası aranır. Zorunlu parametre
internal_num Çağrının başlatılacağı iç dahilinin numarasıdır. Zorunlu parametre
ring_timeout Çağrının açılmadan önce çaldırma süresidir. Zorunlu parametre
crm_id Yapılan istegin IDsidir, yapılan isteklerin cevabı yine istekle beraber gönderilen "crm_id" ile döner. Zorunlu parametre
wait_response Eğer 1 ise isteğin cevabını çağrıyı biri açana kadar döndürmez, açarsada unique id ile beraber döndürür, 0 ise çağrıyı sisteme teslim edince hemen cevabı döndürür. Zorunlu parametre
originate_order Eğer “if” ise öncelikle dahili çalar, “of” ise öncelikle dış numara çalar. Zorunlu parametre
Trunk Santral numaranız, Aradığınızda görünecek numara bilgisidir.(çıkış yapılacak numara). Zorunlu parametre
call_time Saniye cinsinden süre verildiğinde, çağrı tetiklenme süresinden itibaren o kadar süre açık kalacağı anlamına gelir. Zorunlu olmayan parametre
hide_callerid 1 değerini aldığında aranan numara dahilinin ekranında gizlenerek gösterilir. 0 değerini aldığında gizlenmez. Zorunlu olmayan parametre
caller_text originate_order if seçilmişse kullanılabilen bu parametre, çağrı başlatıldığında dahiliye text içeriği ses olarak dinletilebilir. Zorunlu olmayan parametre
called_text originate_order if seçilmişse kullanılabilen bu parametre, çağrı başlatıldığında aranan dış numaraya text içeriği ses olarak dinletilebilir. Zorunlu olmayan parametre
caller_record originate_order if seçilmişse kullanılabilen bu parametre, çağrı başlatıldığında dahiliye öncesinde Netsantral arayüzden daha öncesinde yüklenmiş ses dosyasını dinletilebilirsiniz. (dosya adı yazılırken uzantısıyla birlikte arayüzdeki tam adı yazılmalıdır.) Zorunlu olmayan parametre
called_record originate_order if seçilmişse kullanılabilen bu parametre, çağrı başlatıldığında aranan dış numarayaetsantral arayüzden daha öncesinde yüklenmiş ses dosyasını dinletilebilirsiniz. ( yalnızca dosya adı yazılır, .wav uzantısı yazılmamalıdır.) Zorunlu olmayan parametre

Örnek

Başarılı istek örnek sonuç

Başarısız istek örnek sonuç

Sistemden Alınan Cevap

Parametre Anlamı
caller_num Arayan Numara
called_num Aranan Numara
response İstek Bilgisi
crm_id Yapılan istek ID
unique_id Çağrıya ait ID, Unique_id bilgisi çağrı başlatma başarılı olursa döner, çağrı başarısız olursa dönmez.
status Durum açıklaması, success ya da error döner.
message Mesaj açıklaması

Başarılı başlatılan çağrılarda message parametresinden dönebilir cevaplar

Durum Anlamı
No registration Eğer dahili veya trunk register değilse
Get Busy Karşı taraf meşgule aldığında
No Answer Karşı telefon çaldı, fakat cevaplayan olmadığında
Busy Meşgul
Successfully Başarılı
Unknown reason Nedeni belli olmayan durum(Hata mesajıdır.)

Hata Durumlarında message parametresinden dönebilir cevaplar

message sebebi
Kullanıcı doğrulanamadi username bilgisi hatalı gönderilirse gelen hata mesajı
Eksik yada yanlis parametre 2 internal_num veya trunk bilgisi hatalı gönderilirse gelen hata mesajı
Channel not specified originate_order bilgisi hatalı gönderilirse gelen hata mesajı *Dış numaraya başlatıln çağrılarda olabilir.

İç Dahiliye Çağrı Başlatma

Başarılı istek örnek sonuç

Başarısız istek örnek sonuç

Çağrı Sonlandırma

Parametre olarak aldığı uniqueid değerine sahip kanalı santraliniz üzerinde kapatarak çağrının sonlanmasını sağlar.
Çağrı sonlandırma santral çağrı trafiği izleme ile size gönderilen unique_id bilgisi ile de yapılabilir.

Parametre Anlamı
crm_id Yapılan istegin IDsidir, yapılan isteklerin cevabı yine istekle beraber gönderilen "crm_id" ile döner. Zorunlu parametre
unique_id onlandırmak istenilen çağrıya ait ID Zorunlu parametre

Örnek

Başarılı istek örnek sonuç

Başarısız istek örnek sonuç

Servisten Alınan Örnek Cevap

Kodu Anlamı
response istek bilgisi
crm_id Yaptığınız istek IDsi
unique_id Çağrıya ait ID
status Durum açıklaması
message Mesaj Açıklaması

Çağrıyı Sessize Alma

Parametre Anlamı
/muteaudio çağrıyı sessize alma işlemine ait komut Zorunlu Parametre
username Sistemden hizmet aldığınız abone numarasıdır. (Santral numaranızı göndermelisiniz.312911xxxx,850xxxxxxx) Zorunlu parametre
password API yetkisi tanımlı alt kullanıcı şifresi. Zorunlu parametre
unique_id Sessize alınmak istenilen çağrıya ait ID * * Zorunlu parametre **
crm_id Yapılan istegin IDsidir, yapılan isteklerin cevabı yine istekle beraber gönderilen "crm_id" ile döner. Zorunlu parametre
direction Hangi tarafa doğru sessize alınacağı bilgisi. Bu parametrede all, in, out değerleri gönderilebilir. Zorunlu parametre
state Sessize almak istediğinizde mute, sessizden almak istediğinizde unmute gönderiniz. Zorunlu parametre

Örnek

Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

Çağrı Bağlama

İki dış numarayı arayarak birbirine bağlama işlemidir.

Parametre Anlamı
caller Arama yapılacak dış numara bilgisi girilmelidir. Zorunlu parametre
called Çağrının bağlanacağı diğer dış numara bilgisi girilmelidir. Zorunlu parametre
ring_timeout Çağrının açılmadan önce çaldırma süresidir, saniye cinsinden belirtebilirsiniz. Zorunlu parametre
crm_id Yapılan istegin IDsidir, yapılan isteklerin cevabı yine istekle beraber gönderilen "crm_id" ile döner. Zorunlu parametre
wait_response ğer 1 ise isteğin cevabını çağrıyı biri açana kadar döndürmez, açarsada unique id ile beraber döndürür, 0 ise çağrıyı sisteme teslim edince hemen cevabı döndürür. Zorunlu parametre
originate_order Eğer “if” ise öncelikle “caller” çalar, “of” ise öncelikle “called” çalar. Zorunlu parametre
trunk Santral numaranız (8xxxxxxxxx). Zorunlu Parametre
call_time Saniye cinsinden süre verildiğinde, çağrı tetiklenme süresinden itibaren o kadar süre açık kalacağı anlamına gelir. Zorunlu olmayan parametre
caller_text çağrı bağlandığında caller parametresinde gönderilen numaraya text içeriği ses olarak dinletilebilir. Zorunlu olmayan parametre
called_text çağrı bağlandığında called parametresinde gönderilen numaraya text içeriği ses olarak dinletilebilir. Zorunlu olmayan parametre
caller_record çağrı bağlandığında caller parametresinde gönderilen numaraya Netsantral arayüzden daha öncesinde yüklenmiş ses dosyasını dinletilebilirsiniz. ( yalnızca dosya adı yazılır, .wav uzantısı yazılmamalıdır.) Zorunlu olmayan parametre
called_record originate_order if seçilmişse kullanılabilen bu parametre, çağrı başlatıldığında aranan dış numarayaetsantral arayüzden daha öncesinde yüklenmiş ses dosyasını dinletilebilirsiniz. ( yalnızca dosya adı yazılır, .wav uzantısı yazılmamalıdır.) Zorunlu olmayan parametre

Örnek

Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

Çağrı Transfer

Değişken Anlamı
type=xfer parametresi ile devam eden çağrıya ait unique_id parametresi kullanılarak, exten ile belirtilen dahiliye kör transfer yapılır. Zorunlu parametre
type=atxfer parametresi ile devam eden çağrıya ait unique id parametresi kullanılarak, exten ile belirtilen dahiliye çağrıyı katılımlı olarak aktarır. Çağrı başlatılırken originate_order of olmalıdır. Zorunlu parametre
unique_id Transfer istenilen çağrıya ait ID Zorunlu parametre
crm_id Yapılan istegin IDsidir, yapılan isteklerin cevabı yine istekle beraber gönderilen "crm_id" ile döner. Zorunlu parametre
exten Çağrının aktarılacağı numaradır. Zorunlu parametre
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

Servisten message parametresiyle dönen değerler

message Anlamı
No registration Eğer dahili veya trunk register değilse
Get Busy Karşı taraf meşgule aldığında
No Answer Karşı telefon çaldı, fakat cevaplayan olmadığında
Busy Meşgul
Successfully Başarılı
Unknown reason Nedeni belli olmayan durum(Hata mesajıdır.)

Kuyruğa Dahili Ekleme

Değişken Anlamı
crm_id Yapılan istegin IDsidir, yapılan isteklerin cevabı yine istekle beraber gönderilen "crm_id" ile döner. Zorunlu parametre.Netsantral portaldan eklenecek departman nodur.
exten Eklenmesi istenen dahili bilgisini bu parametrede belirtiniz. Zorunlu parametre
queue İşlem yapılacak kuyruk adını bu parametrede belirtiniz. Zorunlu parametre. Netsantral portaldan eklenecek departman adıdır.
paused Molada baslangıç için 1, açık başlamak için 0 gönderilebilir. Zorunlu parametre
penalty Kuyruktaki dahililerinizin hangisine daha fazla çağrı verileceğini belirtir. 0-99 arasında değer alabilir. penalty değeri önceliğine göre sistem çağrıları dağıtır. Zorunlu parametre *
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

Kuyruktan Dahili Çıkarma

Değişken Anlamı
crm_id Yapılan istegin IDsidir, yapılan isteklerin cevabı yine istekle beraber gönderilen "crm_id" ile döner. Zorunlu parametre.Netsantral portaldan eklenecek departman nodur.
exten Eklenmesi istenen dahili bilgisini bu parametrede belirtiniz. Zorunlu parametre
queue İşlem yapılacak kuyruk adını bu parametrede belirtiniz. Zorunlu parametre. Netsantral portaldan eklenecek departman adıdır.
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

Kuyruk Durum Sorgula

Santralinizdeki kuyruklardaki olaylar anlık olarak izlenebilir.

Değişken Anlamı
crm_id Yapılan istegin IDsidir, yapılan isteklerin cevabı yine istekle beraber gönderilen "crm_id" ile döner. Zorunlu parametre.Netsantral portaldan eklenecek departman nodur.
queue İşlem yapılacak kuyruk adını bu parametrede belirtiniz. Zorunlu parametre. Netsantral portaldan eklenecek departman adıdır.
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

Servisten Alınan Cevap Parametreleri

Değişken Anlamı
queuename Santralde bulunan kuyruğun adı
pbx_num Santralinizin Netgsm ara yüzünde görünen adıdır.
talktime Kaç saniye konuşulduğu bilgisini tutar.
crm_id Tarafınızda belirleyeceğiniz, isteğe ait Id bilgisi
calls Kuyrukta aktif bekleyen çağrı adedi
max Kuyrukta maksimum bekleyen çağrı adedi
abondaned Kuyruğu terkeden kişi sayısı
callers Kuyrukta bekleyen kişi numarası : Beklediği saniye
completed Başarılı çağrı adedi
holdtime Bekleme süresi
agents Kuyruğun içindeki dahililer
agent Dahilin numarası
status Dahilinin çağrı durumu
unregister status parametresi alabilceği değer, dahili register degil
onhook status parametresi alabilceği değer, dahili su an konusuyor
empty status parametresi alabilceği değer, dahili boşta bekliyor
ringing status parametresi alabilceği değer, dahili çalıyor
membership dahilinin kuyruğa eklenme yöntemi, static ise arayüzden, dynamic ise apiden
paused dahili mola durumu (true,false)
reason dahili mola sebebi

Kuyruktaki Dahiliyi Molaya Alma//Çıkarma

Parametre Anlamı
exten Mola konumuna alınacak dahili numarası Zorunlu parametre
queue İşlem yapılacak kuyruk adı Zorunlu parametre
crm_id Login isteğinde tarafınızda oluşturup gönderdiğiniz ID Zorunlu parametre
paused Molaya almak için 1 değeri, moladan çıkmak için 0 gönderiniz. Zorunlu parametre
reason Molaya alma sebebini bu parametre ile gönderebilirsiniz, bu işleminize göre kuyruk izleme APIsinden tarafınıza bu reason bilgisi dönecektir. Zorunlu parametre
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

Kuyruğa Dış Numara Ekleme/Çıkarma

Netsantral'iniz üzerinde kuyruğa harici (dahili dışında) numara/ekleyip çıkarma işlemi gerçekleştirebilirsiniz. Gelen çağrıları karşılamasını istediğiniz, belirleyeceğiniz kuyruğa (departmana) harici numara eklemek ya da çıkarabilirsiniz.

Değişken Anlamı
command Numara ekleme işlemi için queueaddnumber , listeden numara çıkarmak için queuedelnumber gönderebilirsiniz. Zorunlu parametre
tenant Santral numarası. Zorunlu parametre
queue Santralinizde tanımlı olan kuyruk(departman) bilgisi. (85030XXXXX-queue-kuyrukismi formatında gönderilmeli) Zorunlu parametre
no Kuyruğa eklenecek ya da kuruktan çıkarılacak numara. 5xxxxxxxxx, 312xxxxxxx formatında gönderilmeli. Zorunlu parametre
penalty Çağrıların numaralara dağıtımı sırasındaki önceliği belirler.Düşük değerler yüksek önceliğe sahiptir.Birden fazla numara aynı önceliğe sahip olabilir.Dahili numaralarda ve harici numaralarda belirlemiş olduğunuz öncelikler birbirini etkilemektedir. 1-10 arası değer alabilir. Zorunlu parametre
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç
Hata Kodu Anlamı
30 Geçersiz kullanıcı adı , şifre veya kullanıcınızın API erişim izninin olmadığını gösterir.Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı , web arayüzümüzden; sağ üst köşede bulunan ayarlar> API işlemleri menüsünden kontrol edebilirsiniz.
40 Gecersiz Santral Bilgileri
70 Hatalı sorgulama.Gönderdiğiniz parametrelerden birisi hatalı veya zorunlu alanlardan birinin eksik olduğunu ifade eder.
80 Sorgulama sınır aşımı. (dakikada en fazla 2 kez sorgulanabilir, bir kuyruğa max. 5 numara eklenebilir, aynı anda max. 5 kuyruğa işlem sağlanabilir.)
100 Sistem hatası

Dinamik Yönlendirme

Linkup API'ye (Çağrı bağlama API) benzer mantıkta çalışan, called parametresinde belirtilen numarayı arar ve ardından tipi redirect_type, ismi redirect_menu de belirtilmiş menüye aktarır.

Örneğin, arama yapmak istediğiniz dış numara 05XXXXXXXXX olduğunu varsayalım, bu numarayı arayarak operator isimli kuyruğunuza bu çağrıyı API ile yönlendirebilirsiniz.

Parametre Anlamı
called Arama yapılacak numara bilgisi girilmelidir. Zorunlu parametre
ring_timeout Çağrının açılmadan önce çaldırma süresidir. Zorunlu parametre
crm_id Yapılan istegin IDsidir, yapılan isteklerin cevabı yine istekle beraber gönderilen "crm_id" ile döner. Zorunlu parametre
wait_response Eğer 1 ise isteğin cevabını çağrıyı biri açana kadar döndürmez, açarsada unique id ile beraber döndürür, 0 ise çağrıyı sisteme teslim edince hemen cevabı döndürür. Zorunlu parametre
trunk Santral numaranızdır. Zorunlu parametre
redirect_menu Aktarılcak menü ismi belirtilmelidir. Zorunlu parametre
redirect_type Yönlendirmenin yapılması için; queue , announcement , ivr herhagi biri belirtilir. Zorunlu parametre
call_time Saniye cinsinden süre verildiğinde, çağrı tetiklenme süresinden itibaren o kadar süre açık kalacağı anlamına gelir. Zorunlu olmayan parametre
prefix Gelen çağrıda aranan numaranın başına eklenecek karakterlerdir, maksimum 5 adet string karakter eklenebilir. Zorunlu olmayan parametre
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

Otomatik Arama Nedir

Netsantral'iniz üzerinden otomatik arama yaparak müşterilere duyuru, onay alma, hatırlatma, borç bilgisi okutma gibi işlemleri yaptırabilirsiniz.

Neler Yapılabilir ?

Arama Listesi Oluştur

2 tür liste tipi oluşturabilirsiniz. Bitirmeli Sabit Liste ve Devamlı Dinamik Liste(interaktif).
Bitirmeli sabit listelerde düzenleme işlemi yapılamaz, numara ekleme-silme yapılamaz.
Verilen numara listesini belirlenen zaman içerisinde arar ve bir daha bu liste kullanılmaz. Örneğin; 3 günlük bir kampanya yaptınız. Girdiğiniz numaralara bu kampanyayı dinleten bir anons belirleyip tüm numaralar arandığında veya çalışma zamanı bittiğinde listenin tamamlanmasını sağlayabilirsiniz. Bu listeye daha sonradan numara eklemeye ihtiyaç yoktur.
Devamlı dinamik listede ise daha sonradan numara ekleyebilir, liste üzerinde belirli düzenlemeleri yapabilirsiniz.
Bazı entegrasyonlardan bu listeye numara ekletmesi yapabilirsiniz.

Değişken Anlamı
list_name Otomatik arama liste adı, maksimum 50 karakter olabilir. Zorunlu parametre
list_prefix Otomatik arama liste ön eki, otomatik aramanın dahilinize bağlandığında numaranın önünde görünecek kısa koddur. Maksimum 4 haneli olabilir. Zorunlu parametre
liste_type 1 değeri bitirmeli sabit liste, 2 değeri devamlı dinamik listeyi ifade eder. Zorunlu parametre
list_startdate Otomatik aramanın yapılacağı başlangıç tarihi (YYYY-MM-DD) Zorunlu parametre
list_stopdate Otomatik aramanın yapılacağı bitiş tarihi (YYYY-MM-DD) Zorunlu parametre
list_starttime Otomatik aramanın belirlenen günler arasında, her gün için kaçta başlayacağı. (HH:MM) Zorunlu parametre
list_stoptime Otomatik aramanın belirlenen günler arasında, her gün için kaçta biteceği. (HH:MM) Zorunlu parametre
retry_count Bir numaraya başlatılan otomatik aramanın başarısız olması durumunda kaç kere tekrar deneneceğidir. Arama başarılı olduktan sonra kalan tekrarlarda aranmaz. Aramanın başarılı olması çağrının açılması demektir. En fazla 3 kez tekrar edebilir. Zorunlu parametre
try_time Bir numaraya başlatılan Otomatik aramanın başarısız olması durumunda tekrarlanan aramalar arasında minimum kaç dakika olacağı bilgisidir. Varsayılan olarak 60 dakika, maksimum 1440 dk, minimum 0 dk.) Zorunlu parametre
department Otomatik aramadan sorumlu departmanın adıdır. Bu departmandaki boş dahili sayısınca arama başlatılacaktır. Zorunlu parametre
trunk Otomatik aramanın hangi giden hattınızdan yapılacağı bilgisidir. Zorunlu parametre
destination_type Alabileceği değerler : ivr,queue, announcement. Bir numaraya başlatılan otomatik aramanın başarılı olması durumunda santralin hangi hedefine gideceği bilgisidir. Zorunlu parametre
destination_name Bir numaraya başlatılan otomatik aramanın başarılı olması durumunda bağlanılacak hedefin adı. Zorunlu parametre
queue_limit_type Kuyruk Limit tipi default 1 tanımlı.
queue_limit Kuyrukta bekleyecek max. numara sayısı. Varsayılan olarak 1 değerini alır. *
url URL bilgisai göndermeniz halinde belirttiğiniz URLe otomatik arama durumuna ilişkin raporlama için veri POST edilir. Raporlama Servisinde detayını görebilirsiniz. Zorunlu parametre
groups Otomatik aramanın başlatılacağı Netgsm rehberinize ait grup isimleri. Array olarak gönderilir. Zorunlu olmayan parametre
numbers Otomatik aramanın başlatılacağı numaralar. Array olarak gönderilir. groups parametresi varsa, zorunlu olmayan parametre
number Otomatik aramanın başlatılacağı numaralarda numara bilgisi. 5xx....,312xxx.. formatında gönderiniz. numbers parametresi varsa, zorunlu parametre
callstop_type Otomatik arama görev durdurma limiti tipi.
callstop_limit Otomatik arama görev durdurma limiti değeri.
filter Ticari içerikli otomatik aramalarda kullanılır. Ticari içerikli bireysele başlatılacak aramalar için İYS kontrolünde "11" değerini, tacire başlatılacak aramalar için İYS kontrolünde "12" değerini almalıdır. null gönderildiği taktirde filtre uygulanmadan gönderilecektir.

queue_limit_type açıklamaları

Kod Anlamı
1 Sorumlu departmandaki boş temsilci + Kuyrukta bekleyecek numara sayısı : boş temsilci sayısı ve belirlediğiniz kuyrukta bekleyecek max. numara sayıları toplamı kadar arama başlatılır.
2 Sorumlu departmandaki boş temsilci X Kuyrukta bekleyecek numara sayısı : Boş temsilci başına başlatılacak numara sayısı verilebilir.
3 IVR araması: Aramalar bir IVR a yönlendirilecekse tercih edilebilir. Dakikada başlatılacak IVR arama sayısı verilebilir.

callstop_type açıklamaları

Kod Anlamı
0 Limit Yok.
1 Başarılı aramaya göre (adet)
2 Başarılı aramaya göre (yüzde)
3 Başarısız aramaya göre (adet)
4 Başarısız aramaya göre (yüzde)
5 Toplam aramaya göre (adet)
6 Toplam aramaya göre (yüzde)
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

Otomatik Arama Listele

Değişken Anlamı
list_id Ulaşmak istediğiniz otomatik arama listesinin ID bilgisi, bu parametreyi göndermediğinizde tüm listelerinizi görüntüleyebilirsiniz. Zorunlu olmayan parametre
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

Otomatik Arama Listesini Durdur/Başlat

Değişken Anlamı
list_id Durumunu güncelleyeceğiniz otomatik arama liste ID bilgisi Zorunlu parametre
status Durum bilgisi bu parametrede gönderilir. 1: listeyi aktifleştirmek için , 2: listeyi pasifleştirmek için gönderilir. zorunlu parametre
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

Otomatik Arama Raporlama

Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

WebHook ile Raporlama

Bu yöntemi tercih ediyorsanız otomatik arama listesi oluştur eventında url paramretresini de POST etmeniz zorunludur. Parametrede göndereceğiniz URL bilgisine JSON tipinde POST edilecektir.

Değişken Anlamı
JobID Başlattığınız göreve ait ID.
crm_id Çağrıya ait otomatik arama IDsi
called Arama yapılacak numara bilgisi
redirect_menu Yönlendirilen menü ismi
trunk Aramanın çıktığı santral bilgisi
prefix Aramada kullanılan Ön ek
callerid Kişi abone rehberinde kayıtlıysa aradığında görünen isim bilgisi
unique_id Yapılmış aramaya ait CDR ID
status Mesaj durum bilgisi "success" ya da "error" dönmektedir
message Mesaj açıklamaları bu parametrede döner.
laravelde gelen json datayı aşağıdaki örneklerdeki gibi parçalayabilirsiniz.
symfonyde gelen json datayı aşağıdaki örneklerdeki gibi parçalayabilirsiniz.

Webhook Santral Dinleme

Parametre Anlamı
pbx_num Santralinizin Netgsm ara yüzünde görünen adıdır.
unique_id Çağrıya ait ID bilgisidir.
internal_num Çağrının başlatılıdğı iç dahilinin numarasıdır.
customer_num Gelen veya giden aramalardaki dış numara bilgisidir..
scenario Dinlenmek istenen çağrının durumudur.
Context Çağrının hangi aşamasında (contexinde) tuşlamaya basıldığı bilgisidir.
context_name Çağrının düştüğü contextin adıdır.
Digit Yapılmış olan tuşlama bilgisidir.
type Çağrının düştüğü contextin tipidir.
queue_name Çağrının düştüğü kuyruğun adıdır.
talktime Kaç saniye konuşulduğu bilgisini tutar.
holdtime Çağrı kuyruktan geldiyse arayan abonenin kuyrukta kaç saniye bekleyip çağrı karşıladığı bilgisini tutar.(Scenario : Hangup)
holdtime Çağrı kuyrukta kaç saniye bekledikten sonra cevaplandığı bilgisini tutar. (Scenario : Answer)
incoming_number Santralinizde kayıtlı olan müşterinin aradığı numara bilgisidir.
timestamp Milisaniye cinsinden Unix timestamp.
laravelde gelen json datayı aşağıdaki örneklerdeki gibi parçalayabilirsiniz.
symfonyde gelen json datayı aşağıdaki örneklerdeki gibi parçalayabilirsiniz.

Listeye Numara Ekle

Değişken Anlamı
list_id Otomatik arama liste ID bilgisi Zorunlu parametre
name Listenize eklenecek numara için ad - soyad bilgisi. zorunlu parametre
nstatus Eklenecek numaranın durumunu ifade eder, 0 değeri gönderdiğinizde numaranın aranması pasif duruma geçer, 1 ile numaranın aranma durumunu aktif edebilrisiniz.
calltime Numaranın aranacağı zamanı ileri tarih olarak belirleyebilirsiniz, numara formatı ddMMYYHHmm (Örneğin 05.09.2020 15:00 için 050920201500)
trunk Aramanın yapılacağı dış numara seçilebilir.

Dinamik devam eden ya da durdurulmuş listenize numara ekleyebilirsiniz.

Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

Listeden Numara Çıkar

Değişken Anlamı
id Listeden çıkarılacak numara IDsi gönderilir. Numaraya ait ID bilgisini numara eklediğinizde ya da raporlama yaptığınızda alabilirsiniz. zorunlu parametre

Numara Durum Güncelle

Listenizde bulunan bir numaranın aranma durumu, aranma tarihi, numaraya ait isim ya da numaranın aranacağı dış numara (trunk) bilgisi güncellenebilir.

Değişken Anlamı
list_id Otomatik arama liste ID bilgisi Zorunlu parametre
name Listenize eklenecek numara için ad - soyad bilgisi. zorunlu parametre
nstatus Eklenecek numaranın durumunu ifade eder, 0 değeri gönderdiğinizde numaranın aranması pasif duruma geçer, 1 ile numaranın aranma durumunu aktif edebilrisiniz.
calltime Numaranın aranacağı zamanı ileri tarih olarak belirleyebilirsiniz, numara formatı ddMMYYHHmm (Örneğin 05.09.2020 15:00 için 050920201500)
trunk Aramanın yapılacağı dış numara seçilebilir.

Görüşme Detay (CDR)

Netsantralinizdeki görüşme kayıtlarına (CDRlarınıza) bu servisten ulaşabilirsiniz.
Görüşme kayıtlarınızı, belirteceğiniz zaman aralığına göre, çağrıya ait uniqueid bilgisi ile, arayan - aranan numaraya göre sorgulayabilirsiniz.
Çağrı detayı ve ses kaydı linkine ulaşabilirsiniz, ses kaydı linki CDR detayını santral çağrı trafiği de izleyerek alabilirsiniz, cdr scenario bilgisi ile tarafınıza bildirilir.

Parametre Anlamı
startdate İki tarih arası sorgulamanızda başlangıç tarihi (ddMMyyyyHHmm)
stopdate İki tarih arası sorgulamanızda bitiş tarihi(ddMMyyyyHHmm)
uniqueid uniqueid bilgisi ile sorgulama yapabilirsiniz.(1234567890.123459)
querytype Aranan ya da arayan numara ile yapılan sorgulamalarda kullanmalısınız. 1 değeri aranan numara bilgisini, 2 değeri arayan numara bilgisini ifade eder.
no Aranan ya da arayan numara ile yapılan sorgulamalarda numara bilgisini ifade eder.

uniqueid ile cdr sorgulama

querytype ile cdr sorgulama

Tarih aralığı ile cdr sorgulama

Başarılı istek örnek sonuç
Başarısız istek örnek sonuç
SERVİSTEN GELEN CEVAP
Parametre Anlamı
uniqueid Çağrıya ait ID
values Çağrıya ait değerler, array şeklinde döner.
destination Aranan
source Arayan
duration Süre
direction Yön
recording Ses kaydı, varsa bu parametre döner.
line Santrale gelen yada giden çağrının hangi trunk üzerinden çıkış yaptığı bilgisidir.
directory Görüşme detayında yer alan rehber (ön ek bilgisi) bilgisi içerir.
YÖN AÇIKLAMALARI
Kod Anlamı
0 Giden Arama
1 Gelen Arama
2 Gelen Cevapsız Arama
3 Giden Cevapsız Arama
4 İç Arama
5 İç Cevapsız Arama

İstatistik(Gelen Çağrı)

Gelen çağrılarınızdan oluşan tarih bazlı istatistiğe bu servisle ulaşabilirsiniz.

Kod Anlamı
date İstatistik alınan gün bilgisi
incoming_call Gelen çağrı sayısı
answered Cevaplanan çağrı sayısı
noanswer Cevapsız çağrı sayısı
abandoned Terkedilmiş çağrı sayısı
t_calltime Toplam konuşma süresi (sn)
t_waittime Toplam Bekleme süresi (sn)
max_waiting Maksimum Bekleme süresi (sn)
avr_waiting Ortalama bekleme süresi (sn)
avr_answered Ortalama Konuşma süresi (sn)
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

Gün Detayı

Terkedilmiş, cevapsız, cevaplanan çağrı bilgisine ulaşılabilir.

Başarılı istek örnek sonuç
Başarısız istek örnek sonuç

All versions of netsantral with dependencies

PHP Build Version
Package Version
Requires php Version >=7.2.5
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package netgsm/netsantral contains the following files

Loading the files please wait ....