SmartDialog
SmartDialog, SMS ve WhatsApp iletileri gönderip almak için kullanılan bir platformdur. Çok çeşitli akıllı mesajlaşma hizmetleri sunar.
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 | Arena Etkileşimli Desteği |
| URL | https://www.arenainteractive.fi/contact |
| E-posta | support@arenainteractive.fi |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Arena Etkileşimli Oy |
| Web sitesi | https://www.arenainteractive.fi |
| Gizlilik ilkesi | https://www.arenainteractive.fi/privacypolicy |
| Kategoriler | İletişim; Işbirliği |
SmartDialog Bağlayıcısı
Bu bağlayıcı, SmartDialog platformunu kullanarak SMS iletileri göndermek ve almak için kullanılabilir.
Önkoşullar
- SmartDialog aboneliği ve hesabı. Lütfen iletişimde olun sales@arenainteractive.fi
- Hesabınız için OAuth'un etkinleştirilmesi ve bir istemci gizli dizisinin istenmesi gerekir. Bu, adresinden bize bir e-posta support@arenainteractive.figöndererek yapılabilir.
Kurulum
- Lütfen OpenAPI tanımından özel bağlayıcı oluşturma başlığındaki yönergeleri izleyin.
- Bir Flow veya PowerApp oluşturun ve özel bölümden bir SmartDialog eylemi ekleyin. SmartDialog hesabınızla oturum açın.
Desteklenen Eylemler
- Yeni İleti (İleti alma tetikleyicisi)
- İleti Gönder
- WhatsApp İletisi Gönder
- Tartışma Yanıt İletisi Gönder
- Yanıt İletisi Gönder
- WhatsApp Kabul Et
- WhatsApp Geri Çevirme
- WhatsApp Şablonu Oluşturma
- Grup Kişisi Alma
- Grup Kişisi Oluştur
- Grup Kişisini Güncelleştir
- Grup Kişisi Sil
- Tüm Grup Kişilerini Sil
Azaltma Sınırları
| Name | Çağrılar | Yenileme Dönemi |
|---|---|---|
| Bağlantı başına API çağrıları | 100 | 60 saniye |
Eylemler
| Grup Kişisi Alma |
Grup Kişisi Alma |
| Grup kişisi oluşturma |
Grup kişisi oluşturma |
| Grup Kişisi Sil |
Telefon numarasını kullanarak grup kişilerini silin. |
| Grup Kişisini Güncelleştir |
Grup Kişisini Güncelleştir |
| İleti Gönder |
Alıcılara İleti gönder. |
| Tartışma Yanıt İletisi Gönder |
Alıcılara Tartışma Yanıt İletisi gönder. |
| Tüm Grup Kişilerini Sil |
Tüm Grup Kişilerini Sil |
|
Whats |
Gönderen ve alıcı için WhatsApp Geri Çevirme. (kullanım dışı) |
|
Whats |
WhatsApp şablonu iletisi gönderin. |
|
Whats |
Gönderen ve alıcı için WhatsApp Kabul Et. (kullanım dışı) |
|
Whats |
Yeni bir WhatsApp şablonu oluşturun. |
| Yanıt İletisi Gönder |
Alıcılara Bir Yanıt iletisi gönderin. |
Grup Kişisi Alma
Grup Kişisi Alma
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Müşteri
|
Customer | True | string |
Grup Hizmetlerinin getirilmeye hazır olduğu Müşteri. |
|
Grup Hizmeti
|
Group Service | True | string |
Kullanılacak Grup Hizmeti. |
|
Telefon
|
Phone | True | string |
Kişinin Telefon numarası. |
|
Bölge
|
Region | string |
Telefon numarasını ayrıştırmak için kullanılacak isteğe bağlı Telefon numarası bölgesi. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Telefon
|
phone | string |
Kişinin telefon numarası. |
|
E-posta
|
string |
Kişinin e-posta adresi. |
|
|
Ad
|
firstName | string |
Kişinin adı. |
|
Soyadı
|
lastName | string |
Kişinin soyadı. |
|
Gender
|
gender | string |
Kişinin Cinsiyeti. |
|
Doğum Yılı
|
birthYear | integer |
Kişinin Doğum Yılı. |
|
Sokak Adresi
|
streetAddress | string |
Kişinin Sokak Adresi. |
|
Posta Kodu
|
zipCode | string |
İlgili Kişinin Posta Kodu. |
|
City
|
city | string |
İlgili Kişinin Şehri. |
|
Ülke Kodu
|
countryCode | string |
İlgili Kişinin Ülke Kodu. |
|
Başarısız İletiler
|
failedMessages | integer |
Kişi için başarısız ileti sayısı. |
|
Özel Özellikler
|
customContactProperties | array of object |
Kişi için kaydedilen Özel Kişi Özelliği koleksiyonu. |
|
İsim
|
customContactProperties.name | string |
Özel kişi özellik adı. |
|
Değer
|
customContactProperties.value | string |
Özel kişi özellik değeri. |
Grup kişisi oluşturma
Grup kişisi oluşturma
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Müşteri
|
Customer | True | string |
Grup Hizmetlerinin getirilmeye hazır olduğu Müşteri. |
|
Grup Hizmeti
|
Group Service | True | string |
Kullanılacak Grup Hizmeti. |
|
Aktif
|
active | boolean |
Kişinin Etkin olup olmadığını gösteren bayrak. |
|
|
Telefon
|
phone | True | string |
Kişinin telefon numarası. |
|
E-posta
|
string |
Kişinin e-posta adresi. |
||
|
Ad
|
firstName | string |
Kişinin adı. |
|
|
Soyadı
|
lastName | string |
Kişinin soyadı. |
|
|
Gender
|
gender | string |
Kişinin Cinsiyeti. |
|
|
Doğum Yılı
|
birthYear | integer |
Kişinin Doğum Yılı. |
|
|
Sokak Adresi
|
streetAddress | string |
Kişinin Sokak Adresi. |
|
|
Posta Kodu
|
zipCode | string |
İlgili Kişinin Posta Kodu. |
|
|
City
|
city | string |
İlgili Kişinin Şehri. |
|
|
Ülke Kodu
|
countryCode | string |
İlgili Kişinin 3 harfli Ülke Kodu. |
|
|
İsim
|
name | string |
Özel özellik adı. |
|
|
Değer
|
value | string |
Özel özellik değeri. |
|
|
Telefon Numarası Bölgeleri
|
phoneNumberRegions | array of string |
Numaraları ayrıştırmak için kullanılacak telefon numarası bölgeleri. Boş bırakılırsa varsayılan olarak Finlandiya olur. |
Döndürülenler
Oluşturulan Kişinin Benzersiz Kimliği.
- İrtibat Numarası
- uuid
Grup Kişisi Sil
Telefon numarasını kullanarak grup kişilerini silin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Müşteri
|
Customer | True | string |
Grup Hizmetlerinin getirilmeye hazır olduğu Müşteri. |
|
Grup Hizmeti
|
Group Service | True | string |
Kullanılacak Grup Hizmeti. |
|
Telefon
|
Phone | True | string |
Silinecek kişinin Telefon numarası. |
Döndürülenler
- response
- boolean
Grup Kişisini Güncelleştir
Grup Kişisini Güncelleştir
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Müşteri
|
Customer | True | string |
Grup Hizmetlerinin getirilmeye hazır olduğu Müşteri. |
|
Grup Hizmeti
|
Group Service | True | string |
Kullanılacak Grup Hizmeti. |
|
Telefon
|
Phone | True | string |
Güncelleştirilecek kişinin Telefon numarası. |
|
Aktif
|
active | boolean |
Kişinin Etkin olup olmadığını gösteren bayrak. |
|
|
E-posta
|
string |
Kişinin e-posta adresi. |
||
|
Ad
|
firstName | string |
Kişinin adı. |
|
|
Soyadı
|
lastName | string |
Kişinin soyadı. |
|
|
Gender
|
gender | string |
Kişinin Cinsiyeti. |
|
|
Doğum Yılı
|
birthYear | integer |
Kişinin Doğum Yılı. |
|
|
Sokak Adresi
|
streetAddress | string |
Kişinin Sokak Adresi. |
|
|
Posta Kodu
|
zipCode | string |
İlgili Kişinin Posta Kodu. |
|
|
City
|
city | string |
İlgili Kişinin Şehri. |
|
|
Ülke Kodu
|
countryCode | string |
İlgili Kişinin 3 harfli Ülke Kodu. |
|
|
İsim
|
name | string |
Özel kişi özellik adı. |
|
|
Değer
|
value | string |
Özel kişi özellik değeri. |
|
|
Telefon Numarası Bölgeleri
|
phoneNumberRegions | array of string |
Numaraları ayrıştırmak için kullanılacak telefon numarası bölgeleri. Boş bırakılırsa varsayılan olarak Finlandiya olur. |
Döndürülenler
- response
- boolean
İleti Gönder
Alıcılara İleti gönder.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Müşteri
|
Customer-Id | True | string |
Göndermek için kullanılacak Müşteri. |
|
Hizmet
|
Service-Id | True | string |
Göndermek için kullanılacak Hizmet. |
|
İleti Göndereni
|
Sender | True | string |
İletinin göndereni alfasayısal, uzun kod veya kısa kod olabilir (kısıtlamalar geçerlidir). |
|
İleti İçeriği
|
Content | True | string |
İletinin içeriği. |
|
İleti Protokolü
|
Protocol | True | string |
İletiyi göndermek için kullanılacak protokol. |
|
Tarih Saat Gönder
|
SendDateTime | date-time |
İletinin gönderilip gönderilme tarihi ve saati. Anında göndermek için boş bırakın. |
|
|
Adres
|
Address | True | string |
İleti alıcı adresi. |
|
Ek Uri'si
|
AttachmentUri | string |
Ek içeren WhatsApp iletisi gönderilirken kullanılacak ek Uri'sidir. |
|
|
Müşteri Verileri
|
CustomerData | string |
İsteğe bağlı olarak, bu ileti için faturalama/gruplandırma verileri. |
|
|
Reklam İletisi
|
AdMessage | boolean |
İletiyi reklam iletisi olarak işaretlemek için isteğe bağlı geçersiz kılma bayrağı |
|
|
Dlr Url'si
|
DlrUrl | string |
http-get aracılığıyla Teslim durumu geri çağırma url'si. URL'ye sorgu dizesi değerleri ekleyebilirsiniz; bunlar korunur. |
|
|
İstek Kimliği
|
RequestId | string |
Yinelenen istekleri tanımlamak için kullanılabilecek isteğe bağlı benzersiz istek kimliği. Yinelenen istek kimliği algılanırsa gönderme işlemi iptal edilir. Yinelenen istek kimliklerine sahip isteklerin yüksek aktarım hızı/trafik durumlarında engellenmesinin garantisi yoktur. Verilen requestId değeri 7 gün boyunca "anımsanacak". |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
İleti Kimliği
|
MessageId | string |
Yeni oluşturulan iletinin tanımlayıcısı. |
|
İleti Bölümü Sayısı
|
MessagePartCount | integer |
Bu ileti için yaklaşık ileti bölümü sayısı. |
|
Alıcı
|
Recipients | array of object |
Alıcı |
|
Alıcı Adresi
|
Recipients.Address | string |
Alıcı adresi (telefon numarası/e-posta/kullanıcı kimliği vb.). |
|
Alıcı Kimliği
|
Recipients.Id | string |
Teslim durumu bilgilerini almak için kullanılan alıcı tanımlayıcısı. |
Tartışma Yanıt İletisi Gönder
Alıcılara Tartışma Yanıt İletisi gönder.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Müşteri
|
CustomerId | True | string |
Göndermek için kullanılacak Müşteri. |
|
İş Parçacığı Kimliği
|
ThreadId | True | string |
Yanıt için mevcut İş Parçacığının kimliği. |
|
İleti İçeriği
|
Content | True | string |
İletinin içeriği. |
|
Müşteri Verileri
|
CustomerData | string |
İsteğe bağlı olarak, bu ileti için faturalama/gruplandırma verileri. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
İleti Kimliği
|
MessageId | string |
Yeni oluşturulan iletinin tanımlayıcısı. |
|
İleti Bölümü Sayısı
|
MessagePartCount | integer |
Bu ileti için yaklaşık ileti bölümü sayısı. |
|
Alıcı
|
Recipients | array of object |
Alıcı |
|
Alıcı Adresi
|
Recipients.Address | string |
Alıcı adresi (telefon numarası/e-posta/kullanıcı kimliği vb.). |
|
Alıcı Kimliği
|
Recipients.Id | string |
Teslim durumu bilgilerini almak için kullanılan alıcı tanımlayıcısı. |
|
ThreadId
|
ThreadId | string |
İletinin gönderildiği İş Parçacığının tanımlayıcısı. |
Tüm Grup Kişilerini Sil
Tüm Grup Kişilerini Sil
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Müşteri
|
Customer | True | string |
Grup Hizmetlerinin getirilmeye hazır olduğu Müşteri. |
|
Grup Hizmeti
|
Group Service | True | string |
Kullanılacak Grup Hizmeti. |
Döndürülenler
- response
- boolean
WhatsApp Geri Çevirme (kullanım dışı) [KULLANIM DIŞI]
Gönderen ve alıcı için WhatsApp Geri Çevirme. (kullanım dışı)
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Gönderen adresi
|
Sender | True | string |
Geri çevirmek için kayıtlı Whatsapp kimlik numarası. |
|
Alıcı adresi
|
Recipient | True | string |
Kabulden kaldırılacak tarif numarası. |
WhatsApp İletisi Gönder
WhatsApp şablonu iletisi gönderin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Müşteri
|
Customer-Id | True | string |
Göndermek için kullanılacak Müşteri. |
|
Hizmet
|
Service-Id | True | string |
Göndermek için kullanılacak Hizmet. |
|
WhatsApp Şablonu
|
TemplateName | True | string |
Göndermek için kullanılacak Şablon. |
|
Adres
|
Address | True | string |
İleti alıcı adresi. |
|
BodyParameters
|
BodyParameters | array of string |
BodyParameters |
|
|
HeaderParameters
|
HeaderParameters | array of string |
HeaderParameters |
|
|
Türü
|
Type | string |
Düğme türü. Şablon başına yalnızca bir tür, aynı türden birden çok içerebilir. |
|
|
Metin
|
Data | string |
Düğmenin metni. |
|
|
Tarih Saat Gönder
|
SendDateTime | string |
İletinin gönderilip gönderilme tarihi ve saati. Anında göndermek için boş bırakın. |
|
|
Ek Uri'si
|
AttachmentUri | string |
Şablon ek içeriyorsa Ek Uri'sini seçin. |
|
|
SMS Geri Dönüşünü kullanma
|
UseSmsFallback | boolean |
SMS geri dönüş olarak kullanılmalıdır. |
|
|
Dlr Url'si
|
DlrUrl | string |
Gönderme işlemi tamamlandığında geri çağırma alacak teslim raporu Url'si. |
|
|
Müşteri Verileri
|
CustomerData | string |
İsteğe bağlı olarak, bu ileti için faturalama/gruplandırma verileri. |
|
|
İstek Kimliği
|
RequestId | string |
Yinelenen istekleri tanımlamak için kullanılabilecek isteğe bağlı benzersiz istek kimliği. Yinelenen istek kimliği algılanırsa gönderme işlemi iptal edilir. Yinelenen istek kimliklerine sahip isteklerin yüksek aktarım hızı/trafik durumlarında engellenmesinin garantisi yoktur. Verilen requestId değeri 7 gün boyunca "anımsanacak". |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
İleti Kimliği
|
messageId | string |
Yeni oluşturulan iletinin tanımlayıcısı. |
|
İleti Bölümü Sayısı
|
messagePartCount | integer |
Bu ileti için yaklaşık ileti bölümü sayısı. |
|
recipients
|
recipients | array of object |
recipients |
|
Alıcı Adresi
|
recipients.address | string |
Alıcı adresi (telefon numarası/e-posta/kullanıcı kimliği vb.). |
|
Alıcı Kimliği
|
recipients.id | string |
Teslim durumu bilgilerini almak için kullanılan alıcı tanımlayıcısı. |
WhatsApp Kabul Etme (kullanım dışı) [KULLANIM DIŞI]
Gönderen ve alıcı için WhatsApp Kabul Et. (kullanım dışı)
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Gönderen adresi
|
Sender | True | string |
Kabul etmek için kayıtlı Whatsapp kimlik numarası. |
|
Alıcı adresi
|
Recipient | True | string |
Kabul etmek için alıcı numarası. |
WhatsApp şablonu oluşturma
Yeni bir WhatsApp şablonu oluşturun.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Müşteri
|
Customer-Id | True | string |
Şablonun oluşturulacağı Müşteri. |
|
IdentityNumber
|
IdentityNumber | True | string |
Şablon için kullanılan WhatsApp IdentityNumber. |
|
Görünen Ad
|
DisplayName | True | string |
Şablon Görünen Adı. |
|
Content
|
RawContent | True | string |
Şablon içeriği. |
|
Şablon Kategorisi
|
Category | True | string |
Şablon kategorisi. |
|
Şablon Dili
|
Language | True | string |
Şablon dili için 2 karakterlik kod. |
|
Düğme Türü
|
Type | string |
Düğme türü. |
|
|
Düğme Etiketi
|
Label | string |
Düğme Etiketi. |
|
|
Düğme Verileri
|
Data | string |
Düğme verileri. Url (Url), telefon numarası (Arama) veya metin (QuickReply). Maksimum uzunluk Url için 2000, telefon numarası ve metin için 20'dir. |
|
|
Ek Url'si
|
AttachmentUrl | string |
Örnek bir ekin URL'si. |
Yanıt İletisi Gönder
Alıcılara Bir Yanıt iletisi gönderin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
ParentMessage Kimliği
|
ParentMessageId | True | string |
Yanıt için üst ileti kimliği. |
|
Müşteri
|
Customer-Id | True | string |
Göndermek için kullanılacak Müşteri. |
|
Hizmet
|
Service-Id | True | string |
Göndermek için kullanılacak Hizmet. |
|
İleti Göndereni
|
Sender | True | string |
İletinin göndereni alfasayısal, uzun kod veya kısa kod olabilir (kısıtlamalar geçerlidir). |
|
İleti İçeriği
|
Content | True | string |
İletinin içeriği. |
|
İleti Protokolü
|
Protocol | True | string |
İletiyi göndermek için kullanılacak protokol. |
|
Tarih Saat Gönder
|
SendDateTime | date-time |
İletinin gönderilip gönderilme tarihi ve saati. Anında göndermek için boş bırakın. |
|
|
Adres
|
Address | True | string |
İleti alıcı adresi. |
|
Ek Uri'si
|
AttachmentUri | string |
Ek içeren WhatsApp iletisi gönderilirken kullanılacak ek Uri'sidir. |
|
|
Müşteri Verileri
|
CustomerData | string |
İsteğe bağlı olarak, bu ileti için faturalama/gruplandırma verileri. |
|
|
Reklam İletisi
|
AdMessage | boolean |
İletiyi reklam iletisi olarak işaretlemek için isteğe bağlı geçersiz kılma bayrağı |
|
|
Dlr Url'si
|
DlrUrl | string |
http-get aracılığıyla Teslim durumu geri çağırma url'si. URL'ye sorgu dizesi değerleri ekleyebilirsiniz; bunlar korunur. |
|
|
İstek Kimliği
|
RequestId | string |
Yinelenen istekleri tanımlamak için kullanılabilecek isteğe bağlı benzersiz istek kimliği. Yinelenen istek kimliği algılanırsa gönderme işlemi iptal edilir. Yinelenen istek kimliklerine sahip isteklerin yüksek aktarım hızı/trafik durumlarında engellenmesinin garantisi yoktur. Verilen requestId değeri 7 gün boyunca "anımsanacak". |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
İleti Kimliği
|
MessageId | string |
Yeni oluşturulan iletinin tanımlayıcısı. |
|
İleti Bölümü Sayısı
|
MessagePartCount | integer |
Bu ileti için yaklaşık ileti bölümü sayısı. |
|
Alıcı
|
Recipients | array of object |
Alıcı |
|
Alıcı Adresi
|
Recipients.Address | string |
Alıcı adresi (telefon numarası/e-posta/kullanıcı kimliği vb.). |
|
Alıcı Kimliği
|
Recipients.Id | string |
Teslim durumu bilgilerini almak için kullanılan alıcı tanımlayıcısı. |
Tetikleyiciler
| Yeni İleti |
2 Yönlü hizmete yeni bir ileti geldiğinde. |
Yeni İleti
2 Yönlü hizmete yeni bir ileti geldiğinde.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Müşteri
|
Customer | True | string |
Kullanılacak Müşteri. |
|
Hizmet
|
Service | True | string |
Kullanılacak 2 Yönlü hizmet. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
İleti Göndereni
|
sender | string |
İletiyi gönderen. |
|
İleti Alıcısı
|
recipient | string |
İletinin alıcısı. |
|
İleti İçeriği
|
content | string |
Alınan iletinin içeriği. |
|
İleti Zaman Damgası
|
timestamp | date-time |
İletinin zaman damgası. |
|
İleti Protokolü
|
protocol | string |
Alınan iletinin protokolü. |
|
attachments
|
attachments | array of object |
attachments |
|
Ek Dosya Adı
|
attachments.name | string |
Ekin dosya adı. |
|
Ek Mime Türü
|
attachments.mimeType | string |
Ekin mime türü. |
|
Ek Kaynak Konumu
|
attachments.resourceLocation | string |
Ek kaynağı konumu. |
|
İleti Kimliği
|
messageId | string |
Alınan iletinin benzersiz ileti kimliği. |
Tanımlar
UUID (evrensel benzersiz tanımlayıcı)
Boolean
Bu, 'boole' temel veri türüdür.