Compartir a través de

Eventos sms de Azure Communication Services (versión preliminar)

Conector para recibir mensajes SMS de los recursos de Azure Communication Services de la suscripción.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Microsoft
URL https://azure.microsoft.com/services/communication-services
Correo Electrónico acssolutions@microsoft.com
Metadatos del conector
Publicador Microsoft
Website https://azure.microsoft.com/services/communication-services
Directiva de privacidad https://privacy.microsoft.com
Categorías Communication

El conector de eventos sms de Azure Communication Services permite el procesamiento de mensajes SMS enviados a números de teléfono de Azure Communication Services.

Prerrequisitos

Necesitará lo siguiente para continuar:

  • Un plan de Microsoft Power Apps o Power Automate con una característica de conector personalizada
  • Una suscripción de Azure con el proveedor de recursos de Event Grid registrado
  • Un recurso de Azure Communication Services
  • Un número de teléfono comprado de Azure Communication Services que está configurado para recibir mensajes SMS

Obtención de credenciales

  1. Creación de un recurso de Azure Communication Services: documento de inicio rápido.

  2. Compre un número de teléfono en este recurso con la característica "Enviar y recibir SMS" seleccionada.

  3. Registre un proveedor de recursos de Event Grid para la suscripción en la que se encuentra el recurso de Azure Communication Services.

  4. Cree un usuario de Identificador de Entra de Microsoft o una entidad de servicio que se pueda usar para la conexión del conector.

    • Opción 1: Conexión con la cuenta de Id. de Microsoft Entra: agregar un nuevo usuario
    • Opción 2: Conexión mediante la autenticación de entidad de servicio (aplicación microsoft Entra ID): también puede configurar una entidad de servicio, crear una aplicación registrada desde la CLI de Azure o a través de Azure Portal. Las credenciales se pueden usar para autenticarse.

  5. Asegúrese de que el usuario o la entidad de servicio de Microsoft Entra ID tienen asignados los siguientes permisos:

    • Microsoft.Communication/CommunicationServices/Read

    • Microsoft.Resources/subscriptions/resourceGroups/read

    • Microsoft.EventGrid/eventSubscriptions/write

    • Microsoft.EventGrid/eventSubscriptions/read

    • Microsoft.EventGrid/eventSubscriptions/delete

      Esto se puede lograr mediante la creación de un rol personalizado o la asignación del usuario a los siguientes roles integrados:

    • Lector: en el nivel de recurso de Azure Communication Services

    • Colaborador de EventGrid EventSubscription: en el nivel de grupo de recursos

Introducción al conector

Este conector contiene un único desencadenador Cuando se recibe un mensaje SMS. De forma predeterminada, se ejecutará cuando se envíe un mensaje a cualquiera de los números de teléfono comprados, pero también se puede configurar para que solo se ejecute en función de los números de teléfono "To" y "From" del mensaje SMS.

Problemas y limitaciones conocidos

  • Desencadenador deshabilitado temporalmente al actualizar si se establece "Nombre de suscripción de eventos": si se asignó un valor al campo "Nombre de suscripción de eventos" al crear el desencadenador, las actualizaciones del desencadenador (por ejemplo, agregar un número de teléfono "To") pueden tardar hasta 10 minutos en aplicarse. Durante este tiempo, el desencadenador no funcionará.
  • La suscripción de eventos no se elimina si la conexión se eliminó antes de Flow.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:
Microsoft Entra ID: integrado Use Microsoft Entra ID para acceder a los recursos de eventos de ACS. Todas las regiones No se puede compartir
Autenticación de entidad de servicio (aplicación microsoft Entra ID) Use la autenticación de Microsoft Entra ID para acceder al recurso de Azure Communication Service. Todas las regiones No se puede compartir
Valor predeterminado [EN DESUSO] Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores. Todas las regiones No se puede compartir

Microsoft Entra ID integrado

Identificador de autenticación: aadOauth

Aplicable: Todas las regiones

Use Microsoft Entra ID para acceder a los recursos de eventos de ACS.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Autenticación de entidad de servicio (aplicación microsoft Entra ID)

Identificador de autenticación: aadOauthClientCredentials

Aplicable: Todas las regiones

Use la autenticación de Microsoft Entra ID para acceder al recurso de Azure Communication Service.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Id. de inquilino cuerda / cadena Id. de inquilino de la aplicación microsoft Entra ID. Cierto
Id. de cliente cuerda / cadena Id. de cliente (o aplicación) de la aplicación microsoft Entra ID. Cierto
Secreto del cliente securestring Secreto de cliente de la aplicación microsoft Entra ID. Cierto

Valor predeterminado [EN DESUSO]

Aplicable: Todas las regiones

Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Desencadenadores

Cuando se recibe un mensaje SMS

Cuando se recibe un mensaje SMS de Azure Communication Services.

Cuando se recibe un mensaje SMS

Id. de la operación:
CreateSMSReceivedEventSubscription

Cuando se recibe un mensaje SMS de Azure Communication Services.

Parámetros

Nombre Clave Requerido Tipo Description
Subscription
 subscriptionId True string

Identificador único de la suscripción de Microsoft Azure. El identificador de suscripción forma parte del identificador de cada recurso de Azure.
Nombre del grupo de recursos
 resourceGroupName True string

Nombre del grupo de recursos que contiene el recurso.
Nombre de recurso
 resourceName True string

Nombre del recurso de Communication Services.
Filtrar por número de teléfono
 toPhoneNumbers array of string
Filtrar por número de teléfono
 fromPhoneNumbers array of string
Nombre de la suscripción de eventos
 eventSubscriptionName string

Nombre de la nueva suscripción de eventos.
includedEventTypes
 includedEventTypes True array of string

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
Para
 data.to string
De
 data.from string
Message
 data.message string
Marca de tiempo recibida
 data.receivedTimestamp string
Id. de mensaje
 data.messageId string