Formatul raportului de livrare SMPP

Rapoartele de livrare SMPP sunt trimise de Serverul SMPP, către clientul SMPP după ce mesajele text au fost livrate cu succes pe dispozitivul mobil. SMS-ul original este trimis de clientul SMPP folosind o cerere smpp submit_sm. Când submit_sm este acceptat de serverul SMPP, acesta returnează un răspuns submit_sm_resp, cu un ID de referință pentru SMS. Raportul de livrare vine la o dată ulterioară. Acesta conține ora livrării și ID-ul de referință SMS care identifică SMS-ul. Documentul de mai jos explică conținutul unui PDU de raport de livrare SMPP și vă oferă un exemplu de raport de livrare.

Un raport de livrare SMPP este primit ca un mesaj text standard. Textul mesajului are un format special, care conține diverse câmpuri despre SMS-ul trimis inițial. Aceste câmpuri pot fi folosite pentru a determina starea livrării SMS-ului.

Raport de livrare primit. +44251234567->+0000000 'Livrat; Către: +44251234567; La: 2022-10-03 12:07:00; 
Ref: 636445148; id:636445148 sub:000 dlvrd:001 data trimiterii:2210031207 data finalizării:2210031207 
stat:DELIVRD err: text:'

Livrare reușită raportată către admin@localhost. ID-ul sarcinii: cdfd66e1-880e-4ead-a559-7ca46d9ec669. 
Livrat; Către: +44251234567; La: 2022-10-03 12:07:00; Ref: 636445148; id:636445148 sub:000 dlvrd:001 
data trimiterii:2210031207 data finalizării:2210031207 stat:DELIVRD err: text:

Pentru a primi un raport de livrare SMPP

1. Conectează clientul SMPP
2. Conectează-te ca transceiver
3. Trimite SMS-ul folosind PDU submit_sm
4. Înregistrează ID-ul SMS din submit_sm_resp
5. Așteaptă ca SMS-ul să ajungă la mobil
6. Primește PDU-ul raportului de livrare SMS
7. Potrivește ID-ul SMS cu mesajul trimis
8. Înregistrează data și ora livrării SMS

SMPP acceptă confirmări de livrare / rapoarte (DLR) pentru mesajele SMS, astfel încât aplicația ta să poată determina rezultatele livrării.

Returnarea unei confirmări de livrare / raport (DLR) depinde de valoarea setată în câmpul registered_delivery al mesajului trimis inițial de la ESME la MC într-o operațiune submit_sm. Acesta poate fi configurat pentru scenarii de nelivrare și doar livrare, care pot duce la situații în care confirmarea nu va fi returnată. Confirmările de livrare sunt returnate în operațiunile deliver_sm și data_sm.

Următoarele câmpuri sunt relevante în operațiunile deliver_sm și data_sm atunci când sunt folosite pentru transmiterea confirmărilor de livrare.

• adresa sursă (adică source_addr_ton, source_addr_npi, source_addr) - Adresa sursă va fi preluată din adresa destinație a mesajului scurt original, care a generat confirmarea de livrare. Confirmarea apare ca și cum ar proveni de la destinatarul mesajului original înregistrat.
• adresa destinație (adică dest_addr_ton, dest_addr_npi, destination_addr) - Adresa destinație va fi preluată din adresa sursă a mesajului scurt original, care a generat confirmarea de livrare. Confirmarea este adresată SME-ului care a trimis inițial mesajul înregistrat.
• esm_class - Bitul 2 din esm_class este setat la 1 pentru a indica că mesajul este o confirmare de livrare MC. Dacă bitul 5 este setat, atunci mesajul este o notificare intermediară.
• message_state TLV - Indică starea finală a mesajului original. Vezi Stările mesajului mai jos.
• network_error_code TLV - Vezi Codurile de eroare mai jos.
• receipted_message_id TLV - ID-ul mesajului care a fost returnat către ESME de către MC în PDU-ul submit_sm_resp.

Acest tip de mesaj este folosit pentru a transporta o confirmare de livrare MC. MC, la detectarea stării finale a unui mesaj înregistrat, ar genera în mod normal o nouă confirmare adresată expeditorului primului mesaj. Confirmarea de livrare MC este apoi livrată către ESME într-o operațiune deliver_sm sau data_sm.

O notificare intermediară este o formă specială de mesaj pe care MC o poate trimite către un ESME pentru livrarea unui mesaj către un mobil. Aceasta oferă o stare intermediară a unei încercări de livrare a mesajului.

Utilizările tipice sunt raportarea rezultatului încercărilor de livrare făcute în timpul duratei de retransmitere a mesajului în cadrul MC. Aceasta poate fi folosită pentru a urmări diversele motive pentru care un mesaj nu este livrat la destinație și pentru a profila disponibilitatea abonatului.

Suportul pentru funcționalitatea de notificare intermediară este specific implementării MC și Furnizorului de Servicii MC și depășește scopul acestei specificații.

Confirmare în câmpul short_message

Mesaj stări

Următoarea este o listă de stări permise pentru un mesaj scurt. MC returnează valoarea message_state către ESME ca parte a PDU-ului query_sm_resp, query_broadcast_sm_resp sau deliver_sm pentru confirmarea de livrare.

Stările intermediare sunt stări care se pot schimba. Stările finale sunt stări care reprezintă o stare de sfârșit de viață pentru un mesaj.

De exemplu, un mesaj în retry poate returna o stare ENROUTE. La un moment dat în viitor, acest mesaj va fie expira, fie va fi livrat. Starea va progresa apoi la EXPIRED sau DELIVERED. Astfel, un mesaj în starea ENROUTE se spune că este într-o stare intermediară.

Un mesaj în starea DELIVERED sau EXPIRED nu poate progresa către o altă stare. Aceste stări sunt, prin urmare, stări finale.

Ce este un raport de livrare?

Când trimiteți un mesaj SMS, confirmarea sosirii acestuia la telefonul destinatarului este crucială. SMS-ul utilizează un sistem de confirmare în două etape pentru a asigura acest lucru.

La trimiterea mesajului către Centrul de Servicii pentru Mesaje Scurt (SMSC) al rețelei mobile, primiți un „raport de trimitere a mesajului”. Acest raport semnifică faptul că SMSC a acceptat mesajul dumneavoastră pentru livrare. De asemenea, include un identificator unic, adesea denumit „referință de mesaj” sau „ID de callback”, care permite urmărirea mesajului în sistemul SMSC.

După acceptare, mesajul este stocat în SMSC până când livrarea devine posibilă. Acest lucru poate fi întârziat dacă telefonul destinatarului este oprit, ceea ce poate prelungi așteptarea până la câteva zile. Odată ce telefonul destinatarului devine disponibil, mesajul este livrat. După livrarea cu succes, un „raport de livrare” este trimis înapoi expeditorului ca un mesaj SMS separat.

Acest SMS de confirmare conține:

• Numărul de telefon al destinatarului: Verifică faptul că mesajul a fost primit de destinatarul intenționat.
• Referința mesajului (ID de callback): Se potrivește cu identificatorul din raportul original de trimitere, oferind o legătură clară între cele două etape.
• Data și ora livrării: Furnizează momentul exact în care mesajul a ajuns la telefonul destinatarului.

Deși mesajele SMS oferă o modalitate convenabilă de comunicare, asigurarea că un mesaj ajunge la destinatarul său prompt este crucială. Aici intervine conceptul de „perioadă de valabilitate”.

Perioada de valabilitate se referă la intervalul de timp în care un mesaj SMS este stocat în Centrul de Servicii pentru Mesaje Scurt (SMSC) atunci când telefonul destinatarului este indisponibil. Dacă mesajul rămâne nelivrat după expirarea acestei perioade, este șters automat din SMSC, prevenind o livrare întârziată.

Beneficiile utilizării perioadei de valabilitate:

• Mesaje sensibile la timp: Imaginați-vă că trimiteți un text despre un eveniment sensibil la timp, cum ar fi un program TV live. Stabilirea unei perioade de valabilitate adecvate asigură că mesajul nu este livrat după încheierea evenimentului, devenind astfel irelevant.
• Eficiența rețelei: Prin prevenirea încercărilor inutile de livrare cătelefoane indisponibile, perioada de valabilitate optimizează resursele rețelei.

More information

• SMPP specification
• SMPP protocol version comparison
• SMPP PDU logging
• How to use SMPP API with programming languages
• Secure SMPP connection over SSL TLS
• SMPP delivery report format
• What is an SMPP simulator
• SMPP error codes
• How to send a test SMPP SMS message
• SMPP PDU decode
• SMPP Character encoding
• SMPP wireshark