boomapp connect
"Intelligent" global 2-way, Email, Voice, SMS i Push Messaging. Doładuj wszystkie aplikacje platformy Power Platform za pomocą platformy boomapp, aby tworzyć prawdziwie zautomatyzowane wielokanałowe przepływy pracy komunikacji konwersacyjnej (unikatowo sterowane tematem). W pełni interakcyjne przepływy pracy oparte na odpowiedzi odbiorcy umożliwiają dostarczanie bezproblemowych i bezproblemowych interakcji bez wymuszania zmian behawioralnych przez zaangażowanie. Aby uzyskać szczegółowe informacje i skonfigurować bezpłatne konto próbne, zobacz naszą witrynę internetową.
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: - China Cloud obsługiwane przez firmę 21Vianet |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure (Chiny) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - China Cloud obsługiwane przez firmę 21Vianet |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - China Cloud obsługiwane przez firmę 21Vianet |
| Kontakt | |
|---|---|
| Name | Obsługa platformy Boomerang |
| adres URL | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| support@boomcomms.com |
| Metadane łącznika | |
|---|---|
| Publisher | Boomerang I-Comms Ltd |
| Witryna internetowa | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| Zasady ochrony prywatności | https://boomerangmessaging.com/privacy/ |
| Kategorie | Komunikacja; Produktywność |
Pre-requisites
Aby kontynuować, musisz wykonać następujące czynności:
- Plan usługi Microsoft Power Automate z funkcją łącznika niestandardowego
- Subskrypcja platformy Boomerang
- Szczegóły uwierzytelniania interfejsu API platformy Boomerang.
Tworzenie konta przy użyciu platformy Boomerang
- witryna internetowa — dalsze informacje na temat tworzenia kont platformy Boomerang.
Pomoc techniczna i dokumentacja:
Dokumentację można znaleźć tutaj.
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 |
|---|---|---|---|
| nazwa użytkownika | securestring | Nazwa użytkownika dla tego interfejsu API | Prawda |
| hasło | securestring | Hasło dla tego interfejsu API | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Dwukierunkowa wiadomość SMS |
Ta metoda umożliwia śledzenie odpowiedzi bezpośrednio względem każdej transakcji wychodzącej i służy do zarządzania konwersacjami między systemem a użytkownikiem końcowym. Odpowiedzi mogą być przekazywane na adres e-mail, a klienci z platformą Boommail mogą wysyłać wiadomość e-mail-2-SMS z powrotem do obiektu odpowiadającego. Zobacz https://boomerangmessaging.com/docs/sending-sms-messages, aby uzyskać więcej informacji na temat komunikatów dwukierunkowych i konwersacyjnych. |
|
Wysyłaj pojedyncze lub zbiorcze wiadomości e-mail. Wiadomości e-mail są wysyłane z domeny @boomerangui.com i można dostosować temat i zastąpić adres "Od". Istnieje również możliwość przekazywania odpowiedzi na adres e-mail i / lub adres URL |
|
| Jednokierunkowa wiadomość SMS |
Wiadomości SMS są dostarczane przy użyciu jednostki źródłowej alfanumerycznej (takiej jak nazwa firmy), która musi zawierać maksymalnie 11 znaków, a adresat nie może odpowiedzieć na wiadomość wysłaną przy użyciu jednostki źródłowej alfanumerycznej. Należy również pamiętać, że w miejscach docelowych, w których dostarczanie komunikatów z obiektem źródłowym alfanumerycznym nie jest obsługiwane (ze względu na ograniczenia lokalne), może to zostać zastąpione numerycznym inicjatorem, aby upewnić się, że komunikat jest dostarczany. |
| Numer niestandardowy wiadomości SMS |
Wiadomości SMS są dostarczane przy użyciu numeru określonego w żądaniu, aby wszystkie odpowiedzi były zwracane do tej liczby. Klienci korzystający z funkcji kampanii boomerang mogą używać liczby skojarzonej z kampanią, która umożliwia dostęp do odpowiedzi przychodzących z sekcji Raportowanie kampanii w interfejsie użytkownika boomerang. Jednak w przeciwieństwie do metody sms 2-way odpowiedzi nie są śledzone względem wiadomości wychodzącej. Aby uzyskać więcej informacji, zobacz https://boomerangmessaging.com/docs/sending-sms-messages. |
| Voice |
Stała liczba jest używana jako inicjator połączenia głosowego text-To-Speech (TTS). Naciśnięcia "1" i "2" są używane do akceptowania lub odrzucania komunikatu: "9" służy do przekierowywania wywołania. Zobacz https://boomerangmessaging.com/docs/sending-delivering-voice-messages , aby uzyskać więcej informacji |
Dwukierunkowa wiadomość SMS
Ta metoda umożliwia śledzenie odpowiedzi bezpośrednio względem każdej transakcji wychodzącej i służy do zarządzania konwersacjami między systemem a użytkownikiem końcowym. Odpowiedzi mogą być przekazywane na adres e-mail, a klienci z platformą Boommail mogą wysyłać wiadomość e-mail-2-SMS z powrotem do obiektu odpowiadającego. Zobacz https://boomerangmessaging.com/docs/sending-sms-messages, aby uzyskać więcej informacji na temat komunikatów dwukierunkowych i konwersacyjnych.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
conversation_id
|
conversation_id | string |
Definiowanie identyfikatora konwersacji w celu grupowania wszystkich wiadomości (w tym odpowiedzi) części tej samej konwersacji |
|
|
message_content
|
message_content | string |
Zawartość wiadomości wychodzącej wysłanej do wszystkich adresatówAddresses. |
|
|
Adres docelowy odbiorcy
|
number | string |
Adres docelowy odbiorcy; Numer telefonu komórkowego, który musi zawierać co najmniej 11 cyfr (z wyłączeniem + lub wiodącego "0") i maksymalnie 16 cyfr (z wyłączeniem znaku + gdzie jest używany jako wstępna poprawka do samej liczby). Można przekazać pojedynczą liczbę lub tablicę z maksymalnie 10 000 liczb. |
|
|
validity_period
|
validity_period | integer |
Okres, w którym liczba użyta do wysłania wiadomości będzie aktywna. Odpowiedzi na wiadomość nie zostaną dostarczone po wygaśnięciu okresu ważności. W przypadku komunikatów dwukierunkowych minimalny okres ważności wynosi 1 dzień. |
|
|
open_ticket
|
open_ticket | boolean |
Domyślnie wszystkie komunikaty są wysyłane pojedynczy bilet, co oznacza, że komunikat jest zamykany po otrzymaniu pierwszej odpowiedzi. Aby dopasować wiele odpowiedzi do tego samego komunikatu źródłowego, użyj otwartego biletu, przekazując wartość true. |
|
|
email_responses
|
email_responses | string |
Adres e-mail, na który są przekazywane odpowiedzi wiadomości. |
|
|
push_responses
|
push_responses | string |
Adres URL wywołania zwrotnego, do którego są publikowane odpowiedzi na komunikaty. |
|
|
priority
|
priority | boolean |
Opcjonalny parametr używany do ustawiania stanu priorytetu na komunikat. Wszystkie komunikaty wysyłane z priorytetem zastąpią "Godziny społecznościowe" skonfigurowane na koncie. Przekaż wartość true, aby ustawić priorytet. |
|
|
unique_identifier
|
unique_identifier | string |
Unikatowy identyfikator każdej transakcji. Służy to do ochrony przed duplikowaniem komunikatów, ponieważ boomerang zignoruje wszystkie transakcje z identyfikatorem, który został wcześniej użyty. |
|
|
campaign_name
|
campaign_name | string |
Opcjonalny identyfikator, który może służyć do grupowania wiadomości według określonych kampanii i wiadomości wsadowych. |
|
|
custom_parameter
|
custom_parameter | string |
Parametr używany do dokumentacji niestandardowej. Może to być używane na przykład jako odwołanie do kampanii, odwołanie do zadania, identyfikator partii itp. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
status | integer |
stan |
|
komunikat
|
message | string |
komunikat |
|
transakcje
|
transactions | array of object |
transakcje |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
Wysyłaj pojedyncze lub zbiorcze wiadomości e-mail. Wiadomości e-mail są wysyłane z domeny @boomerangui.com i można dostosować temat i zastąpić adres "Od". Istnieje również możliwość przekazywania odpowiedzi na adres e-mail i / lub adres URL
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
z
|
from | string |
Przekaż zawartość do użycia jako adres Od. Jeśli pusta wartość domyślna zostanie pobrana z ustawień konta |
|
|
email_subject
|
email_subject | string |
Temat domyślnie wyświetlany po odebraniu wiadomości e-mail w skrzynce odbiorczej adresata |
|
|
message_content
|
message_content | string |
Zawartość wiadomości wychodzącej wysłanej do wszystkich adresatówAddresses. |
|
|
email_address
|
email_address | array of string |
email_address |
|
|
validity_period
|
validity_period | integer |
Okres, w którym liczba użyta do wysłania wiadomości będzie aktywna. Odpowiedzi na wiadomość nie zostaną dostarczone po wygaśnięciu okresu ważności. W przypadku komunikatów dwukierunkowych minimalny okres ważności wynosi 1 dzień. |
|
|
open_ticket
|
open_ticket | boolean |
Domyślnie wszystkie komunikaty są wysyłane pojedynczy bilet, co oznacza, że komunikat jest zamykany po otrzymaniu pierwszej odpowiedzi. Aby dopasować wiele odpowiedzi do tego samego komunikatu źródłowego, użyj otwartego biletu, przekazując wartość true. |
|
|
email_responses
|
email_responses | string |
Adres e-mail, na który są przekazywane odpowiedzi wiadomości. |
|
|
push_responses
|
push_responses | string |
Adres URL wywołania zwrotnego, do którego są publikowane odpowiedzi na komunikaty. |
|
|
unique_identifier
|
unique_identifier | string |
Unikatowy identyfikator każdej transakcji. Służy to do ochrony przed duplikowaniem komunikatów, ponieważ boomerang zignoruje wszystkie transakcje z identyfikatorem, który został wcześniej użyty. |
|
|
campaign_name
|
campaign_name | string |
Opcjonalny identyfikator, który może służyć do grupowania wiadomości według określonych kampanii i wiadomości wsadowych. |
|
|
custom_parameter
|
custom_parameter | string |
Parametr używany do dokumentacji niestandardowej. Może to być używane na przykład jako odwołanie do kampanii, odwołanie do zadania, identyfikator partii itp. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
status | integer |
stan |
|
komunikat
|
message | string |
komunikat |
|
transakcje
|
transactions | array of object |
transakcje |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
email_address
|
transactions.email_address | string |
email_address |
Jednokierunkowa wiadomość SMS
Wiadomości SMS są dostarczane przy użyciu jednostki źródłowej alfanumerycznej (takiej jak nazwa firmy), która musi zawierać maksymalnie 11 znaków, a adresat nie może odpowiedzieć na wiadomość wysłaną przy użyciu jednostki źródłowej alfanumerycznej. Należy również pamiętać, że w miejscach docelowych, w których dostarczanie komunikatów z obiektem źródłowym alfanumerycznym nie jest obsługiwane (ze względu na ograniczenia lokalne), może to zostać zastąpione numerycznym inicjatorem, aby upewnić się, że komunikat jest dostarczany.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
z
|
from | string |
Identyfikator źródłowy komunikatu 1-way. Wartość alfanumeryczna zawierająca maksymalnie 11 znaków. |
|
|
message_content
|
message_content | string |
Zawartość wiadomości wychodzącej wysłanej do wszystkich adresatówAddresses. |
|
|
Adres docelowy odbiorcy
|
number | string |
Adres docelowy odbiorcy; Numer telefonu komórkowego, który musi zawierać co najmniej 11 cyfr (z wyłączeniem + lub wiodącego "0") i maksymalnie 16 cyfr (z wyłączeniem znaku + gdzie jest używany jako wstępna poprawka do samej liczby). Można przekazać pojedynczą liczbę lub tablicę z maksymalnie 10 000 liczb. |
|
|
priority
|
priority | boolean |
Opcjonalny parametr używany do ustawiania stanu priorytetu na komunikat. Wszystkie komunikaty wysyłane z priorytetem zastąpią "Godziny społecznościowe" skonfigurowane na koncie. Przekaż wartość true, aby ustawić priorytet. |
|
|
unique_identifier
|
unique_identifier | string |
Unikatowy identyfikator każdej transakcji. Służy to do ochrony przed duplikowaniem komunikatów, ponieważ boomerang zignoruje wszystkie transakcje z identyfikatorem, który został wcześniej użyty. |
|
|
campaign_name
|
campaign_name | string |
Opcjonalny identyfikator, który może służyć do grupowania wiadomości według określonych kampanii i wiadomości wsadowych. |
|
|
custom_parameter
|
custom_parameter | string |
Parametr używany do dokumentacji niestandardowej. Może to być używane na przykład jako odwołanie do kampanii, odwołanie do zadania, identyfikator partii itp. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
status | integer |
stan |
|
komunikat
|
message | string |
komunikat |
|
transakcje
|
transactions | array of object |
transakcje |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
Numer niestandardowy wiadomości SMS
Wiadomości SMS są dostarczane przy użyciu numeru określonego w żądaniu, aby wszystkie odpowiedzi były zwracane do tej liczby. Klienci korzystający z funkcji kampanii boomerang mogą używać liczby skojarzonej z kampanią, która umożliwia dostęp do odpowiedzi przychodzących z sekcji Raportowanie kampanii w interfejsie użytkownika boomerang. Jednak w przeciwieństwie do metody sms 2-way odpowiedzi nie są śledzone względem wiadomości wychodzącej. Aby uzyskać więcej informacji, zobacz https://boomerangmessaging.com/docs/sending-sms-messages.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
z
|
from | string |
Identyfikator wysyłania skojarzony z wiadomością może być numerem kampanii dla ruchu przychodzącego, który jest obecnie skojarzony z aktywną kampanią. |
|
|
message_content
|
message_content | string |
Zawartość wiadomości wychodzącej wysłanej do wszystkich adresatówAddresses. |
|
|
Adres docelowy odbiorcy
|
number | string |
Adres docelowy odbiorcy; Numer telefonu komórkowego, który musi zawierać co najmniej 11 cyfr (z wyłączeniem + lub wiodącego "0") i maksymalnie 16 cyfr (z wyłączeniem znaku + gdzie jest używany jako wstępna poprawka do samej liczby). Można przekazać pojedynczą liczbę lub tablicę z maksymalnie 10 000 liczb. |
|
|
priority
|
priority | boolean |
Opcjonalny parametr używany do ustawiania stanu priorytetu na komunikat. Wszystkie komunikaty wysyłane z priorytetem zastąpią "Godziny społecznościowe" skonfigurowane na koncie. Przekaż wartość true, aby ustawić priorytet. |
|
|
unique_identifier
|
unique_identifier | string |
Unikatowy identyfikator każdej transakcji. Służy to do ochrony przed duplikowaniem komunikatów, ponieważ boomerang zignoruje wszystkie transakcje z identyfikatorem, który został wcześniej użyty. |
|
|
campaign_name
|
campaign_name | string |
Opcjonalny identyfikator, który może służyć do grupowania wiadomości według określonych kampanii i wiadomości wsadowych. |
|
|
custom_parameter
|
custom_parameter | string |
Parametr używany do dokumentacji niestandardowej. Może to być używane na przykład jako odwołanie do kampanii, odwołanie do zadania, identyfikator partii itp. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
status | integer |
stan |
|
komunikat
|
message | string |
komunikat |
|
transakcje
|
transactions | array of object |
transakcje |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
Voice
Stała liczba jest używana jako inicjator połączenia głosowego text-To-Speech (TTS). Naciśnięcia "1" i "2" są używane do akceptowania lub odrzucania komunikatu: "9" służy do przekierowywania wywołania. Zobacz https://boomerangmessaging.com/docs/sending-delivering-voice-messages , aby uzyskać więcej informacji
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
voice_intro
|
voice_intro | string |
Komunikat odtwarzany po odebraniu połączenia głosowego. Zawartość wiadomości zostanie odtworzona bezpośrednio po niej. |
|
|
voice_thank_you
|
voice_thank_you | string |
Komunikat odtwarzany na końcu połączenia głosowego po odtworzeniu zawartości wiadomości. |
|
|
voice_redirect_message
|
voice_redirect_message | string |
Komunikat odtwarzany na końcu połączenia głosowego po odtworzeniu zawartości wiadomości. |
|
|
Liczba
|
number | string |
Numer przekierowania |
|
|
voice_retries
|
voice_retries | integer |
Liczba prób, jeśli połączenie głosowe nie zostało odebrane po raz pierwszy. |
|
|
voice_delay
|
voice_delay | integer |
Czas oczekiwania przez system między ponowną próbą. |
|
|
message_content
|
message_content | string |
Zawartość wiadomości wychodzącej wysłanej do wszystkich adresatówAddresses. |
|
|
Liczba
|
number | string |
Adres docelowy odbiorcy; Numer telefonu komórkowego, który musi zawierać co najmniej 11 cyfr (z wyłączeniem + lub wiodącego "0") i maksymalnie 16 cyfr (z wyłączeniem znaku + gdzie jest używany jako wstępna poprawka do samej liczby). Można przekazać pojedynczą liczbę lub tablicę z maksymalnie 10 000 liczb. |
|
|
priority
|
priority | boolean |
Opcjonalny parametr używany do ustawiania stanu priorytetu na komunikat. Wszystkie komunikaty wysyłane z priorytetem zastąpią "Godziny społecznościowe" skonfigurowane na koncie. Przekaż wartość true, aby ustawić priorytet. |
|
|
unique_identifier
|
unique_identifier | string |
Unikatowy identyfikator każdej transakcji. Służy to do ochrony przed duplikowaniem komunikatów, ponieważ boomerang zignoruje wszystkie transakcje z identyfikatorem, który został wcześniej użyty. |
|
|
campaign_name
|
campaign_name | string |
Opcjonalny identyfikator, który może służyć do grupowania wiadomości według określonych kampanii i wiadomości wsadowych. |
|
|
custom_parameter
|
custom_parameter | string |
Parametr używany do dokumentacji niestandardowej. Może to być używane na przykład jako odwołanie do kampanii, odwołanie do zadania, identyfikator partii itp. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
status | integer |
stan |
|
komunikat
|
message | string |
komunikat |
|
transakcje
|
transactions | array of object |
transakcje |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
Wyzwalacze
| Po potwierdzeniu dostawy |
Wyzwalane przez aktualizację stanu dostarczania użytkownika końcowego. Aktualizuje transakcję ze stanem dostawy zwróconym przez operatora sieci użytkownika końcowego. Zobacz https://boomerangmessaging.com/docs , aby uzyskać więcej informacji |
| W przypadku przesyłania odpowiedzi SMS |
Wyzwalane przez odpowiedzi przychodzące, które są automatycznie mapowane na skojarzone komunikaty wychodzące, gdy są wysyłane jako inteligentna 2-way/ konwersacyjna wiadomość |
Po potwierdzeniu dostawy
Wyzwalane przez aktualizację stanu dostarczania użytkownika końcowego. Aktualizuje transakcję ze stanem dostawy zwróconym przez operatora sieci użytkownika końcowego. Zobacz https://boomerangmessaging.com/docs , aby uzyskać więcej informacji
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
status | integer |
stan |
|
komunikat
|
message | string |
komunikat |
|
zawiera_więcej
|
has_more | boolean |
zawiera_więcej |
|
Drs
|
drs | array of object |
Drs |
|
transaction_id
|
drs.transaction_id | string |
transaction_id |
|
stan
|
drs.status | string |
stan |
|
status_date
|
drs.status_date | string |
status_date |
|
docelowy
|
drs.destination | string |
docelowy |
|
custom_parameter
|
drs.custom_parameter | string |
custom_parameter |
|
campaign_name
|
drs.campaign_name | string |
campaign_name |
|
unique_id
|
drs.unique_id | string |
unique_id |
W przypadku przesyłania odpowiedzi SMS
Wyzwalane przez odpowiedzi przychodzące, które są automatycznie mapowane na skojarzone komunikaty wychodzące, gdy są wysyłane jako inteligentna 2-way/ konwersacyjna wiadomość
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
stan
|
status | integer |
stan |
|
komunikat
|
message | string |
komunikat |
|
zawiera_więcej
|
has_more | boolean |
zawiera_więcej |
|
Odpowiedzi
|
replies | array of object |
Odpowiedzi |
|
transaction_id
|
replies.transaction_id | string |
transaction_id |
|
custom_parameter
|
replies.custom_parameter | string |
custom_parameter |
|
response_id
|
replies.response_id | string |
response_id |
|
z
|
replies.from | string |
z |
|
response_content
|
replies.response_content | string |
response_content |
|
is_new
|
replies.is_new | boolean |
is_new |
|
transaction_date
|
replies.transaction_date | string |
transaction_date |
|
response_date
|
replies.response_date | string |
response_date |