Compartilhar via

Email de Comunicação do Azure

Conector para enviar email usando os domínios vinculados aos 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
Website https://azure.microsoft.com/services/communication-services
Política de privacidade https://privacy.microsoft.com
Categorias Communication

O Email dos Serviços de Comunicação do Azure é um novo primitivo que facilita emails transacionais, em massa e de marketing de alto volume na plataforma dos Serviços de Comunicação do Azure e habilitará casos de uso de Aplicativo para Pessoa (A2P). As ofertas de Email dos Serviços de Comunicação do Azure melhorarão seu tempo de comercialização com recursos de email escalonáveis e confiáveis com seus próprios domínios SMTP. Assim como outras modalidades de comunicação, a oferta de email tem o benefício de pagar apenas pelo que você usa.

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
  • Um recurso de Email dos Serviços de Comunicação do Azure com um domínio configurado
  • Um recurso dos Serviços de Comunicação do Azure conectado a um domínio de Email do Azure

Como obter credenciais

  1. Configurar um recurso dos Serviços de Comunicação do Azure

  2. Configurar um recurso de email dos Serviços de Commuincation do Azure

    1. Criar um recurso de email
    2. Configurar um domínio

  3. Conectar o domínio de email com o recurso dos Serviços de Comunicação

  4. Autenticação da cadeia de conexão

Introdução ao conector

Depois de configurar um recurso de Email dos Serviços de Comunicação do Azure e configurar um domínio, navegue até o domínio provisionado e copie o MailFrom email. Isso será usado como o From email na ação Send email .

Problemas e limitações conhecidos

  1. O Email dos Serviços de Comunicação do Azure está atualmente em versão prévia pública. ApIs e SDKs de visualização são fornecidos sem um contrato de nível de serviço e não são recomendados para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos.

  2. Não dá suporte à autenticação de entidade de serviço (aplicativo ID do Microsoft Entra) no momento.

  3. Somente esses tipos de anexo de email têm suporte.

Erros e soluções comuns

Ao anexar anexos sem suporte, a ação Send email falhará como um BadRequest. Consulte esses tipos de anexo de email.

perguntas frequentes

  1. Onde está meu email?

    • A entrega de email pode levar até alguns minutos e acabar na caixa de lixo eletrônico ao usar domínios gerenciados do Azure. Verifique sua caixa de lixo eletrônico.

  2. Como enviar um email com anexos?

    • Anexos de email exigem um nome de anexo e um conteúdo de anexo. Alguns serviços de hospedagem de arquivos, como o OneDrive e o SharePoint, têm suporte nativo no Power Automate e têm ações como Get file metadata obter o nome do arquivo e Get file content obter o conteúdo do arquivo.

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Default Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

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
Cadeia de conexão secureString Cadeia de conexão dos Serviços de Comunicação do Azure. Verdade

Limitações

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

Ações

Enviar email

Envia uma mensagem de email para um ou mais destinatários.
Enviar email (versão prévia) – PRETERIDO [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Enviar email .

Envia uma mensagem de email para um ou mais destinatários – PRETERIDO
Obter o status da mensagem de email

Obtém o status de uma mensagem de email enviada anteriormente.
Obter o status da mensagem de email (versão prévia) – PRETERIDO [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Obter o status da mensagem de email .

Obtém o status de uma mensagem de email enviada anteriormente – PRETERIDO

Enviar email

ID da operação:
SendEmailGAVersion

Envia uma mensagem de email para um ou mais destinatários.

Parâmetros

Nome Chave Obrigatório Tipo Description
De
 senderAddress True string

O endereço de email do remetente de um domínio verificado.11
Importância
 importance string
Email (Para)
 address True string

O endereço de email do destinatário principal.
Email (CC)
 address True string

O endereço de email do destinatário adicional.
Email (CCO)
 address True string

O endereço de email de destinatário adicional que é invisível na cadeia de email.
Assunto
 subject True string

Especifique o assunto do email.
Corpo
 html html

Especifique o corpo do email.
Email (Responder a)
 address True string

O endereço de email para o qual as respostas dos destinatários serão enviadas.
Nome
 name True string

Nome do anexo com extensão.
Tipo
 contentType True string

O tipo de arquivo de anexo.
Content
 contentInBase64 True byte

Conteúdo do anexo.
nome
 name True string

Insira a chave.
value
 value True string

Insira o valor.
Desabilitar o controle de envolvimento do usuário
 userEngagementTrackingDisabled boolean

Indica se o controle de envolvimento do usuário deve ser desabilitado para essa solicitação se a configuração de acompanhamento de envolvimento do usuário no nível do recurso já estava habilitada no plano de controle.

Retornos

Status da operação de longa duração

Corpo
EmailSendResult

Enviar email (versão prévia) – PRETERIDO [PRETERIDO]

ID da operação:
SendEmail

Esta ação foi preterida. Em vez disso, use Enviar email .

Envia uma mensagem de email para um ou mais destinatários – PRETERIDO

Parâmetros

Nome Chave Obrigatório Tipo Description
De
 sender True string

O endereço de email do remetente de um domínio verificado.
Email (Para)
 email True string

O endereço de email do destinatário principal.
Email (CC)
 email True string

O endereço de email do destinatário adicional.
Email (CCO)
 email True string

O endereço de email de destinatário adicional que é invisível na cadeia de email.
Assunto
 subject True string

Especifique o assunto do email.
Corpo
 html html

Especifique o corpo do email.
Email (Responder a)
 email True string

O endereço de email para o qual as respostas dos destinatários serão enviadas.
Nome
 name True string

Nome do anexo com extensão.
Content
 contentBytesBase64 True byte

Conteúdo do anexo.
Importância
 importance string

O tipo de importância para o email.
Desabilitar o controle de envolvimento do usuário
 disableUserEngagementTracking boolean

Indica se o controle de envolvimento do usuário deve ser desabilitado para essa solicitação se a configuração de acompanhamento de envolvimento do usuário no nível do recurso já estava habilitada no plano de controle.

Obter o status da mensagem de email

ID da operação:
GetMessageStatusGAVersion

Obtém o status de uma mensagem de email enviada anteriormente.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da operação
 operationId True string

ID da operação de uma chamada anterior para enviar email.

Retornos

Status da operação de longa duração

Corpo
EmailSendResult

Obter o status da mensagem de email (versão prévia) – PRETERIDO [PRETERIDO]

ID da operação:
GetMessageStatus

Esta ação foi preterida. Em vez disso, use Obter o status da mensagem de email .

Obtém o status de uma mensagem de email enviada anteriormente – PRETERIDO

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da mensagem
 messageId True string

ID da mensagem de uma chamada anterior para enviar email.

Retornos

Nome Caminho Tipo Description
ID da mensagem
 messageId string
Status da mensagem
 status string

Definições

Detalhe do erro

O detalhe do erro.

Nome Caminho Tipo Description
codificar
 code string

O código de erro.
mensagem
 message string

A mensagem de erro.
destino
 target string

O destino do erro.
details
 details array of ErrorDetail

Os detalhes do erro.
Informações adicionais
 additionalInfo array of ErrorAdditionalInfo

As informações adicionais do erro.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Caminho Tipo Description
tipo
 type string

O tipo de informação adicional.
informação
 info object

As informações adicionais.

ResultadoDoEnvioDeEmail

Status da operação de longa duração

Nome Caminho Tipo Description
id
 id string

O ID exclusivo da operação. Use um UUID.
status
 status string

Estado da operação.
erro
 error ErrorDetail

O detalhe do erro.