MESSAGES API
Eine Messaging-API ist eine programmatische Schnittstelle, die es Ihrem Unternehmen ermöglicht, Nachrichten mithilfe standardisierter HTTP-Anfragen zu senden, zu empfangen und zu verwalten. Mit der Sinch Engage Messages API können Sie WhatsApp-Nachrichten und SMS senden, Zustellberichte anfordern, den Status nach Nachrichten-ID überprüfen und Antworten abrufen.
KERN-WORKFLOWS
Verwenden Sie die Messages API, um WhatsApp-Nachrichten und SMS zu senden, den Verarbeitungsstatus zu verfolgen, Antworten abzurufen und Antworten zu bestätigen, nachdem Sie diese verarbeitet haben.
WIE ES FUNKTIONIERT
Senden Sie SMS und WhatsApp-Nachrichten, indem Sie Inhalt, Zielnummer, Planungsoptionen, Einstellungen für Zustellberichte und optionale Metadaten übergeben. Die API gibt eine Nachrichten-ID zurück, die Sie verwenden können, um den Status zu prüfen und Antworten vom Mobiltelefon abzurufen.
INTEGRATION
Integrieren Sie die Messages API mit Standard-HTTP-Anfragen oder einem SDK, um sie in Ihre bestehenden Systeme einzupassen. Fügen Sie eine callback_url hinzu, um Webhooks zu aktivieren, und schließen Sie Metadaten ein, um einen benutzerdefinierten Nachrichtenkontext zu übergeben.
FUNKTIONEN
Die Messages API unterstützt einen strukturierten Workflow zum Senden von Nachrichten und Verwalten von Antworten, sodass Sie Messaging in Ihre Anwendungen einbauen können.
Senden Sie Nachrichten mit content und destination_number
Planen Sie Nachrichten mit scheduled
Fordern Sie Zustellberichte mit delivery_report an
Prüfen Sie den Nachrichtenstatus nach Nachrichten-ID
Rufen Sie Antworten von Mobiltelefonen ab
Bestätigen Sie Antworten und schließen Sie bis zu 10 Metadaten-Paare ein
VERBESSERN SIE IHREN WORKFLOW
Um zu beginnen, benötigen Sie ein Sinch Engage-Konto und Ruby muss installiert sein. Installieren Sie dann das Ruby SDK, um Nachrichten zu senden, Statusaktualisierungen zu prüfen und Antworten abzurufen.
WARUM SINCH ENGAGE?
Sinch Engage kombiniert eine benutzerfreundliche Anwendung mit API-Funktionen, sodass Ihr Team Messaging ohne entwicklerlastige Workflows starten und verwalten kann. Sie erhalten die Benutzerfreundlichkeit, die Geschäftsteams benötigen, und die Integrationsflexibilität, die technische Teams erwarten.
FAQ
Eine Messaging-API ist eine programmatische Schnittstelle, über die Anwendungen mithilfe standardisierter HTTP-Anfragen Nachrichten senden, empfangen und verwalten können. Die Messages API ist eine Möglichkeit, dieses Muster zu implementieren.
Im Messages API-Tutorial enthält der Body der Senden-Nachricht Felder wie content und destination_number. Er kann auch metadata, scheduled und delivery_report enthalten.
Wenn Sie eine Nachricht senden, gibt die Messages API eine Nachrichten-ID im Antwortobjekt zurück. Verwenden Sie diese Nachrichten-ID, um den Nachrichtenstatus zu prüfen.
Von einem Mobiltelefon gesendete Antworten werden angezeigt, wenn Sie die reply-Funktion im Tutorial-Workflow aufrufen. Bestätigen Sie Antworten, nachdem Sie sie verarbeitet haben, damit diese nicht erneut zurückgegeben werden.
Im Messages API-Tutorial können Sie Webhooks aktivieren, indem Sie einen callback_url-Parameter in den Nachrichten-Body Ihrer send_message-Funktion aufnehmen. Das Quellmaterial gibt kein zusätzliches Webhook-Verhalten an.
Ja. Die Messages API unterstützt bis zu 10 Schlüssel/Wert-Metadatenpaare in einer Nachricht. Verwenden Sie Metadaten, wenn Sie keine persistenten Daten in der Anwendung speichern möchten.
Sie benötigen ein MessageMedia-Entwicklerkonto und Ruby muss installiert sein. Das Tutorial verweist auch auf die Installation des Ruby SDK mit gem install messagemedia_messages_sdk.
Zustellberichte sind Benachrichtigungen über eine Änderung des Status einer Nachricht, während diese verarbeitet wird. Im Tutorial-Workflow können Sie delivery_report im Nachrichten-Body anfordern.
Ja. Das Tutorial zeigt ein scheduled-Feld im Nachrichten-Body. Es beschreibt auch Terminerinnerungen mit einer Bestätigung einen Tag im Voraus und einer Erinnerung eine Stunde im Voraus.
Nachdem eine oder mehrere Antwortnachrichten verarbeitet wurden, bestätigen Sie diese mit dem confirm replies-Endpunkt. Bestätigte Antworten werden in späteren Anfragen zur Prüfung von Antworten nicht zurückgegeben.