Download the PHP package netgsm/voicemail without Composer
On this page you can find all versions of the php package netgsm/voicemail. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package voicemail
Laravel Netgsm Voice Mail Entegrasyonu
Netgsm sesli mesaj paket aboneliği bulunan kullanıcılarımız için laravel paketidir.
İçindekiler
- İletişim & Destek
- Doküman
- Supported
- Kurulum
- Ses Dosyası Yükleme
- Ses Dosyası Listeleme
- Basit Sesli Mesaj Başlatma
- Dinamik Sesli Mesaj Başlatma
- Sesli Mesaj İptali
- Sesli Mesaj Raporlama
- Sesli Mesaj Webhook
İletişim & Destek
Netgsm API Servisi ile alakalı tüm sorularınızı ve önerilerinizi [email protected] adresine iletebilirsiniz.
Doküman
https://www.netgsm.com.tr/dokuman/ 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/dokuman adresinden ulaşabilirsiniz.
Supported Laravel Versions
Laravel 6.x, Laravel 7.x, Laravel 8.x, Laravel 9.x,
Supported Symfony Versions
Symfony 4.x, Symfony 5.x, Symfony 6.x
Supported Lumen Versions
Lumen 6.x, Lumen 7.x, Lumen 8.x, Lumen 9.x,
Supported Php Versions
PHP 7.2.5 ve üzeri
Kurulum
composer require netgsm/voicemail
.env dosyası içerisinde NETGSM ABONELİK bilgileriniz tanımlanması zorunludur.
NETGSM_USERCODE=""
NETGSM_PASSWORD=""
Ses Dosyası Yükleme
Sesli mesaj yapacağınız ses dosyasını bu fonksityon ile yükleyebilirsiniz.
Bir dakika içerisinde bir dosya gönderebilirsiniz.
Başarılı istek örnek
Başarısız istek örnek
Ses Dosyası Listeleme
Yüklediğiniz ses dosyalarını sorgulayarak bilgisine ulaşabilirsiniz.
Başarılı istek
Başarısız istek
Sesli Mesaj Başlatma
Sesli Mesaj API ile, sesli mesajlarınızı senaryonuza göre basit ya da dinamik şekilde başlatabilirsiniz. Sistemimize yüklü ses dosyanız ya da göndereceğiniz textin tarafımızda ses dosyasına dönüşümü ile Sesli Mesaj başlatabilirsiniz,
Ses dosyası yükleyebilir,
Gelen sesli Mesajları listeleyebilir,
Başlattığınız Sesli Mesajların durumlarını sorgulayarak Raporlama yapabilirsiniz.
Sesli mesaj senaryoları bir adet tuşlama yapacak şekilde gerçekleştirebilir.
Basit Sesli Mesaj Başlatma
Parametre | Anlamı |
---|---|
startdate | Gönderime başlayacağınız tarih. (ddMMyyyy) |
starttime | Mesajın gönderilmeye başlanacağı saat(ssdd) |
stopdate | İki tarih arası gönderimlerinizde bitiş tarihi.(ddMMyyyy) *Başlangıç ve bitiş tarihleri arasında en az 1 saat en fazla 21 saat olmalıdır. |
stoptime | Mesaj gönderimi bitiş saati(ssdd) |
key=1 | Ses kaydının sonunda tuşa basılmasını istiyorum. |
key=0 | Ses kaydının sonunda tuşa basılmasını istemiyorum. |
audioid | Gönderilmek istenen sesid, sisteme daha önce yüklemiş olmanız gerekir. |
baslangictext | Sesli arama gerçekleştiğinde dinletilecek metin |
baslangicaudioid | Sesli arama gerçekleştiğinde dinletilecek sesin idsi. |
keys | Mesajın gönderildiği telefon numarası |
$data['keyinfo'][0][tus] | tuşa basılığında anlamına gelir |
$data['keyinfo'][0][ses] | tuşa basılığında bu sesi dinlet anlamına gelir.Daha önceden yüklenmiş ses id si girilmelidir. |
$data['keyinfo'][0][text] | tuşa basılığında bu texti dinlet anlamına gelir |
filter | Ticari içerikli sesli mesaj gönderimlerinde bu parametreyi kullanabilirsiniz. Ticari içerikli bireysele gönderilecek numaralar için İYS kontrollü gönderimlerde ise "11" değerini, tacire gönderilecek İYS kontrollü gönderimlerde ise "12" değerini almalıdır. gönderilmediği taktirde İYS kontrolü uygulanmadan gönderilecektir. |
ringtime | Sesli mesaj için yapılan aramada telefoonun çalma süresi. (min 10 - max 30 sn) |
relationid | Tarafınızda belirleyeceğiniz bir random sayı ile sesli mesaj başlattığınızda, Raporlama servisini sorguladığınızda relationID bilgisi de dönecektir. |
Başarılı istek örnek
Başarısız istek örnek
Dinamik Sesli Mesaj Başlatma
Senaryonuza göre sırası belirlenmiş şekilde gönderdiğiniz yüklü ses dosyaları ya da textlerinizle sesli mesajınız başlatılır. 1:n mantığı ile bir sesli mesajı birden fazla numaraya başlatabilirsiniz.
Değişken | Anlamı |
---|---|
startdate |
Gönderime başlayacağınız tarih. (ddMMyyyy) |
starttime |
Mesajın gönderilmeye başlanacağı saat(ssdd) |
stopdate |
İki tarih arası gönderimlerinizde bitiş tarihi.(ddMMyyyy) *Başlangıç ve bitiş tarihleri arasında en az 1 saat en fazla 21 saat olmalıdır. |
stoptime |
Mesaj gönderimi bitiş saati(ssdd). |
key=1 |
Ses kaydının sonunda tuşa basılmasını istiyorum. |
key=0 |
Ses kaydının sonunda tuşa basılmasını istemiyorum. |
audioid |
Gönderilmek istenen sesid, sisteme daha önce yüklemiş olmanız gerekir. |
text |
Gönderilmek istenen metin |
no |
Mesajın gönderildiği telefon numarası |
keyinfo |
Tus bilgisi bu parametre ile gönderilir. Bu parametre sonrasında audioID ya da text bilgisi içeren parametre göndermeniz zorunludur. |
filter |
Ticari içerikli sesli mesaj gönderimlerinde bu parametreyi kullanabilirsiniz. Ticari içerikli bireysele gönderilecek numaralar için İYS kontrollü gönderimlerde ise "11" değerini, tacire gönderilecek İYS kontrollü gönderimlerde ise "12" değerini almalıdır. gönderilmediği taktirde İYS kontrolü uygulanmadan gönderilecektir. |
ringtime |
Sesli mesaj için yapılan aramada telefoonun çalma süresi. (min 10 - max 30 sn) |
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç
Sesli Mesaj İptali
İleri tarihe zamanlanmış sesli mesajlarınızı iptal edebilirsiniz.
bulkid :İptal edilmek istenen, sesli mesaj gönderimi yapılırken dönen görevid(bulkid) nizdir. İstek yapılırken gönderilmesi zorunludur.
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç
Sesli Mesaj ,Raporlama
HTTP Get yöntemini kullanarak; Sesli mesajlarınızı başlattıktan sonra tarafınıza dönen ID bilgisi bulkid ile göndereceğiniz ya da bastar- bittar parametreleri gibi sesli mesajlarınızı yaptığınız zaman aralığına göre sorgulayabilirsiniz.
Değişken | Anlamı |
---|---|
bulkid |
Api ile başarılı sesli mesaj gönderimlerinizde dönen görevid(bulkid) nizdir. |
type |
Sorgulama tipini belirlemek için kullanılır.0: Tek bulkid'ye göre sorgulama yapar. 1: Birden çok bulkid'ye göre sorgulama yapar. (Not: Bu durumda bulkid parametresi 43234, 53453, 54332, ....gibi yazılır.) 2: Tarih aralığında sorgu yapabilmek için kullanılır. (Not: Parametrenin bu değerinde bulkid parametresine girilen değer dikkate alınmaz.) |
bastar |
İki tarih arası sorgulamanızda başlangıç tarihi (ddMMyyyyHHmm) |
bittar |
İki tarih arası sorgulamanızda bitiş tarihi(ddMMyyyyHHmm) |
status |
Mesajınızın durumunu sorgulamak için kullanılır. Status parametesi için açıklamaları aşağıdaki tabloda bulabilirsiniz. |
tus |
Arama yapıldığında komut edilen tuş numarası. Tuşlanan rakam eğer 10 şeklinde gönderilirse hiç bir tuşa basmayanlar listelenir. |
Başarılı istek örnek sonuç
Başarısız istek örnek sonuç
Status Parametresi | Açıklamalar |
---|---|
0 |
Cevaplanmayı bekleyenler |
1 |
Cevaplananlar / Açan |
2 |
Cevaplanmayanlar |
3 |
Ulaşılamayan |
4 |
Ücretlendirelemeyen / Varlık Yetersiz |
5 |
Iptal Edilen |
6 |
Başarısız : başlatılamayan çağrılar, durdurulan, hata alanlar |
7 |
Meşgule Alınan |
8 |
Numara Geçersiz |
9 |
Süresi Doldu |
Sesli Mesaj Webhook
-
Başlattığınız Sesli mesajın durumunun (rapor olarak düşünebilirsiniz) belirleyeceğiniz bir URL'e post edilmesini isterseniz, bu yöntemi tercih edebilirsiniz.
-
Bu durumda Basit ya da Dinamik Sesli mesaj Oluşturma işleminde
url
paramretresini de POST etmeniz zorunludur.
Değişken | Anlamı |
---|---|
bulkid |
Başlatılan sesli mesaj görevID |
caller |
Arayanın numarası |
callee |
Arananın numarası |
state |
Çağrının gerçekleşme durumudur. ( 1: Cevaplananlar, 2: Cevaplanmayan, 3: Ulaşılamayan, 7: Meşgule Alınan ) |
type |
Sesli Mesajın tipi (1: Sadece belirlenmiş ses kaydı dinlet, 2: Belirlenmiş ses kaydını dinlet ve sonrasından ses kaydı al, 3: Belirlenmiş ses kaydını dinlet ve tuş bilgisi al, 4: Belirlenmiş ses kaydını dinlet ve tuş bilgisi al) |
name |
Arananın Adı Soyadı bilgisi |
creation_time |
İşin oluşturulma zamanı ( yyyy-MM-dd HH:mm:ss.SSS ) |
start_time |
Çağrının başlatılma zamanı ( yyyy-MM-dd HH:mm:ss.SSS ) |
answer_time |
Çağrının cevaplanma zamanı ( yyyy-MM-dd HH:mm:ss.SSS ) "Açan" durumu için |
hangup_time |
Cevaplanan çağrının kapanma zamanı ( yyyy-MM-dd HH:mm:ss.SSS ) "Açan" durumu için |
bilsec |
Görüşme süresi, "Açan" durumu için |
relationid |
İşleri gruplandırmak için kullanılan değer. |
detail |
Çağrılar hakkında tiplerine göre daha detaylı bilgi içeren objedir. |
push_button |
Tuşlamalı sesli mesajlarda tuşlama bilgisidir ( NULL: sesi dinleyip tuşlamaya kalmadan ayrılanlar, -1: Sesi dinleyip tuşlamaya kalıp belirlenen sürede tuşlama yapmayanlar type: 4 olanlar için type: 3 veya type: 4 olan işlerde |
survey_push_button_desc |
Anketlerde basılan tuşun açıklamasıdır.type = 3 olan işlerde |
survey_taskid |
Anketlerde basılan tuş için belirlenmiş görev(0: Görev atanmamış, 1: Çağrı kapansın, 2: İlk dinletilen ses kaydını tekrar dinlet, 3: Yeni bir ses kaydı dinlet, 4: Yeni ses kaydını dinlet sonrasında ses kaydını al). type =3 olan işlerde |
record_link |
Aranandan ses kaydı alındığı durumlarda ses kaydını indiren link type = 3 ve taskid = 4 olanlar veya type = 2 olanlar |