Retarus SMS (Önizleme)
Retarus SMS bağlayıcısı, kuruluşların Microsoft iş akışlarından kısa mesajları otomatikleştirmesini ve güvenilir bir şekilde teslim etmelerini sağlar. SMS işleri göndermek, iş durumunu sorgulamak, alıcı başına teslim sonuçlarını almak ve API sürümü ayrıntılarını almak için bu bilgileri kullanın. Etkin bir Retarus hesabı ve geçerli API kimlik bilgileri gereklidir. Bu hizmet veya diğer SMS hizmetlerimiz için bir test hesabı almak için lütfen Retarus ile iletişime geçin.
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 | |
|---|---|
| İsim | Retarus |
| URL | https://www.retarus.com/ |
| E-posta | info@retarus.com |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | retarus GmbH |
| Web sitesi | https://www.retarus.com/ |
| Gizlilik ilkesi | https://www.retarus.com/data-privacy-policy/ |
| Kategoriler | İletişim; Pazarlama |
Retarus SMS
Retarus SMS bağlayıcısı, kuruluşların kısa mesaj göndermeyi otomatikleştirmesine ve teslim durumlarını izlemesine olanak tanır.
Büyük ölçekli SMS teslimi gerektiren iş iş akışları için güvenli ve güvenilir iletişim özellikleri sağlar. İleti göndermek, işlerin durumunu denetlemek, alıcı başına teslim sonuçlarını almak ve API'nin sürüm bilgilerine erişmek için bağlayıcıyı kullanabilirsiniz.
Önkoşullar
Geçerli API kimlik bilgilerine sahip bir Retarus SMS hesabı. Yönetici ayrıcalıklarına sahip bir Azure hesabı ve aboneliği. Desteklenen İşlemler Bağlayıcı aşağıdaki işlemleri destekler:
- SMS işi gönderme: Bir veya daha fazla alıcıya bir veya daha fazla SMS iletisi gönderin.
- İş durumunu alma: Daha önce gönderilen bir işin durumunu ve SMS kimliklerini alın.
- Verilen ölçütler için tüm işleri alma: Zaman aralığına veya diğer ölçütlere göre filtrelenmiş iş kimliklerinin listesini alın.
- İşin tüm alıcılarının durumunu alma: Belirli bir SMS işinde her alıcı için teslim sonuçlarını alma.
- Sürüm bilgilerini alın: Retarus SMS API'sinin geçerli sürüm bilgilerini alın.
Dağıtım Yönergeleri
Bu bağlayıcıyı kullanmak için:
- özel bağlayıcı olarak ortamınızda yapılandırın.
- Retarus hesabınızla ilişkili geçerli Retarus API kimlik bilgilerini sağlayın.
- API tarafından kullanıma sunulan SMS işlerini ve sorgu işi bilgilerini gönderebilmeniz için hesabınızın Sms-for-Applications için sağlandığından emin olun.
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 |
|---|---|---|---|
| kullanıcı adı | securestring | Bu API'nin kullanıcı adı | Doğru |
| şifre | 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
| İş durumunu alma |
Bu işlem, işin durumunu ve işin SMS kimliklerinin listesini alır. bir işteki tüm iletilerin tek tek ileti durumunu almak için, karşılık gelen jobId parametresiyle SMS uç noktasını kullanın. |
| İşin tüm alıcılarının durumunu alma |
Bu işlem, belirli bir işin tüm alıcıları için tek tek ileti durumunu alır. |
| SMS işi gönderme |
Bu işlem, her biri bir veya daha fazla alıcı içeren bir veya daha fazla SMS iletisi gönderir. Yanıt, yeni SMS işinin iş kimliğini (jobId) içerir. |
| Sürüm bilgilerini alma |
Bu işlem API için geçerli sürüm bilgilerini alır. |
| Verilen ölçütler için tüm işleri alma |
Bu işlem, belirli bir süre için iş kimliklerinin listesini ve isteğe bağlı filtreleri alır. |
İş durumunu alma
Bu işlem, işin durumunu ve işin SMS kimliklerinin listesini alır. bir işteki tüm iletilerin tek tek ileti durumunu almak için, karşılık gelen jobId parametresiyle SMS uç noktasını kullanın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
İş Kimliği
|
jobId | True | string |
Retarus iş kimliği. |
Döndürülenler
- Body
- JobReport
İşin tüm alıcılarının durumunu alma
Bu işlem, belirli bir işin tüm alıcıları için tek tek ileti durumunu alır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
İş Kimliği
|
jobId | True | string |
Retarus iş kimliği. |
Döndürülenler
- response
- array of RecipientReport
SMS işi gönderme
Bu işlem, her biri bir veya daha fazla alıcı içeren bir veya daha fazla SMS iletisi gönderir. Yanıt, yeni SMS işinin iş kimliğini (jobId) içerir.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Src
|
src | string |
Alıcıya gösterilen Gönderen Kimliği. |
|
|
encoding
|
encoding | string | ||
|
fatura kodu
|
billcode | string |
Max. 70 karakter. |
|
|
statusRequested
|
statusRequested | boolean |
Teslim bildirimi istendi. |
|
|
flaş
|
flash | boolean | ||
|
customerRef
|
customerRef | string |
Önerilen en fazla 64 karakter. |
|
|
validityMin
|
validityMin | integer |
DAKIKA cinsinden SMS'in geçerliliği. 0 olduğunda sağlayıcının varsayılan değeri kullanılır. Aksi takdirde, değerler 5 ile 2880 dakika arasında olmalıdır. |
|
|
maxParts
|
maxParts | integer |
Çok parçalı iletide izin verilen en fazla bölüm sayısı. Değerler 1 ile 20 arasında olmalıdır. Daha uzun iletiler kesilir. |
|
|
invalidCharacters
|
invalidCharacters | string |
SMS'de geçersiz karakterlerin nasıl işleneceğini tanımlayın. |
|
|
qos
|
qos | string |
Hizmet Kalitesi. |
|
|
jobPeriod
|
jobPeriod | date-time |
SMS İşi'ni (iso-8601) işlemeye ne zaman başlayacağınızı zamanlamak için zaman damgası. |
|
|
duplicateDetection
|
duplicateDetection | boolean | ||
|
blackoutPeriods
|
blackoutPeriods | array of string | ||
|
Başka bir metin sağlanmadığı için, verilen metne dayalı bir çeviri yapmam mümkün değil. Lütfen çevirilecek metni belirtin.
|
text | True | string |
Foo |
|
Dst
|
dst | True | string | |
|
customerRef
|
customerRef | string |
Önerilen en fazla 64 karakter. Varsayılan olarak kullanılan alıcı cep telefonu numarası. |
|
|
blackoutPeriods
|
blackoutPeriods | array of string |
Döndürülenler
- Body
- JobResponse
Sürüm bilgilerini alma
Verilen ölçütler için tüm işleri alma
Bu işlem, belirli bir süre için iş kimliklerinin listesini ve isteğe bağlı filtreleri alır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Yalnızca iş kimliklerini döndürme
|
jobIdsOnly | True | boolean |
Yalnızca iş kimliklerini döndürür. Şu anda yalnızca 'true' desteklenmektedir. |
|
Zaman damgasından
|
fromTs | date-time |
Zaman damgasından (ISO-8601). fromT'ler ve toT'lar arasındaki aralık en fazla 30 gün olabilir. |
|
|
Zaman damgasına
|
toTs | date-time |
To timestamp (ISO-8601). fromT'ler ve toT'lar arasındaki aralık en fazla 30 gün olabilir. |
|
|
Yalnızca açık işleri iade
|
open | boolean |
Yalnızca açık işleri döndürür. |
|
|
Ofset baskı
|
offset | integer |
Sayfalandırma için kullanılan parametre. Uzaklık değeriyle başlayan kayıtların bir alt kümesini alın. |
|
|
En fazla sonuç döndürüldü
|
limit | integer |
Döndürülen sonuç sayısını sınırlayın. Değer 0 ile 1000 arasında olmalıdır. |
Döndürülenler
- response
- array of JobReport
Tanımlar
JobResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
jobId
|
jobId | string |
JobReport
| Name | Yol | Tür | Description |
|---|---|---|---|
|
jobId
|
jobId | string | |
|
Src
|
src | string |
Gönderen Kimliği. |
|
encoding
|
encoding | string | |
|
fatura kodu
|
billcode | string | |
|
statusRequested
|
statusRequested | boolean |
Teslim bildirimi istendi. |
|
flaş
|
flash | boolean | |
|
validityMin
|
validityMin | integer |
DAKIKA cinsinden SMS'in geçerliliği. |
|
customerRef
|
customerRef | string |
Önerilen en fazla 64 karakter. |
|
qos
|
qos | string |
Hizmet Kalitesi. |
|
receiptTs
|
receiptTs | date-time |
İşin Retarus tarafından ne zaman alındığını gösteren zaman damgası (iso-8601). |
|
finishedT'ler
|
finishedTs | date-time |
SMS'nin son durumunu (iso-8601) ne zaman aldığını gösteren zaman damgası. |
|
recipientIds
|
recipientIds | array of string |
RecipientReport
| Name | Yol | Tür | Description |
|---|---|---|---|
|
smsId
|
smsId | string | |
|
Dst
|
dst | string |
Alıcının cep telefonu numarası. |
|
processStatus
|
processStatus | string |
Geçerli işlem durumu (bkz. SMS Giden Durum Kodları). |
|
statü
|
status | string |
Durum (bkz. SMS Giden Durum Kodları). |
|
customerRef
|
customerRef | string |
Önerilen en fazla 64 karakter. |
|
sebep
|
reason | string | |
|
sentT'ler
|
sentTs | date-time |
SMS'in gönderildiği zaman damgası (iso-8601). |
|
finishedT'ler
|
finishedTs | date-time |
SMS'nin son durumunu (iso-8601) ne zaman aldığını gösteren zaman damgası. |
VersionInfoResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
buildNumber (yapı)
|
buildNumber | integer | |
|
buildTimestamp
|
buildTimestamp | string | |
|
majör versiyon
|
majorVersion | integer | |
|
minorVersion
|
minorVersion | integer | |
|
versionInfo
|
versionInfo | string | |
|
message
|
message | string |