Udostępnij przez


SmartDialog

SmartDialog to platforma służąca do wysyłania i odbierania wiadomości SMS- i WhatsApp. Oferuje szeroką gamę usług inteligentnego przesyłania komunikató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 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 Interaktywna pomoc techniczna arena
adres URL https://www.arenainteractive.fi/contact
Email support@arenainteractive.fi
Metadane łącznika
Publisher Arena Interactive Oy
Witryna internetowa https://www.arenainteractive.fi
Zasady ochrony prywatności https://www.arenainteractive.fi/privacypolicy
Kategorie Komunikacja; Kolaboracja

Łącznik SmartDialog

Ten łącznik może służyć do wysyłania i odbierania wiadomości SMS przy użyciu platformy SmartDialog.

Wymagania wstępne

  1. Subskrypcja i konto SmartDialog. Skontaktuj się z sales@arenainteractive.fi
  2. Dla konta należy włączyć uwierzytelnianie OAuth, a należy zażądać wpisu tajnego klienta. Można to zrobić, wysyłając nam wiadomość e-mail pod adresem support@arenainteractive.fi.

Konfiguracja

  1. Postępuj zgodnie z instrukcjami w temacie Tworzenie łącznika niestandardowego na podstawie definicji interfejsu OpenAPI.
  2. Utwórz przepływ lub usługę PowerApp i dodaj akcję SmartDialog z sekcji niestandardowej. Zaloguj się przy użyciu konta SmartDialog.

Obsługiwane akcje

  • Nowy komunikat (wyzwalacz odbierania komunikatów)
  • Wyślij wiadomość
  • Wyślij wiadomość WhatsApp
  • Wyślij wiadomość z odpowiedzią na dyskusję
  • Wyślij wiadomość odpowiedzi
  • WhatsApp — zgoda
  • WhatsApp — rezygnacja
  • Tworzenie szablonu WhatsApp
  • Uzyskiwanie kontaktu z grupą
  • Utwórz kontakt grupy
  • Aktualizuj kontakt grupy
  • Usuń kontakt grupy
  • Usuń wszystkie kontakty grupy

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Aktualizuj kontakt grupy

Aktualizuj kontakt grupy

Tworzenie kontaktu grupy

Tworzenie kontaktu grupy

Tworzenie szablonu WhatsApp

Utwórz nowy szablon WhatsApp.

Usuń kontakt grupy

Usuń kontakt grupy przy użyciu numeru telefonu.

Usuń wszystkie kontakty grupy

Usuń wszystkie kontakty grupy

Uzyskiwanie kontaktu z grupą

Uzyskiwanie kontaktu z grupą

WhatsApp Opt In (przestarzałe) [PRZESTARZAŁE]

WhatsApp Opt In dla nadawcy i odbiorcy. (przestarzałe)

WhatsApp — rezygnacja (przestarzała) [PRZESTARZAŁE]

WhatsApp zrezygnował z nadawcy i odbiorcy. (przestarzałe)

Wyślij wiadomość

Wyślij wiadomość do adresatów.

Wyślij wiadomość odpowiedzi

Wyślij wiadomość zwrotną do adresatów.

Wyślij wiadomość WhatsApp

Wyślij wiadomość szablonu WhatsApp.

Wyślij wiadomość z odpowiedzią na dyskusję

Wyślij wiadomość odpowiedzi dyskusji do adresatów.

Aktualizuj kontakt grupy

Aktualizuj kontakt grupy

Parametry

Nazwa Klucz Wymagane Typ Opis
Klient
Customer True string

Klient pobiera usługi grupy.

Usługa grupy
Group Service True string

Usługa grupy do użycia.

Telefon
Phone True string

Numer telefonu kontaktu do zaktualizowania.

Aktywna
active boolean

Flaga wskazująca, czy kontakt jest aktywny.

Email
email string

Adres e-mail kontaktu.

Imię
firstName string

Imię kontaktu.

Nazwisko
lastName string

Nazwisko kontaktu.

Gender
gender string

Płeć kontaktu.

Rok urodzenia
birthYear integer

Rok urodzenia kontaktu.

Adres ulicy
streetAddress string

Adres ulicy kontaktu.

Kod pocztowy
zipCode string

Kod pocztowy kontaktu.

Miejscowość
city string

Miasto kontaktu.

Kod kraju
countryCode string

3-literowy kod kraju kontaktu.

Name
name string

Niestandardowa nazwa właściwości kontaktu.

Wartość
value string

Niestandardowa wartość właściwości kontaktu.

Regiony numer telefonu
phoneNumberRegions array of string

Regiony numerów telefonów do użycia do analizowania numerów. Wartość domyślna to Finlandia, jeśli pozostanie pusta.

Zwraca

response
boolean

Tworzenie kontaktu grupy

Tworzenie kontaktu grupy

Parametry

Nazwa Klucz Wymagane Typ Opis
Klient
Customer True string

Klient pobiera usługi grupy.

Usługa grupy
Group Service True string

Usługa grupy do użycia.

Aktywna
active boolean

Flaga wskazująca, czy kontakt jest aktywny.

Telefon
phone True string

Numer telefonu kontaktu.

Email
email string

Adres e-mail kontaktu.

Imię
firstName string

Imię kontaktu.

Nazwisko
lastName string

Nazwisko kontaktu.

Gender
gender string

Płeć kontaktu.

Rok urodzenia
birthYear integer

Rok urodzenia kontaktu.

Adres ulicy
streetAddress string

Adres ulicy kontaktu.

Kod pocztowy
zipCode string

Kod pocztowy kontaktu.

Miejscowość
city string

Miasto kontaktu.

Kod kraju
countryCode string

3-literowy kod kraju kontaktu.

Name
name string

Nazwa właściwości niestandardowej.

Wartość
value string

Wartość właściwości niestandardowej.

Regiony numer telefonu
phoneNumberRegions array of string

Regiony numerów telefonów do użycia do analizowania numerów. Wartość domyślna to Finlandia, jeśli pozostanie pusta.

Zwraca

Unikatowy identyfikator utworzonego kontaktu.

Identyfikator kontaktu
uuid

Tworzenie szablonu WhatsApp

Utwórz nowy szablon WhatsApp.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klient
Customer-Id True string

Klient do utworzenia szablonu.

Numer tożsamości
IdentityNumber True string

WhatsApp IdentityNumber używany do szablonu.

Displayname
DisplayName True string

Nazwa wyświetlana szablonu.

Content
RawContent True string

Zawartość szablonu.

Kategoria szablonu
Category True string

Kategoria szablonu.

Język szablonu
Language True string

2-znakowy kod języka szablonu.

Typ przycisku
Type string

Typ przycisku.

Etykieta przycisku
Label string

Etykieta przycisku.

Dane przycisku
Data string

Dane przycisku. Adres URL (adres URL), numer telefonu (połączenie) lub tekst (QuickReply). Maksymalna długość to 2000 dla adresu URL, a 20 — numer telefonu i tekst.

Adres URL załącznika
AttachmentUrl string

Adres URL do przykładowego załącznika.

Usuń kontakt grupy

Usuń kontakt grupy przy użyciu numeru telefonu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klient
Customer True string

Klient pobiera usługi grupy.

Usługa grupy
Group Service True string

Usługa grupy do użycia.

Telefon
Phone True string

Numer telefonu kontaktu do usunięcia.

Zwraca

response
boolean

Usuń wszystkie kontakty grupy

Usuń wszystkie kontakty grupy

Parametry

Nazwa Klucz Wymagane Typ Opis
Klient
Customer True string

Klient pobiera usługi grupy.

Usługa grupy
Group Service True string

Usługa grupy do użycia.

Zwraca

response
boolean

Uzyskiwanie kontaktu z grupą

Uzyskiwanie kontaktu z grupą

Parametry

Nazwa Klucz Wymagane Typ Opis
Klient
Customer True string

Klient pobiera usługi grupy.

Usługa grupy
Group Service True string

Usługa grupy do użycia.

Telefon
Phone True string

Numer telefonu kontaktu.

Region
Region string

Opcjonalny region Numer telefonu do użycia do analizowania numeru telefonu.

Zwraca

Nazwa Ścieżka Typ Opis
Telefon
phone string

Numer telefonu kontaktu.

Email
email string

Adres e-mail kontaktu.

Imię
firstName string

Imię kontaktu.

Nazwisko
lastName string

Nazwisko kontaktu.

Gender
gender string

Płeć kontaktu.

Rok urodzenia
birthYear integer

Rok urodzenia kontaktu.

Adres ulicy
streetAddress string

Adres ulicy kontaktu.

Kod pocztowy
zipCode string

Kod pocztowy kontaktu.

Miejscowość
city string

Miasto kontaktu.

Kod kraju
countryCode string

Kod kraju kontaktu.

Komunikaty, które zakończyły się niepowodzeniem
failedMessages integer

Liczba komunikatów zakończonych niepowodzeniem dla kontaktu.

Właściwości niestandardowe
customContactProperties array of object

Kolekcja niestandardowych właściwości kontaktu zapisana dla kontaktu.

Name
customContactProperties.name string

Niestandardowa nazwa właściwości kontaktu.

Wartość
customContactProperties.value string

Niestandardowa wartość właściwości kontaktu.

WhatsApp Opt In (przestarzałe) [PRZESTARZAŁE]

WhatsApp Opt In dla nadawcy i odbiorcy. (przestarzałe)

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres nadawcy
Sender True string

Zarejestrowany numer tożsamości Whatsapp, aby wyrazić zgodę.

Adres adresata
Recipient True string

Numer odbiorcy, który ma wyrazić zgodę.

WhatsApp — rezygnacja (przestarzała) [PRZESTARZAŁE]

WhatsApp zrezygnował z nadawcy i odbiorcy. (przestarzałe)

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres nadawcy
Sender True string

Zarejestrowany numer tożsamości Whatsapp do rezygnacji z.

Adres adresata
Recipient True string

Numer przepisowy do usunięcia z zgody.

Wyślij wiadomość

Wyślij wiadomość do adresatów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klient
Customer-Id True string

Klient może użyć polecenia do wysyłania.

Usługa
Service-Id True string

Usługa do użycia do wysyłania.

Nadawca wiadomości
Sender True string

Nadawcą wiadomości może być alfanumeryczny, długi kod lub krótki kod (obowiązują ograniczenia).

Zawartość wiadomości
Content True string

Zawartość wiadomości.

Protokół komunikatów
Protocol True string

Protokół używany do wysyłania komunikatu.

Wyślij datę/godzinę
SendDateTime date-time

Data i godzina wysłania wiadomości. Pozostaw wartość pustą, aby wysłać natychmiast.

Address
Address True string

Adres adresata wiadomości.

Identyfikator URI załącznika
AttachmentUri string

Identyfikator URI załącznika do użycia podczas wysyłania wiadomości WhatsApp zawierającej załącznik.

Dane klienta
CustomerData string

Dane dotyczące rozliczeń/grupowania dla tego komunikatu, opcjonalnie.

Wiadomość reklamowa
AdMessage boolean

Opcjonalna flaga zastępowania oznaczania wiadomości jako wiadomości reklamowej

Dlr Url
DlrUrl string

Adres URL wywołania zwrotnego stanu dostawy za pośrednictwem protokołu http-get. Możesz dodać wartości elementu querystring do adresu URL. Zostaną one zachowane.

Identyfikator żądania
RequestId string

Opcjonalny unikatowy identyfikator żądania, który może służyć do identyfikowania zduplikowanych żądań. Jeśli zostanie wykryty zduplikowany identyfikator żądania, wysyłanie zostanie anulowane. Nie ma gwarancji, że żądania z zduplikowanymi identyfikatorami żądań będą blokowane w sytuacjach o wysokiej przepływności/ruchu. Podany identyfikator requestId będzie "zapamiętany" przez 7 dni.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator wiadomości
MessageId string

Identyfikator nowo utworzonej wiadomości.

Liczba części komunikatów
MessagePartCount integer

Przybliżona liczba części komunikatów dla tej wiadomości.

Adresatów
Recipients array of object

Adresatów

Adres adresata
Recipients.Address string

Adres odbiorcy (numer telefonu/adres e-mail/identyfikator użytkownika itp.).

Identyfikator adresata
Recipients.Id string

Identyfikator adresata używany do odbierania informacji o stanie dostawy.

Wyślij wiadomość odpowiedzi

Wyślij wiadomość zwrotną do adresatów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator elementu ParentMessage
ParentMessageId True string

Identyfikator wiadomości nadrzędnej, na który ma odpowiadać.

Klient
Customer-Id True string

Klient może użyć polecenia do wysyłania.

Usługa
Service-Id True string

Usługa do użycia do wysyłania.

Nadawca wiadomości
Sender True string

Nadawcą wiadomości może być alfanumeryczny, długi kod lub krótki kod (obowiązują ograniczenia).

Zawartość wiadomości
Content True string

Zawartość wiadomości.

Protokół komunikatów
Protocol True string

Protokół używany do wysyłania komunikatu.

Wyślij datę/godzinę
SendDateTime date-time

Data i godzina wysłania wiadomości. Pozostaw wartość pustą, aby wysłać natychmiast.

Address
Address True string

Adres adresata wiadomości.

Identyfikator URI załącznika
AttachmentUri string

Identyfikator URI załącznika do użycia podczas wysyłania wiadomości WhatsApp zawierającej załącznik.

Dane klienta
CustomerData string

Dane dotyczące rozliczeń/grupowania dla tego komunikatu, opcjonalnie.

Wiadomość reklamowa
AdMessage boolean

Opcjonalna flaga zastępowania oznaczania wiadomości jako wiadomości reklamowej

Dlr Url
DlrUrl string

Adres URL wywołania zwrotnego stanu dostawy za pośrednictwem protokołu http-get. Możesz dodać wartości elementu querystring do adresu URL. Zostaną one zachowane.

Identyfikator żądania
RequestId string

Opcjonalny unikatowy identyfikator żądania, który może służyć do identyfikowania zduplikowanych żądań. Jeśli zostanie wykryty zduplikowany identyfikator żądania, wysyłanie zostanie anulowane. Nie ma gwarancji, że żądania z zduplikowanymi identyfikatorami żądań będą blokowane w sytuacjach o wysokiej przepływności/ruchu. Podany identyfikator requestId będzie "zapamiętany" przez 7 dni.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator wiadomości
MessageId string

Identyfikator nowo utworzonej wiadomości.

Liczba części komunikatów
MessagePartCount integer

Przybliżona liczba części komunikatów dla tej wiadomości.

Adresatów
Recipients array of object

Adresatów

Adres adresata
Recipients.Address string

Adres odbiorcy (numer telefonu/adres e-mail/identyfikator użytkownika itp.).

Identyfikator adresata
Recipients.Id string

Identyfikator adresata używany do odbierania informacji o stanie dostawy.

Wyślij wiadomość WhatsApp

Wyślij wiadomość szablonu WhatsApp.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klient
Customer-Id True string

Klient może użyć polecenia do wysyłania.

Usługa
Service-Id True string

Usługa do użycia do wysyłania.

Szablon WhatsApp
TemplateName True string

Szablon do użycia do wysyłania.

Address
Address True string

Adres adresata wiadomości.

BodyParameters
BodyParameters array of string

BodyParameters

Parametry nagłówka
HeaderParameters array of string

Parametry nagłówka

Typ
Type string

Typ przycisku. Tylko jeden typ na szablon może zawierać wiele tego samego typu.

Tekst
Data string

Tekst przycisku.

Wyślij datę/godzinę
SendDateTime string

Data i godzina wysłania wiadomości. Pozostaw wartość pustą, aby wysłać natychmiast.

Identyfikator URI załącznika
AttachmentUri string

Identyfikator URI załącznika, jeśli szablon zawiera załącznik.

Korzystanie z rezerwowego programu SMS
UseSmsFallback boolean

Jeśli program SMS powinien być używany jako rezerwowy.

Dlr Url
DlrUrl string

Adres URL raportu dostarczania, który otrzyma wywołanie zwrotne po zakończeniu procesu wysyłania.

Dane klienta
CustomerData string

Dane dotyczące rozliczeń/grupowania dla tego komunikatu, opcjonalnie.

Identyfikator żądania
RequestId string

Opcjonalny unikatowy identyfikator żądania, który może służyć do identyfikowania zduplikowanych żądań. Jeśli zostanie wykryty zduplikowany identyfikator żądania, wysyłanie zostanie anulowane. Nie ma gwarancji, że żądania z zduplikowanymi identyfikatorami żądań będą blokowane w sytuacjach o wysokiej przepływności/ruchu. Podany identyfikator requestId będzie "zapamiętany" przez 7 dni.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator wiadomości
messageId string

Identyfikator nowo utworzonej wiadomości.

Liczba części komunikatów
messagePartCount integer

Przybliżona liczba części komunikatów dla tej wiadomości.

recipients
recipients array of object

recipients

Adres adresata
recipients.address string

Adres odbiorcy (numer telefonu/adres e-mail/identyfikator użytkownika itp.).

Identyfikator adresata
recipients.id string

Identyfikator adresata używany do odbierania informacji o stanie dostawy.

Wyślij wiadomość z odpowiedzią na dyskusję

Wyślij wiadomość odpowiedzi dyskusji do adresatów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klient
CustomerId True string

Klient może użyć polecenia do wysyłania.

Identyfikator wątku
ThreadId True string

Identyfikator istniejącego wątku, na który ma odpowiadać.

Zawartość wiadomości
Content True string

Zawartość wiadomości.

Dane klienta
CustomerData string

Dane dotyczące rozliczeń/grupowania dla tego komunikatu, opcjonalnie.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator wiadomości
MessageId string

Identyfikator nowo utworzonej wiadomości.

Liczba części komunikatów
MessagePartCount integer

Przybliżona liczba części komunikatów dla tej wiadomości.

Adresatów
Recipients array of object

Adresatów

Adres adresata
Recipients.Address string

Adres odbiorcy (numer telefonu/adres e-mail/identyfikator użytkownika itp.).

Identyfikator adresata
Recipients.Id string

Identyfikator adresata używany do odbierania informacji o stanie dostawy.

ThreadId
ThreadId string

Identyfikator wątku, do którego wysłano wiadomość.

Wyzwalacze

Nowa wiadomość

Po nadejściu nowej wiadomości do usługi dwukierunkowej.

Nowa wiadomość

Po nadejściu nowej wiadomości do usługi dwukierunkowej.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klient
Customer True string

Klient do użycia.

Usługa
Service True string

Usługa dwukierunkowa do użycia.

Zwraca

Nazwa Ścieżka Typ Opis
Nadawca wiadomości
sender string

Nadawca wiadomości.

Adresat wiadomości
recipient string

Adresat wiadomości.

Zawartość wiadomości
content string

Zawartość odebranej wiadomości.

Sygnatura czasowa komunikatu
timestamp date-time

Sygnatura czasowa komunikatu.

Protokół komunikatów
protocol string

Protokół odebranego komunikatu.

attachments
attachments array of object

attachments

Nazwa pliku załącznika
attachments.name string

Nazwa pliku załącznika.

Typ mime załącznika
attachments.mimeType string

Typ mime załącznika.

Lokalizacja zasobu załącznika
attachments.resourceLocation string

Lokalizacja zasobu załącznika.

Identyfikator wiadomości
messageId string

Unikatowy identyfikator komunikatu odebranego komunikatu.

Definicje

UUID (Uniwersalnie Unikalny Identyfikator)

Unikatowy identyfikator utworzonego kontaktu.

Unikatowy identyfikator utworzonego kontaktu.

Identyfikator kontaktu
uuid

typ logiczny (boolowski)

Jest to podstawowy typ danych "wartość logiczna".