Notificação MCNE (Pré-visualização)

Envie notificações multicanal a partir dos seus modelos MCNE.

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

Service Classe Regiões
Estúdio Copiloto Premium Todas as regiões Power Automate exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões Azure Government
     - 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 (CCG)
     - 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 (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contact
Name EXE Software SRL
URL https://mcne.live/
Email mcne@exesoftware.ro
Metadados do conector
Publisher EXE SOFTWARE - MCNE
Website https://mcne.live/
Política de privacidade https://mcne.live/privacy-policy/
Categories Comunicação; Produtividade

Notificação MCNE

MCNE (Multi-Channel Notification Engine) é uma plataforma de notificação multi-inquilino da EXE Software SRL. Este conector permite-lhe enviar notificações modelo e multicanal — email, Microsoft Teams, SMS e WhatsApp — diretamente dos seus fluxos, usando os modelos de mensagens e fornecedores de entrega que já configurou no MCNE.

O seu conteúdo de notificações está presente no MCNE como modelos reutilizáveis. O conector lê esses templates, renderiza as variáveis de cada um como campos de entrada individuais no designer e envia o resultado através dos canais de entrega configurados para esse template.

Publisher

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

Prerequisites

  1. Uma subscrição ativa do MCNE. Compre um plano MCNE no Azure Marketplace. Durante o provisionamento, o seu inquilino Microsoft Entra está automaticamente ligado à sua conta MCNE.
  2. Consentimento do administrador do inquilino. O conector solicita as permissões Notifications.Send delegadas e Templates.Read. Um administrador de inquilinos aprova estas uma vez.
  3. Pelo menos um template ativado para uso em conectores. No portal MCNE (/templates), ativa a opção Connector para cada modelo que queres disponível aqui. Isto é opt-in: os modelos ficam ocultos do conector até os ativares.
  4. Fornecedores de entrega configurados no MCNE. Os seus próprios fornecedores de SMS/email (por exemplo, Twilio ou SendGrid) são configurados por canal no portal MCNE.

Como obter credenciais

Não são necessárias chaves API nem segredos. O conector utiliza o login do Microsoft Entra ID:

  1. Adicione uma ação MCNE a um fluxo e escolha Iniciar sessão.
  2. Inicie sessão com a conta de trabalho da sua organização e aceite o pedido de consentimento. Se o consentimento exigir um administrador, o administrador do inquilino aprova-o uma vez para toda a organização.
  3. A ligação resultante é reutilizada por cada fluxo no seu ambiente.

O seu inquilino Entra está associado à sua conta MCNE, por isso só vê os seus próprios modelos.

Introdução ao conector

  1. Adiciona a ação Enviar do template a um fluxo.
  2. Escolhe um modelo no menu suspenso de Modelos — lá estão listados os modelos que ativaste para uso no conector.
  3. As variáveis do modelo aparecem como campos individuais. Associe valores de gatilho ou Dataverse a cada um.
  4. Preencha pelo menos um endereço do destinatário (email, Teams, SMS ou WhatsApp).
  5. Executar o fluxo. A ação devolve o id da notificação e um queued estado.

Example

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

Operações suportadas

Enviar a partir do modelo

Envia uma notificação construída a partir de um dos teus modelos MCNE. Entradas: o modelo, os endereços de entrega do destinatário e um valor para cada variável modelo. Entradas opcionais permitem-lhe restringir o modelo a uma aplicação MCNE específica ou fornecer o seu próprio ID de notificação.

Problemas e limitações conhecidos

  • Os modelos são opt-in. Apenas os modelos com a opção Connector ativada no portal MCNE aparecem no seletor. Se um template for desativado posteriormente, os fluxos que o referenciam falham com um erro claro de "não ativado para o conector externo".
  • A entrega é assíncrona. Uma resposta bem-sucedida significa que a notificação foi aceite e colocada em fila, não que tenha sido entregue. O estado de entrega por canal é monitorizado no MCNE.
  • Um destinatário por chamada. Cada chamada de ação visa um único destinatário, que pode ter vários endereços de canais. Use um loop para notificar múltiplos destinatários.
  • Os canais seguem o modelo. A notificação é enviada nos canais ativados para o modelo escolhido. Fornecer um endereço para um canal que o template não utiliza não tem efeito, e um canal ativado sem endereço não é tentado.
  • Variáveis modelo são texto. Todas as entradas das variáveis são strings; formatar datas e números antes de os vincular.
  • O consumo é medido. As notificações enviadas através do conector contam para o seu plano MCNE.
  • Licenciamento premium. Como conector para um serviço externo, trata-se de um conector premium e requer a licença Power Automate adequada.

Erros e soluções comuns

Resposta Meaning Solução
401 invalid_token / token_expired O login está em falta ou expirado. Recrie a ligação e volte a iniciar sessão.
402 subscription_required Nenhuma subscrição ativa da MCNE está associada ao seu inquilino Entra. Compre um plano MCNE no Azure Marketplace ou contacte o suporte para ligar o seu inquilino.
403 subscription_suspended A sua subscrição do MCNE está suspensa. Resolva a faturação ou contacte o suporte.
403 insufficient_scope A ligação não tem a permissão necessária. Pede a um administrador de inquilinos que conceda consentimento e depois recrie a ligação.
403 template_not_connector_enabled O modelo não está ativado para uso em conectores. Ativa a opção Connector para esse modelo no portal MCNE.
404 template_not_found Não existe esse modelo para a sua organização. Escolhe um modelo do menu suspenso em vez de escrever um ID.
422 template_not_active O modelo existe, mas está inativo. Ative o modelo no portal MCNE.
400 no_delivery_address Não foi fornecido qualquer endereço do destinatário. Forneça pelo menos um email, Teams, SMS ou WhatsApp.
400 validation_failed A notificação falhou na validação do modelo. Verifique a mensagem na resposta para o problema específico.
503 auth_unavailable A validação de início de sessão está temporariamente indisponível. Tente novamente em breve; contacte o apoio se persistir.

Suporte

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição 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.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Ações

Enviar a partir do modelo

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

Enviar a partir do modelo

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

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Template
template_id True string

O modelo a enviar.

ID do utilizador
user_id string
Endereço de e-mail
email string
Endereço da equipa
teams string
Número SMS
sms string
Número do WhatsApp
whatsapp string
Variáveis de modelo
variables object

Valores para as variáveis do modelo.

ID da aplicação
app_id string

Optional. Restrinja o modelo a uma aplicação específica.

ID de notificação
notification_id string

ID opcional fornecido pelo chamador; gerado automaticamente se omitido.

Devoluções

Definições

SendFromTemplateResponse

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