Erste Schritte mit SMS und Voice Programmierbare Kommunikation

Wir haben kürzlich ein Webinar mit David Leary von Intuit Entwickler durchgeführt, um die Grundlagen der Nutzung der Nexmo SMS und Voice APIs zu erläutern. Wenn Sie planen, an dem kommenden Intuit Small Business Hack teilzunehmen und sich einen Überblick über die Möglichkeiten verschaffen wollen, oder wenn Sie sich einfach nur einen schnellen Überblick über die programmierbare SMS- und Voice-Kommunikation mit Nexmo verschaffen wollen, finden Sie hier die Abschnitte des Webinars, die sich direkt mit dem Senden einer SMS, dem Empfang einer SMS, dem Tätigen eines ausgehenden Anrufs und dem Empfang eines eingehenden Anrufs befassen. Zu allen Beispielen gibt es auch Code-Schnipsel und Links zu weiterführenden Informationen.

Vonage API-Konto

Um dieses Tutorial durchzuführen, benötigen Sie ein Vonage API-Konto. Wenn Sie noch keines haben, können Sie sich noch heute anmelden und mit einem kostenlosen Guthaben beginnen. Sobald Sie ein Konto haben, finden Sie Ihren API-Schlüssel und Ihr API-Geheimnis oben auf dem Vonage-API-Dashboard.

In diesem Lernprogramm wird auch eine virtuelle Telefonnummer verwendet. Um eine zu erwerben, gehen Sie zu Rufnummern > Rufnummern kaufen und suchen Sie nach einer Nummer, die Ihren Anforderungen entspricht.

Sind Sie bereit, mit dem Bau zu beginnen?

Erleben Sie nahtlose Konnektivität, Echtzeit-Messaging und kristallklare Sprach- und Videoanrufe - alles auf Knopfdruck.

Wie man eine SMS sendet

Dieser Abschnitt des Webinars behandelt den Versand einer ausgehenden SMS. Er behandelt die Verwendung von alphanumerischen Absendern und die Verwendung einer von Nexmo gekauften Nummer als from Nummer.

const Nexmo = require('nexmo');

const nexmo = new Nexmo({
apiKey: API_KEY,
apiSecret: API_SECRET,
}, {debug: true});

nexmo.message.sendSms(
FROM_NUMBER,
TO_NUMBER,
'Hello from @leggetter', (error, result) => {
if(error) {
console.error(error);
}
else {
console.log(result);
}
});

Weitere Informationen zum Versenden von SMS finden Sie in unserem Beitrag über Versenden einer SMS mit Node.JS, den SMS API Anleitung und SMS API-Referenz. Wenn Sie SMS versenden, möchten Sie vielleicht auch wissen, ob die Nachricht zugestellt wurde. Zu diesem Zweck können Sie sich für eine SMS-Zustellungsbestätigung. Es gibt auch einen Blogbeitrag über Empfang einer SMS-Zustellungsbestätigung mit Node.JS.

So empfangen Sie eine SMS

In diesem Teil des Webinars behandeln wir den Empfang eines eingehenden Webhooks, der die eingehenden SMS-Informationen enthält.

const Nexmo = require('nexmo');

const app = require('express')();
app.set('port', (process.env.PORT || 5000));
app.use(require('body-parser').urlencoded({ extended: false }));

app.listen(app.get('port'), () => {
console.log('Example app listening on port', app.get('port'));
});

app.post('/sms', (request, response) => {
console.log('Received message text "%s"', request.body.text);

response.sendStatus(200);
});

Weitere Informationen zum Empfang von SMS finden Sie in unserem Beitrag über SMS-Empfang mit Node.JS, dem SMS API Anleitung und SMS API-Referenz.

Ausgehende Telefonanrufe tätigen

Hier erfahren Sie, wie Sie mit der Nexmo Voice API einen ausgehenden Anruf tätigen können.

const Nexmo = require('nexmo');

const nexmo = new Nexmo({
apiKey: API_KEY,
apiSecret: API_SECRET,
applicationId: APPLICATION_ID,
privateKey: PRIVATE_KEY
});

nexmo.calls.create({
to: [{
type: 'phone',
number: TO_NUMBER
}],
from: {
type: 'phone',
number: FROM_NUMBER
},
answer_url: ['https://nexmo-community.github.io/ncco-examples/conference.json']
}, (err, res) => {
if(err) { console.error(err); }
else { console.log(res); }
});

Wir haben einen Blogbeitrag, der Folgendes behandelt einen ausgehenden Telefonanruf mit Node.JSgibt es eine Voice-API-Leitfaden für ausgehende Telefonanrufe und natürlich eine Voice API-Referenz. Werfen Sie auch einen Blick auf die NCCO-Referenz für Informationen zur Steuerung von Nexmo-Gesprächen und -Anrufen, wie sie im answer_url im obigen Beispiel.

Empfangen eines eingehenden Anrufs

Schließlich erfahren Sie, wie Sie einen eingehenden Anruf annehmen und steuern können. Dies ist eine Einführung in das Konzept der Nexmo Gesprächssteuerungsobjekten (NCCOs).

const Nexmo = require('nexmo');

const nexmo = new Nexmo({
apiKey: API_KEY,
apiSecret: API_SECRET,
applicationId: APPLICATION_ID,
privateKey: PRIVATE_KEY
});

const app = require('express')();
const bodyParser = require('body-parser');
app.set('port', (process.env.PORT || 5000));
app.use(bodyParser.urlencoded({ extended: false }));
app.use(bodyParser.json());

app.listen(app.get('port'), () => {
console.log('Example app listening on port', app.get('port'));
});

app.get('/answer', (request, response) => {
console.log('Incoming call from "%s"', request.query.from);

// record - All or part of a Call No
// conversation - A conference.
// connect - To a connectable endpoint such as a phone number
// talk - Send synthesized speech to a call
// stream - Send audio files to a call
var ncco = [
// {
// action: 'talk',
// text: 'hello from me',
// loop: 3,
// bargeIn: true
// },
{
action: 'stream',
streamUrl: ['http://www.ladyofthecake.com/rdmp3/theme.mp3'],
loop: 3,
bargeIn: true
},
{
action: 'input',
eventUrl: ['https://nexmo.ngrok.io/event']
}
];

response.json(ncco);
});

app.post('/event', (request, response) => {
console.log('Received event', request.body);

response.sendStatus(200);
});

Weitere Informationen über den Empfang eines eingehenden Telefonanrufs finden Sie in unserem Beitrag über Entgegennahme eines eingehenden Telefonanrufs mit Node.JSsowie in der Voice-API-Leitfaden für eingehende Telefonanrufe und in der Voice API-Referenz. Im obigen Beispiel wird auch erwähnt record, talk, stream und andere NCCO-Aktionen. Werfen Sie also einen Blick auf die NCCO-Referenz für Informationen zur Steuerung von Nexmo-Gesprächen und -Anrufen.

Mehr programmierbare Kommunikationsmöglichkeiten!

Es gibt viele weitere Informationen über Nexmo APIs in den Dokumenten, die oben nicht erwähnt wurden. Zum Beispiel, die Verify API für 2FA und einmalige Passwörter und Numbers Einsicht zum Abrufen von Informationen über Telefonnummern. Wir haben auch eine Auswahl an Tutorials zur programmierbaren Kommunikation die die Erstellung spezifischer Kommunikationsanwendungen abdecken, wie z. B. private Sprachkommunikation, SMS-Kundenbetreuung, interaktive Sprachausgabeund vieles mehr mit den Nexmo-APIs.

Wenn Sie zum Small Business Hack gehen, wünschen wir Ihnen viel Glück, und wir sehen uns dort. Wenn Sie nur vorbeischauen, um etwas über programmierbare Kommunikation zu erfahren, hoffen wir, dass Sie diese Informationen nützlich finden. In jedem Fall können Sie sich gerne der Nexmo Gemeinschaft Slack wenn Sie irgendwelche Fragen haben.