Doe-het-zelf smpp-server die lange berichten overbrengt. Korte beschrijving van het SMPP-protocol. Gereserveerde foutcodes

Een van de sms-protocollen is smpp. Het beschrijft het proces van interactie tussen de ontvanger van het bericht, dat wil zeggen de smpp-client met de sms-server, met behulp van: speciaal systeem dataoverdracht.

Als u smpp-berichten als basis neemt, kunt u:

• gebruik anders tekstformaten, evenals wap push sms;
• stuur niet alleen korte maar ook lange teksten;
• gedetailleerde rapporten ontvangen over afgeleverde en uitgestelde sms'jes;
• berichten uitwisselen in een tweerichtingsformaat;
• kies de verzendsnelheid.

Dus, smpp-protocol heeft geweldige mogelijkheden, die echter verband houden met enkele gebruiks- en installatiefuncties die we zullen overwegen.

Kenmerken van het werken met smpp

Om met dit protocol te werken, moet u over de juiste software en een server beschikken die met smpp kan communiceren. In dit geval moet de apparatuur permanent verbonden zijn met de gateway van het providerbedrijf. Om smpp-sms snel en zonder vertragingen te verzenden, worden alle klanten van ons bedrijf getest op compatibiliteit met apparatuur. Hiermee kunt u in de beginfase veel technische problemen oplossen.

Bovendien kunnen gebruikers, voordat ze het protocol voor mailing gebruiken, het verzenden van smpp-sms testen om de gewenste bezorgsnelheid te bepalen.

Experts staan ​​altijd klaar om advies te geven over het gebruik, de aansluiting en het testen van de dienst, wat uw taak zal vereenvoudigen.

Verbinding via SMPP-protocol.

• system_id - geregistreerd in de systeemgebruikersnaam van de vorm XXXX.X
• wachtwoord - gebruikerswachtwoord
• Adres -
• Poort - 8056

Ondersteunde SMPP-opdrachten

De server reageert op niet-ondersteunde opdrachten met een GENERIC_NAK-bericht met de foutcode ESME_RINVCMDID.

Parameters voor het verzenden van berichten (SUBMIT_SM) via smpp-protocol

Regels voor het werken met SMPP-verbindingen

Wanneer een verbinding tot stand is gebracht, krijgt de client 10 seconden om de opdracht BIND_TRANSMITTER of BIND_TRANSCEIVER te verzenden. Anders wordt de verbinding verbroken door de server.

De klant is verplicht om alle door de server verzonden pakketten binnen 1 minuut met een bijbehorend resp-pakket te beantwoorden. Anders wordt de verbinding verbroken door de server zonder UNBIND te verzenden.

De bezorgstatus van een bericht ophalen

Er zijn twee opties voor het verkrijgen van de bezorgstatus via het smpp-protocol (actief en passief). De passieve optie heeft de voorkeur.

De passieve optie omvat het instellen van de vlag Registered_delivery van het SUBMIT_SM-pakket.
Nadat het bericht de definitieve status heeft bereikt, stuurt de server een DELIVER_SM-pakket met een Delivery Receipt-bericht. Het berichtformaat van de ontvangstbevestiging staat hieronder.

De actieve optie zorgt voor periodieke polling van de berichtstatus door te verzenden
QUERY_SM.

Indeling ontvangstbewijs

"id: IIIIIIIIII sub: SSS dlvrd: DDD indieningsdatum: JJMMDDuumm datum gereed: JJMMDDuumm
stat: DDDDDDD fout: E Tekst:. ... ... ... ... ... ... ... ."

Gereserveerde smpp-foutcodes

Er is zo'n klasse van diensten op het netwerk,
die gebruikers in staat stellen
bel alle functies door een sms te sturen naar
speciale nummers en antwoorden krijgen ook in
SMSkakh. U kunt zich bijvoorbeeld registreren
e-mailbox waarvoor u kunt installeren
doorsturen inkomende zeep naar je telefoon.
U kunt realtime nieuws ontvangen en
deelnemen aan chatgesprekken. U kunt sms'en
bestel foto's en melodieën voor je
mobieltjes. Eindelijk kan men deelnemen aan
stemmen. Sommige opSoS
ondersteuning van een dergelijke dienst wanneer voor elke
hij betaalt de sms die door de gebruiker is verzonden niet
alleen aan OpSoSu, maar ook aan de eigenaar van de dienst,
betalen voor diensten, meestal,
virtueel. Via de telefoon doen we dat niet
we geven de bijbehorende besteding van geld
dezelfde waarde als bij het gebruik van WebMoney
of bij betalingen via SberBank.
De mogelijkheden van SMS bieden veel mogelijkheden voor
e-zaken. Velen worden aangetrokken door
verleidelijk vooruitzicht om licht te krijgen
geld als je gewoon kijkt
verwerk en tel het geld, maar werk voor
je scripts op de server. Ik stel geen doelen
een gids opstellen voor een nieuw soort 'bedrijf'
voor één persoon. "In dit artikel heb ik
Ik zal alleen zeggen: technische kant Problemen
geautomatiseerde sms-verwerking.

Verschillende benaderingen

Afhankelijk van de taken en op
de beschikbare hoeveelheid geld kan worden geselecteerd
een van de volgende oplossingen:

• U kunt alleen sms'en via formulieren
  op de websites van OpSoS of op sommige
  portalen. Het is gratis. Het is dus mogelijk
  implementeer het verzenden van sms vanuit uw portal,
  maar om te implementeren betaalde dienst, van
  waarvan gebruikers bijzondere betrouwbaarheid verwachten,
  dit is niet ernstig. Er is al veel over geschreven,
  daarom zal ik me niet op hen concentreren,
  vooral omdat ze momenteel allemaal zijn
  beschermd door de Turing-test, dus dit
  de methode is momenteel niet beschikbaar.
• Speciale http-naar-SMS-gateways voor zakelijke toepassingen.
  U betaalt en u krijgt de mogelijkheid door http-verzoeken
  stuur sms van uw scripts naar een willekeurig
  punt van de wereld, evenals het ontvangen van sms,
  naar speciale nummers gestuurd. Dus
  het is heel eenvoudig om een ​​portaal te maken met een sms-formulier of
  melding van nieuwe brieven.
• SMPP maakt niet alleen
  SMS ontvangen en verzenden, maar ook ontvangen
  leveringsmeldingen verzonden
  berichten, evenals annuleren en vervangen
  berichten. U krijgt een nummer toegewezen of
  hele reeks getallen, je krijgt alles
  berichten komen eraan en
  berichten verzenden vanaf een willekeurig nummer.
  Mogelijke melding van ontvangen
  berichten: SMS-centrale maakt verbinding met
  het vooraf gespecificeerde IP en poort en
  stuurt u berichten.

In dit artikel zal ik het het meest over SMPP hebben
geavanceerde manier van werken met sms-gateways.

Met dit protocol kunt u
en sms'en via de zogenaamde sms-centra.
SMS-centra zijn gateways tussen internet
en mobiele netwerken... Om hiermee te werken
protocol zijn er kant-en-klare oplossingen,
bijvoorbeeld Net :: SMPP in Perl. Beschrijving van het protocol en
linkt naar softwareproducten is te vinden
op www.smpp.org.
Laatste versie minuten per keer
een artikel schrijven - 3.4. Je kunt daar ook downloaden
testprogramma voor clientsoftware - SMPP
Client Test Tool (SCTT). Heb geen toegang gekocht tot
echt sms-centrum, het is op de een of andere manier nodig om te testen
uw programma's. Het is alleen onhandig voor die SCTT
geschreven voor Linux, dus je moet
sleutelen aan Virtual PC of direct coderen onder Linux.

Protocolbeschrijving

Verbinding kan worden gestart als:
gebruiker genoemd in de beschrijving
External Short Message Entity (ESME)-protocol en SMS-centrum
(SMS). Merk op dat met het oog op deze mogelijkheid
het zou verkeerd zijn om de sms-centrale te bellen
server, aangezien het kan zijn
de cliënt. De eerste optie wordt gebruikt als
meestal bij het verzenden van berichten, en de tweede
bij ontvangst, hoewel niemand verbiedt
berichten verzenden via een verbinding,
ingesteld door de SMS-centrale en ontvangen via
een door u tot stand gebrachte verbinding. Alles
gegevens in het SMPP-protocol zijn genest in blokken,
genaamd Protocol Data Units (PDU), die:
een header die de blokgrootte specificeert en
operatiecode.

PDU-headerformaat:

DWORD-lengte - de lengte van het hele blok, inclusief
rubriek
DWORD-opdracht
DWORD-status - 0 in verzoeken en foutcode en antwoorden
DWORD SequenceNumber - volgnummer.

Het volgnummer in het antwoord moet
gelijk aan het nummer in de aanvraag.

Alle getallen in SMPP zijn zo gecodeerd dat de hoogste
byte naar links. Om dit te doen, kunt u
functie htonl (). Alle PDU's zijn onderverdeeld in verzoeken en
antwoorden. In aanvraagcodes is de meest significante bit
nul, in antwoorden op één. Voor elk verzoek
er zou een antwoord moeten komen, behalve
meldingen over inkomende berichten. Doei
geen reactie ontvangen, de operatie wordt overwogen
onvoltooid. Als er geen antwoord is
totdat de verbinding wordt verbroken, deelnemer, of het een SMSC is
of ESME, moet het verzoek opnieuw proberen. Protocol
asynchroon, d.w.z. de afzender van het verzoek kan
stuur een ander verzoek zonder te wachten
antwoord, en de antwoorden kunnen in elk volgen
volgorde. Alle bewerkingen ook
zijn onderverdeeld in die kunnen worden gebruikt
ESME's die kunnen worden gebruikt door SMSC en die
die door beide kan worden gebruikt
partijen. De verbinding is mogelijk in
de volgende voorwaarden:

- Geopend (nog niet geauthenticeerd)
- Overdracht
- Ontvangst
- Ontvangst en verzending
- Gesloten

In de "Open" staat, dat wil zeggen, onmiddellijk na
Een TCP-verbinding tot stand brengen ESME wishing
sms verzenden, moet een bind_transmitter-verzoek verzenden.
Voor ontvangst - bind_receiver. Voor beide acties
onmiddellijk - bind_transceiver. Dit verzoek verzendt
login en wachtwoord. Als de verbinding tot stand is gebracht
SMSC, het moet eerst een uitbindverzoek verzenden
en geef daarin de login en het wachtwoord door, want in
deze situatie heeft zijn toegangsrechten al nodig
rekening. Ik zal je bijvoorbeeld laten zien hoe het eruit ziet
opdracht bind_transmitter:

Titel:
DWORD-lengte
DWORD-opdracht = BIND_TRANSMITTER
DWORD-status = 0
DWORD Volgnummer

Gegevens:
Aanmeldingsreeks
String wachtwoord
String Systeemtype (bijv. WWW of Mail)
BYTE Protocolversie = 0x34
BYTE addr_ton (nummertype), 0 = standaard
BYTE addr_npi (Nummerplan), 0 = standaard
Tekenreeks Nummerbereik, lege tekenreeks,
als de provider zelf weet welke nummers we zijn
dienen

Strings - ASCIIZ, d.w.z. Null-terminated.

De meeste parameters voor dit verzoek:
kunnen nullen of lege tekenreeksen zijn. V
het antwoord op een dergelijk verzoek zal worden beantwoord, in
die, naast de titel, de SystemId van het sms-centrum zal zijn,
en het veld Status zal nul zijn als dit is gelukt. Indien
een transmissieverbinding tot stand is gebracht, dan kunnen we
we hebben het recht om submit_sm-verzoeken te verzenden, en als
een verbinding tot stand is gebracht voor ontvangst, dan heb je nodig
wacht op deliver_sm-verzoeken met teksten
ontvangen berichten en deze verwerken.
Na het voltooien van het werk, stuur het bericht ontbinden en
Loskoppelen.

De meeste vragen hebben een heleboel:
parameters, waarover u niet speciaal kunt
stoom en vernietig ze. Dus ondanks
een indrukwekkende hoeveelheid documentatie,
een eenvoudig sms-antwoordapparaat op basis van
die je kunt bouwen
help systeem, ik heb het
met een volume van slechts 25 kB tekst in C++, en een test voor
SCTT toonde aan dat alles werkt, en het blijft
koop gewoon toegang tot SMSC :).

Met wie moet ik verbinding maken?

SMPP-berichten voor vriendelijke
klanten worden door veel OpSoS geaccepteerd, zodat:
geen specifieke links. Zoek informatie op
de site van de OpSoS waaraan u de voorkeur geeft
werk. Daarnaast een eigen sms-centrum,
draait op het SMPP-protocol, biedt:

SMPP- een algemeen type protocol dat wordt gebruikt voor het ontvangen en verzenden van sms-berichten en USSD-verzoeken. Zijn eigenaardigheid is de constante verbinding, die een zeer belangrijk voordeel- de verbinding is niet verbroken en er wordt een sms verzonden vanaf hoge snelheid(tot meerdere malen hoger dan bij andere methoden).

Dus bij gebruik van het smpp-protocol krijgt u de volgende functies:

1.beschikbaar verschillende formaten, inclusief wap push-sms;

2. berichten die via smpp worden verzonden, kunnen niet alleen in kort formaat zijn;

4. tweerichtings-sms-kanaal;

5. snelheidsregeling.

Zoals je kunt zien, geeft het smpp-protocol je veel gebruiksvrijheid, maar zoals elke tool heeft het zijn eigen unieke kenmerken gerelateerd aan de setting en direct werken. We zullen hier hieronder over praten.

Kenmerken van het werken met het protocol

Voor het functioneren van smpp is een server nodig die is aangepast om mee te werken dit protocol, en speciaal software(klant). Daarnaast is een constante stabiele verbinding met de gateway van de provider vereist. Daarom testen we zonder mankeren de apparatuur die onze klanten hebben - de server moet compatibel zijn met hoge snelheid door het verzenden van sms... Zo vereenvoudigen we de levering van kwaliteitsdiensten vanaf het begin.

Api is geschikt voor sites die in elke taal zijn geschreven, inclusief php.

Klanten kunnen zelf de werking van het geconfigureerde smpp-kanaal testen, hiervoor zijn alle mogelijkheden al voorzien nog voor het gebruik van de diensten. Hierdoor kunt u begrijpen hoe snel uw berichten die via het smpp-protocol worden verzonden, bij de ontvangers worden afgeleverd.

De servicemedewerkers helpen u graag alle fijne kneepjes van het werken met het smpp-protocol te begrijpen, php in uw site te integreren, te helpen bij het verbinden en testen van alle services en eventuele vragen te beantwoorden.

Verbindingsparameters:

• system_id - geregistreerd in de systeemgebruikersnaam van de vorm XXXX.X
• wachtwoord - gebruikerswachtwoord
• Adres -
• Poort - 8056

Ondersteunde opdrachten

Als u een onjuist commando invoert, ontvangt u een reactie zoals GENERIC_NAK, waarvan de tekst de foutcode ESME_RINVCMDID zal bevatten.

SMS-verzendparameters (SUBMIT_SM)

Verbindingsregels

De client heeft 10 seconden om een ​​verbinding tot stand te brengen via de smpp-gateway, waarbij een van de volgende opdrachten moet worden verzonden: BIND_TRANSCEIVER, BIND_TRANSMITTER. V anders de verbinding wordt verbroken.

Er zal ook een pauze optreden als de client niet binnen een minuut reageert op een pakket dat door de server is verzonden. vastgestelde regels met de resp. Bij zo'n pauze wordt UNBIND niet verzonden.

Per keer toegestaan smpp-verbinding alleen van een enkele gebruikersnaam. Alle andere verbindingen ontvangen fout 0x00000005 ESME Al in gebonden staat. Als u echter meer dan één verbinding binnen uw account moet maken, kunt u voor elk van deze verbindingen uw eigen gebruiker maken.

In het geval van het verzenden van Submit_sm, gemarkeerd met de vlag Registered_delivery, is het verzenden van de SMS-status alleen mogelijk naar de gebruiker die het bericht heeft verzonden.

Status van sms-bezorging

Bij gebruik van dit protocol kan de bezorgstatus passief (bij voorkeur) of actief zijn.

Om een ​​passief rapport te ontvangen, moet het SUBMIT_SM-pakket worden verzonden met de vlag Registered_delivery vooraf ingeschakeld.

De tekst van de afleveringsbon in het DELIVER_SM-pakket komt van de server wanneer de sms doorgaat naar de laatste afleveringsfase.

Bij een actief rapport wordt de SMS-status regelmatig gecontroleerd door het versturen van QUERY_SM.

Indeling ontvangstbewijs

"id: IIIIIIIIII sub: SSS dlvrd: DDD indieningsdatum: JJMMDDuumm datum gereed: JJMMDDuumm
stat: DDDDDDD fout: E Tekst:. ... ... ... ... ... ... ... ."

Gereserveerde foutcodes

Het acroniem SMPP staat voor Short message peer-to-peer protocol, het protocol wordt gebruikt om SMS, USSD en andere soorten berichten over te dragen, meestal in VAS-systemen. Aan het einde van het artikel staat een lijst met termen die in de tekst worden gebruikt.

SMPP is ontwikkeld door Aldiscon uit Ierland, dat later is gekocht door Logica. In 1999 kwam SMPP onder de controle van het SMPP Developers Forum, dat later werd omgedoopt tot SMSForum. Het protocol is gebaseerd op de uitwisseling van PDU's (Protocol Data Units) die worden verzonden op de netwerkmodel 4 OSI. Pakketten kunnen zowel synchroon worden uitgewisseld (nadat een verzoek is verzonden, wordt verdere pakketuitwisseling opgeschort totdat een antwoord is ontvangen), of asynchroon (verzoeken worden zonder vertraging verzonden, reacties worden verwerkt zodra ze binnenkomen). Tot voor kort was de laatst gepubliceerde specificatie SMPP 3.4 en de SMPP 5.0-specificatie lange tijd was eigendom van Logica maar is nu ook beschikbaar. Meestal wordt dit protocol gebruikt in de modus permanente verbinding, waarmee u de transmissiesnelheid aanzienlijk kunt verhogen, omdat u hoeft niet elke keer een verbinding tot stand te brengen. Een verbinding kan worden gestart door een gebruiker met de naam External Short Message Entity (ESME) in de protocolbeschrijving of door een SMS-centrum (SMSC).

Er zijn verschillende verbindingsmodi:

"Zender"-modus - een modus alleen voor het verzenden van berichten naar SMSC en het ontvangen van de juiste antwoorden, zonder inkomende berichten te ontvangen (DELIVER_SM-pakketten);

"Ontvanger"-modus - in deze modus is het tegenovergestelde waar, alleen inkomende berichten ontvangen en de bijbehorende antwoorden van de SMPP-client terugsturen naar de SMSC, er worden geen korte berichten verzonden via deze modus (SUBMIT _SM-pakketten);

modus " Transceiver "- de modus voor het verzenden en ontvangen van berichten, het proces kan synchroon en asynchroon worden uitgevoerd.

Alle gegevens in het SMPP-protocol, zoals eerder vermeld, zijn genest in blokken die Protocol Data Units worden genoemd, die bestaan ​​uit een header en een body.

De header van de pakket-PDU bevat de volgende velden:

command_length - geeft aan totaal aantal octetten in dit pakket, inclusief het lengteveld.

opdracht _ id - opdracht-ID (bijvoorbeeld indienen _ sm,vraag _ sm, enz.). EN de antwoordopdracht-identifier is identiek aan de corresponderende verzoekopdracht-identifier, maar met bits ingesteld op 31.

command_ status - geeft het succes of de mislukking van het verzoek aan. Dit veld heeft alleen betekenis in het antwoordbericht en moet worden ingesteld op NULL in de aanvraagberichten.

reeks _ nummer - hierin het veld bevat een volgnummer waarmee verzoeken en antwoorden kunnen worden gekoppeld voor correlatiedoeleinden. Door het gebruik van volgnummers kunnen SMPP-pakketten asynchroon worden uitgewisseld.

De PDU-body is optioneel en wordt mogelijk niet in elk PDU-pakket meegeleverd. De opbouw van de carrosserie wordt afzonderlijk beschreven in de protocolspecificatie, afhankelijk van het PDU-type.

Ook in het PDU-pakket kunnen er optionele parameters zijn met: algemeen formaat TLV (Tag, Length, Value) Deze parameters bieden een mechanisme voor de toekomstige introductie van nieuwe parameters, zoals en wanneer gedefinieerd in toekomstige releases SMPP-protocol... Optionele parameters zijn velden die willekeurig in het SMPP-bericht kunnen worden opgenomen, ze kunnen in elk willekeurig handige bestelling binnen het gedeelte "Optionele parameters" van de verzonden PDU en hoeven niet te worden gecodeerd in de volgorde die wordt weergegeven in de protocolspecificatie.

Tag - de identifier van deze specifieke optionele parameter;

Lengte - geeft de lengte van het veld Waarde in octetten aan (deze lengte omvat niet de lengte van de velden Tag en Lengte). Het optionele parameterveld Lengte is altijd 2 octetten lang;

Waarde - Dit veld bevat de feitelijke gegevens voor deze optionele parameter.

Scopes van korte berichten in moderne wereld groot, SMPP is ideaal voor snelle overdracht een groot aantal berichten, bijvoorbeeld voor bedrijven die grote basis klanten of om in realtime te stemmen via sms, waar er grote stroom inkomende en uitgaande gegevens.

Meer gedetailleerde beschrijving protocol vindt u hier in de specificatie in het Russisch: SMPP_v3.4_rus.pdf

Basisconcepten en afkortingen

SM (Short Message) - kort bericht;

SMS (Short Message Service) - korte berichtendienst, voert de overdracht van SM uit tussen clients van mobiele netwerken, evenals externe clienttoepassingen;

USSD (Unstructured Supplementary Service Data) is een standaardservice in GSM-netwerken het mogelijk maken om interactieve interactie tussen de netwerkabonnee en de servicetoepassing te organiseren in de modus van het overdragen van korte berichten;

MMS (Multimedia Messaging Service) is een systeem voor het verzenden van multimediaberichten (afbeeldingen, melodieën, video's) via mobiele netwerken.

SMSC (Short Message Service Center) - Short Message Service Center - de basis voor het functioneren van SMS;

VAS (Value Added Services) - diensten die extra inkomsten;

ESME (Externe Short Message Entiteit) - Extern client applicatie die het SMPP-protocol implementeert, ontvangt of verzendt korte berichten;

HLR (Thuislocatieregister) - Permanente database van abonnees die zijn aangesloten op mobiele netwerk... HLR biedt SMS-transmissieroute naar SM-bestemming;

Het octet is 8 bits. In het Russisch wordt een octet meestal een byte genoemd.