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/ |
| 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
- Aktywna subskrypcja MCNE. Kup plan MCNE na Azure Marketplace. Podczas aprowizacji dzierżawa Microsoft Entra jest automatycznie połączona z kontem MCNE.
- Zgoda administratora dzierżawy. Łącznik żąda delegowanych uprawnień
Notifications.SendiTemplates.Read. Administrator dzierżawy zatwierdza je raz. - 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. - 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:
- Dodaj akcję MCNE do przepływu i wybierz pozycję Zaloguj.
- 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.
- 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
- Dodaj akcję Wyślij z szablonu do przepływu.
- Wybierz szablon z listy rozwijanej Szablon — zawiera listę szablonów, które są włączone do użycia łącznika.
- Zmienne szablonu są wyświetlane jako poszczególne pola. Powiązywanie wartości wyzwalacza lub elementu Dataverse z każdym z nich.
- Wypełnij co najmniej jeden adres odbiorcy (adres e-mail, teams, SMS lub WhatsApp).
- Uruchamianie przepływu. Akcja zwraca identyfikator powiadomienia i
queuedstan.
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
- Adres e-mail: mcne@exesoftware.ro
- Witryna internetowa: https://mcne.live/
- Zasady ochrony prywatności: https://mcne.live/privacy-policy/
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
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
|
string | |||
|
Adres aplikacji Teams
|
teams | string | ||
|
Numer SMS
|
sms | string | ||
|
Numer aplikacji 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
Definicje
SendFromTemplateResponse
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator powiadomienia
|
id | string | |
|
Status
|
status | string |