Nexmo
Vonage API Platformu Nexmo, SMS, Voice ve Chat gibi uygulamalarınız bağlamında iletişim eklemenize olanak tanır. Nexmo hesabına buradan kaydolun - https://www.nexmo.com/
Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:
| Hizmet | Class | Bölgeler |
|---|---|---|
| Copilot Studio | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Logic Apps | Standart | Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Kamu bölgeleri - Azure Çin bölgeleri - ABD Savunma Bakanlığı (DoD) |
| Power Apps | Premium | Aşağıdakiler dışında tüm Power Apps bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Power Automate | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Microsoft |
Bağlantı oluşturma
Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
| Varsayılan | Bağlantı oluşturmak için parametreler. | Tüm bölgeler | Paylaşılamaz |
Temerrüt
Geçerli: Tüm bölgeler
Bağlantı oluşturmak için parametreler.
Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.
| İsim | Türü | Description | Gerekli |
|---|---|---|---|
| API Anahtarı | String | API Anahtarı | Doğru |
| API Gizli Dizisi | securestring | API Gizli Dizisi | Doğru |
Azaltma Sınırları
| Name | Çağrılar | Yenileme Dönemi |
|---|---|---|
| Bağlantı başına API çağrıları | 100 | 60 saniye |
Eylemler
| Gelen numaraları listeleme |
Bu işlem, belirli bir ülke için aranabilen tüm gelen numaraları almak için kullanılır. |
| Kimliğine göre uygulama alma |
Bu işlem, kimliğine göre tek bir uygulama hakkındaki bilgileri almak için kullanılır. |
| Konuşma dosyası gönderme |
Bu işlem, bir telefon numarasına sentezlenmiş bir konuşma veya kaydedilmiş ses dosyası göndermek için kullanılır. |
| Sahip olunan numaraları listeleme |
Bu işlem hesabınızla ilişkili tüm sayıları alır. |
| SMS gönderme |
Bu işlem SMS göndermek için kullanılır. |
| Uygulamaları listeleme |
Hesabınızla ilişkili tüm uygulamaların listesini alır. |
| Uygulamayı güncelleştirme |
Bu işlem, hesabınızdaki mevcut bir uygulamayı değiştirmek için kullanılır. |
| Uygulamayı silme |
Bu işlem, hesabınızdaki mevcut bir uygulamayı silmek için kullanılır. |
| Yeni uygulama oluşturma |
Bu işlem, hesabınızda yeni bir uygulama oluşturmak için kullanılır. |
Gelen numaraları listeleme
Bu işlem, belirli bir ülke için aranabilen tüm gelen numaraları almak için kullanılır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Country
|
country | True | string |
ISO 3166-1 alfa-2 biçiminde kod. |
|
Arama Düzeni
|
Search Pattern | string |
Bir desen seçin. |
|
|
Desen
|
pattern | number |
Aranacak sayı düzeni. |
|
|
Kullanılabilir Özellikler
|
features | string |
SMS veya VOICE |
|
|
Sonuç Sayısı
|
size | number |
Varsayılan 10. |
|
|
Sayfa Dizini
|
index | number |
Yanıttaki dizin. |
Döndürülenler
- Body
- ListNumbersResponse
Kimliğine göre uygulama alma
Bu işlem, kimliğine göre tek bir uygulama hakkındaki bilgileri almak için kullanılır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Uygulama Kimliği
|
application_id | True | string |
Uygulamanın benzersiz tanımlayıcısı. |
Döndürülenler
- Body
- applicationResponse
Konuşma dosyası gönderme
Bu işlem, bir telefon numarasına sentezlenmiş bir konuşma veya kaydedilmiş ses dosyası göndermek için kullanılır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Telefon Numarasına
|
to | True | string |
Uluslararası biçim E.164. |
|
Telefon Numarasından
|
from | string |
Ses özellikli Nexmo numarası. |
|
|
Message
|
text | True | string |
Konuşma metni. |
|
Language
|
lg | string |
İletiyi sentezlemek için. |
|
|
Gender
|
voice | string |
Erkek ya da kadın. |
|
|
Yineleme Sayısı
|
repeat | number |
En fazla 10 kez. |
|
|
Makine Algılamaya İzin Ver
|
machine_detection | string |
Doğru veya kapatma. |
|
|
Makine Zaman Aşımı
|
machine_timeout | number |
400ms ile 10000ms. |
|
|
Geri arama URL'si
|
callback | url |
Geri çağırma url'si. |
|
|
Geri Çağırma Yöntemi
|
callback_method | string |
GET veya POST. |
Döndürülenler
- Body
- ttsResponse
Sahip olunan numaraları listeleme
Bu işlem hesabınızla ilişkili tüm sayıları alır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Arama Düzeni
|
Search Pattern | string |
Bir desen seçin. |
|
|
Sayfa Dizini
|
index | number |
Yanıttaki dizin. |
|
|
Sonuç Sayısı
|
size | number |
Varsayılan 10 En Fazla 100. |
|
|
Desen
|
pattern | number |
Aranacak sayı düzeni. |
Döndürülenler
- Body
- ListNumbersResponse
SMS gönderme
Bu işlem SMS göndermek için kullanılır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Gönderen Kimliği
|
from | True | string |
Alfasayısal dize. |
|
Telefon Numarasına
|
to | True | string |
Uluslararası biçim E.164. |
|
Metin
|
text | True | string |
SMS gövdesi. |
|
Türü
|
type | string |
Varsayılan olarak metindir. |
|
|
Teslim Alındı Bilgileri
|
status-report-req | number |
Etkinleştirmek için 1 olarak ayarlayın. |
|
|
İstemci Başvurusu
|
client-ref | string |
İç raporlama için. |
|
|
Kartvizit
|
vcard | string |
vCard biçimi. |
|
|
Takvim Etkinliği
|
vcal | string |
vCal biçimi. |
|
|
SMS'in kullanım ömrü
|
ttl | number |
Milisaniye cinsinden. |
|
|
Geri arama URL'si
|
callback | url |
Teslim alındı bilgisi uç noktası. |
|
|
İleti Sınıfı
|
message-class | number |
Bir sınıf seçin. |
|
|
Kullanıcı Veri Üst Bilgisi
|
udh | string |
Onaltılık kodlanmış UDH. |
|
|
Daha Yüksek Düzeyli Protokol
|
protocol-id | string |
Protokol kimliği. |
|
|
Gövde (Tür ikiliyse.)
|
body | string |
Onaltılık kodlanmış ikili veriler. |
|
|
Başlık
|
title | string |
Tür wappush ise. |
|
|
Bağlantı
|
url | url |
Web Sitesi Url'si (Tür wappush ise.). |
|
|
Kullanılabilirlik (Tür wappush ise.)
|
validity | string |
Milisaniye cinsinden. |
Döndürülenler
- Body
- smsResponse
Uygulamaları listeleme
Hesabınızla ilişkili tüm uygulamaların listesini alır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Sonuç Sayısı
|
page_size | number |
Her çağrıda döndürülen öğeler (Varsayılan 10). |
|
|
Sayfa Dizini
|
page_index | number |
İlk sayfadan uzaklık (Varsayılan 0). |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
applications
|
_embedded.applications | array of applicationResponse |
Uygulamayı güncelleştirme
Bu işlem, hesabınızdaki mevcut bir uygulamayı değiştirmek için kullanılır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Uygulama Kimliği
|
application_id | True | string |
Uygulamanın benzersiz tanımlayıcısı. |
|
İsim
|
name | True | string |
Uygulamanın adı. |
|
Türü
|
type | True | string |
Uygulama türü. |
|
Yanıt Url'si
|
answer_url | True | string |
Web kancanızın Nexmo Çağrı Denetimi Nesnesi'ni teslim ettiği yer. |
|
Olay Url'si
|
event_url | True | string |
Başlatıldı, çaldırma veya tamamlandı |
|
Answer Yöntemi
|
answer_method | string |
HTTP yöntemi (Varsayılan GET). |
|
|
Olay Yöntemi
|
event_method | string |
HTTP yöntemi (Varsayılan POST). |
Döndürülenler
- Body
- applicationResponse
Uygulamayı silme
Bu işlem, hesabınızdaki mevcut bir uygulamayı silmek için kullanılır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Uygulama Kimliği
|
application_id | True | string |
Uygulamanın benzersiz tanımlayıcısı. |
Döndürülenler
- Body
- common
Yeni uygulama oluşturma
Bu işlem, hesabınızda yeni bir uygulama oluşturmak için kullanılır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
İsim
|
name | True | string |
Uygulamanın adı. |
|
Türü
|
type | True | string |
Uygulama türü. |
|
Yanıt Url'si
|
answer_url | True | string |
Web kancanızın Nexmo Çağrı Denetimi Nesnesi'ni teslim ettiği yer. |
|
Olay Url'si
|
event_url | True | string |
Başlatıldı, çaldırma veya tamamlandı |
|
Answer Yöntemi
|
answer_method | string |
HTTP yöntemi (Varsayılan GET). |
|
|
Olay Yöntemi
|
event_method | string |
HTTP yöntemi (Varsayılan POST). |
Döndürülenler
- Body
- applicationResponse
Tanımlar
smsResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
İleti Sayısı
|
message-count | string |
İletinin bölündüğü bölüm sayısı. |
|
İleti Dizisi
|
messages | array of object |
Her ileti bölümünü içerir. |
|
Statü
|
messages.status | string |
SMS gönderme işleminin nasıl işlenmekte olduğunu gösterir. |
|
İleti Kimliği
|
messages.message-id | string |
Gönderilen SMS'in kimliği (8 - 16 karakter). |
|
Telefon Numarasına
|
messages.to | string |
İsteğinizin gönderildiği numara. |
|
İstemci Başvurusu
|
messages.client-ref | string |
İstekte ayarladığınız istemci başvurusu. |
|
Kalan Bakiye
|
messages.remaining-balance | string |
Hesabınızdaki bakiye. Değer EUR cinsindendir. |
|
İleti Fiyatı
|
messages.message-price | string |
İsteğiniz için ücretlendirilen tutar. Değer EUR cinsindendir. |
|
Ağ
|
messages.network | string |
Kayıtlı taşıyıcı için Mobil Ülke Kodu Mobil Ağ Kodu (MCCMNC). |
|
Hata Metni
|
messages.error-text | string |
Bir hata oluştuysa bu, ne olduğunu açıklar. |
ListNumbersResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Sayı
|
count | integer |
Sonuç sayısı. |
|
Sayılar Dizisi
|
numbers | array of object |
Tüm sayıların listesi. |
|
Maliyet
|
numbers.cost | string |
Sayı maliyeti. |
|
Country
|
numbers.country | string |
ISO 3166-1 alfa-2 biçimi. |
|
Gelen Numarası
|
numbers.msisdn | string |
Gelen sanal numarası. |
|
Türü
|
numbers.type | string |
Sayı türü. |
ttsResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Arama Kimliği
|
call_id | string |
Bu çağrı için benzersiz alfasayısal 32 karakter kimliği. |
|
Telefon Numarasına
|
to | string |
TTS veya TTS İstemini gönderdiğiniz kullanıcının numarası. |
|
Statü
|
status | string |
Bu TTS veya TTS istemi için yanıt kodu. |
|
Hata Metni
|
error_text | string |
Bir hata oluştuysa bu, ne olduğunu açıklar. |
applicationResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Kimlik
|
id | string |
Nexmo uygulama kimliği. |
|
İsim
|
name | string |
Uygulama adı. |
|
Keys
|
keys.public_key | string |
bir https://en.wikipedia.org/wiki/JSON_Web_Tokeniçindeki jwt'yi doğrulamak için kullanılan ortak anahtar. |
meydan
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Yanıt
|
type | string |
okunabilir bir mesaj. |
|
Hata Metni
|
error_title | string |
Başarısız olursa hatanın başlığı döndürülür. |