Platforma botów (wersja zapoznawcza)
Łączenie botów platformy botów z dowolną aplikacją, wysyłanie komunikatów do użytkowników botów, ustawianie wartości atrybutów przy użyciu istniejących botów na platformie Bot Platform
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 | Obsługa platformy botów |
| adres URL | https://thebotplatform.com/contact/ |
| hello@thebotplatform.com |
| Metadane łącznika | |
|---|---|
| Publisher | Platforma Bot |
| Witryna internetowa | https://thebotplatform.com |
| Zasady ochrony prywatności | https://thebotplatform.com/privacy-policy/ |
| Kategorie | Komunikacja; Witryna internetowa |
Łącznik platformy Bot Platform umożliwia używanie danych z przepływów usługi Power Automate do wysyłania komunikatów do użytkowników w botze, tworzenia nowych atrybutów i ustawiania wartości dla istniejących atrybutów. Łącznik wykorzystuje nasz interfejs API do wykonywania wszystkich tych akcji bez konieczności ręcznego konfigurowania wywołań interfejsu API, zamiast tego użyć łącznika do szybszego wykonywania akcji interfejsu API.
Wymagania wstępne
Będziesz potrzebować konta na platformie Bot Platform
Jak uzyskać poświadczenia
Po zalogowaniu się do usługi CMS platformy bota przejdź do bota, z którym chcesz nawiązać połączenie. Kliknij pozycję "Dostęp do interfejsu API" w menu paska bocznego i utwórz nową aplikację integracji. Otrzymasz identyfikator klienta i klucz tajny. Wprowadź te informacje w usłudze Power Automate, w której używasz łącznika do uwierzytelniania bota w usłudze Power Automate.
Wprowadzenie do łącznika
Po zalogowaniu się na koncie przejdź do bota, który chcesz zintegrować, i kliknij pozycję "Dostęp do interfejsu API", aby uzyskać identyfikator klienta i klucz tajny. Po uzyskaniu tych informacji utwórz nowy przepływ usługi Power Automate, zostanie wyświetlony monit o wprowadzenie identyfikatora klienta i klucza tajnego. Po wprowadzeniu tych informacji zostanie wyświetlone wyskakujące okienko z prośbą o pozwolenie na dostęp do bota. Wybierz pozycję "Zezwalaj" i wszystko jest ustawione!
Znane problemy i ograniczenia
- Obecnie użytkownicy mogą być identyfikowani tylko za pośrednictwem adresu e-mail, aby móc przekazywać informacje z powrotem do bota.
- Nie można wysłać adresu URL obrazu przy użyciu prostej operacji wiadomości SMS.
Typowe błędy i środki zaradcze
W przypadku botów zainstalowanych w usłudze Microsoft Teams nie można wysłać wiadomości do użytkownika, który wcześniej nie wchodził w interakcję z botem. Obejściem byłoby wysłanie emisji do użytkownika z platformy przed użyciem łącznika w celu wysłania komunikatu.
Często zadawane pytania
Aby uzyskać więcej informacji na temat naszych przypadków użycia, odwiedź naszą stronę Dev Docs
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 App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Identyfikator klienta — identyfikator clientid platformy bota | ciąg | Wprowadź identyfikator klienta. | Prawda |
| Wpis tajny klienta platformy bota | securestring | Wprowadź klucz tajny klienta. | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Tworzenie atrybutu użytkownika |
Konfigurowanie nowego atrybutu w botze |
| Ustawianie wartości atrybutu |
Ustawianie wartości atrybutu za pośrednictwem adresu e-mail użytkowników |
| Wysyłanie prostej wiadomości SMS do użytkownika bota |
Wysyłanie wiadomości do użytkownika bota przy użyciu tekstu |
Tworzenie atrybutu użytkownika
Konfigurowanie nowego atrybutu w botze
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa atrybutu
|
name | string |
Podaj nazwę atrybutu |
|
|
czy pii?
|
is_pii | string |
czy są to dane osobowe? |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
UserAttribute
|
data | UserAttribute |
Atrybut użytkownika |
Ustawianie wartości atrybutu
Ustawianie wartości atrybutu za pośrednictwem adresu e-mail użytkowników
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
adres e-mail użytkownika, który jest ustawiany atrybut
|
emailaddress | True | string |
adres e-mail |
|
Identyfikator atrybutu
|
id | True | string |
Istniejące atrybuty bota |
|
value
|
value | string |
wartość atrybutu |
Wysyłanie prostej wiadomości SMS do użytkownika bota
Wysyłanie wiadomości do użytkownika bota przy użyciu tekstu
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
SMS
|
text | string |
Tutaj wprowadź wiadomość SMS |
|
|
adres e-mail
|
recipient | string |
adres e-mail adresata |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Działanie zewnętrzne
|
data | ExternalActivity |