Powiadomienie MCNE (wersja zapoznawcza)

Wysyłanie powiadomień wielokanałowych z szablonów MCNE.

Ten łącznik jest dostępny w następujących produktach i regionach:

Service Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate - narzędzie do automatyzacji procesów Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Contact
Name Lista SRL oprogramowania EXE
adres URL https://mcne.live/
Email mcne@exesoftware.ro
Metadane łącznika
Publisher OPROGRAMOWANIE EXE — MCNE
Website https://mcne.live/
Zasady ochrony prywatności https://mcne.live/privacy-policy/
Categories Komunikacja; Produktywność

Powiadomienie MCNE

MCNE (wielokanałowy aparat powiadomień) to wielodostępna platforma powiadomień firmy EXE Software SRL. Ten łącznik umożliwia wysyłanie szablonowych, wielokanałowych powiadomień — wiadomości e-mail, Microsoft Teams, wiadomości SMS i WhatsApp — bezpośrednio z przepływów przy użyciu szablonów wiadomości i dostawców dostarczania, które zostały już skonfigurowane w usłudze MCNE.

Zawartość powiadomień znajduje się w aplikacji MCNE jako szablony wielokrotnego użytku. Łącznik odczytuje te szablony, renderuje zmienne każdego z nich jako poszczególne pola wejściowe w projektancie i wysyła wynik za pośrednictwem kanałów dostarczania skonfigurowanych dla tego szablonu.

Publisher

Lista SRL oprogramowania EXE — https://mcne.live/

Prerequisites

  1. Aktywna subskrypcja MCNE. Kup plan MCNE na Azure Marketplace. Podczas aprowizacji dzierżawa Microsoft Entra jest automatycznie połączona z kontem MCNE.
  2. Zgoda administratora dzierżawy. Łącznik żąda delegowanych uprawnień Notifications.Send i Templates.Read. Administrator dzierżawy zatwierdza je raz.
  3. Co najmniej jeden szablon włączony do użycia łącznika. W portalu MCNE (/templates) włącz przełącznik Łącznik dla każdego szablonu, który ma być dostępny tutaj. Jest to zgoda: szablony są ukryte przed łącznikiem do momentu ich włączenia.
  4. Dostawcy dostarczania skonfigurowani w usłudze MCNE. Twoi dostawcy wiadomości SMS/poczty e-mail (na przykład Twilio lub SendGrid) są konfigurowane dla kanału w portalu MCNE.

Jak uzyskać poświadczenia

Nie są potrzebne żadne klucze interfejsu API ani wpisy tajne. Łącznik używa Microsoft Entra ID logowania:

  1. Dodaj akcję MCNE do przepływu i wybierz pozycję Zaloguj.
  2. Zaloguj się przy użyciu konta służbowego organizacji i zaakceptuj monit o wyrażenie zgody. Jeśli zgoda wymaga administratora, administrator dzierżawy zatwierdzi go raz dla całej organizacji.
  3. Wynikowe połączenie jest ponownie używane przez każdy przepływ w danym środowisku.

Twoja dzierżawa entra jest zgodna z twoim kontem MCNE, więc widzisz tylko własne szablony.

Wprowadzenie do łącznika

  1. Dodaj akcję Wyślij z szablonu do przepływu.
  2. Wybierz szablon z listy rozwijanej Szablon — zawiera listę szablonów, które są włączone do użycia łącznika.
  3. Zmienne szablonu są wyświetlane jako poszczególne pola. Powiązywanie wartości wyzwalacza lub elementu Dataverse z każdym z nich.
  4. Wypełnij co najmniej jeden adres odbiorcy (adres e-mail, teams, SMS lub WhatsApp).
  5. Uruchamianie przepływu. Akcja zwraca identyfikator powiadomienia i queued stan.

Example

Przepływ wyzwalany przez nowy przypadek usługi Dataverse o wysokim priorytcie case_acknowledgement wybiera szablon, wiąże numer sprawy i nazwę właściciela ze zmiennymi szablonu oraz wysyła wiadomość e-mail i sms do przypisanego agenta.

Obsługiwane operacje

Wyślij z szablonu

Wysyła powiadomienie utworzone na podstawie jednego z szablonów MCNE. Dane wejściowe: szablon, adresy dostarczania adresata i wartość dla każdej zmiennej szablonu. Opcjonalne dane wejściowe umożliwiają ograniczenie szablonu do określonej aplikacji MCNE lub podanie własnego identyfikatora powiadomienia.

Znane problemy i ograniczenia

  • Szablony są opt-in. Selektor zawiera tylko szablony z włączonym przełącznikiem łącznika w portalu MCNE. Jeśli szablon zostanie później wyłączony, przepływy odwołujące się do niego kończą się niepowodzeniem z wyraźnym błędem "nie włączono dla łącznika zewnętrznego".
  • Dostarczanie jest asynchroniczne. Pomyślna odpowiedź oznacza, że powiadomienie zostało zaakceptowane i w kolejce, a nie dostarczone. Stan dostarczania poszczególnych kanałów jest śledzony w usłudze MCNE.
  • Jeden adresat na połączenie. Każde wywołanie akcji jest przeznaczone dla pojedynczego adresata, który może mieć kilka adresów kanału. Użyj pętli, aby powiadomić wielu adresatów.
  • Kanały są zgodne z szablonem. Powiadomienie jest wysyłane w kanałach włączonych dla wybranego szablonu. Podanie adresu dla kanału, który nie jest używany przez szablon, nie ma żadnego wpływu, a włączony kanał bez adresu nie jest podejmowana.
  • Zmienne szablonu to tekst. Wszystkie zmienne wejściowe są ciągami; formatuj daty i liczby przed ich powiązaniem.
  • Użycie jest mierzone. Powiadomienia wysyłane za pośrednictwem łącznika są wliczane do planu MCNE.
  • Licencjonowanie w warstwie Premium. Jako łącznik usługi zewnętrznej jest to łącznik w warstwie Premium i wymaga odpowiednich Power Automate licencjonowania.

Typowe błędy i środki zaradcze

Response Meaning Rozwiązanie
401 invalid_token / token_expired Brak lub wygaśnięcie logowania. Utwórz ponownie połączenie i zaloguj się ponownie.
402 subscription_required Żadna aktywna subskrypcja MCNE nie jest połączona z dzierżawą entra. Kup plan MCNE na Azure Marketplace lub skontaktuj się z pomocą techniczną, aby połączyć dzierżawę.
403 subscription_suspended Twoja subskrypcja MCNE jest zawieszona. Rozwiąż problemy z rozliczeniami lub skontaktuj się z pomocą techniczną.
403 insufficient_scope Połączenie nie ma wymaganych uprawnień. Poproś administratora dzierżawy o wyrażenie zgody, a następnie utwórz ponownie połączenie.
403 template_not_connector_enabled Szablon nie jest włączony do użycia łącznika. Włącz przełącznik Łącznik dla tego szablonu w portalu MCNE.
404 template_not_found Nie ma takiego szablonu dla organizacji. Wybierz szablon z listy rozwijanej zamiast wpisywać identyfikator.
422 template_not_active Szablon istnieje, ale jest nieaktywny. Aktywuj szablon w portalu MCNE.
400 no_delivery_address Nie podano adresu adresata. Podaj co najmniej jedną wiadomość e-mail, aplikację Teams, sms lub WhatsApp.
400 validation_failed Sprawdzanie poprawności szablonu powiadomienia nie powiodło się. Sprawdź komunikat w odpowiedzi na konkretny problem.
503 auth_unavailable Weryfikacja logowania jest tymczasowo niedostępna. Ponów próbę wkrótce; skontaktuj się z pomocą techniczną, jeśli będzie się powtarzać.

Support

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Akcje

Wyślij z szablonu

Wyślij powiadomienie przy użyciu jednego z szablonów MCNE.

Wyślij z szablonu

Identyfikator operacji:
SendFromTemplate

Wyślij powiadomienie przy użyciu jednego z szablonów MCNE.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Template
 template_id True string

Szablon do wysłania.
Identyfikator użytkownika
 user_id string
Adres e-mail
 email string
Adres aplikacji Teams
 teams string
Numer SMS
 sms string
Numer aplikacji WhatsApp
 whatsapp string
Zmienne szablonu
 variables object

Wartości zmiennych szablonu.
Identyfikator aplikacji
 app_id string

Optional. Ogranicz szablon do określonej aplikacji.
Identyfikator powiadomienia
 notification_id string

Opcjonalny identyfikator dostarczony przez obiekt wywołujący; automatycznie generowane w przypadku pominięcia.

Zwraca

Body
SendFromTemplateResponse

Definicje

SendFromTemplateResponse

Nazwisko Ścieżka Typ Opis
Identyfikator powiadomienia
 id string
Status
 status string