Sinch (Preview)
Sinch pomáhá vaší firmě spojit se se zákazníky prostřednictvím upozornění, připomenutí, pozvánek, marketingových kampaní a dalších. S využitím Sinch Engage, One NZ, Spark eTXT a 2Degrees poskytují naše platformy miliardy zpráv globálně. Pomocí tohoto konektoru můžete snadno integrovat SMS, RCS a MMS do pracovních postupů, streamování a automatizaci komunikace zákazníků.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate kromě následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logické aplikace | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Azure Government oblastí – Azure oblasti Čína - Ministerstvo obrany USA (DoD) |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Automatizace napájení | Premium | Všechny oblasti Power Automate kromě následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Název | Kanál podpory |
| URL | https://support.app.sinch.com/hc/en-us/articles/10765297401999-Contact-support |
| support-engage@app.sinch.com |
| Metadata konektoru | |
|---|---|
| Publisher | Sinch Švédsko AB |
| Internetová stránka | https://engage.sinch.com |
| Zásady ochrany osobních údajů | https://sinch.com/legal/privacy-notice/ |
| Kategorie | Communication |
Název konektoru
Sinch Engage
Dokumentace k rozhraní API
https://docs.app.api.sinch.com/
Podporované operace
Jak získat přihlašovací údaje
Tento konektor používá API Key a API secret ověřování (viz kroky v odkazech k získání tohoto konektoru). https://support.app.sinch.com/hc/en-us/articles/11098727231375-Creating-new-API-credentials
Podporované operace
Tento konektor podporuje následující operace:
-
Send Text Message (SMS): Odeslání textové zprávy (SMS) více mobilním příjemcům. -
Send Rich Text Message (RCS): Odešlete zprávu RCS mobilnímu příjemci. -
Send MMS Message (MMS): Odeslat multimediální zprávu (MMS) více příjemcům mobilního zařízení. -
Get sender IDs: Získejte seznam ID odesílatelů propojených s vaším účtem. -
Get message status: Získání stavu zprávy pomocí ID zprávy. -
When a message is received: Tato operace se aktivuje, když obdržíte příchozí zprávu (SMS, RCS, MMS). -
When delivery receipt is received: Tato operace se aktivuje, když obdržíte potvrzení o doručení odchozí zprávy (SMS, RCS, MMS).
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| výchozí | Parametry pro vytvoření připojení | Všechny oblasti | Nesdílitelné |
Výchozí
Použitelné: Všechny oblasti
Parametry pro vytvoření připojení
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| klíč API | securestring | Api_key pro toto rozhraní API | Pravdivé |
| api_secret | securestring | Api_secret pro toto rozhraní API | Pravdivé |
| Služby Sinch | řetězec | Toto je rozhraní API, ke kterému se připojujete, zvolte jednu z následujících možností: Sinch MessageMedia (nejlepší pro účty specifické pro Asii); Zapojení sinchu (nejlepší pro Evropu, účty USA) | Pravdivé |
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 100 | 60 sekund |
Akce
| Odeslat textovou zprávu (SMS) |
Odeslat textovou zprávu (SMS) více mobilním příjemcům |
| Odeslat zprávu MMS |
Tato akce slouží k odeslání multimediální zprávy (MMS) na číslo mobilního zařízení. |
| Odeslat zprávu s formátem RTF (RCS) |
Odeslat zprávu RCS mobilnímu příjemci |
| Získání ID odesílatele |
Získejte seznam ID odesílatelů propojených s vaším účtem. |
| Získání stavu zprávy |
Získání stavu zprávy pomocí ID zprávy |
Odeslat textovou zprávu (SMS)
Odeslat textovou zprávu (SMS) více mobilním příjemcům
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID odesílatele
|
source_number | string |
Zadejte zdrojové číslo, které se má použít. |
|
|
Cílové číslo
|
to | True | string |
Mobilní číslo příjemce ve formátu E.164 Maximálně 100 příjemců oddělených mezerou |
|
Message
|
message | True | string |
Text zprávy SMS |
|
Zpráva o doručení
|
delivery_report | boolean |
Zprávy o doručení je možné vyžádat s každou zprávou. Pokud jsou požadovány zprávy o doručení, webhook se odešle do vlastnosti callback_url určené pro zprávu (nebo do webhooků). |
|
|
Adresa URL zpětného volání
|
callback_url | string |
Adresu URL je možné zahrnout do každé zprávy, do které se webhooky budou odesílat prostřednictvím požadavku HTTP POST. |
|
|
Klíč metadat
|
metadata_key | string |
klíč metadat |
|
|
Hodnota metadat
|
metadata_value | string |
hodnota metadat |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
messages
|
messages | array of object |
messages |
|
callback_url
|
messages.callback_url | string |
callback_url |
|
delivery_report
|
messages.delivery_report | boolean |
Zprávy o doručení je možné vyžádat s každou zprávou. Pokud jsou požadovány zprávy o doručení, webhook se odešle do vlastnosti callback_url určené pro zprávu (nebo do webhooků). |
|
destination_number
|
messages.destination_number | string |
cílové číslo |
|
format
|
messages.format | string |
format |
|
message_expiry_timestamp
|
messages.message_expiry_timestamp | string |
časové razítko vypršení platnosti zprávy |
|
message_flags
|
messages.message_flags | array of |
příznaky zprávy |
|
message_id
|
messages.message_id | string |
ID zprávy |
|
Zdroj
|
messages.metadata.Source | string |
Zdroj |
|
scheduled
|
messages.scheduled | string |
scheduled |
|
stav
|
messages.status | string |
stav |
|
obsah
|
messages.content | string |
obsah |
|
source_number
|
messages.source_number | string |
zdrojové číslo |
|
média
|
messages.media | array of string |
média |
|
předmět
|
messages.subject | string |
předmět |
Odeslat zprávu MMS
Tato akce slouží k odeslání multimediální zprávy (MMS) na číslo mobilního zařízení.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Cílové číslo
|
to | True | string |
Mobilní číslo příjemce ve formátu E.164 Maximálně 100 příjemců oddělených mezerou |
|
Message
|
message | True | string |
Text zprávy MMS |
|
Mediální obsah
|
media | byte |
Mediální obsah, který se má zahrnout do zprávy MMS, kódovaný jako řetězec Base64. Mezi podporované typy médií patří obrázky (JPEG, PNG, GIF), videa (MP4) a zvukové soubory (MP3). Maximální velikost souboru pro každou přílohu médií je 600 kB. |
|
|
ID odesílatele
|
source_number | string |
Zadejte zdrojové číslo podporující MMS, které se má použít. |
|
|
Klíč metadat
|
metadata_key | string |
Klíč metadat |
|
|
Hodnota metadat
|
metadata_value | string |
Hodnota metadat |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
messages
|
messages | array of object |
messages |
|
callback_url
|
messages.callback_url | string |
callback_url |
|
delivery_report
|
messages.delivery_report | boolean |
Zprávy o doručení je možné vyžádat s každou zprávou. |
|
destination_number
|
messages.destination_number | string |
cílové číslo |
|
format
|
messages.format | string |
format |
|
message_expiry_timestamp
|
messages.message_expiry_timestamp | string |
časové razítko vypršení platnosti zprávy |
|
message_id
|
messages.message_id | string |
ID zprávy |
|
Zdroj
|
messages.metadata.Source | string |
Zdroj |
|
scheduled
|
messages.scheduled | string |
scheduled |
|
stav
|
messages.status | string |
stav |
|
obsah
|
messages.content | string |
obsah |
|
source_number
|
messages.source_number | string |
zdrojové číslo |
|
média
|
messages.media | array of string |
média |
|
předmět
|
messages.subject | string |
předmět |
Odeslat zprávu s formátem RTF (RCS)
Odeslat zprávu RCS mobilnímu příjemci
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
Získání ID odesílatele
Získejte seznam ID odesílatelů propojených s vaším účtem.
Návraty
| Name | Cesta | Typ | 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 |
|
typ
|
default_sender.type | string |
typ |
|
číslo
|
default_sender.number | string |
číslo |
|
source_type
|
default_sender.source_type | string |
source_type |
|
mms_capable
|
default_sender.mms_capable | boolean |
mms_capable |
|
odesílatelé
|
senders | array of object |
odesílatelé |
|
display_type
|
senders.display_type | string |
display_type |
|
is_default
|
senders.is_default | boolean |
is_default |
|
jmenovka
|
senders.label | string |
jmenovka |
|
mms_capable
|
senders.mms_capable | boolean |
mms_capable |
|
číslo
|
senders.number | string |
číslo |
|
display_name
|
senders.display_name | string |
Formátovaný zobrazovaný název odesílatele |
|
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 |
Získání stavu zprávy
Získání stavu zprávy pomocí ID zprávy
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Jedinečné ID této zprávy
|
messageId | True | string |
Jedinečné ID této zprávy |
Návraty
- Body
- message
Aktivační události
| Při přijetí potvrzení o doručení |
Tato operace se aktivuje, když obdržíte potvrzení o doručení odchozí zprávy (SMS, RCS, MMS). |
| Při přijetí zprávy |
Tato operace se aktivuje při příjmu příchozí zprávy (SMS, RCS, MMS). |
Při přijetí potvrzení o doručení
Tato operace se aktivuje, když obdržíte potvrzení o doručení odchozí zprávy (SMS, RCS, MMS).
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
message_id
|
message_id | string |
ID původní zprávy |
|
stav
|
status | string |
Zprávy o doručení označují stav zprávy |
|
source_address
|
source_address | string |
zdrojová adresa |
|
destination_address
|
destination_address | string |
cílová adresa |
|
obsah
|
content | string |
obsah |
|
typ
|
type | string |
typ |
|
delivery_report_id
|
delivery_report_id | string |
ID zprávy o doručení |
|
status_code
|
status_code | string |
Stavové kódy poskytují podrobnější přehled o stavu zprávy. |
|
submitted_date
|
submitted_date | string |
Časové razítko zprávy |
|
date_received
|
date_received | string |
Časové razítko zprostředkovatele |
|
Attachments
|
attachments | array of object |
Attachments |
|
Typ přílohy
|
attachments.attachment_type | string |
Typ přílohy |
|
Obsah přílohy
|
attachments.attachment_content | string |
Obsah přílohy |
|
Název přílohy
|
attachments.attachment_name | string |
Název přílohy |
|
Metadatové informace
|
metadata | array of object |
Všechna metadata obsažená v původní zprávě pro odeslání |
|
Klíč metadat
|
metadata.metadata_key | string |
Klíč metadat |
|
Hodnota metadat
|
metadata.metadata_value | string |
Hodnota metadat |
Při přijetí zprávy
Tato operace se aktivuje při příjmu příchozí zprávy (SMS, RCS, MMS).
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
message_id
|
message_id | string |
ID původní zprávy |
|
reply_id
|
reply_id | string |
Jedinečné ID odpovědi, kterou toto oznámení představuje |
|
stav
|
status | string |
Zprávy o doručení označují stav zprávy |
|
source_address
|
source_address | string |
zdrojová adresa |
|
destination_address
|
destination_address | string |
cílová adresa |
|
obsah
|
content | string |
Obsah odpovědi |
|
Obsah zprávy V2 – text
|
contact_message.text_message.text | string |
Obsah zprávy V2 – text |
|
typ
|
type | string |
typ |
|
status_code
|
status_code | string |
Stavové kódy poskytují podrobnější přehled o stavu zprávy. |
|
submitted_date
|
submitted_date | string |
Časové razítko zprávy |
|
date_received
|
date_received | string |
Časové razítko zprostředkovatele |
|
Attachments
|
attachments | array of object |
Seznam obsahující všechny přílohy, které byly součástí odpovědi. Toto pole se nachází jenom v případě, že jste ve svém účtu povolili příchozí MMS a odpověď obsahuje přílohy. |
|
Typ přílohy
|
attachments.attachment_type | string |
Typ MIME přidružený k této příloze |
|
Obsah přílohy
|
attachments.attachment_content | string |
Zakódovaná příloha Base64 |
|
Název přílohy
|
attachments.attachment_name | string |
Název přílohy |
|
Metadatové informace
|
metadata | array of object |
Všechna metadata, která byla zahrnuta v původní žádosti o odeslání zprávy |
|
Klíč metadat
|
metadata.metadata_key | string |
Klíč metadat |
|
Hodnota metadat
|
metadata.metadata_value | string |
Hodnota metadat |
Definice
zpráva
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
callback_url
|
callback_url | string |
Adresu URL je možné zahrnout do každé zprávy, do které se webhooky budou odesílat prostřednictvím požadavku HTTP POST. |
|
delivery_report
|
delivery_report | boolean |
Zprávy o doručení je možné vyžádat s každou zprávou. Pokud jsou požadovány zprávy o doručení, webhook se odešle do vlastnosti callback_url určené pro zprávu (nebo do webhooků). |
|
destination_number
|
destination_number | string |
Cílové číslo zprávy by mělo být doručeno do |
|
format
|
format | string |
Formát určuje, který formát bude zpráva odeslána jako SMS (textová zpráva), MMS (multimediální zpráva) nebo TTS (text na řeč). |
|
message_expiry_timestamp
|
message_expiry_timestamp | string |
Časové razítko vypršení platnosti zprávy lze zadat k zadání nejnovějšího času, kdy má být zpráva doručena. |
|
message_flags
|
message_flags | array of |
message_flags |
|
message_id
|
message_id | string |
ID zprávy |
|
Zdroj
|
metadata.Source | string |
Zdroj |
|
scheduled
|
scheduled | string |
Plánované datum doručení zprávy |
|
stav
|
status | string |
Stav zprávy |
|
obsah
|
content | string |
obsah |
|
source_number
|
source_number | string |
zdrojové číslo |
|
média
|
media | array of string |
média |
|
předmět
|
subject | string |
předmět |