Sinch (wersja zapoznawcza)
Sinch pomaga twojej firmie łączyć się z klientami za pośrednictwem alertów, przypomnień, zaproszeń, kampanii marketingowych i nie tylko. Obsługiwane przez Sinch Engage, Sinch MessageMedia, One NZ, eTXT i GroupText, nasze platformy dostarczają miliardy komunikatów globalnie. Dzięki temu łącznikowi można łatwo zintegrować programy SMS i RCS z przepływami pracy, usprawniać i automatyzować komunikację klientów.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate - narzędzie do automatyzacji procesów | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Kanał pomocy technicznej |
| adres URL | https://messagemedia.com/contact/ |
| support@messagemedia.com |
| Metadane łącznika | |
|---|---|
| Publisher | Sinch Szwecja AB |
| Witryna internetowa | https://messagemedia.com |
| Zasady ochrony prywatności | https://messagemedia.com/legal/privacy-policy/ |
| Kategorie | Communication |
Nazwa łącznika
Sinch
Dokumentacja interfejsu API
https://messagemedia.github.io/documentation/#tag/Messages/operation/SendMessages
Obsługiwane operacje
https://support.messagemedia.com/hc/en-us/categories/10710547404559-Power-Automate-App-Support
Jak uzyskać poświadczenia
Ten łącznik używa API Key i API secret uwierzytelniania (zobacz kroki w linku dzwonka, aby dowiedzieć się, jak go uzyskać) https://support.messagemedia.com/hc/en-us/articles/4413627066383-Creating-New-API-Credentials
Obsługiwane operacje
Ten łącznik obsługuje następujące operacje:
-
Send Text Message (SMS): Wyślij wiadomość SMS do wielu adresatów mobilnych. -
Send Rich Text Message (RCS): Wyślij wiadomość sformatowaną (RCS). -
Get sender IDs: Ta akcja zwróci listę identyfikatorów nadawcy połączonych z twoim kontem. -
Get message status: Uzyskiwanie stanu komunikatu przy użyciu identyfikatora komunikatu -
When SMS or RCS is received: Ta operacja jest wyzwalana po otrzymaniu wiadomości przychodzącej (SMS lub RCS). -
When delivery receipt is received: Ta operacja jest wyzwalana po otrzymaniu potwierdzenia dostarczenia dla wiadomości wychodzącej (SMS lub RCS).
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| klucz_api | securestring | Api_key dla tego interfejsu API | Prawda |
| api_secret | securestring | Api_secret dla tego interfejsu API | Prawda |
| Usługi sinch | ciąg | Jest to interfejs API, z który jest połączony, wybierz jedną z następujących opcji: Sinch MessageMedia (najlepsze dla kont specyficznych dla Azji); Sinch engage (Najlepsze dla Europy, konta USA) | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Pobieranie identyfikatorów nadawcy |
Ta akcja zwróci listę identyfikatorów nadawców połączonych z Twoim kontem. |
| Uzyskiwanie stanu komunikatu |
Uzyskiwanie stanu komunikatu przy użyciu identyfikatora komunikatu |
| Wysyłanie wiadomości sformatowanej (RCS) |
Wysyłanie wiadomości sformatowanej (RCS) |
| Wyślij wiadomość SMS |
Ta akcja służy do wysyłania wiadomości SMS do numeru telefonu komórkowego. |
Pobieranie identyfikatorów nadawcy
Ta akcja zwróci listę identyfikatorów nadawców połączonych z Twoim kontem.
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
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 |
|
typ
|
default_sender.type | string |
typ |
|
Liczba
|
default_sender.number | string |
Liczba |
|
source_type
|
default_sender.source_type | string |
source_type |
|
mms_capable
|
default_sender.mms_capable | boolean |
mms_capable |
|
Nadawców
|
senders | array of object |
Nadawców |
|
display_type
|
senders.display_type | string |
display_type |
|
is_default
|
senders.is_default | boolean |
is_default |
|
etykieta
|
senders.label | string |
etykieta |
|
mms_capable
|
senders.mms_capable | boolean |
mms_capable |
|
Liczba
|
senders.number | string |
Liczba |
|
number_id
|
senders.number_id | string |
number_id |
|
source_type
|
senders.source_type | string |
source_type |
|
typ
|
senders.type | string |
typ |
|
number_status
|
senders.number_status | string |
number_status |
|
account_id
|
account_id | string |
account_id |
|
vendor_id
|
vendor_id | string |
vendor_id |
Uzyskiwanie stanu komunikatu
Uzyskiwanie stanu komunikatu przy użyciu identyfikatora komunikatu
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Unikatowy identyfikator tej wiadomości
|
messageId | True | string |
Unikatowy identyfikator tej wiadomości |
Zwraca
- Body
- message
Wysyłanie wiadomości sformatowanej (RCS)
Wysyłanie wiadomości sformatowanej (RCS)
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
Wyślij wiadomość SMS
Ta akcja służy do wysyłania wiadomości SMS do numeru telefonu komórkowego.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator nadawcy
|
source_number | string |
Określanie numeru źródłowego do użycia |
|
|
Numer docelowy
|
to | True | string |
Numer telefonu komórkowego odbiorcy w formacie E.164. Maksymalnie 100 adresatów oddzielonych spacją |
|
Message
|
message | True | string |
Treść wiadomości SMS |
|
Raport dostarczania
|
delivery_report | boolean |
Raporty dostarczania można zażądać za pomocą każdego komunikatu. Jeśli zażądano raportów dostarczania, element webhook zostanie przesłany do właściwości callback_url określonej dla komunikatu (lub do elementów webhook) |
|
|
Adres URL wywołania zwrotnego
|
callback_url | string |
Adres URL można dołączyć do każdego komunikatu, do którego będą wypychane elementy webhook za pośrednictwem żądania HTTP POST |
|
|
Klucz metadanych
|
metadata_key | string |
klucz metadanych |
|
|
Wartość metadanych
|
metadata_value | string |
wartość metadanych |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
messages
|
messages | array of object |
messages |
|
callback_url
|
messages.callback_url | string |
callback_url |
|
delivery_report
|
messages.delivery_report | boolean |
Raporty dostarczania można zażądać za pomocą każdego komunikatu. Jeśli zażądano raportów dostarczania, element webhook zostanie przesłany do właściwości callback_url określonej dla komunikatu (lub do elementów webhook) |
|
destination_number
|
messages.destination_number | string |
numer docelowy |
|
format
|
messages.format | string |
format |
|
message_expiry_timestamp
|
messages.message_expiry_timestamp | string |
znacznik czasu wygaśnięcia komunikatu |
|
message_flags
|
messages.message_flags | array of |
flagi komunikatów |
|
message_id
|
messages.message_id | string |
identyfikator wiadomości |
|
Źródło
|
messages.metadata.Source | string |
Źródło |
|
scheduled
|
messages.scheduled | string |
scheduled |
|
stan
|
messages.status | string |
stan |
|
zawartość
|
messages.content | string |
zawartość |
|
source_number
|
messages.source_number | string |
numer źródłowy |
|
multimedia
|
messages.media | array of string |
multimedia |
|
Temat
|
messages.subject | string |
Temat |
Wyzwalacze
| Po odebraniu potwierdzenia dostawy |
Ta operacja jest wyzwalana po otrzymaniu potwierdzenia dostarczenia dla wychodzącej wiadomości SMS. |
| Po odebraniu wiadomości SMS lub RCS |
Ta operacja jest wyzwalana po otrzymaniu przychodzącej wiadomości SMS. |
Po odebraniu potwierdzenia dostawy
Ta operacja jest wyzwalana po otrzymaniu potwierdzenia dostarczenia dla wychodzącej wiadomości SMS.
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
message_id
|
message_id | string |
Identyfikator oryginalnej wiadomości |
|
stan
|
status | string |
Raporty dostarczania wskazują stan komunikatu |
|
source_address
|
source_address | string |
adres źródłowy |
|
destination_address
|
destination_address | string |
adres docelowy |
|
zawartość
|
content | string |
zawartość |
|
typ
|
type | string |
typ |
|
delivery_report_id
|
delivery_report_id | string |
identyfikator raportu dostarczania |
|
status_code
|
status_code | string |
Kody stanu zapewniają bardziej szczegółowy wgląd w stan komunikatu |
|
submitted_date
|
submitted_date | string |
Sygnatura czasowa komunikatu |
|
date_received
|
date_received | string |
Sygnatura czasowa dostawcy |
|
Załączniki
|
attachments | array of object |
Załączniki |
|
Typ załącznika
|
attachments.attachment_type | string |
Typ załącznika |
|
Zawartość załącznika
|
attachments.attachment_content | string |
Zawartość załącznika |
|
Nazwa załącznika
|
attachments.attachment_name | string |
Nazwa załącznika |
|
Metadane
|
metadata | array of object |
Wszelkie metadane uwzględnione w oryginalnej wiadomości przesyłania |
|
Klucz metadanych
|
metadata.metadata_key | string |
Klucz metadanych |
|
Wartość metadanych
|
metadata.metadata_value | string |
Wartość metadanych |
Po odebraniu wiadomości SMS lub RCS
Ta operacja jest wyzwalana po otrzymaniu przychodzącej wiadomości SMS.
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
message_id
|
message_id | string |
Identyfikator oryginalnej wiadomości |
|
reply_id
|
reply_id | string |
Unikatowy identyfikator odpowiedzi reprezentowanej przez to powiadomienie |
|
stan
|
status | string |
Raporty dostarczania wskazują stan komunikatu |
|
source_address
|
source_address | string |
adres źródłowy |
|
destination_address
|
destination_address | string |
adres docelowy |
|
zawartość
|
content | string |
Zawartość odpowiedzi |
|
Zawartość wiadomości w wersji 2 — tekst
|
contact_message.text_message.text | string |
Zawartość wiadomości w wersji 2 — tekst |
|
typ
|
type | string |
typ |
|
status_code
|
status_code | string |
Kody stanu zapewniają bardziej szczegółowy wgląd w stan komunikatu |
|
submitted_date
|
submitted_date | string |
Sygnatura czasowa komunikatu |
|
date_received
|
date_received | string |
Sygnatura czasowa dostawcy |
|
Załączniki
|
attachments | array of object |
Lista zawierająca wszystkie załączniki, które zostały uwzględnione w odpowiedzi. To pole jest obecne tylko wtedy, gdy na twoim koncie włączono program MMS dla ruchu przychodzącego, a odpowiedź zawiera załączniki |
|
Typ załącznika
|
attachments.attachment_type | string |
Typ MIME skojarzony z tym załącznikiem |
|
Zawartość załącznika
|
attachments.attachment_content | string |
Kodowany załącznik Base64 |
|
Nazwa załącznika
|
attachments.attachment_name | string |
Nazwa załącznika |
|
Metadane
|
metadata | array of object |
Wszelkie metadane uwzględnione w oryginalnym żądaniu wiadomości przesyłania |
|
Klucz metadanych
|
metadata.metadata_key | string |
Klucz metadanych |
|
Wartość metadanych
|
metadata.metadata_value | string |
Wartość metadanych |
Definicje
komunikat
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
callback_url
|
callback_url | string |
Adres URL można dołączyć do każdego komunikatu, do którego będą wypychane elementy webhook za pośrednictwem żądania HTTP POST |
|
delivery_report
|
delivery_report | boolean |
Raporty dostarczania można zażądać za pomocą każdego komunikatu. Jeśli zażądano raportów dostarczania, element webhook zostanie przesłany do właściwości callback_url określonej dla komunikatu (lub do elementów webhook) |
|
destination_number
|
destination_number | string |
Numer docelowy, do którego powinien zostać dostarczony komunikat |
|
format
|
format | string |
Format określa, który format wiadomości będzie wysyłany jako, SMS (wiadomość SMS), MMS (wiadomość multimedialna) lub TTS (tekst na mowę) |
|
message_expiry_timestamp
|
message_expiry_timestamp | string |
Znacznik czasu wygaśnięcia komunikatu można podać, aby określić czas ostatniego dostarczenia komunikatu |
|
message_flags
|
message_flags | array of |
message_flags |
|
message_id
|
message_id | string |
Identyfikator wiadomości |
|
Źródło
|
metadata.Source | string |
Źródło |
|
scheduled
|
scheduled | string |
Zaplanowana data dostarczenia komunikatu |
|
stan
|
status | string |
Stan wiadomości |
|
zawartość
|
content | string |
zawartość |
|
source_number
|
source_number | string |
numer źródłowy |
|
multimedia
|
media | array of string |
multimedia |
|
Temat
|
subject | string |
Temat |