Konfigurieren Sie BYO SMS für SMPP

Voraussetzungen
  • Genesys Cloud CX 2, Genesys Cloud CX 3, Genesys Cloud CX 4, Genesys Cloud CX 2 Digital, Genesys Cloud CX 3 Digital oder Genesys Cloud CX 1 Digital Add-on II-Lizenz
  • Integrationen > Integration > Hinzufügen , Löschen , Bearbeiten , Und Sicht Berechtigungen
  • SMS > Telefonnummer > Alle Berechtigungen
  • Vom Hersteller bereitgestellte Verbindungseigenschaften zum Konfigurieren der Short Message Peer to Peer (SMPP) Kurznachrichtendienst (SMS) Integration
  • Genesys Cloud Internet Protocol (IP)-Adressen hinzugefügt zum Anbieter-Zulassungsliste verfügbar in Schritt 4: Speichern Sie Ihren Konfigurationsabschnitt in diesem Artikel.
  • Der Anbieter ermöglicht Genesys Cloud die Einrichtung von drei SMPP-Bindungen. Dies ist die Standardanzahl an Bindungen und derzeit nicht konfigurierbar.

Verwenden Sie die „Bring Your Own (BYO) SMS“-Funktion, um Ihr bestehendes Short Message Peer-to-Peer (SMPP)-Konto mit Genesys Cloud zu verbinden. Wenn Ihr SMS-Anbieter eine SMPP-Schnittstelle unterstützt, können Sie diese integrieren und mit dem Senden und Empfangen von SMS-Nachrichten an Kunden beginnen, indem Sie die vollständigen SMS-Funktionen von Genesys Cloud nutzen.

Die Preise für BYO SMS finden Sie unter Genesys Cloud Fair Use Policy.

Notizen:
  • Wenn Sie ein indirekter Genesys Cloud-Kunde sind, müssen Sie direkt mit Ihrer Partnerorganisation zusammenarbeiten, um BYO SMS für SMPP einzurichten.
  • Stellen Sie sicher, dass die IP-Adressen von Genesys Cloud zur Zulassungsliste des Anbieters hinzugefügt werden. Sehen Anbieter-Zulassungsliste verfügbar in Schritt 4: Speichern Sie Ihren Konfigurationsabschnitt in diesem Artikel.
  • Genesys Cloud BYO SMS für SMPP unterstützt nicht:
    • Virtuelles privates Netzwerk (VPNs). Wir verlangen von unseren Kunden stattdessen die Verwendung der Transport Layer Security (TLS)-Verschlüsselung.
    • Multimedia Messaging Service (MMS).
    • Alphanumerische Absenderidentifikation (IDs). Weitere Informationen finden Sie unter SMS-Zustellbestätigungen .
    • Bandbreite als BYO-SMS-Anbieter. Eine Plattformsteuerung innerhalb von Bandwidth verhindert die Bereitstellung öffentlicher IP-Adressen über mehrere Konten hinweg. Genesys Cloud stellt Updates bereit, sobald eine Lösung verfügbar ist.
  • Genesys Cloud erwartet, dass für jedes Segment Zustellberichte zur Zustellverfolgung verketteter Nachrichten empfangen werden.
  • Stellen Sie als Kunde sicher, dass Sie mit Ihrem SMS-Anbieter zusammenarbeiten, um alle erforderlichen Anwendungsfallregistrierungen abzuschließen.
  • Genesys Cloud erfordert den Besitz von SMS-Schlüsselwort-Compliance-Funktionen, unabhängig vom gewählten Messaging-Anbieter des Kunden. Zu den SMS-Schlüsselwort-Compliance-Funktionen gehören:
    • Verwalten und Verarbeiten von Compliance-Schlüsselwörtern (zum Beispiel: HILFE, STOP).
    • Senden obligatorischer automatischer Antworten.
    • Sicherstellen, dass alle Opt-out-Anfragen bearbeitet werden.

Richten Sie die BYO SMPP SMS-Integration ein

Führen Sie die folgenden Schritte aus, um die BYO SMPP-SMS-Integration einzurichten:

  1. Klicken Sie auf Admin.
  2. Klicken Sie unter Integrationen auf Integrationen.
  3. Klicken Speisekarte > IT und Integrationen > Integrationen .
  4. Klicken Sie auf Integrationen
  5. Suchen Sie die Bringen Sie Ihre eigene SMPP-Konfiguration mit Fliese. Wenn Sie die BYO-Twilio-Integration bereits verwenden, fahren Sie mit der Installation Ihrer Integration fort. Wenn die Kachel zur Konfiguration des SMPP-SMS-Kontos nicht angezeigt wird, müssen Sie sie hinzufügen. Führen Sie die folgenden Schritte aus, um die Kachel „SMPP-SMS-Kontokonfiguration“ hinzuzufügen:
    1. Rufen Sie die Website Genesys AppFoundry auf.
    2. Suchen Sie nach dem Bring Your Own SMS-Konto.
    3. Um die BYO SMPP-SMS-Integration zu Ihrer Genesys Cloud-Organisation hinzuzufügen, befolgen Sie die Anweisungen in diesem Abschnitt und gehen Sie entsprechend vor. 
  6. Klicken Installieren . Der Bildschirm „Bring Your Own SMPP Configuration“ wird angezeigt.

Sie können jetzt mit der Konfiguration und Verwaltung Ihrer BYO SMPP-SMS-Integration fortfahren.

Konfigurieren und verwalten Sie Ihre BYO SMPP SMS-Integration

Konfigurieren Sie Ihre BYO SMPP SMS-Integration

Führen Sie die folgenden Schritte aus, um Ihre BYO SMPP-Integration zu konfigurieren:

Im Details Geben Sie auf der Registerkarte den Namen Ihrer Integration ein und fügen Sie Notizen hinzu. Genesys Cloud empfiehlt, dass Sie zur Identifizierung Ihrer SMPP-Konten aussagekräftige Namen und Notizen verwenden.

Klicken Sie auf die einzelnen Registerkarten, um weitere Informationen zu erhalten.

Auf der Registerkarte „Konfiguration“ wird Folgendes angezeigt: Standardmäßig wird die Registerkarte „Eigenschaften“ verwendet. A Geben Sie relevante Details für Ihren SMPP-Anbieter an. Definieren Sie die Eigenschaften für die folgenden Felder: 

  1. Im SMSC-Adresse Geben Sie in das Feld den Hostnamen oder die IP-Adresse Ihres Anbieter-SMSC ein. 
  2. Im Eingehend plus Präfix Geben Sie im Feld an, ob Ihr Anbieter bei eingehenden (vom Mobiltelefon stammenden) Nachrichten ein führendes + an die Quelladressen (nicht an die Mobiltelefonnummer) anfügt. Die Werte sind:
    • Wahr
    • FALSCH 
  3. Im Ausgehend plus Präfix Geben Sie im Feld an, ob Ihr Anbieter bei ausgehenden (mobile Terminated) Nachrichten ein vorangestelltes + an den Quelladressen verlangt. Die Werte sind:
    • Wahr
    • Falsch (Dies ist die Standardauswahl.) 
  4. Im SMSC-Port Feld, geben Sie Folgendes ein Portdetails zur Verbindung mit Ihrem Anbieter-SMSC. Der Standardwert ist 2776, der übliche verschlüsselte Port für SMPP über TLS. Genesys Cloud empfiehlt die Verwendung des Standardportwerts. Genesys Cloud unterstützt die folgenden zusätzlichen Ports: 1776, 2775, 2776, 2780, 3550, 3601, 3775, 4200, 4331, 4332, 7777, 8887, 10000, 29999, 30001 und 52775.
    Notiz : Wenn Ihr Port nicht in der Liste angezeigt wird, können Sie einen benutzerdefinierten Portwert anfordern, indem Sie eine Anfrage mit Genesys Cloud Mein Support . Die Umsetzung der Anfrage kann jedoch 3–4 Wochen dauern.
  5. Im Adresse TON Wählen Sie im Feld „Nummerntyp“ (TON) aus. Sie können Werte von 0–6 auswählen. Null ist der Standardwert. Dies gilt für die Telefonnummer, an die eine ausgehende Nachricht gesendet wird. gesendet von .  
  6. Im Adresse NPI Wählen Sie im Feld den Wert „Numbering Plan Identification“ (NPI) aus. Sie können einen der folgenden Werte auswählen: 0,1,3,4,6,8,9,10,13,18. Null ist der Standardwert. Dies gilt für die Telefonnummer, an die eine ausgehende Nachricht gesendet wird. gesendet von . 
  7. Im Standardzieladresse TON Wählen Sie im Feld den gewünschten Wert aus. Sie können Werte von 0–6 auswählen. Null ist der Standardwert. Dies gilt für die Telefonnummer, an die eine ausgehende Nachricht gesendet wird. gesendet an .
  8. Im Standardzieladresse NPI Wählen Sie im Feld einen Wert für die Nummerierungsplankennung aus. Sie können einen der folgenden Werte auswählen: 0,1,3,4,6,8,9,10,13,18. Null ist der Standardwert. Dies gilt für die Telefonnummer, an die eine ausgehende Nachricht gesendet wird. gesendet an .  
  9. Im Nachrichten pro Sekunde Geben Sie den erforderlichen Wert ein. Der Standardwert beträgt 20 Nachrichten pro Sekunde mit einem Höchstlimit von 100 Nachrichten pro Sekunde.
  10. Im Bindungstyp Wählen Sie im Feld „Typ“ den Typ aus. Zur Auswahl stehen folgende Typen:
    • Transceiver : Dies ist die Standard- und empfohlene Auswahl.
    • Sender : Wenn Sie diese Option auswählen, stellen Sie sicher, dass Sie über eine Empfängerbindung verfügen, um Zustellberichte und vom Mobiltelefon stammende Nachrichten zu empfangen. Wenn Sie keinen Empfänger haben, können Sie keine Zustellberichte und mobil gesendeten Nachrichten empfangen.
    • Empfänger

Geben Sie im Abschnitt „Erweiterte Konfiguration“ Folgendes ein: Zeichensatzkodierung Details zu Ihrem SMPP-Anbieter oder dem Fehlercodes für Ihren SMPP-Anbieter. Sie können diesen Abschnitt leer lassen und die Standardkonfiguration verwenden.


 

{
  "protocolSpecificCodeMapping": {
    "0": {
      "genericErrorCode": 0,
      "genericErrorCause": "DELIVERED",
      "description": "Message delivered"
   },
   "1" : {
      "genericErrorCode": 3,
      "genericErrorCause": "MESSAGE_DATA_INVALID",
      "description": "Message length is invalid"
   },
   "2" : {
      "genericErrorCode": 3,
      "genericErrorCause": "MESSAGE_DATA_INVALID",
      "description": "Command length is invalid"
   },
   "3":  {
      "genericErrorCode": 3,
      "genericErrorCause": "MESSAGE_DATA_INVALID",
      "description": "Invalid command ID"
   },
   "4":  {
      "genericErrorCode": 2,
      "genericErrorCause": "OTHER_TEMPORARY_FAILURE",
      "description": "Incorrect carrier status for given command"
   },
   "5":  {
      "genericErrorCode": 2,
      "genericErrorCause": "OTHER_TEMPORARY_FAILURE",
      "description": "Incorrect carrier status for given command"
   },
   "6":  {
      "genericErrorCode": 3,
      "genericErrorCause": "PRIORITY_INVALID",
      "description": "Invalid priority flag"
   },
   "7":  {
      "genericErrorCode": 3,
      "genericErrorCause": "MESSAGE_DATA_INVALID",
      "description": "Invalid registered delivery flag"
   },
   "8":  {
      "genericErrorCode": 2,
      "genericErrorCause": "OTHER_TEMPORARY_FAILURE",
      "description": "Internal system error"
   },
   "10" : {
      "genericErrorCode": 3,
      "genericErrorCause": "SOURCE_ADDR_INVALID",
      "description": "Invalid source address"
   },
   "11" : {
      "genericErrorCode": 3,
      "genericErrorCause": "DEST_ADDR_INVALID",
      "description": "Invalid destination address"
   },
   "12" : {
      "genericErrorCode": 3,
      "genericErrorCause": "MESSAGE_ID_INVALID",
      "description": "Invalid message ID"
   },
   "13" : {
      "genericErrorCode": 2,
      "genericErrorCause": "OTHER_TEMPORARY_FAILURE",
      "description": "Bind failed"
   },
   "14" : {
      "genericErrorCode": 2,
      "genericErrorCause": "AUTHENTICATION_FAILED",
      "description": "Invalid password"
   },
   "15" : {
      "genericErrorCode": 2,
      "genericErrorCause": "AUTHENTICATION_FAILED",
      "description": "Invalid system ID"
   },
   "17" : {
      "genericErrorCode": 3,
      "genericErrorCause": "OTHER_PERMANENT_FAILURE",
      "description": "ESME_RCANCELFAIL: Cancel SM failed."
   },
   "19" : {
      "genericErrorCode": 3,
      "genericErrorCause": "OTHER_PERMANENT_FAILURE",
      "description": "ESME_RREPLACEFAIL: Replace SM failed."
   },
   "20" : {
      "genericErrorCode": 2,
      "genericErrorCause": "CARRIER_CONGESTED",
      "description": "ESME_RMSGQFUL: Message queue full."
   },
   "21" : {
      "genericErrorCode": 3,
      "genericErrorCause": "OTHER_PERMANENT_FAILURE",
      "description": "ESME_RINVSERTYP: Invalid service type."
   },
   "51" : {
      "genericErrorCode": 3,
      "genericErrorCause": "DEST_ADDR_INVALID",
      "description": "ESME_RINVNUMDESTS: Invalid number of destinations."
   },
   "52": {
      "genericErrorCode": 3,
      "genericErrorCause": "DEST_ADDR_INVALID",
      "description": "ESME_RINVLDLNAME: Invalid distribution list name."
   },
   "64" : {
      "genericErrorCode": 3,
      "genericErrorCause": "DEST_ADDR_INVALID",
      "description": "ESME_RINVDESTFLAG: Destination flag is invalid (submit_multi)."
   },
   "66": {
      "genericErrorCode": 3,
      "genericErrorCause": "MESSAGE_DATA_INVALID",
      "description": "ESME_RINVSUBREP: Invalid 'submit with replace' request (i.e. submit_sm with replace_if_present_flag set)."
   },
   "67" : {
      "genericErrorCode": 3,
      "genericErrorCause": "MESSAGE_DATA_INVALID",
      "description": "ESME_RINVESMCLASS: Invalid esm_class field data."
   },
   "68" : {
      "genericErrorCode": 3,
      "genericErrorCause": "DEST_ADDR_INVALID",
      "description": "ESME_RCNTSUBDL: Cannot submit to distribution list."
   },
   "69": {
      "genericErrorCode": 3,
      "genericErrorCause": "OTHER_PERMANENT_FAILURE",
      "description": "ESME_RSUBMITFAIL: submit_sm or submit_multi failed."
   },
   "72" : {
      "genericErrorCode": 3,
      "genericErrorCause": "SOURCE_ADDR_INVALID",
      "description": "ESME_RINVSRCTON: Invalid source address TON."
   },
   "73" : {
      "genericErrorCode": 3,
      "genericErrorCause": "SOURCE_ADDR_INVALID",
      "description": "ESME_RINVSRCNPI: Invalid source address NPI."
   },
   "80" : {
      "genericErrorCode": 3,
      "genericErrorCause": "DEST_ADDR_INVALID",
      "description": "ESME_RINVDSTTON: Invalid destination address TON."
   },
   "81" : {
      "genericErrorCode": 3,
      "genericErrorCause": "DEST_ADDR_INVALID",
      "description": "ESME_RINVDSTNPI: Invalid destination address NPI."
   },
   "83": {
      "genericErrorCode": 3,
      "genericErrorCause": "AUTHENTICATION_FAILED",
      "description": "ESME_RINVSYSTYP: Invalid system_type field."
   },
   "84" : {
      "genericErrorCode": 3,
      "genericErrorCause": "MESSAGE_DATA_INVALID",
      "description": "ESME_RINVREPFLAG: Invalid replace_if_present flag."
   },
   "85" : {
      "genericErrorCode": 3,
      "genericErrorCause": "MESSAGE_DATA_INVALID",
      "description": "ESME_RINVNUMMSGS: Invalid number of messages."
   },
   "88" : {
      "genericErrorCode": 2,
      "genericErrorCause": "THROTTLED",
      "description": "ESME_RTHROTTLED: Throttling error(ESME has exceeded allowed message limits)."
   },
   "97" : {
      "genericErrorCode": 3,
      "genericErrorCause": "TIME_PERIOD_INVALID",
      "description": "ESME_RINVSCHED: Invalid scheduled delivery time."
   },
   "98" : {
      "genericErrorCode": 3,
      "genericErrorCause": "TIME_PERIOD_INVALID",
      "description": "ESME_RINVEXPIRY: Invalid message validity period (expiry time)."
   },
   "99" : {
      "genericErrorCode": 3,
      "genericErrorCause": "MESSAGE_DATA_INVALID",
      "description": "ESME_RINVDFTMSGID: Predefined message invalid or not found."
   },
   "100": {
     "genericErrorCode": 2,
     "genericErrorCause": "OTHER_TEMPORARY_FAILURE",
     "description": "ESME_RX_T_APPN: ESME receiver temporary app error code."
   },
   "101": {
     "genericErrorCode": 3,
     "genericErrorCause": "OTHER_PERMANENT_FAILURE",
     "description": "ESME_RX_P_APPN: ESME receiver permanent app error code."
   },
   "102": {
     "genericErrorCode": 3,
     "genericErrorCause": "OTHER_PERMANENT_FAILURE",
     "description": "ESME_RX_R_APPN: ESME receiver reject message error code."
   },
   "103": {
     "genericErrorCode": 3,
     "genericErrorCause": "OTHER_PERMANENT_FAILURE",
     "description": "ESME_RQUERYFAIL: query_sm request failed."
   },
   "192": {
     "genericErrorCode": 3,
     "genericErrorCause": "MESSAGE_DATA_INVALID",
     "description": "ESME_RINVOPTPARSTREAM: Error in the optional part of the PDU body."
   },
   "193": {
     "genericErrorCode": 3,
     "genericErrorCause": "MESSAGE_DATA_INVALID",
     "description": "ESME_ROPTPARNOTALLWD: Optional parameter not allowed."
   },
   "194": {
     "genericErrorCode": 3,
     "genericErrorCause": "MESSAGE_DATA_INVALID",
     "description": "ESME_RINVPARLEN: Invalid parameter length."
   },
   "195": {
     "genericErrorCode": 3,
     "genericErrorCause": "MESSAGE_DATA_INVALID",
     "description": "ESME_RMISSINGOPTPARAM: Expected optional parameter missing."
   },
   "196": {
   "genericErrorCode": 3,
   "genericErrorCause": "MESSAGE_DATA_INVALID",
   "description": "ESME_RINVOPTPARAMVAL: Invalid optional parameter value."
   },
   "254": {
     "genericErrorCode": 2,
     "genericErrorCause": "CARRIER_DELIVERY_FAILED",
     "description": "ESME_RDELIVERYFAILURE: Delivery failure (used for data_sm_resp)."
   },
   "255": {
     "genericErrorCode": 3,
     "genericErrorCause": "OTHER_PERMANENT_FAILURE",
     "description": "ESME_RUNKNOWNERR: Unknown error."
   }
},
"charsets": [
  {
    "dcs": 0,
    "charset": "gsm_0338"
  },
  {
    "dcs": 1,
    "charset": "ASCII"
  },
  {
    "dcs": 2,
    "charset": "gsm_0338"
  },
  {
    "dcs": 3,
    "charset": "ISO-8859-1"
  },
  {
    "dcs": 5,
    "charset": "JIS0201"
  },
  {
    "dcs": 6,
    "charset": "ISO-8859-5"
  },
  {
    "dcs": 7,
    "charset": "ISO-8859-8"
  },
  {
    "dcs": 8,
    "charset": "utf-16be"
  }
 ]
}

Wenn Sie eine benutzerdefinierte erweiterte Konfiguration eingeben, werden die Standardwerte für die benutzerdefinierten Fehlercodes überschrieben, während alle nicht überschriebenen Standardwerte beibehalten werden. Eine benutzerdefinierte erweiterte Konfiguration muss ein gültiges JSON-Objekt sein und dem richtigen Schema folgen. 

 

{
  "protocolSpecificCodeMapping": {
    "0": {
      "genericErrorCode": 0,
      "genericErrorCause": "DELIVERED",
      "description": "Message delivered"
     },
     "1": {
      "genericErrorCode": 3,
      "genericErrorCause": "MESSAGE_DATA_INVALID",
      "description": "Message length is invalid"
     }
},
"charsets": [
  {
    "dcs": 0,
    "charset": "gsm_0338"
  },
  {
    "dcs": 1,
    "charset": "ASCII"
  }
 ]
}

Die folgende Tabelle beschreibt die beiden Abschnitte auf der Registerkarte „Erweiterte Konfiguration“:

Abschnittsname Beschreibung
protocolSpecificCodeMapping

Verwenden Sie diesen Abschnitt, um Ihren Anbieterfehlercode einem allgemeinen Fehler zuzuordnen, den Genesys Cloud weiter interpretieren kann.

  • Schlüssel : Die Fehlercodes, die Sie in diese Karte eingeben, sollten den Fehlercodes Ihres Anbieters entsprechen.
  • Werte : Die Werte, die Sie in diese Karte eingeben, sollten Objekte mit Feldern für „generischerFehlercode“, „generischeFehlerursache“ und einer Beschreibung (optional) sein.
    • Der Wert, den Sie in das Feld „GenericErrorCode“ eingeben, sollte eine Zahl aus dieser Liste sein:
      • 0 – Erfolg
      • 1 – Unbekannter Fehler
      • 2 – Wiederholbarer Fehler
      • 3 – Dauerhafter Ausfall
      • 4 – Abgelaufen
      • 5 – Aufgeschoben
      • 6 – Unterwegs
      • 7 – Abgelehnt
      • 8 – Akzeptiert
      • 9 – Unbekannt
      • 10 – Nicht zustellbar.
    • Der Wert, den Sie in das Feld genericErrorCause eingeben, sollte aus diesem Liste der Lieferscheine .
charsets

Verwenden Sie diesen Abschnitt für eine geordnete Liste von Zeichensatzeinstellungen. Damit können Sie eine Nachricht verschlüsseln, bevor Sie sie an das SMSC des Anbieters senden. Wenn eine Nachricht nicht mit dem ersten Zeichensatz in der Liste kodiert werden kann, wird der nächste Zeichensatz verwendet und so weiter. Beispiele für Zeichensätze sind wie folgt:

  • GSM_0338
  • ISO-8859-1
  • UTF-16be
  • ASCII
  • JIS0201
  • ISO-8859-5
  • ISO-8859-8

Im Anmeldeinformationen auf Konfigurieren . Das Dialogfeld Anmeldeinformationen konfigurieren wird angezeigt. Führen Sie die folgenden Schritte aus:

  1. Im System-ID Geben Sie in das Feld die System-ID für Ihr SMPP-Konto ein. 
  2. Im Passwort Geben Sie in das Feld das Kennwort für Ihr SMPP-Konto ein.
    Notiz : Genesys Cloud verschlüsselt Ihre SMPP-Anmeldeinformationen und speichert sie in einer sicheren Umgebung. Weitere Informationen finden Sie unter Wie verarbeitet Genesys Cloud Anmeldeinformationen?
  3. Klicken Sie auf OK.

Nachdem Sie die Felder in Ihrer Integration ausgefüllt haben, klicken Sie auf Speichern , um Ihre Konfiguration zu speichern.

Wenn die Schaltfläche „Speichern“ nicht zur Auswahl steht, erkundigen Sie sich bei Ihrem Anbieter, ob er eine IP-Zulassungsliste verwaltet. Fügen Sie dieser Zulassungsliste die Genesys Cloud-IP-Adressen hinzu, von denen SMPP-Bind-Anfragen stammen. Um eine Liste der IP-Adressen zu erhalten, führen Sie die folgenden Schritte aus:

  1. Navigieren Sie zum API-Zentrale . 
  2. Klicken Sie in der oberen rechten Ecke der Seite auf das Kontoauswahl runterfallen.
  3. Klicken Konto hinzufügen und wählen Sie die Region Ihrer Genesys Cloud-Organisation aus.
  4. Klicken Sie im linken Bereich auf API-Ressourcen .
  5. Wählen Sie aus der Liste Dienstprogramme .
  6. Click GET /api/v2/ipranges.
  7. Deaktivieren Sie auf der rechten Seite der Seite die Der Lesemodus ist aktiviert Umschalten, um den Lesemodus zu verlassen. 
  8. Klicken Anfrage ausführen .
  9. Der Abschnitt „Antworten“ wird angezeigt. Sie können die IP-Adressen anzeigen, von denen aus Sie die IP-Adressen der BYO-SMPP-Dienste ausführen und suchen können. Weitere Informationen finden Sie unter IP-Adressen für die Firewall-Whitelist .  

Sobald Sie alle oben genannten Schritte abgeschlossen haben, können Sie Ihre Integration endgültig aktivieren. Um Ihre Integration zu aktivieren, klicken Sie unten auf der Seite auf Aktiv .

Genesys Cloud versucht, eine SMPP-Bindung unter Verwendung der Anbietereigenschaften herzustellen, die beim Konfigurieren der Integration verwendet wurden. Rechnen Sie mit einer Wartezeit von 15 Minuten, bis die Bindung getestet und hergestellt ist. Wenn die Bindung nicht erfolgreich war und Verbindungsfehler aufgetreten sind, lesen Sie den Abschnitt „Fehlerbehebung und Betriebskonsole“ in diesem Artikel. Sobald Sie sich auf der Betriebskonsole befinden, suchen Sie nach den Ereignissen, die in der Entwicklerzentrum .

Wenn bei der Integration Probleme auftreten, müssen Sie direkt mit Ihrem Anbieter zusammenarbeiten.

Notiz : Sie können maximal 10 BYO SMPP-Integrationen erstellen. Um eine Aktiv-Aktiv-Verbindung zum redundanten SMSC Ihres Anbieters einzurichten, erstellen Sie für jede Verbindung eine separate Integration.

Verwalten Sie Ihre BYO SMPP-SMS-Integration

Sobald Ihre Integration fertig ist, können Sie Ihre Nummern zum SMS-Nummernbestand hinzufügen, Ihre Integrationen aktualisieren, deaktivieren oder löschen. Klicken Sie auf die einzelnen Klappelemente, um weitere Informationen zu erhalten.

Nachdem Sie Ihre SMPP-SMS-Integration eingerichtet haben, können Sie Ihre Nummern zum SMS-Nummernbestand hinzufügen. Sie können jeweils nur eine Nummer hinzufügen.

Notiz : Das Hinzufügen Ihrer Nummern zum SMS-Nummernbestand hat keinen Einfluss auf Ihre Kontrolle über diese Nummern. Im Wesentlichen erlauben Sie Genesys Cloud, diese Nummern für SMS zu verwenden. Die Nummern verbleiben im Konto Ihres Anbieters.

Um Ihre SMS-Nummern hinzuzufügen, führen Sie die folgenden Schritte aus:

  1. Klicken Sie auf Admin.
  2. Klicken Sie unter Nachricht auf SMS-Nummernbestand .
  3. Klicken Speisekarte > Digitale Telefonie > Nachricht > SMS-Inventar . 
  4. Die Seite „SMS-Nummernbestand“ wird angezeigt. Klicken Zahlen hinzufügen .
  5. Klicken Sie auf Importieren.
  6. Das Dialogfeld „Importnummer“ wird angezeigt. Im Integration Wählen Sie in der Liste die Integration aus, aus der Sie Nummern importieren möchten.
  7. Im Typ Wählen Sie in der Liste den zu importierenden Nummerntyp aus. 
    • Ortsgespräch, Mobilgespräch oder gebührenfrei : Zeigt die Absender-ID Feld, in das Sie die Nummer im E164-Format eingeben können. Wenn Sie eine lokale, mobile oder gebührenfreie Nummer importieren, stellt Genesys automatisch einen Standardsatz automatischer Antworten für die Schlüsselwörter „HELP“ und „STOP“ bereit.

      Standardmäßige automatische Antwort Beschreibung
      Hilfestichwörter HILFE oder INFO.
      Automatische Hilfeantwort Antworten Sie mit STOP, um sich abzumelden. Es können Nachrichten- und Datengebühren anfallen.
      Opt-out-Schlüsselwörter ABBRECHEN, BEENDEN, BEENDEN, STOPPEN, ABMELDEN, ALLES STOPPEN, WIDERRUFEN oder OPTOUT.
      Automatische Opt-out-Antwort Ihre Abmeldung ist erfolgreich. Sie erhalten von dieser Nummer keine weiteren Nachrichten. Antworten Sie mit START, um sich erneut anzumelden.
      Opt-in-Schlüsselwörter START, JA oder UNSTOP.
      Automatische Opt-in-Antwort Sie wurden erfolgreich erneut für Nachrichten von dieser Nummer angemeldet. Antwort HELP für Hilfe. Antworten Sie mit STOP, um sich abzumelden. Es können Nachrichten- und Datengebühren anfallen.

    • Kurzwahl : Zeigt die Land Und Absender-ID Felder, in denen Sie das Land auswählen und die Nummer im E164-Format eingeben können.
  8. Klicken Sie auf Weiter.
  9. Wenn Sie in der Liste „Typ“ als Typ „Shortcode“ ausgewählt haben, wird das Dialogfeld „Erforderliche Interaktion“ angezeigt. Das Dialogfeld zeigt die folgenden Registerkarten an:
    • Gehen Sie auf der Registerkarte „Hilfe“ wie folgt vor:
      • Geben Sie in das Feld Schlüsselwörter die gewünschten Hilfeschlüsselwörter ein.
      • Geben Sie in das Feld Nachricht die Nachricht ein, die Sie als Antwort auf eine Hilfeanfrage an Kunden senden möchten.
    • Im Gehen Sie auf der Registerkarte „Opt-out“ wie folgt vor:
      • Geben Sie in das Feld Keywords die gewünschten Opt-out-Keywords ein.
      • Geben Sie in das Feld Nachricht die Nachricht ein, die Sie als Antwort auf eine Opt-out-Anfrage an Kunden senden möchten.
    • Im Gehen Sie auf der Registerkarte „Opt-in“ wie folgt vor:
      • Geben Sie in das Feld Keywords die gewünschten Opt-in-Schlüsselwörter ein.
      • Geben Sie in das Feld Nachricht die Nachricht ein, die Sie als Antwort auf eine Opt-in-Anfrage an Kunden senden möchten.
  10. Klicken Sie auf . Bestätigen Sie den Import. Genesys Cloud ruft die Daten der SMS-Nummern ab und kehrt dann zur Seite SMS Number Inventory zurück. Oben auf der Seite erscheint ein Toast, der Ihnen mitteilt, dass der Nummernimport erfolgreich war.

Weitere Informationen finden Sie unter Verwalten Sie Ihren Bestand an SMS-Langzeitkennzahlen.

Sie können Ihre SMPP-SMS-Integration über das Integrations-Dashboard ändern. Um die Integration zu aktualisieren, führen Sie die folgenden Schritte aus:

  1. Wählen Sie im Integrations-Dashboard die Integration aus, an der Sie Änderungen vornehmen möchten.
  2. Nehmen Sie die erforderlichen Änderungen auf den Registerkarten „Details“, „Konfigurationseigenschaften“, „Erweitert“ oder „Anmeldeinformationen“ vor.
  3. Klicken Sie auf Speichern. 

Notiz : Wenn Sie die Anmeldeinformationen ändern, müssen Sie Ihre Integration erneut aktivieren. 
  • Wenn sich die Integration im Status „Inaktiv“ befindet, schalten Sie den Schalter ein, um die Integration zu aktivieren.
  • Wenn sich die Integration bereits im Status „Aktiv“ befindet, deaktivieren Sie den Schalter, um sie zu inaktivieren, und ändern Sie sie dann erneut in „Aktiv“.

Sie können Ihre SMPP-SMS-Integration auf der Integrations-Dashboard-Seite deaktivieren. Um Ihre Integration zu deaktivieren, führen Sie die folgenden Schritte aus:

  1. Klicken Sie auf der Seite Integration in der Spalte Aktionen auf das Mehr Symbol. 
  2. Wählen Sie aus den Optionen Integration deaktivieren .  

Wenn Sie die Integration deaktivieren:

  • Dies wird vorübergehend in der Genesys Cloud durchgeführt und alle für diese Integration importierten Nummern werden deaktiviert.
  • Die SMPP-Verbindung wird getrennt. Dies bedeutet, dass keine Nachrichten gesendet oder empfangen werden können. Alle gesendeten oder empfangenen Nachrichten werden der Warteschlange hinzugefügt und bleiben dort, bis die Verbindung aktiviert wird.

Sie können Ihre SMPP-SMS-Integration von der Integrations-Dashboard-Seite löschen. Um Ihre Integration zu löschen, führen Sie die folgenden Schritte aus:

  1. Klicken Sie auf der Seite Integration in der Spalte Aktionen auf das Mehr Symbol. 
  2. Wählen Sie aus den Optionen Integration löschen .  

Warnung : Durch das Löschen einer SMPP-SMS-Integration werden alle importierten Nummern aus dem SMS-Nummernbestand entfernt, ohne Rücksicht auf aktive eingehende Flüsse oder Warteschlangenkonfigurationen.

Notiz : Durch das Löschen einer SMPP-SMS-Integration in Genesys Cloud werden die Nummern nicht aus Ihrem SMPP-Konto gelöscht. Es wird lediglich die Möglichkeit genommen, die Nummern in Genesys Cloud zu verwenden.
  • Durch das Löschen der SMPP-SMS-Integration wird die SMPP-Verbindung in Genesys Cloud beendet und Sie können sie nicht mehr zum Senden oder Empfangen von SMS-Nachrichten verwenden.
  • Stellen Sie sicher, dass Sie die IP-Adressen von Genesys Cloud entfernen. 

Fehlerbehebung

In der folgenden Tabelle sind häufige Fehlermeldungen und deren Beschreibungen aufgeführt, die bei der Integration Ihres SMPP-Kontos in Genesys Cloud angezeigt werden können.

Nachricht Beschreibung
Bitte prüfen Sie die Integration für BYO Sender ID. Diese Meldung wird angezeigt, wenn die Anfrage an den Back-End-Dienst gesendet wird und der Integration die Sender-ID fehlt. 
Bitte geben Sie die erforderlichen Compliance-Schlüsselwörter und Nachrichten für Ihre Sender-ID an.

Diese Meldung wird angezeigt, wenn Konformitätsinformationen fehlen. Überprüfen Sie die Felder auf den drei Registerkarten im Dialogfeld „Erforderliche Interaktion“:

  • Hilfe
  • Opt-out
  • Re-Opt-In
Bitte überprüfen Sie den Typ Ihrer Absender-ID.

Diese Meldung wird angezeigt, wenn entweder die Rufnummer oder die Kurzwahlnummer falsch formatiert ist.

  • Die Rufnummer muss im E.164-Format vorliegen.
  • Der Kurzcode muss 5–6 Zeichen lang sein.
Bitte überprüfen Sie den Ländercode Ihrer Absender-ID. Diese Meldung wird angezeigt, wenn die Rufnummer und die Landesvorwahl nicht übereinstimmen.
Für diese Rufnummer ist bereits eine Einrichtungsaktion im Gange. Diese Meldung wird angezeigt, wenn Sie versuchen, eine Anfrage, die bereits bereitgestellt wurde, erneut zu übermitteln. Bei einigen Nummern dauert die Bereitstellung länger.
Diese Rufnummernadresse ist nicht für die Bereitstellung verfügbar. Bitte wählen Sie eine andere Telefonnummer und versuchen Sie es erneut. Diese Meldung wird angezeigt, wenn die Rufnummer bereits in einer anderen Organisation bereitgestellt wurde.

Betriebskonsole 

Sie finden relevante Ereignisse für Ihre BYO SMPP-Integration in der Betriebskonsole. Um zur Betriebskonsole zu navigieren, führen Sie die folgenden Schritte aus:

  1. Klicken Sie auf Admin.
  2. Klicken Sie unter Fehlerbehebung auf Betriebskonsole .
  3. Klicken Speisekarte > IT und Integrationen > Betriebskonsole .

Die Seite „Betriebskonsole“ wird angezeigt.

Weitere Informationen zum SMS-Ereigniskatalog zu den Betriebsereignissen, die für BYO SMPP relevant sind, finden Sie im SMS-Ereigniskatalog im Entwicklercenter. Weitere Informationen zur Verwendung der Betriebskonsole finden Sie unter Fehlerbehebung mit der Genesys Cloud Operational Console .

Wenn bei der Integration weiterhin Probleme auftreten, müssen Sie direkt mit Ihrem Anbieter zusammenarbeiten.