Sinch (Önizleme)
Sinch, işletmenizin uyarılar, anımsatıcılar, davetler, pazarlama kampanyaları ve daha fazlası aracılığıyla müşterilerle bağlantı kurmasına yardımcı olur. Sinch Engage, Sinch MessageMedia, One NZ, eTXT ve GroupText tarafından desteklenen platformlarımız küresel olarak milyarlarca ileti sunar. Bu bağlayıcı ile SMS, RCS ve MMS'yi iş akışlarınızla kolayca tümleştirebilir, müşteri iletişimlerini akışa alabilir ve otomatikleştirebilirsiniz.
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 | Destek kanalı |
| URL | https://messagemedia.com/contact/ |
| E-posta | support@messagemedia.com |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Sinch İsveç AB |
| Web sitesi | https://messagemedia.com |
| Gizlilik ilkesi | https://messagemedia.com/legal/privacy-policy/ |
| Kategoriler | Communication |
Bağlayıcınızın Adı
Sinch
API belgeleri
https://messagemedia.github.io/documentation/#tag/Messages/operation/SendMessages
Desteklenen İşlemler
https://support.messagemedia.com/hc/en-us/categories/10710547404559-Power-Automate-App-Support
Kimlik bilgilerini alma
Bu bağlayıcı ve kimlik doğrulamasını kullanır API KeyAPI secret (nasıl edinmeye ilişkin bellow bağlantısındaki adımlara bakın) https://support.messagemedia.com/hc/en-us/articles/4413627066383-Creating-New-API-Credentials
Desteklenen İşlemler
Bu bağlayıcı aşağıdaki işlemleri destekler:
-
Send Text Message (SMS): Birden çok mobil alıcıya kısa mesaj (SMS) gönderin. -
Send Rich Text Message (RCS): RCS iletisini bir mobil alıcıya gönderin. -
Send MMS Message (MMS): Birden çok mobil alıcıya multimedya iletisi (MMS) gönderin. -
Get sender IDs: Hesabınıza bağlı Gönderen Kimliklerinin listesini alın. -
Get message status: İleti kimliğini kullanarak ileti durumunu alın. -
When a message is received: Bu işlem, gelen bir ileti (SMS, RCS, MMS) aldığınızda tetikler. -
When delivery receipt is received: Bu işlem, giden ileti (SMS, RCS, MMS) için teslim bilgisi aldığınızda tetikler.
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ı | securestring | Bu API için api_key | Doğru |
| api_secret | securestring | Bu API için api_secret | Doğru |
| Sinch hizmetleri | String | Bu, bağlanmakta olan API'dir, aşağıdakilerden birini seçin: Sinch MessageMedia (Asya'ya özgü hesaplar için en iyi); Sinch engage (Avrupa, ABD hesapları için en iyi) | 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
| Gönderen kimliklerini alma |
Hesabınıza bağlı Gönderen Kimliklerinin listesini alın. |
| İleti durumunu alma |
İleti kimliğini kullanarak ileti durumunu alma. |
| Kısa Mesaj Gönder (SMS) |
Birden çok mobil alıcıya kısa mesaj (SMS) gönderin. |
| MMS İletisi Gönder |
Bu eylem, bir cep telefonu numarasına multimedya iletisi (MMS) göndermek için kullanılır. |
| Zengin Metin İletisi Gönder (RCS) |
RCS iletisini bir mobil alıcıya gönderin. |
Gönderen kimliklerini alma
Hesabınıza bağlı Gönderen Kimliklerinin listesini alın.
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
page
|
pagination.page | integer |
page |
|
page_size
|
pagination.page_size | integer |
page_size |
|
total_count
|
pagination.total_count | integer |
total_count |
|
page_count
|
pagination.page_count | integer |
page_count |
|
type
|
default_sender.type | string |
type |
|
Numara
|
default_sender.number | string |
Numara |
|
source_type
|
default_sender.source_type | string |
source_type |
|
mms_capable
|
default_sender.mms_capable | boolean |
mms_capable |
|
Gönderenler
|
senders | array of object |
Gönderenler |
|
display_type
|
senders.display_type | string |
display_type |
|
is_default
|
senders.is_default | boolean |
is_default |
|
label
|
senders.label | string |
label |
|
mms_capable
|
senders.mms_capable | boolean |
mms_capable |
|
Numara
|
senders.number | string |
Numara |
|
display_name
|
senders.display_name | string |
Gönderen için biçimlendirilmiş görünen ad |
|
number_id
|
senders.number_id | string |
number_id |
|
source_type
|
senders.source_type | string |
source_type |
|
type
|
senders.type | string |
type |
|
number_status
|
senders.number_status | string |
number_status |
|
account_id
|
account_id | string |
account_id |
|
vendor_id
|
vendor_id | string |
vendor_id |
İleti durumunu alma
İleti kimliğini kullanarak ileti durumunu alma.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Bu iletinin benzersiz kimliği
|
messageId | True | string |
Bu iletinin benzersiz kimliği |
Döndürülenler
- Body
- message
Kısa Mesaj Gönder (SMS)
Birden çok mobil alıcıya kısa mesaj (SMS) gönderin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Gönderen Kimliği
|
source_number | string |
Kullanılacak kaynak numarasını belirtin |
|
|
Hedef Numarası
|
to | True | string |
Alıcının E.164 biçimindeki cep telefonu numarası. Boşlukla ayrılmış en fazla 100 alıcı |
|
Message
|
message | True | string |
SMS ileti gövdesi |
|
Teslim raporu
|
delivery_report | boolean |
Teslim raporları her iletiyle birlikte istenebilir. Teslim raporları istenirse, ileti için belirtilen callback_url özelliğine (veya web kancalarına) bir web kancası gönderilir |
|
|
Geri arama URL'si
|
callback_url | string |
Web kancalarının bir HTTP POST isteği aracılığıyla gönderileceği her iletiye bir URL eklenebilir |
|
|
Meta veri anahtarı
|
metadata_key | string |
meta veri anahtarı |
|
|
Meta veri değeri
|
metadata_value | string |
meta veri değeri |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
messages
|
messages | array of object |
messages |
|
callback_url
|
messages.callback_url | string |
callback_url |
|
delivery_report
|
messages.delivery_report | boolean |
Teslim raporları her iletiyle birlikte istenebilir. Teslim raporları istenirse, ileti için belirtilen callback_url özelliğine (veya web kancalarına) bir web kancası gönderilir |
|
destination_number
|
messages.destination_number | string |
hedef numarası |
|
format
|
messages.format | string |
format |
|
message_expiry_timestamp
|
messages.message_expiry_timestamp | string |
ileti süre sonu zaman damgası |
|
message_flags
|
messages.message_flags | array of |
ileti bayrakları |
|
message_id
|
messages.message_id | string |
ileti kimliği |
|
Kaynak
|
messages.metadata.Source | string |
Kaynak |
|
scheduled
|
messages.scheduled | string |
scheduled |
|
statü
|
messages.status | string |
statü |
|
içerik
|
messages.content | string |
içerik |
|
source_number
|
messages.source_number | string |
kaynak numarası |
|
medya
|
messages.media | array of string |
medya |
|
konu
|
messages.subject | string |
konu |
MMS İletisi Gönder
Bu eylem, bir cep telefonu numarasına multimedya iletisi (MMS) göndermek için kullanılır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Hedef Numarası
|
to | True | string |
Alıcının E.164 biçimindeki cep telefonu numarası. Boşlukla ayrılmış en fazla 100 alıcı |
|
Message
|
message | True | string |
MMS ileti gövdesi |
|
Medya İçeriği
|
media | byte |
Base64 dizesi olarak kodlanmış, MMS iletisine eklenecek medya içeriği. Desteklenen medya türleri arasında görüntüler (JPEG, PNG, GIF), videolar (MP4) ve ses dosyaları (MP3) bulunur. Her medya eki için en büyük dosya boyutu 600 kb'tır. |
|
|
Gönderen Kimliği
|
source_number | string |
Kullanılacak MMS özellikli bir kaynak numarası belirtin |
|
|
Meta veri anahtarı
|
metadata_key | string |
Meta veri anahtarı |
|
|
Meta veri değeri
|
metadata_value | string |
Meta veri değeri |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
messages
|
messages | array of object |
messages |
|
callback_url
|
messages.callback_url | string |
callback_url |
|
delivery_report
|
messages.delivery_report | boolean |
Her iletiyle birlikte teslim raporları istenebilir |
|
destination_number
|
messages.destination_number | string |
hedef numarası |
|
format
|
messages.format | string |
format |
|
message_expiry_timestamp
|
messages.message_expiry_timestamp | string |
ileti süre sonu zaman damgası |
|
message_id
|
messages.message_id | string |
ileti kimliği |
|
Kaynak
|
messages.metadata.Source | string |
Kaynak |
|
scheduled
|
messages.scheduled | string |
scheduled |
|
statü
|
messages.status | string |
statü |
|
içerik
|
messages.content | string |
içerik |
|
source_number
|
messages.source_number | string |
kaynak numarası |
|
medya
|
messages.media | array of string |
medya |
|
konu
|
messages.subject | string |
konu |
Zengin Metin İletisi Gönder (RCS)
RCS iletisini bir mobil alıcıya gönderin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
Tetikleyiciler
| İleti alındığında |
Bu işlem, gelen bir ileti (SMS, RCS, MMS) aldığınızda tetikler. |
| Teslim alındı bilgisi alındığında |
Bu işlem, giden ileti (SMS, RCS, MMS) için teslim alındı bilgisi aldığınızda tetikler. |
İleti alındığında
Bu işlem, gelen bir ileti (SMS, RCS, MMS) aldığınızda tetikler.
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
message_id
|
message_id | string |
Özgün iletinin kimliği |
|
reply_id
|
reply_id | string |
Bu bildirimin temsil ettiği yanıt için benzersiz bir kimlik |
|
statü
|
status | string |
Teslim Raporları ileti durumunu gösterir |
|
source_address
|
source_address | string |
kaynak adresi |
|
destination_address
|
destination_address | string |
hedef adres |
|
içerik
|
content | string |
Yanıtın içeriği |
|
İleti içeriği V2 - metin
|
contact_message.text_message.text | string |
İleti içeriği V2 - metin |
|
type
|
type | string |
type |
|
status_code
|
status_code | string |
Durum kodları, iletinin durumu hakkında daha ayrıntılı içgörüler sağlar |
|
submitted_date
|
submitted_date | string |
İleti Zaman Damgası |
|
date_received
|
date_received | string |
Sağlayıcı Zaman Damgası |
|
Attachments
|
attachments | array of object |
Yanıta dahil edilen tüm ekleri içeren liste. Bu alan yalnızca hesabınızda Gelen MMS'yi etkinleştirdiyseniz ve yanıt ekleri içeriyorsa kullanılabilir |
|
Ek türü
|
attachments.attachment_type | string |
Bu ekle ilişkilendirilmiş MIME türü |
|
Ek içeriği
|
attachments.attachment_content | string |
Base64 kodlanmış ek |
|
Ek adı
|
attachments.attachment_name | string |
Ekin adı |
|
Meta veriler
|
metadata | array of object |
Özgün gönderme iletisi isteğine dahil edilen tüm meta veriler |
|
Meta veri anahtarı
|
metadata.metadata_key | string |
Meta veri anahtarı |
|
Meta veri değeri
|
metadata.metadata_value | string |
Meta veri değeri |
Teslim alındı bilgisi alındığında
Bu işlem, giden ileti (SMS, RCS, MMS) için teslim alındı bilgisi aldığınızda tetikler.
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
message_id
|
message_id | string |
Özgün iletinin kimliği |
|
statü
|
status | string |
Teslim Raporları ileti durumunu gösterir |
|
source_address
|
source_address | string |
kaynak adresi |
|
destination_address
|
destination_address | string |
hedef adres |
|
içerik
|
content | string |
içerik |
|
type
|
type | string |
type |
|
delivery_report_id
|
delivery_report_id | string |
teslim raporu kimliği |
|
status_code
|
status_code | string |
Durum kodları, iletinin durumu hakkında daha ayrıntılı içgörüler sağlar |
|
submitted_date
|
submitted_date | string |
İleti Zaman Damgası |
|
date_received
|
date_received | string |
Sağlayıcı Zaman Damgası |
|
Attachments
|
attachments | array of object |
Attachments |
|
Ek türü
|
attachments.attachment_type | string |
Ek türü |
|
Ek içeriği
|
attachments.attachment_content | string |
Ek içeriği |
|
Ek adı
|
attachments.attachment_name | string |
Ek adı |
|
Meta veriler
|
metadata | array of object |
Özgün gönderme iletisine dahil edilen tüm meta veriler |
|
Meta veri anahtarı
|
metadata.metadata_key | string |
Meta veri anahtarı |
|
Meta veri değeri
|
metadata.metadata_value | string |
Meta veri değeri |
Tanımlar
message
| Name | Yol | Tür | Description |
|---|---|---|---|
|
callback_url
|
callback_url | string |
Web kancalarının bir HTTP POST isteği aracılığıyla gönderileceği her iletiye bir URL eklenebilir |
|
delivery_report
|
delivery_report | boolean |
Teslim raporları her iletiyle birlikte istenebilir. Teslim raporları istenirse, ileti için belirtilen callback_url özelliğine (veya web kancalarına) bir web kancası gönderilir |
|
destination_number
|
destination_number | string |
İletinin teslim edilmesi gereken hedef numara |
|
format
|
format | string |
Biçim, iletinin hangi biçimde gönderileceğini belirtir, SMS (kısa mesaj), MMS (multimedya iletisi) veya TTS (metin okuma) |
|
message_expiry_timestamp
|
message_expiry_timestamp | string |
İletinin teslim edilmesi gereken en son saati belirtmek için bir ileti süre sonu zaman damgası sağlanabilir |
|
message_flags
|
message_flags | array of |
message_flags |
|
message_id
|
message_id | string |
İleti kimliği |
|
Kaynak
|
metadata.Source | string |
Kaynak |
|
scheduled
|
scheduled | string |
İletinin zamanlanmış teslim tarihi saati |
|
statü
|
status | string |
İletinin durumu |
|
içerik
|
content | string |
içerik |
|
source_number
|
source_number | string |
kaynak numarası |
|
medya
|
media | array of string |
medya |
|
konu
|
subject | string |
konu |