Handbuch als PDF speichern oder drucken  


NVXSMS SMS Interface


Stellt die Basis Funktionalitäten des SMS Versands zur Verfügung.

Aktuelle Version: 1.0.5.0 ab Business Central 22.

Handbuch


Erstellungsdatum: 2024/12/27
Die aktuelle Version dieses Handbuchs finden Sie unter:

https://www.navax.app/help.php?AppID=NVXSMS&L=de


☰ Inhaltsverzeichnis



Allgemein

  • App SMS Interface
    Diese App erweitert Business Central um die Funktion, SMS-Nachrichten zu erstellen und diese dann anschließend zu versenden...

Einrichtung

  • Einrichtung SMS-Konto
    Die SMS-Konten enthalten alle notwendigen Informationen, um SMS an die SMS-Provider weiterzuleiten und damit den SMS-Versand aus BC zu ermöglichen...
  • Einrichtung SMS-Szenarios
    Szenarios verknüpfen SMS mit Belegen und bestimmen je nach Belegart das Verhalten der SMS...

Aufgaben

  • Arbeiten mit der App
    Bevor eine SMS versandt werden kann, sind einige Felder verpflichtend zu befüllen...
  • Seiten

    • SMS-Konto
    • SMS-Konten
    • Zuweisung von SMS-Szenarios
    • SMS-Nachricht
    • SMS-Fehlerprotokoll
    • SMS-Nachrichten
    • SMS-Nachrichtenzeilen
    • Telefonvorwahlen
    • Gesendete SMS-Nachricht
    • Gesendete SMS-Nachrichten
    • Gesendete SMS-Nachrichtenzeilen
    • Gesendete SMS-Empfängerliste
    • SMS-Empfängerliste
    • SMS-Szenarios für das Konto
    • Kontakte
    • Gebuchte Servicerechnung
    • Verkaufsauftrag
    • Serviceauftrag
    • Serviceangebot

Anhang

  • Versionshinweise

Docs  /  NVXSMS SMS Interface  /  Allgemein
Allgemein

Diese App erweitert Business Central um die Funktion, SMS-Nachrichten zu erstellen und diese dann anschließend zu versenden.

Docs  /  NVXSMS SMS Interface  /  Einrichtung
Einrichtung SMS-Konto

Die SMS-Konten enthalten alle notwendigen Informationen, um SMS an die SMS-Provider weiterzuleiten und damit den SMS-Versand aus BC zu ermöglichen.

Neues Konto anlegen

Mit den Seiten SMS-Konten und SMS-Konto kann über die + Schaltfläche ein neues Konto angelegt werden.

SMS-Konten

Neues Konto befüllen

Beim Erstellen eines neuen Kontos, muss der SMS-Provider gesetzt werden. Der SMS-Provider bestimmt, welcher Provider für den Versand von SMS, bei Verwendung des Kontos, ausgewählt werden soll. In der Liste SMS-Konten wird der Name des Kontos zuerst angezeigt. Das Befüllen des entsprechenden Feldes ist aufgrund der Übersichtlichkeit empfehlenswert. Nachdem das Konto das erste Mal gespeichert wurde, ist es möglich die Web Genehmigung anzupassen. Weitere Informationen dazu finden Sie unter Web Genehmigung Um die Verbindung zu einem SMS-Provider zu gewährleisten, müssen hier alle notwendigen Anmeldeinformationen eingetragen werden. Der Provider legt dabei fest welche Arten der Anmeldungen möglich sind. Bei Linked Mobility ist die Endpunkt URL: "https://api.websms.com/" zu hinterlegen. Falls kein Verbindung mit diesem Endpunkt möglich ist, ist die Verbindung mit dem zweiten Endpunkt empfehlenswert: "https://api.linkmobility.eu/". Weitere Informationen findet man in der Hilfe des SMS-Providers, der im Konto hinterlegt werden soll.

Konto und Szenarios

Anschließend können Szenarios definiert werden. Der Default Wert kann direkt von der Konto Karte aus gesetzt werden, alle anderen, benutzerdefinierte Szenarios, müssen individuell eingerichtet werden. Beim Zuweisen von Szenarios gilt, ein Szenario kann nur einem Konto zugewiesen werden. Ein Konto kann aber mehrere Szenarios besitzen. Für weitere Informationen siehe Szenario Einrichtung.

Docs  /  NVXSMS SMS Interface  /  Einrichtung
Einrichtung SMS-Szenarios

Szenarios verknüpfen SMS mit Belegen und bestimmen je nach Belegart das Verhalten der SMS. Das Einrichten der Szenarios spielt eine wichtige Rolle beim Versenden und Erstellen von SMS, denn das Szenario entscheidet mit welchem Konto die SMS versandt wird. Ist kein spezifisches Konto für das jeweilige Szenario hinterlegt, wird das Standard-Szenario verwendet. Hierbei ist wichtig zu beachten, dass zumindest das Default-Szenario eingerichtet werden muss.

Szenario Seite

Auf der Seite Zuweisung von SMS-Szenarios sind alle verfügbaren SMS-Konten ersichtlich. Wird ein SMS-Konto aufgerufen werden die zugehörigen Szenarios angezeigt. Ein SMS-Konto wird immer fett dargestellt und das SMS-Szenario ist unter dem Konto eingerückt.

Funktionen Konto

Die aufgelisteten Funktionen sind nur für SMS-Konten verfügbar. Sie sind nur ausführbar wenn ein Konto ausgewählt wurde.
FunktionsnameBeschreibung
Szenario zuweisenÖffnen die Liste aller verfügbaren SMS-Szenarios. Aus dieser Liste lässt sich ein Szenaro auswählen, dass dem ausgewähltem SMS-Konto zugeordned wird.

Funktionen Szenario

Die aufgelisteten Funktionen sind nur für SMS-Szenarios verfügbar. Sie sind nur ausführbar wenn ein Szenario ausgewählt ist.
FunktionsnameBeschreibung
ZuweisenÖffnet die Liste aller verfügbaren SMS-Konten. Aus dieser Liste lässt sich das Szenario dem ausgewählten Konto zuordnen.
Zuweisen aufhebenLöscht das SMS-Szenario aus der Liste und entfernt alle Textbausteine die zu diesem Szenario gehören.
TextbausteineÖffnet die Textbausteine Übersicht für das ausgewählte SMS-Szenario. In der Übersicht können neue Textbausteine erstellt, geändert oder gelöscht werden.

Docs  /  NVXSMS SMS Interface  /  Aufgaben
Arbeiten mit der App

Bevor eine SMS versandt werden kann, sind einige Felder verpflichtend zu befüllen. Zu Beginn müssen ein SMS-Konto und zumindest das Default-Szenario eingerichtet werden.

SMS-Empfängerliste

In der SMS-Empfängerliste können alle Empfänger für die jeweilige SMS angegeben werden. Die maximal zugelassene Menge legt der Provider fest. Jede Mobiltelefonnummer, die in der Empfängerliste angegeben ist, erhält die Nachricht aus den SMS-Nachrichtenzeilen. Dabei muss beachtet werden, dass dies zu mehreren Nachrichten gleichzeitig führen kann, abhängig vom Anbieter und der maximalen Nachrichtenlänge. Zum Versenden muss zumindest eine Mobiltelefonnummer und die dazugehörige Ländervorwahl eingetragen werden.

Ländervorwahl

Ist die Ländervorwahl noch nicht vorhanden, kann sie in der Liste Ländervorwahl angelegt werden. Dazu muss der Ländercode mit einer Vorwahl verknüpft werden. Auf der Seite SMS-Nachricht, kann die Liste über den Button "Ländervorwahl anzeigen" oder das Drilldown des Felds geöffnet werden.

SMS-Nachrichtenzeilen

In den SMS-Nachrichtenzeilen kann der Inhalt der SMS verfasst werden. Wird die maximale Zeichenanzahl pro SMS überschritten, wird je nach Provider mehr als eine SMS an den Empfänger gesendet. Wenn die SMS verfasst und die Empfänger eingerichtet wurden, kann die Nachricht versendet werden. Das Versenden geschieht über den Button "SMS versenden".

Senden von SMS

Wird eine SMS gesendet, wird anhand der SMS-Nachricht das passende Konto aus den SMS-Konten ausgewählt. In den Nachrichten ist ein Szenario hinterlegt, welches beim Erstellen der Nachricht automatisch festgelegt wird. Wird anhand einer Verkaufsrechnung eine SMS erstellt, erhält die Nachricht automatisch das verknüpfte Szenario. Für weitere Informationen siehe Szenario Einrichtung. Nach erfolgreichem Senden von SMS-Nachrichten wird die gesendete SMS archiviert und gelöscht. Archivierte Nachrichten sind auf der Seite Gesendete SMS-Nachrichten zu finden. Schlägt das Senden einer SMS-Nachricht fehl, wird ein Eintrag auf der Seite SMS-Fehlerprotokoll erstellt. Hier sind alle nicht versendeten Nachrichten zu finden. Außerdem wird eine kurze Nachricht mit dem Grund ausgegeben. Kann die SMS nicht an den Provider weitergeleitet werden, wird ein Fehler ausgegeben. Für weitere Informationen siehe Web Messages.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
SMS-Konto

Felder

NameBeschreibung
Konto NameGibt den Kontonamen an.
SMS-ProviderGibt den Provider für den SMS-Versand an.

Aktionen

  • SMS Fehlerprotokoll

    SMS anzeigen, die auf das Senden warten oder aufgrund eines Fehlers nicht gesendet wurden.
  • SMS-Szenarios

    Weisen Sie den SMS-Konten Szenarios zu.
  • Als Standard festlegen

    Legt das Konto als Standardkonto für nicht definierte Szenarios fest.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
SMS Konten

Felder

NameBeschreibung
Konto NameGibt den Kontonamen an.
Server-URLGibt die Server-URL für den SMS-Anbieter an.
ServerportGibt den Server Port für den Server an.

Aktionen

  • SMS Fehlerprotokoll

    SMS anzeigen, die auf das Senden warten oder aufgrund eines Fehlers nicht gesendet wurden.
  • SMS Szenarios

    Weisen Sie den SMS Konten Szenarios zu.
  • Als Standard festlegen

    Legt das Konto als Standardkonto für nicht definierte Szenarios fest.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
Zuweisung von SMS-Szenarios

Felder

NameBeschreibung
Szenarios nach SMS-KontenGibt die Szenarios an, die das SMS-Konto verwenden.
StandardGibt an, ob dies das Standardkonto ist, das für Szenarios verwendet wird, wenn kein anderes Konto angegeben wird.

Aktionen

  • Szenarien zuordnen

    Weist SMS-Szenarios für das ausgewählte Konto zu. Bei der Zuweisung wird für alle Benutzer das Konto für das Szenario verwendet. Wenn Sie z.B. das Verkaufsauftragsszenario Konto A zuweisen, wird das Konto A von allen verwendet, um Verkaufsaufträge zu senden.
  • Zuweisen

    Weisen Sie die ausgewählten Szenarios einem anderen SMS-Konto zu.
  • Zuweisung aufheben

    Die Zuweisung der ausgewählten Szenarios aufheben. Danach wird das Standardkonto verwendet, um SMS für die Szenarios zu senden.
  • Textbausteine

    Öffenet die Textbausteine Übersicht für das ausgewählte SMS-Szenario. In der Übersicht können neue Textbausteine erstellt, geändert oder gelöscht werden.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
SMS-Nachricht

Felder

NameBeschreibung
Belegnr.Gibt die Belegnumber an.
BeschreibungGibt die Beschreibung an.

Aktionen

  • SMS versenden

    Verschickt die SMS and die Empfänger.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
SMS-Fehlerprotokoll

Felder

NameBeschreibung
Belegnr.Gibt die Beschreibung an.
BeschreibungGibt die Belegnummer an.
Nachrichtennr.Gibt die Nummer der Nachricht an die versucht wurde zu senden.
Nachricht gesendet amGibt die Uhrzeit und das Datum an, an dem die SMS gesendet wurde.
StatuscodeGibt Gibt den Statuscode des Providers an.
Status NachrichtGibt die Statusmeldung an, die den Fehler beschreibt. Nicht alle Statuscodes haben eine Statusmeldung.
Sender KontoGibt das Konto an, über das die SMS gesendet wurde.

Aktionen

  • Original SMS anzeigen

    Zeigt die ursprüngliche SMS-Nachricht an, aus der dieser Fehler stammt.
  • SMS versenden

    Verschickt die SMS and die Empfänger.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
SMS-Nachrichten

Felder

NameBeschreibung
Belegnr.Gibt die Belegnumber an.
BeschreibungGibt die Beschreibung an.
Nachrichtennr.Gibt die Nachrichtennummer an.
Anzahl der EmpfängernGibt die Anzahl der Empfänger an.
Anzahl der ZeichenGibt die Anzahl der Zeichen an.

Aktionen

  • SMS versenden

    Verschickt die SMS and die Empfänger.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
SMS-Nachrichtenzeilen

Felder

NameBeschreibung
Text NachrichtGibt den Inhalt der SMS-Nachricht an.
ZeilenumbruchGibt an, ob nach der ausgewählten Zeile ein Zeilenumbruch eingefügt werden soll.

Aktionen

  • Standard Textbausteine

    Wählen Sie zusätzlichen Textbausteine für SMS aus oder richten Sie diese ein. Markierte Textbausteine können mit dem Button OK in die SMS eingefügt werden.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
Telefonvorwahlen

Felder

NameBeschreibung
LändercodeGibt den Ländercode an, für die eine Vorwahl definiert werden soll.
VorwahlGibt die Vorwahl für den Ländercode an.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
Gesendete SMS-Nachricht

Felder

NameBeschreibung
Belegnr.Gibt die Belegnumber an.
BeschreibungGibt die Beschreibung an.
Sender KontoGibt das Konto an, über das die SMS gesendet wurde.
Nachricht gesendet amGibt die Uhrzeit und das Datum an, an dem die SMS gesendet wurde.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
Gesendete SMS-Nachrichten

Felder

NameBeschreibung
Belegnr.Gibt die Belegnumber an.
BeschreibungGibt die Beschreibung an.
Nachrichtennr.Gibt die Nachrichtennummer an.
Anzahl der EmpfängernGibt die Anzahl der Empfänger an.
Anzahl der ZeichenGibt die Anzahl der Zeichen an.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
Gesendete SMS-Nachrichtenzeilen

Felder

NameBeschreibung
Text NachrichtGibt den Inhalt der SMS-Nachricht an.
ZeilenumbruchGibt an, ob nach der ausgewählten Zeile ein Zeilenumbruch eingefügt werden soll.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
Gesendete SMS-Empfängerliste

Felder

NameBeschreibung
NameGibt den Namen des Empfängers an.
LändervorwahlGibt den Ländercode mit der Ländervorwahl des Empfängers an.
Mobiltelefonnr.Gibt die Mobiltelefonnummer des Empfängers an.
EmpfängertypGibt den Empfängertyp für die Suche in der Empfängernummer an.
Empfängernr.Gibt die Empfängernummer an.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
SMS-Empfängerliste

Felder

NameBeschreibung
NameGibt den Namen des Empfängers an.
LändervorwahlGibt den Ländercode mit der Ländervorwahl des Empfängers an.
Mobiltelefonnr.Gibt die Mobiltelefonnummer des Empfängers an.
EmpfängertypGibt den Empfängertyp für die Suche in der Empfängernummer an.
Empfängernr.Gibt die Empfängernummer an.

Aktionen

  • Telefonvorwahl anzeigen

    Öffnet die Seite mit der Liste der Ländervorwahlen.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
SMS-Szenarios für das Konto

Felder

NameBeschreibung
Szenarios nach SMS-KontenGibt die Szenarios an, die das SMS-Konto verwenden.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
Kontakte

Die Seite Kontakte wurde um folgende Felder erweitert:

Felder

MobiltelefonnummerGibt die Mobiltelefonnummer des Kontakts an.
Weitere Informationen dazu finden Sie unter Working with the App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
Gebuchte Servicerechnung

Die Karte Gebuchte Servicerechnung wurde um folgendes erweitert:

Felder

Anzahl gesendeter SMSGibt die Anzahl der gesendeten SMS an.

Aktionen

  • SMS versenden Diese Funktion öffnet eine Seite zum SMS versenden an.
  • Verknüpfte SMS Nachrichten Diese Funktion zeigt alle verknüpften Nachrichten an.
  • Gesendete SMS Nachrichten Diese Funktion zeigt alle gesendeten Nachrichten an.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
Verkaufsauftrag

Die Karte Verkaufsauftrag wurde um folgendes erweitert:

Felder

Anzahl gesendeter SMSGibt die Anzahl der gesendeten SMS an.

Aktionen

  • SMS versenden Diese Funktion öffnet eine Seite zum SMS versenden.
  • Verknüpfte SMS Nachrichten Diese Funktion zeigt alle verknüpften Nachrichten.
  • Gesendete SMS Nachrichten Diese Funktion zeigt alle gesendeten Nachrichten.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
Serviceauftrag

Die Karte Serviceauftrag wurde um folgendes erweitert:

Felder

Anzahl gesendeter SMSGibt die Anzahl der gesendeten SMS an.

Aktionen

  • SMS versenden Diese Funktion öffnet eine Seite zum SMS versenden.
  • Verknüpfte SMS Nachrichten Diese Funktion zeigt alle verknüpften Nachrichten.
  • Gesendete SMS Nachrichten Diese Funktion zeigt alle gesendeten Nachrichten.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Aufgaben  /  Seiten
Serviceangebot

Die Karte Serviceangebot wurde um folgendes erweitert:

Felder

Anzahl gesendeter SMSGibt die Anzahl der gesendeten SMS an.

Aktionen

  • SMS versenden Diese Funktion öffnet eine Seite zum SMS versenden.
  • Verknüpfte SMS Nachrichten Diese Funktion zeigt alle verknüpften Nachrichten.
  • Gesendete SMS Nachrichten Diese Funktion zeigt alle gesendeten Nachrichten.
Weitere Informationen dazu finden Sie unter Arbeiten mit der App.

Docs  /  NVXSMS SMS Interface  /  Anhang
Versionshinweise

Möchten Sie wissen, was sich in der Erweiterung geändert hat?
Nachfolgend finden Sie eine Übersicht über die neuen Funktionen und Änderungen, die in den Updates vorgenommen wurden. Build-Übersicht in DevOps

NVXSMS 1.0.5.0

ab Business Central 22
2024/11/13
  • Fehlerbehebungen

    • Die Endpunkt URL wurde in der Codeunit Linked Mobility REST API geändert
    • Die online Hilfe wurde erweitert

NVXSMS 1.0.4.0

ab Business Central 22
2024/10/02
  • Fehlerbehebungen

    • Das Feld Telefonnr. wurde zu Mobiltelefonnr. umbenannt
    • Die online Hilfe wurde verbessert

NVXSMS 1.0.3.0

ab Business Central 22
2024/09/26
  • Fehlerbehebungen

    • Das Feld Dokumentnr. wurde auf nicht editierbar geändert
    • Ein Übersetzungsfehler wurde geändert

NVXSMS 1.0.2.0

ab Business Central 22
2024/09/09
  • Fehlerbehebungen

    • Die Anzeige des Feldes "Anzahl an gesendeter SMS" wurde geändert in "Anzahl gesendeter SMS"

NVXSMS 1.0.1.0

ab Business Central 22
2024/08/23
  • Fehlerbehebungen

    • Ein Fehler wurde behoben, bei dem der Empfänger eine leere Telefonnummer haben konnte
    • Hinzufügen des verzögerten Einfügungens in der Empfängertabelle

NVXSMS 1.0.0.0

ab Business Central 22
2024/08/05
  • Ursprungsversion

  Handbuch als PDF speichern oder drucken  
DE|EN Impressum