Konfigurieren eines benutzerdefinierten Anbieters sms-configuration-custom
Diese Funktion ermöglicht es Ihnen, Ihre eigenen Messaging-Anbieter zu integrieren und zu konfigurieren, und bietet Flexibilität über die Standardanbieter (Sinch, Twilio und Infobip) hinaus. Dadurch werden Erstellung, Versand, Reporting und Einverständnisverwaltung für SMS- und RCS-Nachrichten nahtlos möglich.
Über die Konfiguration benutzerdefinierter Anbieter können Sie Messaging-Services von Drittanbietern direkt in Journey Optimizer verbinden, Nachrichten-Payloads für dynamische Inhalte anpassen und Opt-in-/Opt-out-Voreinstellungen verwalten, um Compliance über SMS- und RCS-Kanäle hinweg sicherzustellen.
Gehen Sie wie folgt vor, um Ihren benutzerdefinierten Anbieter zu konfigurieren:
Erstellen von API-Anmeldedaten api-credential
Gehen Sie wie folgt vor, um in Journey Optimizer SMS- und RCS-Nachrichten mit einem benutzerdefinierten Anbieter zu versenden, der nicht von Adobe vorkonfiguriert bereitgestellt wird (z. B. Sinch, Infobip, Twilio):
-
Navigieren Sie in der linken Leiste zu Administration
>Kanäle, wählen Sie das Menü API-Anmeldedaten unter SMS-Einstellungen aus und klicken Sie auf die Schaltfläche Neue API-Anmeldedaten erstellen.
-
Konfigurieren Sie Ihre SMS-API-Anmeldedaten wie unten beschrieben:
-
SMS-Anbieter: Benutzerdefiniert.
-
Name: Geben Sie einen Namen für Ihre API-Anmeldedaten ein.
-
Anbieter-App-ID: Geben Sie die von Ihrem SMS-Anbieter bereitgestellte Anwendungs-ID ein.
-
Anbietername: Geben Sie den Namen Ihres SMS-Anbieters ein.
-
Anbieter-URL: Geben Sie die URL Ihres SMS-Anbieters ein.
-
Authentifizierungstyp: Wählen Sie Ihren Autorisierungstyp aus und füllen Sie die entsprechenden Felder je nach der ausgewählten Authentifizierungsmethode aus.
-
-
Klicken Sie im Abschnitt Header auf Neuen Parameter hinzufügen, um die HTTP-Header der Anfragenachricht anzugeben, die an den externen Service gesendet werden soll.
Die Header-Felder Inhaltstyp und Charset werden standardmäßig festgelegt und können nicht gelöscht werden.
-
Fügen Sie Ihre Anbieter-Payload hinzu, um Ihre Anfrage-Payloads zu validieren und anzupassen.
Bei RCS-Nachrichten wird diese Payload später beim Gestalten des Inhalts verwendet.
-
Wenn Sie die Konfiguration Ihrer API-Anmeldedaten abgeschlossen haben, klicken Sie auf Senden.
-
Klicken Sie im Menü API-Anmeldedaten auf den
-
Um vorhandene Anmeldedaten zu ändern, suchen Sie die gewünschten API-Anmeldedaten und klicken Sie auf die Option Bearbeiten, um die erforderlichen Änderungen vorzunehmen.
-
Klicken Sie auf SMS-Verbindung überprüfen, um Ihre SMS-API-Anmeldeinformationen über eine Beispielnachricht an ein bestimmtes Gerät zu testen und zu überprüfen.
-
Füllen Sie die Felder Zahl und Nachricht aus und klicken Sie auf Verbindung überprüfen.
note important IMPORTANT Die Nachricht muss so strukturiert sein, dass sie mit dem Payload-Format des Anbieters übereinstimmt. 
Nachdem Sie Ihre API-Anmeldedaten erstellt und konfiguriert haben, müssen Sie jetzt die eingehenden Webhook-Einstellungen für SMS-Nachrichten erstellen.
Authentifizierungsoptionen für benutzerdefinierte SMS-Anbieter auth-options
Nachdem Sie Ihre API-Anmeldedaten erstellt haben, füllen Sie die Felder aus, die für die API-Schlüsselauthentifizierung erforderlich sind:
- Name: Geben Sie einen Namen für Ihre API-Schlüsselkonfiguration ein.
- API-Token: Geben Sie das von Ihrem SMS-Anbieter bereitgestellte API-Token ein.
Nachdem Sie Ihre API-Anmeldedaten erstellt haben, füllen Sie die Felder aus, die für die MAC-Authentifizierung erforderlich sind:
- Name: Geben Sie einen Namen für Ihre MAC-Authentifizierungskonfiguration ein.
- API-Token: Geben Sie das von Ihrem SMS-Anbieter bereitgestellte API-Token ein.
- API-Geheimschlüssel: Geben Sie den von Ihrem SMS-Anbieter bereitgestellten API-Geheimschlüssel ein. Dieser Schlüssel wird verwendet, um den MAC (Nachrichtenauthentifizierungs-Code) für eine sichere Kommunikation zu generieren.
- Hash-Format für Mac-Autorisierung: Wählen Sie das Hash-Format für die MAC-Authentifizierung.
Nachdem Sie Ihre API-Anmeldedaten erstellt haben, füllen Sie die Felder aus, die für die OAuth-Authentifizierung erforderlich sind:
-
Name: Geben Sie einen Namen für Ihre OAuth-Authentifizierungskonfiguration ein.
-
API-Token: Geben Sie das von Ihrem SMS-Anbieter bereitgestellte API-Token ein.
-
OAuth-URL: Geben Sie die URL zum Abrufen des OAuth-Tokens ein.
-
OAuth-Text: Stellen Sie den OAuth-Anfragetext im JSON-Format bereit, einschließlich Parametern wie
grant_type,client_idundclient_secret.
Nachdem Sie Ihre API-Anmeldedaten erstellt haben, füllen Sie die Felder aus, die für die JWT-Authentifizierung erforderlich sind:
-
Name: Geben Sie einen Namen für Ihre JWT-Authentifizierungskonfiguration ein.
-
API-Token: Geben Sie das von Ihrem SMS-Anbieter bereitgestellte API-Token ein.
-
JWT-Payload: Geben Sie die JSON-Payload ein, die die für das JWT erforderlichen Ansprüche enthält, z. B. Aussteller, Betreff, Zielgruppe und Gültigkeit.
Erstellen eines Webhook webhook
Wenn keine Opt-in- oder Opt-out-Keywords angegeben werden, werden standardmäßige Einverständnisnachrichten verwendet, um den Datenschutz der Benutzenden zu berücksichtigen. Durch das Hinzufügen benutzerdefinierter Keywords werden die Standardwerte automatisch überschrieben.
Standard-Keywords:
- Opt-in: SUBSCRIBE, YES, UNSTOP, START, CONTINUE, RESUME, BEGIN
- Opt-out: STOP, QUIT, CANCEL, END, UNSUBSCRIBE, NO
- Hilfe: HELP.
Nachdem Ihre API-Anmeldedaten erfolgreich erstellt wurden, besteht der nächste Schritt darin, einen Webhook zu erstellen und Ihre Einstellungen für „eingehend“ zu konfigurieren. Diese Konfiguration stellt sicher, dass Ihr System eingehende Daten oder Nachrichten ordnungsgemäß empfangen und verarbeiten kann.
-
Navigieren Sie in der linken Leiste zu Administration
>Kanäle, wählen Sie das Menü SMS-Webhooks unter SMS-Einstellungen aus und klicken Sie auf die Schaltfläche Webhook erstellen.
-
Konfigurieren Sie Ihre Webhook-Einstellungen wie unten beschrieben:
-
Name: Geben Sie einen Namen für Ihren Webhook ein.
-
SMS-Anbieter auswählen: Benutzerdefiniert.
-
API-Anmeldedaten auswählen: Wählen Sie aus der Dropdown-Liste, die Sie zuvor konfiguriert haben, API-Anmeldedaten aus.
-
Opt-in-Keywords: Geben Sie die standardmäßigen oder benutzerdefinierten Keywords ein, durch die Ihre Opt-in-Nachricht automatisch ausgelöst wird. Verwenden Sie für mehrere Keywords kommagetrennte Werte.
-
Opt-in-Nachricht: Geben Sie die benutzerdefinierte Antwort ein, die automatisch als Ihre Opt-in-Nachricht gesendet wird.
-
Opt-out-Keywords: Geben Sie die standardmäßigen oder benutzerdefinierten Keywords ein, durch die Ihre Opt-out-Nachricht automatisch ausgelöst wird. Verwenden Sie für mehrere Keywords kommagetrennte Werte.
-
Opt-out-Nachricht: Geben Sie die benutzerdefinierte Antwort ein, die automatisch als Ihre Opt-out-Nachricht gesendet wird.
-
-
Klicken Sie auf Payload-Editor anzeigen, um Ihre Anfrage-Payloads zu validieren und anzupassen.
Sie können Ihre Payload mithilfe von Profilattributen dynamisch personalisieren und mithilfe integrierter Hilfsfunktionen sicherstellen, dass genaue Daten zur Verarbeitung und Antworterstellung gesendet werden.
-
Wenn Sie die Konfiguration Ihres Webhook abgeschlossen haben, klicken Sie auf Senden.
-
Klicken Sie im Menü Webhooks auf
-
Um vorhandene Konfigurationen zu ändern, suchen Sie den gewünschten Webhook und klicken Sie auf die Option Bearbeiten, um die erforderlichen Änderungen vorzunehmen.
-
Greifen Sie über Ihren zuvor gesendeten Webhook auf Ihre neue Webhook-URL zu und kopieren Sie sie.
Nachdem Sie die Einstellungen für „eingehend“ für den Webhook erstellt und konfiguriert haben, müssen Sie jetzt eine Kanalkonfiguration für SMS-Nachrichten erstellen.
Nach der Konfiguration können Sie alle betriebsbereiten Kanalfunktionen wie Nachrichtenbearbeitung, Personalisierung, Linktracking und Berichte nutzen.