Anwendungsfall

CM Communication APIs meets Dashdash Apps

Testen und nutzen Sie unsere Communication API's mit wenigen Klicks. Mit Dashdash bauen Sie im Handumdrehen eine Web App ohne Progammierkenntnisse. Wir werden Ihnen das anhand eines Beispiels demonstrieren.

dashdash-cm

Dashdash ist eine Software-Plattform, mit der Business-Nutzer ihre eigenen Tools entwickeln können. Sie bietet die besten Daten und APIs in einer Spreadsheet-Oberfläche.

Nutzer können mit einfachen Spreadsheet-Formeln APIs nutzen zur Datenanreicherung, zur Kommunikation oder zur Integration mit anderer Standard-Software. So können sie ihre digitalen Werkzeuge selbst erstellen und automatisieren - ohne programmieren zu müssen und ohne Hilfe durch Softwareentwickler. 

CM macht es Ihnen möglich, alle Kommunikationsdienste über entsprechende Programmierschnittstellen zu nutzen.

Schauen Sie in der Developers Section vorbei, um einen Überblick über alle Dienste und API's zu bekommen.

 

Bevor wir starten

Zuerst sollten Sie sicherstellen, dass Sie den CM Product Token haben, um unsere API's nutzen zu können.

Erstellen Sie einen kostenlosen Account bei Dashdash.

Im Dashboard angekommen werden wir eine neue App erstellen ("Create App").





dashdash-dashboard

Sie befinden sich nun in der App-Ansicht. Wenn Sie mit MS Excel arbeiten, sollte Ihnen diese Ansicht vertraut vorkommen. Sie können Dashdash Apps auch für Tabellenkalkulation nutzen und bietet Ihnen auch Funktionen, die es auch bei MS Excel gibt.





dashdash-app

Die Views, im seitlichen Menü ersichtlich, sind vergleichbar mit den Tabellenblättern bei MS Excel oder anderen Tabellenkalkulationsprogrammen.

 

 

Erstellen einer Text-To-Speech App

In unserem Beispiel möchten wir Personen anrufen und ihnen eine Sprachansage übermitteln.

Bevor wir aber anrufen, möchten wir gerne wissen, ob die Nummer gültig ist, und ob sie eine Festnetz- oder Mobilfunknummer ist.

Ist Sie gültig und eine Mobilfunknummer, soll ein Anruf getätigt werden.

Dazu verwenden wir die Number Verifier API und die Voice-TTS-API.

Über die Dashdash- Formeln =POST() bzw. =GET() können wir einen API- Aufruf starten.





dashdash-formulas


 

Aufruf Number Verifier API

Für den Number Verifier verwenden wir GET wie folgt:


Action URL: https://api.cmtelecom.com/v1.1/numberlookup/ + Rufnummer
Headers: {"X-CM-PRODUCTTOKEN":"00000000-0000-0000-0000-000000000000"}






dashdash-get

In Zelle A5 befindet sich die Rufnummer, der 00 vorangestellt wird.

In der Zelle, in der wir die GET- Formel geschrieben haben, erhalten wir die Daten im JSON- Format.





dashdash-json

 

 

Mit Klicken auf den Doppelpfeil sehen wir die Daten.

Über die copy- Funktion beim jeweiligen Feld können wir uns den Wert in der Tabelle anzeigen lassen.

In unserem Fall benötigen wir das Feld "valid_number" und "mobile".

Nach klicken auf copy können wir die Werte einfach über das Tastenkürzel strg+V in eine Zelle einfügen.

Unsere Beispielnummer ist sowohl gültig als auch eine Mobilfunknummer.





cm-numberlookup

Text-To-Speech über die Voice Apps API

Für die Voice API werden wir Dashdash's POST- Formel verwenden:


Action URL: https://api.cmtelecom.com/voiceapi/v2/Notification
Headers: {"X-CM-PRODUCTTOKEN":"00000000-0000-0000-0000-000000000000"}
Body: {"callee":"00'&A5&'",
"caller":"0049xxxxxxxxxxx",
"anonymous":false,"prompt":"'&E5&'",
"prompt-type":"TTS"}


Der POST- Teil wird nun noch in eine IF Anweisung verpackt. Es soll schließlich nur angerufen werden, wenn die Nummer gültig ist (C5=true) und es eine Mobilfunknummer ist (D5=true). Außerdem haben wir noch eine Kontrolle mit eingefügt, die den API Aufruf nur startet, wenn in Zelle B2 ein "ja" steht.

Der Rufnummer (callee) aus Zelle A5 wird wieder eine 00 vorangestellt. Wir verwenden in diesem Beispiel nur eine Nummer, von der aus angerufen wird (caller).

Der Text (prompt), der vorgelesen werden soll, wird in E5 gespeichert.

In Zelle G5 wird der Wert des Feldes "success" angezeigt. Dieser sagt aus, ob der Anruf auch durchging.

Die fertige Formel:

=IF(AND(C5="true",D5="true",$B$2="ja"),
POST('https://api.cmtelecom.com/voiceapi/v2/Notification',
'{"X-CM-PRODUCTTOKEN":"00000000-0000-0000-0000-000000000000"}',
'{"callee":"00'&A5&'",
"caller":"0049xxxxxxxxxxx",
"anonymous":false,"prompt":"'&E5&'","prompt-type":"TTS"}',0),"")





dashdash-voice-api

Die App ist fertig! Wir können jetzt beliebig viele Rufnummern in die Tabelle kopieren, und die Formeln einfach nachziehen (nach unten kopieren).





dashdash-final-app

Zuerst werden die Rufnummern überprüft, ob sie gültig sind und eine Mobilfunknummer sind.

Sobald "ja" in die Zelle B2 geschrieben wird, werden die Anrufe für die gültigen Mobilfunknummern gestartet und es wird ausgegeben, welche Anrufe erfolgreich war.

 

Anhand dieses Praxisbeispiels wollen wir verdeutlichen, wie einfach es ist, über Dashdash die unterschiedlichen Communication-API's von CM zu kombinieren und zu testen.

 

Probieren Sie es selbst aus!

Erfahren Sie mehr über CM's Communication API's und SDK's für Entwickler

mehr erfahren
mehr erfahren

Verwandte Artikel

Select Your Country

Selecting a country will show relevant information for that region and may change the language.

Choose a different country or region if you want to see the content for your location.

Go

Select Your Country

Choosing a country or region will show content for your location.

Go