Compartilhar via

Eventos sms dos Serviços de Comunicação do Azure (versão prévia)

Conector para receber mensagens SMS dos recursos dos Serviços de Comunicação do Azure em sua assinatura.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Microsoft
URL https://azure.microsoft.com/services/communication-services
Email acssolutions@microsoft.com
Metadados do conector
Publicador Microsoft
Site https://azure.microsoft.com/services/communication-services
Política de privacidade https://privacy.microsoft.com
Categorias Communication

O conector de Eventos SMS dos Serviços de Comunicação do Azure permite o processamento de mensagens SMS enviadas para números de telefone dos Serviços de Comunicação do Azure.

Pré-requisitos

Você precisará do seguinte para continuar:

  • Um plano do Microsoft Power Apps ou do Power Automate com o recurso de conector personalizado
  • Uma assinatura do Azure com o provedor de recursos da Grade de Eventos registrado
  • Um recurso dos Serviços de Comunicação do Azure
  • Um número de telefone comprado dos Serviços de Comunicação do Azure configurado para receber mensagens SMS

Como obter credenciais

  1. Criar um recurso dos Serviços de Comunicação do Azure – documento de início rápido.

  2. Compre um número de telefone neste recurso com o recurso "Enviar e receber SMS" selecionado.

  3. Registre um provedor de recursos da Grade de Eventos para a assinatura em que o recurso dos Serviços de Comunicação do Azure está contido.

  4. Crie um usuário da ID do Microsoft Entra ou uma Entidade de Serviço que possa ser usada para a conexão do conector.

    • Opção 1: Conexão usando a conta da ID do Microsoft Entra – Adicionar um novo usuário
    • Opção 2: Conexão usando a Autenticação da Entidade de Serviço (aplicativo Microsoft Entra ID) – você também pode configurar uma entidade de serviço, criar um aplicativo registrado na CLI do Azure ou por meio do portal do Azure. Em seguida, as credenciais podem ser usadas para autenticar.

  5. Verifique se o usuário ou a entidade de serviço do Microsoft Entra ID tem as seguintes permissões atribuídas a eles:

    • Microsoft.Communication/CommunicationServices/Read

    • Microsoft.Resources/subscriptions/resourceGroups/read

    • Microsoft.EventGrid/eventSubscriptions/write

    • Microsoft.EventGrid/eventSubscriptions/read

    • Microsoft.EventGrid/eventSubscriptions/delete

      Isso pode ser feito criando uma função personalizada ou atribuindo o usuário às seguintes funções internas:

    • Leitor – No nível de recurso dos Serviços de Comunicação do Azure

    • Colaborador eventGrid EventSubscription – No nível do grupo de recursos

Introdução ao conector

Esse conector contém um único gatilho quando uma mensagem SMS é recebida. Por padrão, ele será executado quando uma mensagem for enviada para qualquer um dos números de telefone comprados, mas também poderá ser configurada para ser executada apenas com base nos números de telefone "Para" e "De" da mensagem SMS.

Problemas e limitações conhecidos

  • Dispare temporariamente desabilitado na atualização se "Nome da Assinatura do Evento" estiver definido – se um valor tiver sido atribuído ao campo "Nome da Assinatura do Evento" ao criar o gatilho, todas as atualizações no gatilho (por exemplo, adicionar um número de telefone "Para") poderão levar até 10 minutos para serem aplicadas. Durante esse tempo, o gatilho não funcionará.
  • A Assinatura de Evento não será excluída se a Conexão for excluída antes do Fluxo.

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Microsoft Entra ID Integrado Use a ID do Microsoft Entra para acessar os recursos de evento do ACS. Todas as regiões Não compartilhável
Autenticação da entidade de serviço (aplicativo ID do Microsoft Entra) Use a Autenticação de ID do Microsoft Entra para acessar o recurso do Serviço de Comunicação do Azure. Todas as regiões Não compartilhável
Padrão [PRETERIDO] Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. Todas as regiões Não compartilhável

ID do Microsoft Entra Integrado

ID de autenticação: aadOauth

Aplicável: todas as regiões

Use a ID do Microsoft Entra para acessar os recursos de evento do ACS.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Autenticação da entidade de serviço (aplicativo ID do Microsoft Entra)

ID de autenticação: aadOauthClientCredentials

Aplicável: todas as regiões

Use a Autenticação de ID do Microsoft Entra para acessar o recurso do Serviço de Comunicação do Azure.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
ID do locatário cadeia ID do locatário do aplicativo Microsoft Entra ID. Verdade
ID do cliente cadeia ID do cliente (ou aplicativo) do aplicativo Microsoft Entra ID. Verdade
Segredo de Cliente secureString Segredo do cliente do aplicativo Microsoft Entra ID. Verdade

Padrão [PRETERIDO]

Aplicável: todas as regiões

Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Gatilhos

Quando uma mensagem SMS é recebida

Quando uma mensagem SMS dos Serviços de Comunicação do Azure é recebida.

Quando uma mensagem SMS é recebida

ID da operação:
CreateSMSReceivedEventSubscription

Quando uma mensagem SMS dos Serviços de Comunicação do Azure é recebida.

Parâmetros

Nome Chave Obrigatório Tipo Description
Subscription
 subscriptionId True string

O identificador exclusivo para a assinatura do Microsoft Azure. A ID da assinatura faz parte da ID de cada recurso do Azure.
Nome do Grupo de Recursos
 resourceGroupName True string

O nome do grupo de recursos que contém o recurso.
Nome do Recurso
 resourceName True string

O nome do recurso dos Serviços de Comunicação.
Filtrar por número de telefone
 toPhoneNumbers array of string
Filtrar por meio do número de telefone
 fromPhoneNumbers array of string
Nome da assinatura do evento
 eventSubscriptionName string

O nome da nova assinatura de evento.
includedEventTypes
 includedEventTypes True array of string

Retornos

Nome Caminho Tipo Description
array of object
Para
 data.to string
De
 data.from string
Message
 data.message string
Carimbo de data/hora recebido
 data.receivedTimestamp string
ID da mensagem
 data.messageId string