RCS-Nachrichten versenden
RCS steht für Rich Communication Services und ist ein moderner Kommunikationsstandard für Mobilfunkgeräte, der als Nachfolger der klassischen SMS entwickelt wurde.
Im Gegensatz zur reinen Text-SMS können RCS-Nachrichten hochauflösende Fotos und Videos (oft bis zu 100 MB), Sprachnachrichten und andere Dateitypen senden.
todo4teams bietet eine Schnittstelle zum Messaging-Dienstleister Esendex (https://www.esendex.com) an.
Versand von RCS
Esendex bietet Ihnen eine komfortable Oberfläche, um RCS-Inhalte zu generieren: In Templates konfigurieren Sie Bild-, Text- und Interaktionselemente, siehe https://www.esendex.co.uk/text-message-template-library/
Gestalten Sie Ihr eigenes Template und verwenden Sie bei Bedarf Platzhalter, die empfängerspezifisch beim Versand eingefügt werden:
Um Platzhalter in den Textelementen zu verwenden, setzen Sie einfach den Namen des Platzhalters in doppelte eckige Klammern, z.B. "Guten Tag [[Name]], ...".
Nach dem Speichern des Templates im Esendex Studio kopieren Sie die ID Ihres neuen Templates. Sie benötigen sie später in todo4teams.
Erzeugen Sie zudem einen "Subscription-Key" in der Esendex-Konsole: https://console.esendex.com/subscribe:
Klicken Sie dort auf "Show" und speichern Sie den angezeigten "Primary Key".
Wenn noch nicht geschehen, richten Sie nun das Esendex-Konto im Bereich "Messaging" in todo4teams ein, wie hier und hier beschrieben.
Tragen Sie den kopierten Primary Key im Bereich Eigenschaften als Variable richContentSubscriptionKey ein, z.B.
richContentSubscriptionKey=825555tttzz7778uuzzz1
Um nun in einem todo4teams-Skript ein RCS-Template zu versenden, übernehmen Sie den folgenden Code und passen Sie Parameter entsprechend an:
data.put("Name", "Herr Kraus");
helper.sendTemplateMessageChannel(6,"+49156555555555", "ac78fxxx-47xx-40xx-a3xx-7c0axxxx", data, null, "RCS");
Das Format des Aufrufs ist
helper.sendTemplateMessageChannel(
ID_DER_MESSAGING_KONFIGURATION,
EMPFAENGER_RUFNUMMER,
TEMPLATE-ID,
VARIABLEN-MAP,
ABSENDERKENNUNG,
"RCS");
Setzen Sie als VARIABLEN-MAP einfach null, wenn keine Platzhalter verwendet werden.
Setzen Sie für ABSENDERKENNUNG ebenfalls null ein, wenn der voreingestellte Wert aus Ihrem Esendex-Konto verwendet werden soll.
Antworten empfangen
Fügen Sie Ihrer Messaging-Konfiguration in todo4teams den Primary Key einer Webhooks Subscription hinzu, z.B.
webhooksSubscriptionKey=?????????????????????
um Antworten auf Ihrer SMS/RCS direkt in todo4teams empfangen zu können!
SMS/RCS-Antworten treffen dann wie E-Mails ein:
