Protocol en instellingen voor sms-connector sms-connector-protocol

Overzicht overview

SMS kan beperkt zijn tot het verzenden van korte tekstberichten zonder opmaak, maar de eenvoud ervan maakt het een waardevol communicatiekanaal.

Er zijn twee belangrijke manieren om SMS te verzenden:

In dit document wordt de verbinding tussen Adobe Campaign en een SMPP-provider besproken.

SMPP-aanbieders kunnen soms afwijken van de officiële specificaties, maar de SMS-connector in Adobe Campaign biedt veel mogelijkheden om het gedrag aan te passen zodat het compatibel is met de meeste aanbieders.

Typen SMS sms-types

Wanneer u SMS-berichten verzendt via een SMS-provider, worden er drie verschillende soorten SMS-berichten weergegeven:

U moet tussen erkenning (RESP PDU, een deel van het protocol SMPP) en SR onderscheid maken: SR is een soort SMS dat door het netwerk van begin tot eind wordt verzonden, terwijl een erkenning slechts een bevestiging is dat één overdracht succesvol is geweest.

Zowel erkenningen als SR kunnen fouten teweegbrengen, die tussen twee onderscheiden zal helpen het oplossen van problemen.

Informatie die via een SMS wordt verzonden information-sms

Een SMS bevat meer informatie dan tekst. Hier een lijst van wat u in SMS kunt verwachten te vinden:

SMPP-protocol smpp-protocol

Adobe Campaign Classic ondersteunt versie 3.4 van het SMPP-protocol. Dit is een wijdverbreid protocol dat het verzenden van SMS naar een leverancier (SMSC) en het ontvangen van SMS evenals ontvangstbewijzen toestaat. Voor meer op dit, verwijs naar de documentatie SMPP.

Het netwerkmateriaal op de dienstverlener van SMS wordt vaak genoemd SMSC.

SMPP-verbindingen smpp-connections

Adobe Campaign maakt via TCP verbinding met de netwerkapparatuur van de SMS-serviceprovider. Het protocol SMPP plaatst permanente verbindingen van TCP van Adobe Campaign aan de leverancier. TCP-verbindingen worden altijd geïnitieerd door Adobe Campaign, zelfs om berichten te ontvangen.
SMPP opent 1 of 2 verbindingen van TCP, afhankelijk van zijn wijze. Alle verbindingen worden altijd geïnitieerd door Adobe Campaign.

Het protocol SMPP kan in twee wijzen werken:

SMPP PDU smpp-pdu

De transmissieeenheden van SMPP ("pakketten") worden genoemd PDUs. A PDU bevat een bevel, een status, een opeenvolgingsaantal en gegevens.

Elke PDU moet door een SMPP RESP PDU (synchrone reactie) worden erkend. Aanvragen kunnen via pijpleidingen worden verzonden: de afzender kan vele opdrachten verzenden zonder op RESP te wachten. Het aantal verzoeken dat op elk moment via een pijpleiding kan worden verzonden, wordt het venster genoemd. RESP PDU kan in om het even welke orde aankomen, los van de orde van hun overeenkomstige initiator PDU.

In de gescheiden Transmitter+receiver wijze, hangt de gebruikte verbinding van het soort verzonden bericht af. De transmissieverbinding wordt gebruikt voor MT, en de ontvangerverbinding wordt gebruikt voor MO en SR. De verzoeken en de reacties voor elk soort bericht worden verzonden over de zelfde verbinding van TCP.

Wanneer u bijvoorbeeld een MT verzendt, wordt de transmissieverbinding gebruikt en wordt de RESP die bevestigt dat de MT ook via het transmissiekanaal wordt verzonden. Wanneer u een MO (of een SR) ontvangt, wordt de ontvangerverbinding gebruikt om MO te ontvangen en RESP te verzenden die MO erkent.

Als u in Adobe Campaign Classic SR wilt koppelen aan de bijbehorende MT, geeft het SMSC een id met de stappen SUBMIT_SM_RESP en DELIVER_SM . De id wordt opgeslagen in het veld providerId van de nms::providerMsgId -tabel en is gekoppeld aan broadLogId en deliveryId . Deze passende verrichting wordt gedaan door het proces van SMS wanneer het schrijven aan het gegevensbestand.

Een geslaagde SUBMIT_SM_RESP PDU activeert de status van het "verzonden" bericht in het verzendende logbestand terwijl een geslaagde DELIVER_SM (SR) PDU de status van het "ontvangen" bericht activeert.

Beveiligingsaspecten security-aspects

Het protocol zelf is niet gecodeerd. De meeste leveranciers voeren een variant van IP op lijst van gewenste personen uit zodat moeten de serverIP van Adobe Campaign adressen aan de leverancier worden verklaard.

Adobe Campaign ondersteunt het doorgeven van een aanmelding en een wachtwoord tijdens de bind fase. Ook SMPP via TLS wordt ondersteund. Er zij op gewezen dat certificaten vereist zijn voor een goede beveiliging. Hoewel met de SMPP-connector certificaatcontroles kunnen worden overgeslagen, mag deze alleen worden gebruikt voor tests, aangezien TLS zonder certificaten een aanzienlijk lager beveiligingsniveau biedt.

De schakelaar gebruikt de standaardcertificaten die door de systeem openssl bibliotheek worden verstrekt. Meestal wordt deze opgegeven door de map /etc/ssl/certs op Debian. Deze map wordt standaard geleverd door het pakket "ca-certificates", maar kan worden aangepast.

Informatie in elke soort PDU information-pdu

Elk type PDU heeft verschillende gebieden die verschillende stukken van informatie dragen. Deze PDU wordt gedetailleerd in SMPP 3.4 specificatie.

Elke sectie beschrijft hieronder zowel PDU als zijn synchrone reactie (*_RESP PDU). Alle PDU's moeten worden herkend door een corresponderende RESP . Dit is een verplicht onderdeel van de specificatie.

PDU's kunnen optionele velden hebben. Alleen de meest voorkomende velden worden hier beschreven. Verwijs naar SMPP 3.4 specificatievoor meer informatie.

BIND_TRANSMITTER / BIND_RECEIVER / BIND_TRANSCEIVER

Deze PDU wordt gebruikt om een verbinding met SMSC in werking te stellen. Transmitter, Ontvanger en Transceiver wijzen veranderen slechts het soort SMS dat wordt toegestaan om over deze verbinding, specifiek worden overgebracht:

Noteerbare velden in een BIND_* PDU :

BIND_*_RESP heeft geen specifiek veld. Hiermee wordt bevestigd of de verbinding is gelukt of niet.

ONBINDEN unbind

Deze PDU moet door het systeem worden verzonden alvorens los te maken van. De overeenkomende UNBIND_RESP PDU moet wachten voordat de verbinding wordt gesloten.

Als u SMSC in overeenstemming acht, mag de verbinding niet worden gesloten, wordt de TCP-verbinding bestuurd door de Adobe Campaign-connector.

VERZENDEN_SM submit-sm

Deze PDU verzendt een MT naar SMSC. Zijn reactie PDU geeft identiteitskaart van MT.

Noteerbare velden in een SUBMIT_SM PDU:

Adobe Campaign ondersteunt de volgende optionele velden:

SUBMIT_SM_RESP submit-sm-resp

Deze PDU zal identiteitskaart van MT bevatten. Dit is handig om deze aan te passen aan de binnenkomende SR.

Sommige providers verzenden SUBMIT_SM_RESP nadat de SR is verzonden. Om van dat gedrag rekenschap te geven, wacht Adobe Campaign 30 seconden alvorens Ongeldige berichtidentiteitskaart aan een SR met onbekende identiteitskaart te antwoorden.

DELIVER_SM delivery-sm

Deze PDU wordt door SMSC naar Adobe Campaign verzonden. Het bevat een MO of een SR.

De meeste velden hebben dezelfde betekenis als de SUBMIT_SM -tegenhanger. Hier volgt een lijst met nuttige velden:

Adobe Campaign kan bericht-id lezen in het optionele veld receipted_message_id met een bepaalde configuratie.

DELIVER_SM_RESP deliver-sm-resp

Deze PDU wordt door Adobe Campaign verzonden om SR en MO te erkennen.

Adobe Campaign Classic erkent SR en MO zodra deze in de database zijn ingevoegd. Er kunnen verwerkingsfouten optreden, zelfs als een DELIVER_SM_RESP PDU met succes is verzonden. Deze beperking wordt veroorzaakt door de softwarearchitectuur van Adobe Campaign Classic.

INQUIRE_LINK enquire-links

Deze PDU wordt alleen gebruikt om te controleren of de verbinding live is. De frequentie moet worden vastgesteld op basis van de behoeften van de aanbieder.

De standaardconfiguratie 60 seconden moet overeenkomen met de meeste configuraties die zijn ingesteld in de externe account.

INQUIRE_LINK_RESP enquire-links-resp

Deze PDU erkent dat de verbinding levend is.

Multipart SMS (lang SMS) multipart

Multipart SMS, of lange SMS, zijn SMS die in veelvoudige delen worden verzonden. Vanwege technische beperkingen in het mobiele netwerkprotocol kan een SMS niet groter zijn dan 140 bytes of moet het worden gesplitst. Zie de tekst het coderen van SMSsectie om meer op het aantal karakters te leren die in een SMS kunnen passen.

Elk deel van een lang bericht is een individueel SMS. Deze onderdelen reizen onafhankelijk op het netwerk en worden door de ontvangende mobiele telefoon gemonteerd. Om herpogingen en connectiviteitsproblemen te behandelen, verzendt Adobe Campaign deze delen in omgekeerde orde en verzoekt slechts om SR op het eerste deel van het bericht, het laatst verzonden. Aangezien de mobiele telefoon alleen een bericht weergeeft wanneer het eerste deel ervan is ontvangen, worden bij nieuwe pogingen op extra onderdelen geen duplicaten op de mobiele telefoon gegenereerd.

Het maximumaantal SMS per bericht kan per levering worden geplaatst gebruikend het Maximum aantal SMS per bericht plaatsend in het malplaatje van de Levering. Berichten die deze limiet overschrijden, mislukken tijdens het verzenden met een te lange reden voor SMS-fout.

Er zijn twee manieren om lange SMS te verzenden:

Zie de beschrijving van esm_class, short_message en message_payload gebieden van SUBMIT_SM PDUvoor meer details over het protocol en de formaten.

Vastzetten en ramen van doorvoer throughput-capping

De meeste leveranciers vereisen een productielimiet voor elke verbinding SMPP. Dit kan worden bereikt door een aantal SMS in te stellen in de externe account. Merk op dat de productiesnelheid per verbinding gebeurt, is de totale efficiënte productie de grens per verbinding die door het totale aantal verbindingen wordt vermenigvuldigd. Dit wordt gedetailleerd in de Gelijktijdige verbindingensectie.

Om maximum mogelijke productie te bereiken, zult u het maximum verzendende venster moeten verfijnen. Het verzendende venster is het aantal SUBMIT_SM PDU s dat zonder het wachten op SUBMIT_SM_RESP kan worden verzonden. Zie het Verzendende venster plaatsendsectie voor meer details.

SR- en foutbeheer ("Bijlage B") sr-error-management

Het protocol SMPP bepaalt standaard synchrone fouten in RESP PDU s, maar het bepaalt geen foutencodes voor SR. Elke provider gebruikt zijn eigen foutcodes met hun betekenis.

Een aanbeveling wordt gemaakt in de sectie van Bijlage B van de SMPP protocolspecificatie(pagina 167), maar dit maakt geen lijst van de daadwerkelijke foutencodes noch hun betekenis.

Om zich aan foutenbeheer aan te passen, is het systeem van het uitzendingsbericht van Adobe Campaign gebruikt aan behoorlijk leveringsfouten en hun strengheid (hard, zacht, enz.).

Zoals hierboven vermeld, zijn er twee verschillende soorten fouten:

Wanneer een SR wordt ontvangen, kunnen de status en de fout in zijn short_message gebied (voorbeeld voor Bijlage B conformerende implementaties) worden gevonden. Het short_message gebied van PDU wordt vaak genoemd het tekstgebied aangezien het tekst in MT bevat. In geval van SR, bevat het technische informatie plus een subgebied genoemd Tekst. Deze 2 gebieden zijn verschillend en short_message bevat eigenlijk het 2} gebied van de Tekst {en andere informatie.

Adobe Campaign Classic-connectors (met uitzondering van Extended SMPP) gebruiken een gehard gedrag dat afhankelijk is van de geselecteerde provider. Algemene SMPP maakt alleen onderscheid tussen succes en fout, zonder detail. Het leveringslogboek kan bepaalde informatie bevatten die niet gegarandeerd is.

Indeling van het tekstveld SR sr-text-field-format

De specificatie raadt u aan deze indeling te gebruiken voor het tekstveld SR. Het is een lijst van subvelden, spaties gescheiden met een dubbele punt om de veldnaam en de waarde ervan te scheiden. Veldnamen zijn niet hoofdlettergevoelig.

Voorbeeld van een SR-tekstveld dat overeenkomt met de aanbeveling in aanhangsel B:

id:1234567890 sub:001 dlvrd:001 submit date:1608011415 done date:1608011417 stat:DELIVRD err:000 Text:Hello Adobe world

Het id-veld is de id die is ontvangen in de SUBMIT_SM_RESP PDU , de id die de MT bevestigt.

sub en dlvrd worden geacht de hoeveelheid geleverde onderdelen en geleverde berichten te tellen, maar dit wordt niet door Adobe Campaign gebruikt omdat het breedbandsysteem betere en meer geïntegreerde informatie biedt.

submit date - en done date -velden zijn indicatieve tijdstempels van het moment waarop de MT is verzonden en het tijdstip waarop de mobiele versie de SR heeft verzonden. Verwacht enkele problemen met tijdzones of zelfs onjuiste tijdstempels die worden gegeven door mobiele apparaten met een onjuiste datumset.

Het statusveld is belangrijk omdat het de status van het bericht aangeeft. De enige belangrijke status zijn DELIVRD , UNDELIV en REJECTD . De status DELIVRD geeft aan dat de bewerking is geslaagd, de andere twee geven een fout aan. Andere waarden zijn mogelijk, maar doorgaans zijn het tussentijdse meldingen, zoals de MT die de mobiele provider heeft bereikt, maar niet de mobiele telefoon. Deze tussentijdse meldingen worden genegeerd door Adobe Campaign.

Het foutveld bevat de providerspecifieke foutcode. De provider moet een tabel met mogelijke foutcodes en de betekenis ervan opgeven om deze waarde te kunnen interpreteren.

Ten slotte bevat het tekstveld gewoonlijk het begin van de tekst van de MT. Dit wordt genegeerd door Adobe Campaign en sommige providers verzenden het niet om PII-lekkage en netwerkbandbreedteverbruik te voorkomen. Het kan tijdens het oplossen van problemen worden gebruikt om SR te vlekken die een test MT door dit gebied gemakkelijker aanpast te lezen.

Voorbeeld van SR-verwerking in Adobe Campaign Classic Extended algemeen SMPP sr-processing

In dit voorbeeld wordt het geval van een implementatie weergegeven volgens de aanbeveling in appendix B, de standaardwaarden in de externe account en een geslaagde SMS MT.

id:1234567890 sub:001 dlvrd:001 submit date:1608011415 done date:1608011417 stat:DELIVRD err:000 Text:Hello Adobe world

Eerst wordt de id extraction regex toegepast om de id te extraheren en deze af te stemmen op de overeenkomstige MT.

Vervolgens worden status extraction regex en error code extraction regex toegepast om deze velden te extraheren en aan de tekenreeks toegevoegd.

Het breedbandbericht wordt geconstrueerd met deze informatie, en het originele onveranderde koord wordt toegevoegd voor verwijzing:

SR ExampleProvider DELIVRD 000|MESSAGE=id:1234567890 sub:001 dlvrd:001 submit date:1608011415 done date:1608011417 stat:DELIVRD err:000 Text:Hello Adobe world

Het bericht wordt dan genormaliseerd, verwijderend het deel van het BERICHT om veelvoudige berichten met de zelfde staat en err codes te kunnen aanpassen.

SR ExampleProvider DELIVRD 000|#MESSAGE#

Als het bericht niet reeds provisioned in de lijst van het uitzendingsbericht is, zal een nieuwe ingang worden gecreeerd, gebruikend het volledige bericht als firstText en het genormaliseerde bericht. Vervolgens gebruikt de connector het succes en error regex om te bepalen of dit een succes of een mislukking was:

Standaard worden alle fouten weergegeven als schermfouten. Dit betekent dat harde fouten met de hand moeten worden opgelost.

SMS-tekstcodering sms-text-encoding

U zou altijd de leverancier moeten contacteren SMSC in het geval van het coderen problemen. Alleen de SMSC-aanbieders hebben kennis van de codering die zij ondersteunen en van de speciale regels die van toepassing kunnen zijn vanwege beperkingen in hun technische platform.

SMS-berichten gebruiken een speciale 7-bits codering, vaak de GSM7-codering genoemd.

In het protocol SMPP, zal de tekst GSM7 tot 8 beetjes per karakter voor het gemakkelijkere oplossen van problemen worden uitgebreid. Het SMSC zal het in 7 beetjes per karakter verpakken alvorens het naar mobiel wordt verzonden. Dit betekent dat het short_message gebied van SMS tot 160 bytes lang in het kader SMPP kan zijn terwijl het tot 140 bytes wanneer verzonden op het mobiele netwerk beperkt is.

In het geval van coderingsproblemen moet u een aantal belangrijke zaken controleren:

In het veld data_coding wordt aangegeven welke codering wordt gebruikt. Een groot probleem is dat de waarde 0 standaard SMSC-codering in de specificatie betekent, die meestal naar GSM7 verwijst. Vraag de SMSC-partner welke codering is gekoppeld aan data_coding = 0 die alleen door Adobe Campaign wordt ondersteund. Andere data_coding -waarden volgen meestal de specificatie, maar de enige manier om zeker te zijn is om contact op te nemen met de SMSC-provider.

De maximumgrootte van een bericht hangt van zijn codering af. In deze tabel worden alle relevante gegevens samengevat:

SMPP-parameters voor externe account SMPP-parameters-external

Elke implementatie van het protocol SMPP heeft vele variaties. Om de compatibiliteit en het aanpassingsvermogen te verbeteren, zijn er veel instellingen beschikbaar om het gedrag van de SMPP-connector te wijzigen. Deze sectie beschrijft elke parameter en zijn gevolgen op de schakelaar.

Algemene parameters en routering general-parameters-routing

MTA instanties van de Grens voor deze rekening

Het is mogelijk om een grens aan het aantal MTA instanties te plaatsen die met de leverancier SMPP mogen verbinden. Wanneer gecontroleerd, kunt u specificeren hoeveel MTAs maximaal kan worden gebruikt.

Deze optie staat fijnere controle over het aantal verbindingen toe, zie Gelijktijdige verbindingen.

Als u een waarde hoger dan het aantal lopende MTAs plaatst, zullen alle MTAs normaal lopen: deze optie is slechts een grens en kan geen extra MTAs kweken.

Als u het aantal verbindingen, b.v. leveranciersvereiste moet nauwkeurig controleren, wordt het geadviseerd om deze optie altijd te plaatsen zelfs als de huidige plaatsing het juiste aantal lopende MTAs heeft. Als extra MTAs daarna wordt toegevoegd, zal de verbindingsgrens nog worden geëerbiedigd.

Verbindingsinstellingen connection-settings

Naam van SMSC-implementatie smsc-implementation-name

Hier geeft u de naam van de SMSC-implementatie op. Deze moet op de naam van uw provider worden ingesteld. Neem contact op met de beheerder of het leveringsteam om te weten wat u in dit veld wilt toevoegen. De rol van dit gebied wordt beschreven in de sectie van het foutenbeheer van SR.

Server server

De DNS naam of IP adres van de server om met te verbinden.

Poort port

De TCP-poort voor verbinding.

Account account

De aanmelding van de verbinding. Wordt doorgegeven in het veld system_id van de PDU BIND.

Wachtwoord password

Wachtwoord van de SMPP-verbinding. Wordt doorgegeven in het wachtwoordveld van de PDU BIND.

Systeemtype system-type

Waarde die wordt doorgegeven in het veld system_id van de PDU BIND. Sommige providers hebben hier een specifieke waarde nodig.

Aantal MTA kindverbindingen number-mta-child

In Adobe Campaign Classic wordt het aantal verbindingen per MTA-onderliggend item gedefinieerd.

De Adobe Campaign Classic Extended SMPP-connector kan het aantal verbindingen per MTA-onderliggend item bepalen. Om de globale grens van verbindingen te controleren, zult u het aantal MTA kindprocessen moeten beperken, wat vaak het hebben van een specifiek midsourcingsplatform voor SMS betekent.

Voor Adobe Campaign Classic kan het aantal ontvangers- en transmissieverbindingen verschillen:

Zoals hierboven gesuggereerd, opent het proces van Adobe Campaign Classic SMS meer transmissieverbindingen als het auto-antwoord wordt toegelaten. Deze extra verbindingen worden gebruikt om de automatische antwoorden te verzenden.

Als u opstelling automatische antwoorden, zal het proces van SMS zenders/ontvangerparen openen, die het aantal transmissieverbindingen verhogen. Als u geen automatische reactie hebt ingesteld, worden alleen de ontvangerverbindingen geopend.

TLS inschakelen via SMPP enable-TLS

Gebruik TLS om verbinding te maken met de provider. De verbinding wordt versleuteld. De TLS-verbinding wordt beheerd door de OpenSSL-bibliotheek en alles wat op OpenSSL van toepassing is, geldt voor deze verbinding.

Brede SMPP-sporen inschakelen in het logbestand enable-verbose-log-file

Deze instelling dumpt al SMPP-verkeer in logbestanden. Het wordt vaak vereist om parameters tijdens aanvankelijke opstelling aan te passen. Dit moet worden toegelaten wanneer het oplossen van problemen de schakelaar en vergeleken met het verkeer dat door de leverancier wordt gezien.

In Adobe Campaign Classic bevindt de loguitvoer zich in het MTA-logboek voor MT-gerelateerd verkeer en in het SMS-logboek voor MO- en SR-gerelateerd verkeer.

Verbindingsinstelling ontvanger receiver-connection

Deze sectie is slechts zichtbaar op gescheiden zender+receiver wijze.

Verschillende parameters gebruiken voor de ontvanger receiver-parameters

Als het selectievakje is uitgeschakeld, worden dezelfde instellingen gebruikt voor zender en ontvanger.

Wanneer de doos wordt gecontroleerd, zullen de montages in de montages van de Verbinding sectie op de zender van toepassing zijn en de montages in de Ontvanger verbindings montages zullen op de ontvanger van toepassing zijn.

Ontvangerserver, haven, rekening, wachtwoord, systeemtype

Deze instellingen zijn van toepassing op de ontvanger in de modus zender+ontvanger. Ze werken als het zenderdeel, zie hierboven voor meer details.

SMPP-kanaalinstellingen smpp-channel-settings

Tekentransliteratie toestaan allow-character-transliteration

Transliteratie is het zoeken naar tekens die equivalent zijn aan ontbrekende tekens. Het Franse "ê"-teken (e met omstreeks accent) ontbreekt bijvoorbeeld in GSM-codering, maar kan worden vervangen door "e" zonder dat dit de leesbaarheid aantast.

Als dit selectievakje is uitgeschakeld, mislukt de tekstcodering als de tekenreeks niet exact zo kan worden gecodeerd.

Als dit selectievakje is ingeschakeld, probeert de tekstcodering de tekenreeks om te zetten in een versie die bij benadering overeenkomt in plaats van te mislukken. Als sommige tekens geen equivalent hebben in de doelcodering, mislukt de tekstcodering.

Zie een specifieke afbeelding van coderingen bepalen dievoor een meer algemene verklaring van het het coderen proces plaatsen.

Inkomende MO opslaan in de database incoming-mo-storing

Als deze optie is ingeschakeld, wordt de inkomende MO opgeslagen in de inSMS-tabel van de database. Deze lijst kan worden gevraagd gebruikend de vraagactiviteit van om het even welke werkschema.

Adobe Campaign Classic slaat altijd alle MO's op in de InSMS-database, zodat deze optie niet beschikbaar is.

Real-time KPI-updates inschakelen tijdens SR-verwerking real-time-kpi

Indien toegelaten, KPIs zal in real time op de belangrijkste leveringspagina worden bijgewerkt wanneer het ontvangen van foutSR.

Het nadeel kan lage prestaties wegens het gegevensbestandgeschil zijn het produceert. Als gehandicapt, worden de statistieken bijgewerkt door het syncfromexec werkschema, dat om de 20 minuten in werking stelt.

Adobe Campaign Classic heeft een geheel ander mechanisme voor KPI's, dus deze optie is niet beschikbaar.

Source-nummer source-number

Bepaalt het standaardbronadres voor berichten. Deze instelling is alleen van toepassing als het bronnummer leeg is gelaten in de levering.

Het veld Bronnummer wordt standaard niet doorgegeven, zodat de provider dit veld vervangt door de korte code.

Dit laat de de opheffingseigenschap van het afzenderadres/oADC toe.

Korte code short-code

Geeft de korte hoofdcode van de account aan. Als er meerdere korte codes worden gebruikt voor deze account of als de korte code onbekend is, laat u dit veld leeg.

Het opgeven van korte code is handig voor twee functies:

Source TON/NPI, TON/NPI bestemming ton-npi

TON (Type van Aantal) en NPI (de Indicator van het Plan van de Nummering) worden beschreven in sectie 5.2.5 van de SMPP 3.4 specificatie(pagina 117). Deze waarden moeten op de behoeften van de leverancier worden ingesteld.

Ze worden ongewijzigd verzonden in de velden source_addr_ton , source_addr_npi , dest_addr_ton en dest_addr_npi van de SUBMIT_SM PDU .

Servicetype service-type

Dit veld wordt ongewijzigd verzonden in het service_type -veld van SUBMIT_SM PDU . Stel dit in op de behoeften van de provider.

Doorvoer en time-outs throughput-timeouts

Deze montages controleren alle timingsaspecten van het kanaal SMPP. Sommige leveranciers vereisen zeer nauwkeurige controle van het berichttarief, venster en retry timings. Deze instellingen moeten worden ingesteld op waarden die overeenkomen met de capaciteit van de aanbieder en de voorwaarden die in het contract zijn vermeld.

Venster verzenden sending-window

Het venster is het aantal SUBMIT_SM PDU s dat zonder het wachten op een aanpassing SUBMIT_SM_RESP kan worden verzonden.

Voorbeeld van een transmissie met een maximum venster van 4:

De vensterhulp verhoogt de productie wanneer de netwerkverbinding een hoge latentie heeft. De waarde van het venster moet ten minste het aantal SMS/s zijn, vermenigvuldigd met de latentie van de koppeling
in seconden zodat de connector nooit op een SUBMIT_SM_RESP wacht voordat het volgende bericht wordt verzonden.
Als het venster te groot is, kunt u meer dubbele berichten verzenden in het geval van verbindingsproblemen. Bovendien hebben de meeste providers een zeer strikte limiet voor het venster en weigeren berichten die de limiet overschrijden.

Hoe te om de optimale verzendende vensterformule te berekenen:

Voorbeeld: als u 300 SMS/s hebt ingesteld in maximale MT-doorvoer en er gemiddeld 100 ms latentie tussen SUBMIT_SM en SUBMIT_SM_RESP is, is de optimale waarde 300×0.1 = 30 .

Maximale MT-doorvoer max-mt-throughput

Maximum aantal MT per seconde en per verbinding. Deze instelling wordt strikt gehandhaafd, de MTA zal nooit berichten sneller dan deze grens duwen. Het is nuttig voor leveranciers die nauwkeurige vertraging vereisen.

Om de totale productielimiet te kennen, vermenigvuldig dit aantal met het totale aantal verbindingen zoals die in de bovenstaande formule worden beschreven.

0 betekent geen limiet, de MTA zal MT zo snel mogelijk verzenden.

Over het algemeen wordt aanbevolen deze instelling onder de 1000 te houden, aangezien het onmogelijk is een exacte doorvoer boven dit aantal te garanderen, tenzij deze op de uiteindelijke architectuur is gebaseerd en specifiek om een SMPP-leverancier is verzocht. Het kan beter zijn om het aantal verbindingen te verhogen om boven 1000 MT/s te gaan.

Tijd vóór opnieuw verbinden time-reconnection

Wanneer de verbinding van TCP wordt verloren, zal de schakelaar dit aantal seconden wachten alvorens te proberen om een verbinding te maken.

Vervalperiode van de MT expiration-period

Time-out tussen SUBMIT_SM en de overeenkomende SUBMIT_SM_RESP . Als RESP niet tijdig wordt ontvangen, zal het bericht als ontbroken worden beschouwd en zal het globale terugkeerbeleid van MTA van toepassing zijn.

Time-out binden bind-timeout

Time-out tussen de poging van TCP verbinden en het BIND_*_RESP antwoord. Wanneer de verbinding uitvalt, wordt deze door de Adobe Campaign-connector gesloten en wacht deze op Tijd voordat u opnieuw verbinding maakt. Probeer het opnieuw.

request_link period enquire-link-period

enquire_link is een speciaal soort PDU die wordt verzonden om de verbinding levend te houden. Deze periode is in seconden. De campagnector verzendt alleen enquire_link wanneer de verbinding niet-actief is om bandbreedte te besparen. Als geen RESP na tweemaal deze periode wordt ontvangen, zal de verbinding als dood worden beschouwd en zal een reconnectieproces worden teweeggebracht.

SMSC-specificaties SMSC-specifics

Deze instellingen zijn geavanceerde instellingen die de Adobe Campaign-aansluiting aanpassen aan de meeste specifieke kenmerken van de SMPP-implementatie.

bepaal een specifieke afbeelding van coderingen

Zie de tekst het coderen van SMSsectie voor details op tekstcodering.

Met deze instelling kunt u een aangepaste coderingstoewijzing definiëren die afwijkt van de specificatie. U kunt een lijst met coderingen declareren, samen met de waarde data_coding ervan.

De MTA zal proberen te coderen gebruikend het eerste coderen in de lijst. Als dit mislukt, probeert het de volgende codering in de lijst te gebruiken, enzovoort. Als het bericht niet kan worden gecodeerd, treedt er een fout op. Nadat de codering is gevonden, maakt de MTA de SUBMIT_SM PDU met de gecodeerde tekst en de data_coding -veldset met de waarde die in de tabel is opgegeven.

De volgorde van items in de tabel is belangrijk: coderingen zijn pogingen van boven naar beneden. Plaats de goedkoopste of meest aanbevolen codering boven aan de lijst, gevolgd door meer en duurdere coderingen.

Houd er rekening mee dat UCS-2 nooit zal mislukken omdat het alle tekens kan coderen die in Adobe Campaign worden ondersteund en dat de maximale lengte van een UCS-2 SMS veel kleiner is: alleen 70 tekens.

U kunt deze instelling ook gebruiken om een specifieke codering te forceren die altijd moet worden gebruikt door slechts 1 regel in de toewijzingstabel te declareren.

De standaardtoewijzing die wordt gebruikt wanneer het selectievakje niet is ingeschakeld, is gelijk aan de volgende tabel:

Dit betekent dat de MTA zal proberen de boodschap in GSM te coderen. Als het lukt, wordt het verzonden met data_coding ingesteld op 0.

Als het bericht niet in GSM kan worden gecodeerd, wordt het gecodeerd in UCS-2 en wordt data_coding ingesteld op 8.

message_payload inschakelen enable-message-payload

Wanneer ongecontroleerd, lang SMS door MTA zal worden verdeeld en in veelvoudige SUBMIT_SM PDU s met UDH verzonden. Het bericht wordt opnieuw samengesteld door de mobiele telefoon na UDH-gegevens.

Wanneer gecontroleerd, lange SMS zal in één SUBMIT_SM PDU worden verzonden, die de tekst in het bericht_payload facultatieve gebied zetten. Zie de specificatie SMPPvoor details over dit.

Als deze functie is ingeschakeld, kan Adobe Campaign geen SMS-onderdelen afzonderlijk tellen: alle berichten worden geteld zoals ze in één deel zijn verzonden.

Het volledige telefoonnummer verzenden send-full-phone-number

Wanneer dit selectievakje niet is ingeschakeld, worden alleen cijfers van het telefoonnummer verzonden naar de provider (destination_addr veld van het SUBMIT_SM veld). Dit is het standaardgedrag aangezien de internationale aantalindicator, gewoonlijk a + prefix, door TON en NPI gebieden in SMPP wordt vervangen.

Als het selectievakje is ingeschakeld, wordt het telefoonnummer ongewijzigd verzonden, zonder voorbehandeling en mogelijke spaties, plus voorvoegsel- of hekje-/sterborden.

Deze eigenschap heeft ook een effect op het gedrag van de auto functie van de lijst van gewezen personen van de repliek: wanneer checkbox niet wordt gecontroleerd, zal een + prefix aan telefoonaantallen worden toegevoegd die in de quarantainetabel worden opgenomen om te compenseren + prefix die van het telefoonaantal door het protocol SMPP zelf wordt verwijderd.

TLS-certificaatcontrole overslaan skip-tls

Wanneer TLS is ingeschakeld, slaat u alle certificaatcontroles over.

Wanneer gecontroleerd, is de verbinding niet veilig meer, zou het niet in productie moeten worden toegelaten.

Het kan nuttig voor het zuiveren of testdoeleinden zijn.

U kunt kiezen uit drie verschillende waarden voor de certificaatvalidatie:

Binden TON/NPI bind-ton-npi

TON (Type van Aantal) en NPI (de Indicator van het Plan van de Nummering) die in sectie 5.2.5 van de wordt beschreven SMPP 3.4 specificatie(pagina 117). Deze waarden moeten worden ingesteld op wat de provider nodig heeft.

Ze worden als zodanig verzonden in addr_ton - en addr_npi -velden van de BIND PDU.

Adresbereik address-range

Verzonden as-is op het address_range gebied van BIND PDU. Deze waarde moet worden ingesteld op wat de provider nodig heeft.

Aantal voor ongeldige id-erkenning invalid-id

Beperkt het aantal ongeldige identiteitskaart van het Bericht DELIVER_SM_RESP die voor één enkele SR kan worden verzonden.

dit zou slechts voor het oplossen van problemendoel als alternerende actie moeten worden gebruikt en aan 0 in normale voorwaarden worden geplaatst.

Voorbeeld bij instelling op 2:

Het plaatsen van dit gebied aan 0 maakt het mechanisme onbruikbaar waar ongeldige identiteitskaart van het Bericht altijd is teruggekeerd, is dit normaal gedrag.

Als u dit veld instelt op 1, reageert de connector altijd op OK, zelfs als de id ongeldig is. Dit zou slechts aan 1 moeten worden geplaatst onder toezicht, voor het oplossen van problemen en voor de minimumhoeveelheid tijd, bijvoorbeeld om van een leverancier-zijkwestie terug te krijgen.

Extractieregex van de id in de SR regex-extraction

SR-indeling wordt niet strikt afgedwongen door de specificatie van het SMPP-protocol. Het is slechts een aanbeveling die in wordt beschreven Bijlage B(pagina 167) van de specificatie. Sommige implementatoren van SMPP formatteren dit gebied verschillend, zodat heeft Adobe Campaign een manier nodig om het correcte gebied te halen.

Standaard worden maximaal 10 alfanumerieke tekens na id: vastgelegd.

De regex moet precies één vastleggroep hebben met een onderdeel tussen haakjes. Haakjes moeten rond het id-onderdeel staan. De regex-indeling is PCRE.

Wanneer u deze instelling aanpast, moet u zoveel mogelijk context opnemen om onjuiste triggers te voorkomen. Als er specifieke voorvoegsels zijn, zoals id: in de standaard, neemt u deze op in de regex. Gebruik ook woordscheidingstekens (\b) zoveel mogelijk om te voorkomen dat tekst in het midden van een woord wordt vastgelegd.

Als u niet genoeg context in de regex opneemt, kan er een klein veiligheidsprobleem ontstaan: de feitelijke inhoud van het bericht kan in de SR worden opgenomen. Als u alleen een specifieke id-indeling aanpast zonder context, bijvoorbeeld een UUID, wordt de werkelijke tekstinhoud mogelijk geparseerd, bijvoorbeeld een UUID die is ingesloten in het tekstveld, in plaats van de ID.

Regex is toegepast om de status van geslaagd/fout te bepalen regex-applied

Wanneer berichten met een onbekende stat/err gebiedscombinatie worden ontmoet, worden deze regex toegepast op het staatsgebied om te bepalen of SR een succes of een fout was. SR met statuswaarden die niet overeenkomen met een van deze regexes wordt genegeerd.

Door gebrek, zullen de staatswaarden die met DELIV beginnen, bijvoorbeeld DELIVRD in Bijlage B, als met succes worden beschouwd en alle staatswaarden die fouten aanpassen, b.v. REJECTED, UNDELIV, worden beschouwd als fouten.

ID-indeling in MT-bevestiging id-format-mt

Dit geeft de indeling van de id aan die wordt geretourneerd in het veld message_id van SUBMIT_SM_RESP PDU .

ID-indeling in SR id-format-sr

Dit geeft de indeling aan van de id die is vastgelegd door de Extraction regex van de id in de SR. Waarden hebben dezelfde betekenis en hetzelfde gedrag als de notatie in MT hierboven.

identiteitskaart van SR of foutencode op facultatief gebied

Als deze optie is ingeschakeld, wordt de inhoud van optionele velden toegevoegd aan de tekst die wordt verwerkt door bovenstaande regexes. De tekst heeft de opmaak 0xTAG:VALUE , waarbij 0xTAG de hexadecimale waarde van 4 cijfers van de tag in hoofdletters is, bijvoorbeeld 0x002E .

U kunt bijvoorbeeld de id vastleggen in het veld receipted_message_id . Hiervoor schakelt u dit selectievakje in en wordt de volgende tekst aan de status toegevoegd:

0x001E:05e3299e-8d37-49d0-97c6-8e4fe60c7739

In dit voorbeeld is 0x001E de tag van het optionele veld en is UUID de waarde van het veld.

Als u deze waarde wilt vastleggen, kunt u nu de volgende regex instellen in het vak Extractie van de id in het veld SR:

\b0x001E:([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\b

identiteitskaart van SR of foutencode op tekstgebied

Als gecontroleerd, zal het gebied van de Tekst tijdens verwerking van de statustekst van SR worden gehouden.

Dit is handig als de provider belangrijke gegevens in dit veld plaatst, zoals de id of de status. Dit veld kan gewoonlijk veilig worden verwijderd, omdat het tekst met een niet-ASCII-codering kan bevatten en de verwerking van regex kan verstoren.

Als u deze optie inschakelt, kan dit leiden tot een zeer klein beveiligingsprobleem als de Extraction regex van de id in het veld SR niet specifiek genoeg is. De inhoud van het gebied van de Tekst kan als identiteitskaart worden ontleed en een aanvaller kan het gebruiken om vervalste IDs te injecteren, die tot een gedeeltelijke ontkenning van de dienstsituatie kan leiden.

markering van identiteitskaart van de Dienst

Hiermee kunt u een aangepaste TLV toevoegen. In dit veld wordt het taggedeelte ingesteld. De waarde kan per levering in de waarde van identiteitskaart van de Dienst of van het programma in de geavanceerde parameters van de levering worden aangepast.

Met deze instelling kunt u slechts één TLV-optie per bericht toevoegen.

Automatisch antwoord verzonden aan de MO automatic-reply

Met deze functie kunt u snel tekst op de MO beantwoorden en per korte code naar de lijst van gewezen personen verzenden.

Het Sleutelwoord en Korte code kolommen bepalen voorwaarden om het autoantwoord teweeg te brengen. Als beide velden overeenkomen, wordt de MO verzonden en wordt de aanvullende actie geactiveerd. Als u een jokerteken wilt opgeven, laat u het veld leeg. Trefwoorden komen overeen met het eerste alfanumerieke woord in de MO-tekst, waarbij leestekens en voorloopruimten worden genegeerd. Het betekent dat het 1} gebied van het Sleutelwoord {geen ruimten kan bevatten en één enkel woord moet zijn.

Het Trefwoord plaatsen is een prefix. Als u bijvoorbeeld "AD" opgeeft, komt deze overeen met "AD", "ADAPT" en "ADOBE". Als u meerdere trefwoorden met een algemeen voorvoegsel hebt, moet u rekening houden met de volgorde, aangezien de trefwoorden van boven naar beneden worden verwerkt.

De kolom van het Antwoord is de tekst om te antwoorden. Er is geen personalisatie beschikbaar op dit gebied. Als u dit veld leeg laat, wordt er geen bericht geantwoord, maar wordt de aanvullende actie toch geactiveerd.

De Extra actie kolom verstrekt een extra actie wanneer zowel Trefwoord als Korte code gelijke, lege korte code alle korte codes aanpast. U kunt naar quarantaine verzenden of uit quarantaine verwijderen, waarde geen antwoorden op de tekst. Als u een Aanvullende actie specificeert maar het antwoordt gebied leeg verlaat, zal de actie worden uitgevoerd maar geen antwoord zal worden verzonden. Quarantaine wordt alleen toegepast voor de opgegeven korte code of voor alle korte codes als het veld leeg blijft.

Alle items in de tabel worden in de opgegeven volgorde verwerkt, totdat één regel overeenkomt. Als de veelvoudige regels een MO aanpassen, slechts zal de hoogste regel worden toegepast.

Sjabloonparameters voor verzending via SMS sms-delivery-template-parameters

Sommige parameters kunnen per leveringsmalplaatje worden geplaatst.

Van veld from-field

Dit veld is optioneel. Het staat met voeten treedt afzenderadres (oADC) toe. De inhoud van dit veld wordt in het veld source_addr van SUBMIT_SM PDU geplaatst.

Het veld is door de SMPP-specificatie beperkt tot 21 tekens, maar sommige providers staan mogelijk langere waarden toe. Houd er rekening mee dat in sommige landen zeer strikte beperkingen kunnen worden toegepast, zoals lengte, inhoud en toegestane tekens.

Leveringsparameters delivery-parameters

Maximum aantal SMS per bericht maximum-sms

Dit het plaatsen werkt slechts als het nuttige lading van het Bericht plaatsen gehandicapt is. Als het bericht meer SMS dan deze waarde vereist, zal een fout worden teweeggebracht.

Het protocol van SMS beperkt SMS tot 255 delen, maar sommige mobiele telefoons hebben moeite samenstellend lange berichten met meer dan 10 delen zo, hangt de grens van het nauwkeurige model af. We raden u aan niet meer dan 5 delen per bericht te verzenden.

Vanwege de manier waarop gepersonaliseerde berichten in Adobe Campaign werken, kan de grootte van berichten variëren. Een grote hoeveelheid lange berichten zou de verzendkosten kunnen verhogen.

Transmissiemodus transmission-mode

In dit veld wordt het type SMS aangegeven dat u wilt overbrengen: normale of flash-berichten, die op de mobiele kaart of de simkaart worden opgeslagen.

Deze instelling wordt verzonden in het optionele veld dest_addr_subunit in SUBMIT_SM PDU .

Geldigheidsperiode validity-period

De geldigheidsperiode wordt verzonden in het validity_period veld van SUBMIT_SM PDU . De datum wordt altijd opgemaakt als een absolute UTC-tijdnotatie. Het datumveld eindigt met "00+".

Uitgebreide algemene SMPP-connector acc-extended-connector

Pijlen vertegenwoordigen gegevensstromen.

Wanneer het verzenden van leveringsdelen, paait MTA kinderen MTA. Het aantal MTA kindprocessen is dynamisch en hangt van een configuratie in serverConf.xml af. Elk kind MTA concretiseert de schakelaar CSmppConnectorWorker die met de leverancier SMPP verbindt. De verbindingen worden levend gehouden zolang het kind MTA levend wordt gehouden, ook configureerbaar in serverConf.xml.

Het proces van SMS verwerkt slechts SR, het verbindt met de leverancier en verlaat de verbinding open. Het proces verbindt opnieuw om de 10 minuten om nieuwe montages opnieuw te laden, dit is normale verrichting.

Overeenkomende MT-, SR- en Broadlog-vermeldingen matching-mt

Een tussenliggende tabel nmsProviderMsgId wordt gebruikt om MT- en SR-gegevens tijdelijk op te slaan voordat deze asynchroon worden toegewezen aan de broadlog.

nmsProviderMsgId table heeft 3 groepen kolommen:

Wanneer zowel MT als SR verwerking beëindigde, zou u volledige lijnen, met zowel breedbandinformatie als statusinformatie moeten hebben.

Hier wordt iMsgId gekoppeld aan de nmsBroadLogMsg -tabel om het volledige status-/foutbericht aan te geven.

Het proces van SMS controleert volledige lijnen elke minuut, dan verwerkt hen asynchroon:

Productie en parallelle verbindingen

Elk kind MTA leidt tot een configureerbare hoeveelheid verbindingen, zo beperkend het aantal kind MTA zal het aantal verbindingen beperken. Omdat de correlatie tussen MTA kindprocessen en verkeer gecorreleerd is, kan dit enigszins gecontroleerd maar nog een beetje onvoorspelbaar zijn.

Voordat u live gaat checklist

Deze checklist bevat een lijst met dingen die u moet controleren voordat u live gaat. Een onvolledige opstelling kan tot vele kwesties leiden.

Controleren op conflicten met externe accounts external-account-conflict

Controleer of je geen oude externe SMS-accounts hebt. Als u de testaccount uitschakelt, loopt u het risico dat deze weer wordt ingeschakeld in het productiesysteem en dat er potentiële conflicten ontstaan.

Als u meerdere accounts op dezelfde Adobe Campaign-instantie hebt die verbinding maken met dezelfde provider, neemt u contact op met de provider om ervoor te zorgen dat ze daadwerkelijk een onderscheid maken tussen deze accounts. Voor meerdere accounts met dezelfde aanmelding is een extra configuratie vereist.

Brede SMPP-sporen tijdens controles inschakelen enable-verbose

U zou uitgebreide sporen SMPP tijdens controles altijd moeten toelaten.
Zelfs als u niet de logboeken kunt controleren zelf, zal het voor de Zorg van de Klant van de Adobegemakkelijker zijn om u te helpen.

Je SMS testen test

PDU's controleren check-pdus

Zelfs als de berichten succesvol kijken, is het belangrijk om te controleren dat PDUs behoorlijk geformatteerd is.

Deze stap is nodig wanneer u verbinding maakt met een provider die nog niet eerder verbinding had met Adobe Campaign.

BIND bind

Controleer of BIND_* PDUs correct is verzonden. Het belangrijkste om te controleren is dat de leverancier altijd succesvol BIND_*_RESP PDUs terugkeert (command_status = 0).

Controleer dat er niet teveel BIND_* PDU s zijn. Als er te veel zijn, zou het erop kunnen wijzen dat de verbinding instabiel is. Zie de Kwesties met instabiele verbindingensectie voor meer informatie.

INQUIRE_LINK enquire-link-pdus

Controleer dat ENQUIRE_LINK PDU s regelmatig wordt geruild wanneer de verbinding nutteloos is.

SUBMIT_SM / DELIVER_SM

Verzend een bericht en zoek in de logboeken naar de bijbehorende SUBMIT_SM, SUBMIT_SM_RESP, DELIVER_SM en DELIVER_SM_RESP PDU s.

Met de lus SUBMIT_SM PDU :

Met de lus SUBMIT_SM_RESP PDU :

Met de lus DELIVER_SM PDU :

Met de lus DELIVER_SM_RESP PDU :

Raadpleeg uw provider provider

Zelfs als uw SMS succesvol is, contacteer de leverancier om te zien of is alles in orde.

Brede SMPP-sporen uitschakelen disable-verbose

Zodra alle controles volledig zijn, moet het laatste ding uitgebreide sporen van SMPP onbruikbaar maken om niet teveel logboeken te produceren. U kunt hen voor het oplossen van problemendoeleinden opnieuw toelaten zelfs op productiesystemen.