SMPP-instellingen voor externe account smpp-external-account

Adobe Campaign gebruikt het protocol SMPP om SMS naar een dienstverlener te verzenden.

De sms-connector in Adobe Campaign biedt veel mogelijkheden om zijn gedrag aan te passen om compatibel te zijn met de meeste SMPP-aanbieders, die geneigd zijn een beetje van de officiële specificatie af te wijken.

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

Verbindingsinstellingen smpp-connection-settings

{modal="regular"}

Hier zijn de parameters en hun rol nodig om de verbinding te plaatsen:

Op zendontvangerwijze, is dit het totale aantal verbindingen.

In transmitter+receiver wijze, bepaalt dit het aantal paren transmitter+receiver (één paar = één zender + één ontvanger).
Het evenwicht tussen zenders en ontvangers kan niet worden gewijzigd.

SMPP-kanaalinstellingen smpp-channel-settings

{modal="regular"}

Tekentransliteratie autoriseren smpp-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 de leesbaarheid te veel te belemmeren.

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 die ​ voor een meer algemene verklaring van het het coderen proces plaatsen.

Source-nummer

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 afzenderadres/oADC opheffingseigenschap toe.

Source TON/NPI, TON/NPI bestemming

TON (type nummer) en NPI (indicator nummerplan) (beschreven in punt 5.2.5 van de specificatie SMPP 3.4). Deze waarden moeten worden ingesteld op wat de provider nodig heeft.

Zij worden overgebracht as-is in source_addr_ton, source_addr_npi, dest_addr_ton en dest_addr_npi gebieden van SUBMIT_SM PDU.

Servicetype

Dit gebied wordt overgebracht as-is op het service_type gebied van SUBMIT_SM PDU. Stel dit in op wat de provider nodig heeft.

Doorvoer en vertragingen smpp-delays

{modal="regular"}

Deze montages controleren alle timingsaspecten van het kanaal SMPP. Sommige leveranciers vereisen zeer nauwkeurige controle van het berichttarief, venster en retry timings, zodat zouden deze montages aan waarden moeten worden geplaatst die de capaciteit van de leverancier en de voorwaarden aanpassen die in hun contract worden vermeld.

Venster verzenden

Het venster is het aantal PDUs SUBMIT_SM die zonder het wachten op passende SUBMIT_SM_RESP kan worden verzonden.

Voorbeeld van een transmissie met een maximum venster van 4:

{modal="regular"}

Het venster helpt de productie te verhogen wanneer de netwerkverbinding een hoge latentie heeft. De waarde van het venster moet minstens het aantal SMS/s zijn die door de latentie van de verbinding (in seconden) wordt vermenigvuldigd zodat de schakelaar nooit op SUBMIT_SM_RESP wacht alvorens het volgende bericht te verzenden.

Als het venster te groot is, kunt u meer dubbele berichten verzenden in het geval van verbindingsproblemen (zeldzame gevallen). 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:

Meet de maximumlatentie tussen SUBMIT_SM en SUBMIT_SM_RESP.
Vermenigvuldig deze waarde (in seconden) tot de maximale MT-doorvoer: dit zal de optimale verzendende vensterwaarde geven.
Voorbeeld: Als u 300 SMS/s in maximum MT productie en er is 100ms latentie tussen SUBMIT_SM en SUBMIT_SM_RESP gemiddeld geplaatst, zou de optimale waarde 300×0.1 = 30 zijn.

In twijfel, verkies een groter venster om prestatiesproblemen te vermijden.

Maximale MT-doorvoer

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 (zie de bovenstaande formule).

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

Het wordt over het algemeen aanbevolen deze instelling onder de 1000 te houden, aangezien het onmogelijk is een exacte doorvoer boven dit aantal te garanderen, tenzij dit 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

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

Dit is de onderbreking tussen SUBMIT_SM en zijn overeenkomstige SUBMIT_SM_RESP. Als het RESP niet tijdig wordt ontvangen, zal het bericht als ontbroken worden beschouwd en zal het globale hertestbeleid van MTA van toepassing zijn.

Time-out binden

De onderbreking tussen TCP verbindt poging en het BIND_*_RESP antwoord. Wanneer het uit tijden, wordt de verbinding gesloten door de schakelaar van de Campagne en het zal Tijd wachten alvorens opnieuw te verbinden alvorens opnieuw te proberen.

request_link period

inquire_link is een speciaal soort PDU die wordt verzonden om de verbinding levend te houden. Deze periode is in seconden. De campagnector verzendt alleen inquire_link wanneer de verbinding inactief 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.

Toewijzing van coderingen mapping-encodings

Gelieve te zien de ​ de tekstcoderende sectie van SMS ​ voor details over 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. De MTA zal proberen te coderen gebruikend de eerste codering in de lijst; als het ontbreekt, probeert het om de volgende codering op de lijst te gebruiken, etc… Als het bericht niet kan worden gecodeerd, treedt er een fout op. Zodra het coderen wordt gevonden, zal MTA SUBMIT_SM PDU met de gecodeerde tekst en het data_coding gebied tot stand brengen met de waarde die in de lijst wordt gespecificeerd.

De volgorde van items in de tabel is belangrijk: coderingen worden van boven naar beneden geprobeerd . Plaats de goedkoopste of meest aanbevolen codering boven aan de lijst, gevolgd door meer en duurdere (of minder gewenste) coderingen.

UCS-2 zal nooit mislukken omdat het alle karakters kan coderen die in Campagne worden gesteund. Houd er rekening mee 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 om het bericht in GSM te coderen, als het erin slaagt het verzendt het met data_coding die aan 0 wordt geplaatst.

Als het bericht niet in GSM kan worden gecodeerd, zal het in UCS-2 worden gecodeerd en data_coding aan 8 plaatsen.

Specifieke kenmerken van het SMSC smsc-specificities

{modal="regular"}

message_payload activeren

Wanneer ongecontroleerd, lang SMS door MTA zal worden verdeeld en in veelvoudige SUBMIT_SM PDUs 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 SMPP voor details over dit).

Als deze functie is ingeschakeld, kan Campagne de SMS-onderdelen niet afzonderlijk tellen: alle berichten worden als verzonden in één deel geteld .

Het volledige telefoonnummer verzenden

Wanneer dit checkbox niet wordt gecontroleerd, slechts worden de cijfers van het telefoonaantal verzonden naar de leverancier (bestemmings_addr gebied van het SUBMIT_SM gebied). Dit is het standaardgedrag omdat 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, + voorvoegsel of pound/hash/star-tekens).

Deze functie heeft ook een effect op het gedrag van de quarantainefunctie voor automatische antwoorden: wanneer checkbox niet wordt gecontroleerd, zal a + prefix aan telefoonaantallen worden toegevoegd die in de quarantainelijst worden opgenomen om te compenseren + prefix die van het telefoonaantal door het protocol SMPP zelf wordt verwijderd.

Binden TON/NPI

TON (type nummer) en NPI (indicator nummerplan) (beschreven in punt 5.2.5 van de specificatie SMPP 3.4). Deze waarden moeten worden ingesteld op wat de provider nodig heeft.

Zij worden overgebracht zoals-is in addr_ton en addr_npi gebieden van BIND PDU.

Adresbereik

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

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.

Gedetailleerde uitleg: Stel deze instelling in op 2:

Deze functie is bedoeld om SR-buffers op de providerzijde te verwijderen wanneer ongeldige SR-blokgeldige berichten blokkeren die niet kunnen worden verwerkt.

Als u dit veld instelt op 0, wordt het mechanisme uitgeschakeld zodat “Bericht-id ongeldig” altijd wordt geretourneerd, dit is normaal.

Als u dit veld instelt op 1, reageert de connector altijd op OK, zelfs als de id ongeldig is. Dit moet worden ingesteld op 1, dat alleen onder toezicht wordt gebruikt voor het oplossen van problemen en voor de minimale hoeveelheid tijd, bijvoorbeeld om te herstellen van een probleem aan de aanbodzijde.

Extractieregex van de id in de SR

SR-indeling wordt niet strikt afgedwongen door de specificatie van het SMPP-protocol. Dit is slechts een aanbeveling die wordt beschreven in aanhangsel B van de specificatie. Daarom wordt dit veld door sommige SMPP-implementoren anders opgemaakt, zodat Campagne een manier nodig heeft om het juiste veld te extraheren.

Standaard worden maximaal 10 alfanumerieke tekens na “id:” vastgelegd.

De regex moet precies één vastleggroep hebben (een onderdeel dat tussen haakjes staat). Haakjes moeten rondom het onderdeel staan dat overeenkomt met de id. 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 (zoals “id:” in de standaard) zijn, 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 daadwerkelijke inhoud van het bericht kan in SR worden omvat, zodat als u enkel een specifiek formaat identiteitskaart zonder context (b.v. een UUID) aanpast, kan het de daadwerkelijke tekstinhoud (b.v. een UUID ingebed in het tekstgebied) in plaats van identiteitskaart parseren.

Extractieregex van de status in de SR

Deze regex vangt de status van het tekstgebied van SR berichten.

Standaard worden er tussen 5 en 15 tekens vastgelegd na “stat:”.

Regex moet precies één vangstgroep hebben (een deel dat binnen haakjes bevat is). Haakjes moeten rondom het onderdeel staan dat overeenkomt met de status. De regex-indeling is PCRE.

Regex is toegepast om de status geslaagd te bepalen

Deze regex wordt toegepast op het resultaat van de vorige regex (“Uittrekkingsregex van de status”). Als regex aanpast, wordt het bericht beschouwd als succesvol.

Standaard komt deze overeen met alles wat begint met “DELIV”. Deze komt overeen met de standaardwaarde “DELIVRD”.

Regex toegepast om foutstatus te bepalen

Deze regex wordt toegepast op het resultaat van de vorige regex (“Uittrekkingsregex van de status”). Als regex aanpast, wordt het bericht beschouwd als fout.

Standaard komt deze overeen met alle verschillende foutstatussen die in de specificatie worden beschreven.

Extractieregex van de foutcode in de SR

Deze regex vangt de foutencode van het tekstgebied van sr- berichten.

Foutcodes kunnen worden gekwalificeerd in de kwalificatie van het leveringslogboek.

Standaard worden er 3 tekens na “err:” vastgelegd.

ID-indeling in MT-bevestiging

Dit wijst op het formaat van identiteitskaart die op het message_id gebied van SUBMIT_SM_RESP PDU is teruggekeerd.

ID-indeling in de SR

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

SR-id of foutcode in optioneel veld

Als deze optie is ingeschakeld, wordt de inhoud van optionele velden toegevoegd aan de tekst die wordt verwerkt door bovenstaande regexes. De tekst zal het formaat " 0xTAG :VALUE"hebben, 0xTAG die de 4-cijferhexadecimale waarde van de markering in hogere letters is (b.v. 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

SR-id of foutcode in tekstveld

Indien ingeschakeld, wordt de tekst: veld wordt bewaard tijdens de verwerking van de statustekst van de SR. 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 extractieregex van de id in het veld SR niet specifiek genoeg is: de inhoud van het tekstveld kan als een id worden geparseerd en een aanvaller kan deze gebruiken om vervalste id’s te injecteren, wat tot een gedeeltelijke ontkenning van de servicesituatie kan leiden.

Tag voor service-id

Hiermee kunt u een aangepaste TLV toevoegen. Dit gebied plaatst de markering, die als hexadecimale waarde in het formaat 0x1234 wordt overgegaan.

De waarde van het aangepaste TLV moet worden ingesteld in het veld “Service or program ID” in de geavanceerde parameters van de levering. De waarde wordt verzonden als UTF-8-gecodeerde tekst.

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

TLS inschakelen via SMPP

Als deze optie is ingeschakeld, worden alle verbindingen met SMSC gecodeerd met TLS.

Certificaatverificatie

Binnenkomend verkeer incoming-traffic

{modal="regular"}

Optionele SMPP-parameters (TLV) in MO

De campagne staat het ontvangen van 3 extra gebieden in MO (nms :inSms lijst) toe: Gekoppelde SMS, alias en groot account. Met de schakelaar SMPP, kunnen deze gebieden met gegevens worden gevuld die uit om het even welke facultatieve parameter SMPP (TLV), met om het even welk gemeenschappelijk formaat komen.

Voor elk veld kunt u de bijbehorende tag en de indeling ervan instellen. Vraag de dienstverlener SMPP om deze informatie te hebben.

Automatisch antwoord verzonden aan de MO

Met deze functie kunt u snel tekst op MO’s beantwoorden en zwarte lijsten per code verwerken.

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. Dit betekent dat het trefwoordveld geen spaties mag bevatten en slechts één woord mag zijn.

Ook, is het Trefwoord plaatsen een prefix. Als u bijvoorbeeld “AD” opgeeft, komt deze overeen met “AD”, “ADAPT” en “ADOBE”. Als u meerdere trefwoorden met een algemeen voorvoegsel hebt, let dan op de volgorde, worden de trefwoorden van boven naar beneden verwerkt.

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

De Extra actiekolom verstrekt een extra actie om te doen wanneer zowel sleutelwoord als korte codegelijke (lege korte code past alle korte codes aan). Op dit moment kunt u naar quarantaine verzenden of uit quarantaine verwijderen. Als u een aanvullende actie opgeeft maar het antwoordveld leeg laat, wordt de actie uitgevoerd, maar wordt er geen antwoord 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.