Plivo (Önizleme)
Plivo, her büyüklükteki işletmeler için küresel olarak SMS ve sesli arama göndermeyi ve almayı sağlar.
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) |
| İletişim | |
|---|---|
| URL | https://support.plivo.com/support/home |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Plivo Inc |
| Web sitesi | https://www.plivo.com/ |
| Gizlilik ilkesi | https://www.plivo.com/legal/privacy/ |
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 |
|---|---|---|---|
| Kimlik Doğrulaması | String | Bu API'nin kullanıcı adı. | Doğru |
| Kimlik Doğrulama Belirteci | securestring | Bu api'nin parolası. | 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
| Arama yap |
Bu işlem çağrı yapmak için kullanılır. |
| İleti al |
Bu işlem, ileti kimliğine göre bir iletinin ayrıntılarını getirmek için kullanılır. |
| SMS gönder |
Bu işlem, kısa mesaj göndermek için kullanılır. |
| Tüm iletileri listeleme |
Bu işlem, Plivo hesabınızla ilişkili tüm iletilerin listesini döndürür. |
Arama yap
Bu işlem çağrı yapmak için kullanılır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Kaynak
|
from | True | string |
Arama yapmak için kullanılacak Plivo numarası. |
|
İçin
|
to | True | string |
Aranacak telefon numarası. |
|
Yanıt URL'si
|
answer_url | True | string |
Çağrı yapıldığında çağrılacak URL. |
|
Answer Yöntemi
|
answer_method | string |
Yanıt URL'sini çağırmak için kullanılması gereken HTTP Yöntemi (GET/POST). |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
API Kimliği
|
api_id | string |
API isteğinin benzersiz kimliği. |
|
Yanıt
|
message | string |
Çağrı yapıldığında yanıt alındı. |
|
UUID çağrısı
|
request_uuid | string |
Aramanın benzersiz kimliği. |
İleti al
Bu işlem, ileti kimliğine göre bir iletinin ayrıntılarını getirmek için kullanılır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
İleti UUID
|
message_uuid | True | string |
Ayrıntıların alınması gereken iletinin UUID değeri. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
API Kimliği
|
api_id | string |
API isteğinin benzersiz kimliği. |
|
Hata Kodu
|
error_code | string |
İleti teslim edilmemişse teslim hata kodu. |
|
Kaynak
|
from_number | string |
İletinin gönderildiği numara. |
|
İleti Yönü
|
message_direction | string |
İletinin yönü (gelen/giden). |
|
İleti Teslim Durumu
|
message_state | string |
İletinin durumu (kuyruğa alındı/gönderildi/teslim edildi/başarısız). |
|
Zaman Damgası
|
message_time | string |
İletinin gönderildiği veya alındığı zaman damgası (yyyy-MM-dd HH:mm:ss UTC). |
|
İleti Türü
|
message_type | string |
İletinin türü. |
|
İleti UUID
|
message_uuid | string |
İletinin benzersiz kimliği. |
|
İleti URI'si
|
resource_uri | string |
Bu tek iletinin ayrıntılarını almak için URI. |
|
İçin
|
to_number | string |
İletinin gönderildiği numara. |
|
Toplam Tutar
|
total_amount | string |
İleti için ücretlendirilen tutar. |
|
Ücret
|
total_rate | string |
İletinin birim başına oranı. |
|
Units
|
units | integer |
İletinin bölündüğü birim sayısı. |
SMS gönder
Bu işlem, kısa mesaj göndermek için kullanılır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Kaynak
|
src | True | string |
İletinin gönderileceği Plivo numarası. |
|
İçin
|
dst | True | string |
İletinin gönderileceği telefon numarası. |
|
Message
|
text | True | string |
Gönderilecek iletinin metni. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
API Kimliği
|
api_id | string |
API isteğinin benzersiz kimliği. |
|
Yanıt
|
message | string |
Gönderilen iletinin yanıtı. |
|
İleti UUID
|
message_uuid | array of string |
İletinin benzersiz kimliği. |
Tüm iletileri listeleme
Bu işlem, Plivo hesabınızla ilişkili tüm iletilerin listesini döndürür.
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
API Kimliği
|
api_id | string |
API isteğinin benzersiz kimliği. |
|
Sınır
|
meta.limit | integer |
Tek bir sayfadaki en fazla ileti sayısı. |
|
Next
|
meta.next | string |
Varsa iletilerin sonraki sayfasının URI'sini seçin. |
|
Ofset baskı
|
meta.offset | integer |
Bu sayfadan önceki ileti sayısı. |
|
Önceki
|
meta.previous | string |
Önceki sayfanın URI'sini seçin. |
|
Toplam Sayı
|
meta.total_count | integer |
Toplam ileti sayısı. |
|
İleti Listesi
|
objects | array of object |
Tüm iletilerin ayrıntıları. |
|
Hata Kodu
|
objects.error_code | string |
İleti teslim edilmemişse teslim hata kodu. |
|
Kaynak
|
objects.from_number | string |
İletinin gönderildiği numara. |
|
İleti Yönü
|
objects.message_direction | string |
İletinin yönü (gelen/giden). |
|
İleti Teslim Durumu
|
objects.message_state | string |
İletinin durumu (kuyruğa alındı/gönderildi/teslim edildi/başarısız). |
|
Zaman Damgası
|
objects.message_time | string |
İletinin gönderildiği veya alındığı zaman damgası (yyyy-MM-dd HH:mm:ss UTC). |
|
İleti Türü
|
objects.message_type | string |
İletinin türü. |
|
İleti UUID
|
objects.message_uuid | string |
İletinin benzersiz kimliği. |
|
İleti URI'si
|
objects.resource_uri | string |
Bu tek iletinin ayrıntılarını almak için URI. |
|
İçin
|
objects.to_number | string |
İletinin gönderildiği numara. |
|
Toplam Tutar
|
objects.total_amount | string |
İleti için ücretlendirilen tutar. |
|
Ücret
|
objects.total_rate | string |
İletinin birim başına oranı. |
|
Units
|
objects.units | integer |
İletinin bölündüğü birim sayısı. |