Sdílet prostřednictvím

SmartDialog

SmartDialog je platforma, která slouží k odesílání a přijímání zpráv SMS a WhatsApp. Nabízí širokou škálu služeb inteligentního zasílání zpráv.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate 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)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure Government
     – Oblasti Azure China
     - 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)
Power Automate Premium Všechny oblasti Power Automate 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)
Kontakt
Název Aréna Interactive Support
URL https://www.arenainteractive.fi/contact
Email support@arenainteractive.fi
Metadata konektoru
Vydavatel Arena Interactive Oy
Internetová stránka https://www.arenainteractive.fi
Zásady ochrany osobních údajů https://www.arenainteractive.fi/privacypolicy
Kategorie Komunikace; Spolupráce

Konektor SmartDialog

Tento konektor lze použít k odesílání a přijímání zpráv SMS pomocí platformy SmartDialog.

Požadavky

  1. Předplatné a účet SmartDialog. Obraťte se prosím na sales@arenainteractive.fi
  2. Pro váš účet je potřeba povolit OAuth a je potřeba požádat o tajný klíč klienta. Můžete to udělat tak, že nám pošlete e-mail na adresu support@arenainteractive.fi.

Nastavení

  1. Postupujte podle pokynů v tématu Vytvoření vlastního konektoru z definice OpenAPI.
  2. Vytvořte tok nebo PowerApp a přidejte akci SmartDialogu z vlastního oddílu. Přihlaste se pomocí účtu SmartDialog.

Podporované akce

  • Nová zpráva (trigger pro příjem zpráv)
  • Odeslat zprávu
  • Odeslat zprávu WhatsApp
  • Odeslat zprávu odpovědi na diskuzi
  • Odeslat zprávu odpovědi
  • WhatsApp Opt In
  • WhatsApp Opt Out
  • Vytvoření šablony WhatsApp
  • Získání skupinového kontaktu
  • Vytvoření skupinového kontaktu
  • Aktualizovat kontakt skupiny
  • Odstranit kontakt skupiny
  • Odstranit všechny kontakty skupiny

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Aktualizovat kontakt skupiny

Aktualizovat kontakt skupiny
Odeslat zprávu

Odeslání zprávy příjemcům
Odeslat zprávu odpovědi

Odeslání zprávy Replymessage příjemcům
Odeslat zprávu odpovědi na diskuzi

Odeslání zprávy s odpovědí na diskuzi příjemcům
Odeslat zprávu WhatsApp

Odeslat zprávu šablony WhatsApp.
Odstranit kontakt skupiny

Odstraňte kontakt skupiny pomocí telefonního čísla.
Odstranit všechny kontakty skupiny

Odstranit všechny kontakty skupiny
Opt In WhatsApp (zastaralé) [ZASTARALÉ]

WhatsApp Opt In for sender and recipient. (zastaralé)
Vytvoření skupinového kontaktu

Vytvoření skupinového kontaktu
Vytvoření šablony WhatsApp

Vytvořte novou šablonu WhatsApp.
WhatsApp Opt Out (zastaralé) [ZASTARALÉ]

WhatsApp Opt Out for sender and recipient. (zastaralé)
Získání skupinového kontaktu

Získání skupinového kontaktu

Aktualizovat kontakt skupiny

ID operace:
UpdateGroupContact

Aktualizovat kontakt skupiny

Parametry

Name Klíč Vyžadováno Typ Description
Zákazník
 Customer True string

Zákazník, pro který chce načíst služby skupiny.
Group Service
 Group Service True string

Skupinaová služba, která se má použít.
telefon
 Phone True string

Telefonní číslo kontaktu, který se má aktualizovat.
Aktivní
 active boolean

Příznak označující, jestli je kontakt aktivní.
Email
 email string

E-mailová adresa kontaktu.
Jméno
 firstName string

Jméno kontaktu.
Příjmení
 lastName string

Příjmení kontaktu.
Pohlaví
 gender string

Pohlaví kontaktu.
Rok narození
 birthYear integer

Rok narození kontaktu.
Adresa ulice
 streetAddress string

Adresa ulice kontaktu.
PSČ
 zipCode string

PSČ kontaktu.
City
 city string

Město kontaktu.
Kód země
 countryCode string

3-letter country code of the Contact.
Název
 name string

Název vlastnosti vlastního kontaktu.
Hodnota
 value string

Hodnota vlastnosti vlastního kontaktu
Oblasti telefonního čísla
 phoneNumberRegions array of string

Oblasti telefonního čísla, které se mají použít k analýze čísel. Ve výchozím nastavení je Finsko prázdné.

Návraty

response
boolean

Odeslat zprávu

ID operace:
SendMessage

Odeslání zprávy příjemcům

Parametry

Name Klíč Vyžadováno Typ Description
Zákazník
 Customer-Id True string

Zákazník, který se má použít k odesílání.
Service
 Service-Id True string

Služba, která se má použít k odesílání.
Odesílatel zprávy
 Sender True string

Odesílatel zprávy může být alfanumerický, dlouhý kód nebo krátký kód (platí omezení).
Obsah zprávy
 Content True string

Obsah zprávy.
Protokol zpráv
 Protocol True string

Protokol, který se má použít k odeslání zprávy.
Odeslat datum a čas
 SendDateTime date-time

Datum a čas odeslání zprávy. Okamžité odeslání ponechte prázdné.
Address
 Address True string

Adresa příjemce zprávy
Identifikátor URI přílohy
 AttachmentUri string

Identifikátor URI přílohy, který se má použít při odesílání zprávy WhatsApp obsahující přílohu.
Zákaznická data
 CustomerData string

Fakturační nebo seskupovací data pro tuto zprávu, volitelná.
Zpráva o reklamě
 AdMessage boolean

Volitelný příznak přepsání pro označení zprávy jako reklamní zprávy
Dlr Url
 DlrUrl string

Adresa URL zpětného volání stavu doručení prostřednictvím http-get Do adresy URL můžete přidat hodnoty řetězce dotazu, které se zachovají.
ID požadavku
 RequestId string

Volitelné jedinečné ID požadavku, které lze použít k identifikaci duplicitních požadavků. Pokud se zjistí id duplicitní žádosti, odesílání se zruší. Není zaručeno, že požadavky s duplicitními ID požadavků budou zablokované v situacích s vysokou propustností a provozem. Dané ID požadavku se "zapamatuje" po dobu 7 dnů.

Návraty

Name Cesta Typ Description
ID zprávy
 MessageId string

Nově vytvořený identifikátor zprávy
Počet částí zprávy
 MessagePartCount integer

Přibližný počet částí zprávy pro tuto zprávu
Příjemci
 Recipients array of object

Příjemci
Adresa příjemce
 Recipients.Address string

Adresa příjemce (telefonní číslo, e-mail, ID uživatele atd.).
ID příjemce
 Recipients.Id string

Identifikátor příjemce použitý pro příjem informací o stavu doručení.

Odeslat zprávu odpovědi

ID operace:
SendReplyMessage

Odeslání zprávy Replymessage příjemcům

Parametry

Name Klíč Vyžadováno Typ Description
ParentMessage Id
 ParentMessageId True string

ID nadřazené zprávy, na které chcete odpovědět.
Zákazník
 Customer-Id True string

Zákazník, který se má použít k odesílání.
Service
 Service-Id True string

Služba, která se má použít k odesílání.
Odesílatel zprávy
 Sender True string

Odesílatel zprávy může být alfanumerický, dlouhý kód nebo krátký kód (platí omezení).
Obsah zprávy
 Content True string

Obsah zprávy.
Protokol zpráv
 Protocol True string

Protokol, který se má použít k odeslání zprávy.
Odeslat datum a čas
 SendDateTime date-time

Datum a čas odeslání zprávy. Okamžité odeslání ponechte prázdné.
Address
 Address True string

Adresa příjemce zprávy
Identifikátor URI přílohy
 AttachmentUri string

Identifikátor URI přílohy, který se má použít při odesílání zprávy WhatsApp obsahující přílohu.
Zákaznická data
 CustomerData string

Fakturační nebo seskupovací data pro tuto zprávu, volitelná.
Zpráva o reklamě
 AdMessage boolean

Volitelný příznak přepsání pro označení zprávy jako reklamní zprávy
Dlr Url
 DlrUrl string

Adresa URL zpětného volání stavu doručení prostřednictvím http-get Do adresy URL můžete přidat hodnoty řetězce dotazu, které se zachovají.
ID požadavku
 RequestId string

Volitelné jedinečné ID požadavku, které lze použít k identifikaci duplicitních požadavků. Pokud se zjistí id duplicitní žádosti, odesílání se zruší. Není zaručeno, že požadavky s duplicitními ID požadavků budou zablokované v situacích s vysokou propustností a provozem. Dané ID požadavku se "zapamatuje" po dobu 7 dnů.

Návraty

Name Cesta Typ Description
ID zprávy
 MessageId string

Nově vytvořený identifikátor zprávy
Počet částí zprávy
 MessagePartCount integer

Přibližný počet částí zprávy pro tuto zprávu
Příjemci
 Recipients array of object

Příjemci
Adresa příjemce
 Recipients.Address string

Adresa příjemce (telefonní číslo, e-mail, ID uživatele atd.).
ID příjemce
 Recipients.Id string

Identifikátor příjemce použitý pro příjem informací o stavu doručení.

Odeslat zprávu odpovědi na diskuzi

ID operace:
SendDiscussionReplyMessage

Odeslání zprávy s odpovědí na diskuzi příjemcům

Parametry

Name Klíč Vyžadováno Typ Description
Zákazník
 CustomerId True string

Zákazník, který se má použít k odesílání.
ID vlákna
 ThreadId True string

ID existujícího vlákna pro odpověď.
Obsah zprávy
 Content True string

Obsah zprávy.
Zákaznická data
 CustomerData string

Fakturační nebo seskupovací data pro tuto zprávu, volitelná.

Návraty

Name Cesta Typ Description
ID zprávy
 MessageId string

Nově vytvořený identifikátor zprávy
Počet částí zprávy
 MessagePartCount integer

Přibližný počet částí zprávy pro tuto zprávu
Příjemci
 Recipients array of object

Příjemci
Adresa příjemce
 Recipients.Address string

Adresa příjemce (telefonní číslo, e-mail, ID uživatele atd.).
ID příjemce
 Recipients.Id string

Identifikátor příjemce použitý pro příjem informací o stavu doručení.
ThreadId
 ThreadId string

Identifikátor vlákna, do kterého byla zpráva odeslána.

Odeslat zprávu WhatsApp

ID operace:
SendWhatsappTemplateMessage

Odeslat zprávu šablony WhatsApp.

Parametry

Name Klíč Vyžadováno Typ Description
Zákazník
 Customer-Id True string

Zákazník, který se má použít k odesílání.
Service
 Service-Id True string

Služba, která se má použít k odesílání.
Šablona WhatsApp
 TemplateName True string

Šablona, která se má použít k odesílání.
Address
 Address True string

Adresa příjemce zprávy
BodyParameters
 BodyParameters array of string

BodyParameters
HeaderParameters
 HeaderParameters array of string

HeaderParameters
Typ
 Type string

Typ tlačítka. Pro každou šablonu může obsahovat pouze jeden typ, který může obsahovat více stejných typů.
Text
 Data string

Text tlačítka.
Odeslat datum a čas
 SendDateTime string

Datum a čas odeslání zprávy. Okamžité odeslání ponechte prázdné.
Identifikátor URI přílohy
 AttachmentUri string

Identifikátor URI přílohy, pokud šablona obsahuje přílohu.
Použití náhradní služby SMS
 UseSmsFallback boolean

Měla by být sms použita jako záložní.
Dlr Url
 DlrUrl string

Adresa URL zprávy o doručení, která obdrží zpětné volání po dokončení sendprocesu.
Zákaznická data
 CustomerData string

Fakturační nebo seskupovací data pro tuto zprávu, volitelná.
ID požadavku
 RequestId string

Volitelné jedinečné ID požadavku, které lze použít k identifikaci duplicitních požadavků. Pokud se zjistí id duplicitní žádosti, odesílání se zruší. Není zaručeno, že požadavky s duplicitními ID požadavků budou zablokované v situacích s vysokou propustností a provozem. Dané ID požadavku se "zapamatuje" po dobu 7 dnů.

Návraty

Name Cesta Typ Description
ID zprávy
 messageId string

Nově vytvořený identifikátor zprávy
Počet částí zprávy
 messagePartCount integer

Přibližný počet částí zprávy pro tuto zprávu
recipients
 recipients array of object

recipients
Adresa příjemce
 recipients.address string

Adresa příjemce (telefonní číslo, e-mail, ID uživatele atd.).
ID příjemce
 recipients.id string

Identifikátor příjemce použitý pro příjem informací o stavu doručení.

Odstranit kontakt skupiny

ID operace:
DeleteGroupContact

Odstraňte kontakt skupiny pomocí telefonního čísla.

Parametry

Name Klíč Vyžadováno Typ Description
Zákazník
 Customer True string

Zákazník, pro který chce načíst služby skupiny.
Group Service
 Group Service True string

Skupinaová služba, která se má použít.
telefon
 Phone True string

Telefonní číslo kontaktu, který chcete odstranit.

Návraty

response
boolean

Odstranit všechny kontakty skupiny

ID operace:
DeleteAllGroupContacts

Odstranit všechny kontakty skupiny

Parametry

Name Klíč Vyžadováno Typ Description
Zákazník
 Customer True string

Zákazník, pro který chce načíst služby skupiny.
Group Service
 Group Service True string

Skupinaová služba, která se má použít.

Návraty

response
boolean

Opt In WhatsApp (zastaralé) [ZASTARALÉ]

ID operace:
WhatsAppOptIn

WhatsApp Opt In for sender and recipient. (zastaralé)

Parametry

Name Klíč Vyžadováno Typ Description
Adresa odesílatele
 Sender True string

Zaregistrovali jsme číslo identity Whatsapp, ke které se chcete přihlásit.
Adresa příjemce
 Recipient True string

Číslo příjemce, které se má přihlásit.

Vytvoření skupinového kontaktu

ID operace:
CreateGroupContact

Vytvoření skupinového kontaktu

Parametry

Name Klíč Vyžadováno Typ Description
Zákazník
 Customer True string

Zákazník, pro který chce načíst služby skupiny.
Group Service
 Group Service True string

Skupinaová služba, která se má použít.
Aktivní
 active boolean

Příznak označující, jestli je kontakt aktivní.
telefon
 phone True string

Telefonní číslo kontaktu.
Email
 email string

E-mailová adresa kontaktu.
Jméno
 firstName string

Jméno kontaktu.
Příjmení
 lastName string

Příjmení kontaktu.
Pohlaví
 gender string

Pohlaví kontaktu.
Rok narození
 birthYear integer

Rok narození kontaktu.
Adresa ulice
 streetAddress string

Adresa ulice kontaktu.
PSČ
 zipCode string

PSČ kontaktu.
City
 city string

Město kontaktu.
Kód země
 countryCode string

3-letter country code of the Contact.
Název
 name string

Název vlastní vlastnosti.
Hodnota
 value string

Vlastní hodnota vlastnosti.
Oblasti telefonního čísla
 phoneNumberRegions array of string

Oblasti telefonního čísla, které se mají použít k analýze čísel. Ve výchozím nastavení je Finsko prázdné.

Návraty

Jedinečné ID vytvořeného kontaktu

ID kontaktu
uuid

Vytvoření šablony WhatsApp

ID operace:
CreateWhatsappTemplate

Vytvořte novou šablonu WhatsApp.

Parametry

Name Klíč Vyžadováno Typ Description
Zákazník
 Customer-Id True string

Zákazník vytvoří šablonu pro.
Číslo identity
 IdentityNumber True string

WhatsApp IdentityNumber použité pro šablonu.
Zobrazované jméno
 DisplayName True string

Zobrazovaný název šablony
Content
 RawContent True string

Obsah šablony
Kategorie šablony
 Category True string

Kategorie šablony
Jazyk šablony
 Language True string

2znakový kód pro jazyk šablony.
Typ tlačítka
 Type string

Typ tlačítka.
Popisek tlačítka
 Label string

Popisek tlačítka
Data tlačítka
 Data string

Data tlačítka. Adresa URL (Url), telefonní číslo (hovor) nebo text (QuickReply). Maximální délka je 2000 pro adresu URL a 20 pro telefonní číslo a text.
Adresa URL přílohy
 AttachmentUrl string

Adresa URL ukázkové přílohy

WhatsApp Opt Out (zastaralé) [ZASTARALÉ]

ID operace:
WhatsAppOptOut

WhatsApp Opt Out for sender and recipient. (zastaralé)

Parametry

Name Klíč Vyžadováno Typ Description
Adresa odesílatele
 Sender True string

Zaregistrované číslo identity Whatsapp pro odhlášení.
Adresa příjemce
 Recipient True string

Číslo receptu, které se má odebrat z výslovného souhlasu.

Získání skupinového kontaktu

ID operace:
GetGroupContact

Získání skupinového kontaktu

Parametry

Name Klíč Vyžadováno Typ Description
Zákazník
 Customer True string

Zákazník, pro který chce načíst služby skupiny.
Group Service
 Group Service True string

Skupinaová služba, která se má použít.
telefon
 Phone True string

Telefonní číslo kontaktu.
Región
 Region string

Volitelná oblast Telefonní číslo, která se má použít k analýze telefonního čísla.

Návraty

Name Cesta Typ Description
telefon
 phone string

Telefonní číslo kontaktu.
Email
 email string

E-mailová adresa kontaktu.
Jméno
 firstName string

Jméno kontaktu.
Příjmení
 lastName string

Příjmení kontaktu.
Pohlaví
 gender string

Pohlaví kontaktu.
Rok narození
 birthYear integer

Rok narození kontaktu.
Adresa ulice
 streetAddress string

Adresa ulice kontaktu.
PSČ
 zipCode string

PSČ kontaktu.
City
 city string

Město kontaktu.
Kód země
 countryCode string

Kód země kontaktu.
Neúspěšné zprávy
 failedMessages integer

Počet neúspěšných zpráv kontaktu
Vlastní vlastnosti
 customContactProperties array of object

Vlastní kolekce vlastností kontaktu uložená pro kontakt.
Název
 customContactProperties.name string

Název vlastnosti vlastního kontaktu.
Hodnota
 customContactProperties.value string

Hodnota vlastnosti vlastního kontaktu

Aktivační události

Nová zpráva

Když dorazí nová zpráva do 2cestné služby.

Nová zpráva

ID operace:
NewMessage

Když dorazí nová zpráva do 2cestné služby.

Parametry

Name Klíč Vyžadováno Typ Description
Zákazník
 Customer True string

Zákazník, který se má použít.
Service
 Service True string

2cestná služba, která se má použít.

Návraty

Name Cesta Typ Description
Odesílatel zprávy
 sender string

Odesílatel zprávy.
Příjemce zprávy
 recipient string

Příjemce zprávy.
Obsah zprávy
 content string

Obsah přijaté zprávy.
Časové razítko zprávy
 timestamp date-time

Časové razítko zprávy.
Protokol zpráv
 protocol string

Protokol přijaté zprávy.
attachments
 attachments array of object

attachments
Název souboru přílohy
 attachments.name string

Název souboru přílohy.
Typ MIME přílohy
 attachments.mimeType string

Typ MIME přílohy.
Umístění zdroje přílohy
 attachments.resourceLocation string

Umístění prostředku přílohy.
ID zprávy
 messageId string

Jedinečné ID přijaté zprávy.

Definice

Univerzální jednoznačný identifikátor (UUID)

Jedinečné ID vytvořeného kontaktu

Jedinečné ID vytvořeného kontaktu

ID kontaktu
uuid

Boolean

Toto je základní datový typ logická hodnota.