Einführung in die Messages API Sandbox

Die Messages API Sandbox ist eine neue Methode zum Entwickeln und Testen jeder Anwendung, die Sie mit WhatsApp, Viberoder Facebook Messenger über unsere Messages API.

Die Sandkasten ermöglicht es Ihnen, Ihre eigenen WhatsApp-, Viber- oder Facebook-Messenger-Konten zu verknüpfen, so dass Sie bereits während der Entwicklung Testnachrichten auf Ihren eigenen Geräten senden und empfangen können.

In diesem Lernprogramm gehen wir durch, wie Sie alles einrichten können.

Voraussetzungen

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.

Sind Sie bereit, mit dem Bau zu beginnen?

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

Sobald Sie Ihren Account eingerichtet haben, benötigen Sie außerdem:

• Ein Smartphone mit installiertem WhatsApp, Viber oder Facebook Messenger.

• Eine Kommandozeilen- oder Terminalanwendung.

Sich selbst auf die Whitelist setzen

Gehen Sie zur Messages API Sandbox in Ihrem Vonage API-Dashboard.

Der erste Schritt besteht darin, Ihre Konten auf die Whitelist zu setzen. Da der Prozess für alle unterstützten Dienste ähnlich ist, konzentrieren wir uns im Abschnitt Externe Konten auf WhatsApp.

Klicken Sie auf den Link "Zur Sandbox hinzufügen", um die Liste der Optionen zu öffnen. Es gibt drei Möglichkeiten, einen neuen Account zur Whitelist hinzuzufügen:

1. Scannen Sie den QR-Code mit Ihrer Kamera, um WhatsApp mit einer vordefinierten Nachricht zu öffnen.

2. Senden Sie Anweisungen an sich selbst oder an ein anderes Teammitglied per E-Mail.

3. Senden Sie eine Nachricht direkt von WhatsApp an die angegebene Nummer unter Verwendung der angezeigten eindeutigen Phrase.

Unabhängig davon, welche Methode du wählst, verknüpfst du die Nummer und die Account-ID, die du in deinem WhatsApp-Account eingestellt hast, mit dem API-Schlüssel deines Nexmo-Accounts.

Sie wissen, dass es funktioniert hat, wenn am Ende des Abschnitts über die Whitelist steht You have 1 user(s) whitelisted. Wenn Sie dies nicht sofort sehen, klicken Sie auf den Link Aktualisieren.

Wenn Sie einen Viber oder Facebook Messenger Account verknüpfen möchten, wiederholen Sie die Schritte für jeden Dienst.

Senden Sie sich selbst eine Nachricht

Sobald Ihr Account auf der Whitelist steht, können Sie ihn testen, indem Sie sich selbst eine Nachricht schicken.

Dazu können Sie Terminal unter macOS und Linux oder die Befehlszeile unter Windows verwenden.

Kopieren Sie den Code für den von Ihnen gewählten Dienst aus dem Codeblock am unteren Rand des Bildschirms.

Es ist bereits mit Ihren API-Anmeldedaten ausgefüllt, aber Sie müssen die $TO_NUMBER so ändern, dass sie mit der Nummer des Accounts übereinstimmt, den Sie zuvor in die Whitelist aufgenommen haben.

Fügen Sie den Code in Ihre Terminal-Anwendung ein. Drücken Sie die Eingabetaste und warten Sie auf die Antwort des Servers; sie sollte etwa so aussehen:

{"message_uuid":"7836a42b-7493-4ece-a7a7-3f59c5058471"}

Warten Sie dann, bis die Nachricht erscheint!

Ziemlich cool, oder?

Verbindung zu Ihrer Anwendung über Webhooks

CURL ist zwar hervorragend, aber wir wissen, dass Sie nicht hier sind, um sich selbst über die Kommandozeile Nachrichten zu schicken.

Um Ihrer Anwendung die Möglichkeit zu geben, eingehende Nachrichten von jedem der unterstützten Dienste zu empfangen, können Sie einen Inbound Webhook einrichten.

Um eingehende Nachrichten zu empfangen, müssen Sie zunächst sicherstellen, dass Ihre Anwendung über einen Endpunkt verfügt, an dem sie auf Nachrichten warten kann, und dass sie POST Anfragen. Sie können ihn nennen, wie Sie wollen; wir haben gehört, dass /inbound eine beliebte Wahl ist.

Bevor Sie Ihre Anwendung auf einem Server einsetzen, können Sie eine Anwendung wie Ngrok verwenden, um sie für die Außenwelt zugänglich zu machen. Weitere Details zur Einrichtung finden Sie in unserer Dokumentation.

Es ist gut zu wissen, was mit den Nachrichten geschieht, die Ihre Anwendung sendet. Zu diesem Zweck bieten wir einen Status Webhook zur Verfügung, der alle Änderungen auf dem Übertragungsweg meldet.

Wenn Sie z. B. wissen möchten, ob die von Ihrer Anwendung gesendeten Nachrichten ankommen, wird dies über den Status-Webhook mit einem delivered Status. Obwohl die Verwendung dieses Webhooks optional ist, ist es eine ausgezeichnete Wahl, ihn aktiv zu überwachen und die Daten aufzuzeichnen, die er Ihnen sendet.

Sie können es von hier aus übernehmen

Die Messages API Sandbox ermöglicht es Ihnen, schnell und einfach mit WhatsApp, Viber und Facebook Messenger zu arbeiten. Sie können jetzt jeden dieser Dienste mit Ihren neuen oder bestehenden Anwendungen verbinden. Was werden Sie also damit bauen?

Beginnen Sie mit einem Blick in die Dokumentation für die Messages API.

Wenn Sie auf der Suche nach Inspirationen sind, finden Sie hier fünf weitere Tutorials, die wir erstellt haben und die Ihnen vielleicht einige Ideen liefern:

• Empfangene SMS-Nachrichten mit Airtable und Node.js speichernSie könnten dies ändern, um empfangene WhatsApp-, Viber- oder Facebook-Messenger-Nachrichten zu speichern.

• Entdecken Sie Ihren Twitter-Positivitäts-ScoreSie könnten auf diesem React-Beispiel aufbauen und den Punktestand stattdessen über Viber oder WhatsApp senden lassen.

• Scrapen Sie das Web und senden Sie SMS-Updates-Sie könnten diese Beispielanwendung nehmen und die Ergebnisse per WhatsApp versenden.

• SMS-Übersetzungen in Echtzeit mit Node, React und Google-Anwendung hinzufügen und SMS, WhatsApp oder Facebook Messenger-Nachrichten übersetzen lassen?

• Senden und Empfangen von SMS-Nachrichten mit Node.js und Azure FunctionsVersuchen Sie, diese Azure-Funktion so zu ändern, dass sie Viber-Nachrichten anstelle von SMS sendet.

Was auch immer Sie bauen, wir sind für Sie da, wenn Sie uns brauchen. Gehen Sie zum Vonage Entwickler-Community Slack um am Gespräch teilzunehmen, Tipps auszutauschen und von anderen zu lernen.