Udostępnij przez

Zdarzenia SMS usług Azure Communication Services (wersja zapoznawcza)

Łącznik do odbierania wiadomości SMS z zasobów usług Azure Communication Services w ramach subskrypcji.

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 Microsoft
adres URL https://azure.microsoft.com/services/communication-services
Email acssolutions@microsoft.com
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://azure.microsoft.com/services/communication-services
Zasady ochrony prywatności https://privacy.microsoft.com
Kategorie Communication

Łącznik zdarzeń SMS usług Azure Communication Services umożliwia przetwarzanie wiadomości SMS wysyłanych do numerów telefonów usług Azure Communication Services.

Wymagania wstępne

Aby kontynuować, musisz wykonać następujące czynności:

  • Plan usługi Microsoft Power Apps lub Power Automate z funkcją łącznika niestandardowego
  • Subskrypcja platformy Azure z zarejestrowanym dostawcą zasobów usługi Event Grid
  • Zasób usług Azure Communication Services
  • Zakupiony numer telefonu usługi Azure Communication Services skonfigurowany do odbierania wiadomości SMS

Jak uzyskać poświadczenia

  1. Tworzenie zasobu usług Azure Communication Services — dokument Szybki start.

  2. Kup numer telefonu w tym zasobie z wybraną funkcją "Wyślij i odbierz wiadomość SMS".

  3. Zarejestruj dostawcę zasobów usługi Event Grid dla subskrypcji, w ramach których znajduje się zasób usług Azure Communication Services.

  4. Utwórz użytkownika identyfikatora entra firmy Microsoft lub jednostki usługi, którego można użyć na potrzeby połączenia łącznika.

  5. Upewnij się, że użytkownik lub jednostka usługi Microsoft Entra ID mają przypisane do nich następujące uprawnienia:

    • Microsoft.Communication/CommunicationServices/Read

    • Microsoft.Resources/subscriptions/resourceGroups/read

    • Microsoft.EventGrid/eventSubscriptions/write

    • Microsoft.EventGrid/eventSubscriptions/read

    • Microsoft.EventGrid/eventSubscriptions/delete

      Można to osiągnąć, tworząc rolę niestandardową lub przypisując użytkownika do następujących wbudowanych ról:

    • Czytelnik — na poziomie zasobów usług Azure Communication Services

    • EventGrid EventSubscription — na poziomie grupy zasobów

Wprowadzenie do łącznika

Ten łącznik zawiera pojedynczy wyzwalacz Po odebraniu wiadomości SMS. Domyślnie będzie ona uruchamiana po wysłaniu wiadomości do dowolnego zakupionego numeru telefonu, ale można ją również skonfigurować tak, aby była uruchamiana tylko na podstawie numerów telefonów "Do" i "Od" wiadomości SMS.

Znane problemy i ograniczenia

  • Wyzwalacz tymczasowo wyłączony podczas aktualizacji, jeśli ustawienie "Nazwa subskrypcji zdarzeń" — jeśli wartość została przypisana do pola "Nazwa subskrypcji zdarzeń" podczas tworzenia wyzwalacza, wszelkie aktualizacje wyzwalacza (na przykład dodanie numeru telefonu "Do" może potrwać do 10 minut. W tym czasie wyzwalacz nie będzie działać.
  • Subskrypcja zdarzeń nie została usunięta, jeśli połączenie zostało usunięte przed przepływem.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Microsoft Entra ID Integrated Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do zasobów zdarzeń usługi ACS. Wszystkie regiony Nie można udostępniać
Uwierzytelnianie jednostki usługi (aplikacji Microsoft Entra ID) Użyj uwierzytelniania microsoft Entra ID, aby uzyskać dostęp do zasobu usługi Azure Communication Service. Wszystkie regiony Nie można udostępniać
Domyślne [PRZESTARZAŁE] Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami. Wszystkie regiony Nie można udostępniać

Microsoft Entra ID Zintegrowany

Identyfikator uwierzytelniania: aadOauth

Dotyczy: wszystkie regiony

Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do zasobów zdarzeń usługi ACS.

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.

Uwierzytelnianie jednostki usługi (aplikacji Microsoft Entra ID)

Identyfikator uwierzytelniania: aadOauthClientCredentials

Dotyczy: wszystkie regiony

Użyj uwierzytelniania microsoft Entra ID, aby uzyskać dostęp do zasobu usługi Azure Communication Service.

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
Identyfikator dzierżawy ciąg Identyfikator dzierżawy aplikacji Microsoft Entra ID. Prawda
ID klienta ciąg Identyfikator klienta (lub aplikacji) aplikacji Microsoft Entra ID. Prawda
Tajemnica klienta securestring Wpis tajny klienta aplikacji Microsoft Entra ID. Prawda

Domyślne [PRZESTARZAŁE]

Dotyczy: wszystkie regiony

Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.

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.

Limity ograniczania

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

Wyzwalacze

Po odebraniu wiadomości SMS

Po odebraniu wiadomości SMS usług Azure Communication Services.

Po odebraniu wiadomości SMS

Identyfikator operacji:
CreateSMSReceivedEventSubscription

Po odebraniu wiadomości SMS usług Azure Communication Services.

Parametry

Nazwa Klucz Wymagane Typ Opis
Subscription
 subscriptionId True string

Unikatowy identyfikator subskrypcji platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora dla każdego zasobu platformy Azure.
Nazwa grupy zasobów
 resourceGroupName True string

Nazwa grupy zasobów zawierającej zasób.
Nazwa zasobu
 resourceName True string

Nazwa zasobu usług komunikacyjnych.
Filtruj według numeru telefonu
 toPhoneNumbers array of string
Filtruj według według numeru telefonu
 fromPhoneNumbers array of string
Nazwa subskrypcji zdarzeń
 eventSubscriptionName string

Nazwa nowej subskrypcji zdarzeń.
includedEventTypes
 includedEventTypes True array of string

Zwraca

Nazwa Ścieżka Typ Opis
array of object
Do
 data.to string
Źródło
 data.from string
Message
 data.message string
Odebrano znacznik czasu
 data.receivedTimestamp string
Identyfikator komunikatu
 data.messageId string