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/ |
| 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
- 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.
- Consentimento do administrador do inquilino. O conector solicita as permissões
Notifications.Senddelegadas eTemplates.Read. Um administrador de inquilinos aprova estas uma vez. - 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. - 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:
- Adicione uma ação MCNE a um fluxo e escolha Iniciar sessão.
- 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.
- 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
- Adiciona a ação Enviar do template a um fluxo.
- Escolhe um modelo no menu suspenso de Modelos — lá estão listados os modelos que ativaste para uso no conector.
- As variáveis do modelo aparecem como campos individuais. Associe valores de gatilho ou Dataverse a cada um.
- Preencha pelo menos um endereço do destinatário (email, Teams, SMS ou WhatsApp).
- Executar o fluxo. A ação devolve o id da notificação e um
queuedestado.
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
- E-mail: mcne@exesoftware.ro
- Sítio Internet: https://mcne.live/
- Política de privacidade: https://mcne.live/privacy-policy/
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
|
string | |||
|
Endereço da equipa
|
teams | string | ||
|
Número SMS
|
sms | string | ||
|
Número do 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
- Corpo
- SendFromTemplateResponse
Definições
SendFromTemplateResponse
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID de notificação
|
id | string | |
|
Status
|
status | string |