Notificação do MCNE (versão prévia)

Envie notificações de vários canais de seus modelos mcne.

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

Service Classe Regions
Copilot Studio Premium Todas as regiões 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:
     – Azure Governamental regiões
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões 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 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
Name EXE Software SRL
URL https://mcne.live/
Email mcne@exesoftware.ro
Metadados do conector
Publicador SOFTWARE EXE – MCNE
Website https://mcne.live/
Política de privacidade https://mcne.live/privacy-policy/
Categories Comunicação; Produtividade

Notificação do MCNE

O MCNE (Mecanismo de Notificação multicanal) é uma plataforma de notificação multilocatário da EXE Software SRL. Esse conector permite enviar notificações de vários canais e modelos – email, Microsoft Teams, SMS e WhatsApp – diretamente de seus fluxos, usando os modelos de mensagem e os provedores de entrega que você já configurou no MCNE.

O conteúdo da notificação reside no MCNE como modelos reutilizáveis. O conector lê esses modelos, renderiza as variáveis de cada um como campos de entrada individuais no designer e envia o resultado por meio dos canais de entrega configurados para esse modelo.

Publicador

EXE Software SRL — https://mcne.live/

Prerequisites

  1. Uma assinatura ativa do MCNE. Compre um plano MCNE no Azure Marketplace. Durante o provisionamento, seu locatário Microsoft Entra é vinculado à sua conta MCNE automaticamente.
  2. Consentimento do administrador do locatário. O conector solicita as permissões Notifications.Send delegadas e Templates.Read. Um administrador de locatários aprova isso uma vez.
  3. Pelo menos um modelo habilitado para uso do conector. No portal do MCNE (/templates), alterne a alternância do Conector para cada modelo que você deseja que esteja disponível aqui. Isso é aceita: os modelos ficam ocultos do conector até você habilitá-los.
  4. Provedores de entrega configurados no MCNE. Seus próprios provedores de SMS/email (por exemplo, Twilio ou SendGrid) são configurados por canal no portal do MCNE.

Como obter credenciais

Não são necessárias chaves de API ou segredos. O conector usa Microsoft Entra ID entrada:

  1. Adicione uma ação MCNE a um fluxo e escolha Entrar.
  2. Entre com a conta corporativa da sua organização e aceite o prompt de consentimento. Se o consentimento exigir um administrador, o administrador do locatário o aprovará uma vez para toda a organização.
  3. A conexão resultante é reutilizado por cada fluxo em seu ambiente.

Seu locatário do Entra é correspondido à sua conta mcne, para que você só veja seus próprios modelos.

Introdução ao conector

  1. Adicione a ação Enviar do modelo a um fluxo.
  2. Escolha um modelo na lista suspensa Modelo – ele lista os modelos que você habilitou para uso do conector.
  3. As variáveis do modelo aparecem como campos individuais. Associe os valores do gatilho ou do Dataverse a cada um deles.
  4. Preencha pelo menos um endereço de destinatário (email, Teams, SMS ou WhatsApp).
  5. Execute o fluxo. A ação retorna a ID de notificação e um queued status.

Example

Um fluxo disparado por um novo caso dataverse de alta prioridade seleciona o case_acknowledgement modelo, associa o número de caso e o nome do proprietário às variáveis de modelo e envia um email e SMS ao agente atribuído.

Operações com suporte

Enviar do modelo

Envia uma notificação criada a partir de um de seus modelos mcne. Entradas: o modelo, os endereços de entrega do destinatário e um valor para cada variável de modelo. As entradas opcionais permitem restringir o modelo a um aplicativo MCNE específico ou fornecer sua própria ID de notificação.

Limitações e problemas conhecidos

  • Os modelos são aceitos. Somente os modelos com a alternância conector habilitada no portal do MCNE aparecem no seletor. Se um modelo for desabilitado posteriormente, os fluxos referenciando-o falharão com um erro claro "não habilitado para o conector externo".
  • A entrega é assíncrona. Uma resposta bem-sucedida significa que a notificação foi aceita e enfileirada, não que tenha sido entregue. O status de entrega por canal é acompanhado no MCNE.
  • Um destinatário por chamada. Cada chamada de ação tem como destino um único destinatário, que pode ter vários endereços de canal. Use um loop para notificar vários destinatários.
  • Os canais seguem o modelo. A notificação é enviada nos canais habilitados para o modelo escolhido. O fornecimento de um endereço para um canal que o modelo não usa não tem efeito e um canal habilitado sem endereço não é tentado.
  • Variáveis de modelo são texto. Todas as entradas variáveis são cadeias de caracteres; formatar datas e números antes de as associar.
  • O uso é medido. Notificações enviadas por meio da contagem de conectores para seu plano MCNE.
  • Licenciamento Premium. Como conector para um serviço externo, esse é um conector premium e requer o licenciamento Power Automate apropriado.

Erros comuns e soluções

Resposta Meaning Solução
401 invalid_token / token_expired A entrada está ausente ou expirou. Crie novamente a conexão e entre novamente.
402 subscription_required Nenhuma assinatura ativa do MCNE está vinculada ao locatário do Entra. Compre um plano MCNE no Azure Marketplace ou entre em contato com o suporte para vincular seu locatário.
403 subscription_suspended Sua assinatura do MCNE está suspensa. Resolva a cobrança ou contate o suporte.
403 insufficient_scope A conexão não tem uma permissão necessária. Peça a um administrador de locatário para conceder consentimento e, em seguida, recriar a conexão.
403 template_not_connector_enabled O modelo não está habilitado para uso do conector. Alterne a alternância do Conector para esse modelo no portal do MCNE.
404 template_not_found Nenhum modelo desse tipo para sua organização. Escolha um modelo na lista suspensa em vez de digitar uma ID.
422 template_not_active O modelo existe, mas está inativo. Ative o modelo no portal do MCNE.
400 no_delivery_address Nenhum endereço do destinatário foi fornecido. Forneça pelo menos um email, Teams, SMS ou WhatsApp.
400 validation_failed Falha na validação do modelo de notificação. Verifique a mensagem na resposta do problema específico.
503 auth_unavailable A validação de entrada está temporariamente indisponível. Tente novamente em breve; contate o suporte se ele persistir.

Suporte

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.

Ações

Enviar do modelo

Envie uma notificação usando um dos modelos do MCNE.

Enviar do modelo

Envie uma notificação usando um dos modelos do MCNE.

Parâmetros

Nome Chave Obrigatório Tipo Description
Template
template_id True string

O modelo a ser enviado.

Identificação de usuário
user_id string
Endereço de email
email string
Endereço do Teams
teams string
Número de SMS
sms string
Número do WhatsApp
whatsapp string
Variáveis de modelo
variables object

Valores para as variáveis do modelo.

ID do aplicativo
app_id string

Optional. Restrinja o modelo a um aplicativo específico.

ID de notificação
notification_id string

ID opcional fornecida pelo chamador; gerado automaticamente se omitido.

Retornos

Definições

SendFromTemplateResponse

Nome Caminho Tipo Description
ID de notificação
id string
Status
status string