In der heutigen, vernetzten Welt ist Kommunikation der Schlüssel, und eine der allgegenwärtigsten Formen der Kommunikation ist nach wie vor die bescheidene Textnachricht. Ob es um das Senden von Benachrichtigungen, Warnungen oder Werbebotschaften geht, die Möglichkeit, SMS (Short Message Service)-Nachrichten programmatisch zu versenden, eröffnet Entwicklern eine Welt voller Möglichkeiten. Hier kommt Twilio ins Spiel, eine Cloud-Kommunikationsplattform, die Entwicklern die nahtlose Integration von SMS-Funktionen in ihre Anwendungen ermöglicht.
Einführung:
In diesem Tutorial werden wir untersuchen, wie man die Leistungsfähigkeit von Twilio zusammen mit der Flexibilität von Node.js nutzt, um mühelos SMS-Nachrichten zu versenden. Node.js bietet mit seinem nicht-blockierenden I/O-Modell und seinem reichhaltigen Ökosystem an Paketen eine ideale Umgebung für die Erstellung skalierbarer und effizienter Anwendungen, während Twilio das Senden und Empfangen von SMS-Nachrichten vereinfacht, die Zustellung abwickelt und Telefonnummern verwaltet.
Egal, ob Sie ein Benachrichtigungssystem entwickeln, einen Kundensupport-Chatbot erstellen oder einfach nur SMS-Funktionen in Ihre Anwendung integrieren möchten, dieses Tutorial führt Sie Schritt für Schritt durch den Prozess. Am Ende werden Sie ein solides Verständnis dafür haben, wie Sie die API von Twilio mit Node.js nutzen können, um SMS-Nachrichten zuverlässig und sicher zu versenden.
Also, lasst uns eintauchen und lernen, wie man Ihre Node.js-Anwendungen mit den SMS-Funktionen von Twilio auf Touren bringt!
Einrichten eines Twilio-Kontos:
Bevor Sie SMS-Nachrichten mit Twilio und Node.js versenden können, müssen Sie zunächst ein Twilio-Konto einrichten.
Twilio bietet eine kostenlose Testversion an, mit der Sie alle ihre Dienste testen können, z. B. das Senden von SMS mit einer kostenlosen Nummer, die sie Ihnen zuweisen.
Um zu beginnen, melden Sie sich für ein kostenloses Konto an.
Melden Sie sich für ein kostenloses Twilio-Konto an:
Navigieren Sie zur Twilio-Website (https://www.twilio.com/) und melden Sie sich für ein neues Konto an, falls Sie dies noch nicht getan haben. Der Anmeldevorgang ist unkompliziert und erfordert nur grundlegende Informationen wie Ihre E-Mail-Adresse, Ihren vollständigen Namen und Ihr Passwort.
Bestätigen Sie Ihre E-Mail-Adresse:
Laut Twilio
Diese Verifizierung hilft, den Missbrauch der Twilio-Plattform zu verhindern und die Einhaltung der Telekommunikationsvorschriften sicherzustellen.
Nach der Anmeldung sendet Twilio eine Bestätigungs-E-Mail an die Adresse, die Sie bei der Registrierung angegeben haben. Klicken Sie auf den Bestätigungslink in der E-Mail, um Ihre E-Mail-Adresse zu bestätigen und Ihr Twilio-Konto zu aktivieren.
Telefonnummern-Verifizierung:
Dies hilft Twilio, Ihre Identität zu überprüfen, und ermöglicht es Ihnen auch, Testnachrichten von Ihrem Twilio-Konto an Ihr Telefon zu senden, während Sie sich im Testmodus befinden.
Nach der Bestätigung Ihrer E-Mail-Adresse werden Sie aufgefordert, Ihre Telefonnummer zu bestätigen. Twilio erkennt Ihren Standort automatisch anhand Ihrer IP. Stellen Sie sicher, dass Sie Ihr Konto mit einer Nummer erstellen, die Sie in Ihrem Land verifizieren können.
Greifen Sie auf Ihr Twilio-Dashboard zu:
Sobald Ihr Konto verifiziert wurde, melden Sie sich bei Ihrem Twilio-Konto an, um auf die Twilio Console zuzugreifen. In der Konsole verwalten Sie Ihre Twilio-Dienste, Telefonnummern und API-Anmeldeinformationen.
Erhalten Sie Twilio API-Anmeldeinformationen:
Navigieren Sie in der Twilio Console zum Abschnitt "Dashboard" oder "Einstellungen", um Ihre Account SID und Ihr Auth Token zu finden. Diese Anmeldeinformationen sind unerlässlich, um Ihre Anfragen bei der Interaktion mit der Twilio-API zu authentifizieren.
- Account SID (Account Identifier): Dies ist eine eindeutige Kennung für Ihr Twilio-Konto. Sie fungiert als Benutzername, wenn Sie API-Anfragen stellen.
- Auth Token (Authentication Token): Dieses Token dient als Passwort zur Authentifizierung Ihrer API-Anfragen. Bewahren Sie es sicher auf und geben Sie es niemals öffentlich weiter.
- Twilio Telefonnummer: Dieses Telefon ist entscheidend, damit senden Sie SMS und nicht Ihre Telefonnummer.
Durch die Durchführung dieser Schritte haben Sie Ihr Twilio-Konto erfolgreich eingerichtet, Ihre API-Anmeldeinformationen erhalten und Ihre Telefonnummer(n) für SMS-Nachrichten erhalten. Jetzt sind Sie bereit, Twilio in Ihre Node.js-Anwendung zu integrieren und programmatisch mit dem Senden von SMS-Nachrichten zu beginnen.
N.B: Wenn Ihr kostenloses Testkonto abläuft, müssen Sie eine Telefonnummer kaufen, die Sie zum Senden einer SMS verwenden.
Wenn Sie keine Telefonnummer für Tests kaufen möchten, stellen Sie sicher, dass Sie Ihr Konto erst erstellen, wenn Sie bereit sind, Ihre SMS zu senden.
Installieren von Abhängigkeiten:
Um die SMS-Funktionalität von Twilio in Ihre Node.js-Anwendung zu integrieren, müssen Sie ein neues Node.js-Projekt einrichten und das Twilio Node.js SDK installieren.
Bevor wir mit der Installation der Abhängigkeiten fortfahren, beachten Sie, dass wir keine Benutzeroberfläche verwenden oder eine Front-End-Anwendung erstellen, um dies zu testen. Um dies jedoch zu testen, werden wir Apidog verwenden, eine bessere Alternative zu Postman.
Apidog ist eine integrierte Plattform für API-Design, -Debugging, -Entwicklung, -Mocking und -Testen.
Hier ist eine hilfreiche Anleitung, um ein umfassendes Verständnis davon zu erhalten, was Apidog ist und wie man es optimal nutzt. Erstellen Sie ein Konto, um sich auf die API-Testphase dieses Artikels vorzubereiten.
Nun zurück zur Einrichtung von Node.Js und Twilio. Befolgen Sie diese Schritte, um zu beginnen:
Einrichten eines neuen Node.js-Projekts:
Wenn Sie dies noch nicht getan haben, erstellen Sie ein neues Verzeichnis für Ihr Node.js-Projekt und navigieren Sie mit Ihrem Terminal oder Ihrer Eingabeaufforderung dorthin.
mkdir twilio-sms-demo
cd twilio-sms-demo
Initialisieren eines Node.js-Projekts:
Verwenden Sie den folgenden Befehl, um ein neues Node.js-Projekt zu initialisieren. Mit diesem Befehl wird eine package.json-Datei erstellt, die die Abhängigkeiten Ihres Projekts verfolgt.
npm init -y
Dieser Befehl erstellt eine package.json-Datei mit Standardwerten. Sie können diese Werte nach Bedarf anpassen.
Installieren des Twilio Node.js SDK:
Nun müssen Sie das Twilio Node.js SDK installieren, das eine praktische Schnittstelle für die Interaktion mit der API von Twilio von Ihren Node.js-Anwendungen aus bietet. Sie können npm oder yarn verwenden, um das SDK zu installieren.
Verwendung von npm:
Führen Sie den folgenden Befehl aus, um das Twilio Node.js SDK zusammen mit dem Express-Framework mit npm zu installieren:
npm install express twilio
Verwendung von yarn:
Wenn Sie yarn bevorzugen, führen Sie stattdessen den folgenden Befehl aus:
yarn add express twilio
Dieser Befehl lädt das Twilio Node.js SDK zusammen mit dem Express-Framework herunter und fügt es als Abhängigkeit in Ihre package.json-Datei ein.
Wenn Sie es nicht wissen, ist Express ein node.js-Framework, das das Erstellen von APIs vereinfacht.
Überprüfen der Installation:
Stellen Sie nach der Installation des Twilio SDK sicher, dass es Ihrer package.json-Datei hinzugefügt wurde. Sie sollten "twilio": "^x.x.x" im Abschnitt dependencies sehen.
Darüber hinaus können Sie überprüfen, ob die Installation erfolgreich war, indem Sie in Ihrem Projekt nach dem Vorhandensein des Verzeichnisses node_modules suchen. Dieses Verzeichnis enthält alle installierten Abhängigkeiten, einschließlich des Twilio SDK.
Durch Befolgen dieser Schritte haben Sie erfolgreich ein neues Node.js-Projekt eingerichtet und das Twilio Node.js SDK installiert, wodurch der Weg für die Integration der SMS-Funktionalität von Twilio in Ihre Anwendung geebnet wird. Jetzt sind Sie bereit, den Code zu schreiben, um SMS-Nachrichten mit Twilio in Ihrer Node.js-Anwendung zu senden.
Schreiben des Node.js-Codes:
Nachdem Sie nun Ihr Node.js-Projekt eingerichtet und das Twilio SDK installiert haben, schreiben wir den Code, um eine SMS-Nachricht mit Twilio in Kombination mit Express zu senden.
Erstellen einer neuen JavaScript-Datei:
Erstellen Sie in Ihrem Projektverzeichnis eine neue JavaScript-Datei mit dem Namen index.js (oder einem anderen Namen Ihrer Wahl), in der Sie den Code zum Senden von SMS-Nachrichten schreiben.
touch index.js
Sobald Sie fertig sind, öffnen Sie das Projektverzeichnis/den Ordner in einer IDE Ihrer Wahl. Wenn Sie zu den Leuten gehören, die Einfachheit mögen, haben Sie wahrscheinlich VsCode installiert. Öffnen Sie das Projekt init und Sie sollten etwas Ähnliches wie unten sehen;
Öffnen Sie die Datei index.js und lassen Sie uns anfangen, etwas Code zu schreiben. Fügen Sie den folgenden Code in die Datei index.js ein.
const express = require('express');
const accountSid = "your_account_sid;
const authToken = "your_auth_token";
const client = require('twilio')(accountSid, authToken);
Im obigen Code importieren wir am Anfang der Datei das Modul express. Wir haben auch zwei Konstanten ( const) erstellt, die unsere accountSid & authToken enthalten. Schließlich haben wir eine weitere Konstante definiert, in der wir das Twilio-Modul importiert und die accountSid & den authToken an es übergeben haben.
Manche Leute könnten argumentieren, dass es am besten ist, die accountSid und das AuthToken in einer .env-Datei zu kapseln. Sie können das tun, wenn Sie möchten, aber ich werde die Dinge hier einfach halten.
Schreiben des Codes zum Senden einer SMS-Nachricht:
Schreiben wir nun den Code, um eine SMS-Nachricht mit der Methode messages.create() von Twilio zu senden.
Fügen Sie in derselben Datei index.js die folgenden Codes unter dem hinzu, was wir zuerst hatten.
const app = express()
app.post('/send-sms', (req, res) => {
client.messages
.create({
body: 'So fühlt sich der Empfang von Test-SMS von Twilio an. Init?',
from: '+122345678', // Ersetzen Sie dies durch Ihre Twilio-Telefonnummer einschließlich der Landesvorwahl.
to: '+123456789' // die Telefonnummer, mit der Sie Ihr Konto verifiziert haben.
})
.then(message => {
console.log('Nachricht gesendet:', message.sid);
res.send('SMS erfolgreich gesendet!');
})
.catch(error => {
console.error('Fehler beim Senden von SMS:', error);
res.status(500).send('SMS konnte nicht gesendet werden');
});
});
const PORT = 3000;
app.listen(PORT, () => {
console.log(`Server is running on port ${PORT}`);
});
In diesem Code:
- Wir erstellen eine Express-Anwendung und definieren eine POST-Route
/send-sms, um das Senden von SMS-Nachrichten zu verarbeiten. - Dann initialisieren wir einen Twilio-Client mit unseren Twilio-Anmeldeinformationen.
- Mit dem Twilio-Client senden wir eine SMS-Nachricht an die angegebene Empfänger-Telefonnummer (
to) mit dem bereitgestellten Nachrichtentext (body).
Das ist es! Sie haben jetzt den Node.js-Code geschrieben, um SMS-Nachrichten mit Twilio und Express zu senden. Vergessen Sie nicht, 'from' & 'to' durch Ihre Twilio-Telefonnummer und die verifizierte Telefonnummer zu ersetzen.
Speichern Sie die Datei, öffnen Sie Ihr Terminal und geben Sie node index.js ein und klicken Sie auf Eingabe. Wenn alles gut geht, sollten Sie etwas Ähnliches sehen;
Testen unserer API:
Wenn Sie sich erinnern, habe ich erwähnt, dass wir Apidog verwenden werden, um unsere APIs zu testen, um zu sehen, ob sie wie erwartet funktionieren. Bitte laden Sie also die Webversion von Apidog herunter oder verwenden Sie sie, um die API zu testen, die wir gerade erstellt haben.
Nochmals, hier ist eine Anleitung, die Ihnen zeigt, wie Sie mit Apidog beginnen können.
Nachdem Sie nun mit Apidog vertraut sind, melden Sie sich an und erstellen Sie Ihr erstes Projekt - oder verwenden Sie das, das standardmäßig automatisch für Sie erstellt wurde. Klicken Sie danach auf "Neue Anfrage"
Danach wird Ihnen eine Seite zum Senden einer Anfrage angezeigt.
Sie können sehen, dass ich eine POST-Anfrage an localhost:3000/send-sms sende, und das liegt daran, dass die Route, die wir in unserer Web-App definiert haben, /send-sms ist und wir unseren lokalen Computer verwenden.
Wenn Sie die richtige Route eingeben und auf die Schaltfläche "Senden" oben rechts klicken, erhalten Sie eine Antwort. In meinem Fall erhielt ich einen Fehler - und der Fehler wurde mir in meinem Terminal protokolliert.
Der Fehler war einfach, die Telefonnummer, an die ich versucht habe, die SMS zu senden, ist nicht verifiziert - da ich ein Testkonto verwende, muss ich meine Nummer verifizieren oder ein Upgrade durchführen, um SMS an eine beliebige Telefonnummer zu senden.
Eines der coolen Features von Twilio ist, dass Sie Ihre Protokolle und Ihren Verlauf einsehen können. Ich habe meinen angesehen und die folgende Antwort erhalten;
Alle APIs meiner Tests sind fehlgeschlagen. Können Sie erraten, warum?
Meine to phone number war nicht verifiziert;
Sobald Sie Ihr Konto verifizieren oder auf ein kostenpflichtiges Konto upgraden, können Sie eine SMS empfangen.
Erweitern der Anwendung (optional):
Sobald Sie das Senden von SMS-Nachrichten mit Twilio und Node.js erfolgreich implementiert haben, können Sie zusätzliche Funktionen erkunden und die Zuverlässigkeit Ihrer Anwendung verbessern. Hier sind einige optionale Erweiterungen, die Sie in Betracht ziehen können:
Erkunden zusätzlicher Twilio-Funktionen:
Twilio bietet eine breite Palette von Funktionen, die über einfaches SMS-Messaging hinausgehen. Sie können Funktionen wie Folgendes erkunden:
- Senden von MMS: Erweitern Sie Ihre Nachrichten, indem Sie Multimedia-Inhalte wie Bilder, Videos und Audiodateien senden.
- Planen von Nachrichten: Planen Sie SMS-Nachrichten, die zu einem bestimmten Datum und einer bestimmten Uhrzeit gesendet werden sollen, ideal für Erinnerungen und Benachrichtigungen.
Fazit:
In diesem Tutorial haben wir untersucht, wie man die SMS-Funktionalität von Twilio in Node.js integriert, sodass Sie programmatisch SMS-Nachrichten von Ihren Anwendungen aus senden können. Lassen Sie uns die wichtigsten Schritte rekapitulieren:
Einrichten eines Twilio-Kontos: Melden Sie sich für ein Twilio-Konto an, erhalten Sie Ihre API-Anmeldeinformationen (Account SID und Auth Token) und verifizieren Sie Telefonnummern für SMS-Nachrichten.
Installieren von Abhängigkeiten: Richten Sie ein neues Node.js-Projekt ein, installieren Sie das Twilio Node.js SDK und konfigurieren Sie Twilio mit Ihren Anmeldeinformationen.
Schreiben des Node.js-Codes: Erstellen Sie eine neue JavaScript-Datei zum Senden von SMS-Nachrichten, importieren Sie Express und das Twilio-Modul und schreiben Sie Code, um SMS-Nachrichten mit der Methode messages.create() von Twilio zu senden.
Testen des Codes mit Apidog: Wir haben gesehen, wie wir ein Dev-Tool wie Apidog verwenden können, um unsere Node.js-APIs einfach und stressfrei zu testen.
Durch Befolgen dieser Schritte haben Sie gelernt, wie Sie die leistungsstarke API von Twilio zusammen mit der Flexibilität von Node.js nutzen können, um SMS-Funktionen in Ihre Anwendungen zu integrieren. Zögern Sie nicht, bei der Weiterentwicklung Ihrer Projekte weitere Twilio-Funktionen zu erkunden und Ihre Anwendungen an die spezifischen Bedürfnisse Ihrer Benutzer anzupassen.
Viel Spaß beim Codieren!
