WirelessBR

5 - Definição dos parâmetros SMPP

Esta seção descreve os parâmetros SMPP que podem ser utilizados em um comando SMPP.

5.1 - Parâmetros do cabeçalho SMPP (Command Header)

5.1.1 - Command_length

O parâmetro command_length indica o tamanho total em octetos de uma mensagem SMPP. São considerados o cabeçalho SMPP (incluindo o próprio campo command_length), os parâmetros mandatórios e os parâmetros opcionais.

5.1.2 - Command_id

O campo command_id indica o tipo de mensagem que o PDU SMPP representa, por exemplo, submit_sm, deliver_sm etc.

Um identificador de comando é destinado para cada primitiva de solicitação SMPP.

Um identificador de comando de resposta é destinado para cada primitiva de resposta SMPP.

Verifique na tabela a seguir a faixa de valores reservados.

5.1.2.1 - Conjunto de comandos SMPP

Tabela 20 - Valores para o campo command_id do PDU SMPP

5.1.3 - Command_status

O campo command_staus indica o sucesso ou falha de uma solicitação SMPP. Somente é relevante em mensagens de resposta SMPP. Nas mensagens de solicitação SMPP, deve ser preenchido com o valor valor nulo. O código de erro retornado no comando de resposta SMPP é informando neste campo. O conjunto completo de códigos de erro e seus valores associados estão apresentados na tabela 21.

Tabela 21 -  Códigos de erro do SMPP

5.1.4 - Sequence_number

Um número de sequência permite que um PDU de resposta seja relacionado a um PDU de solicitação. O PDU de resposta SMPP deve preservar este campo. A faixa de valores possíveis deste campo vai de 0x00000001 a 0x7FFFFFFF.

5.2 - Parâmetros mandatórios do SMPP

5.2.1 - System_id

O parãmetro system_id é utilizado para identificar uma ESME ou um SMSC no momento do BIND.

5.2.2 - Password

O parâmetro password é utilizado pelo SMSC para autenticar uma ESME que está solicitanto o BIND. Também é utilizado pela ESME para autenticar um SMSC, no caso da operação de outbind.

5.2.3 - System_type

O parâmetro system_type é utilizado para categorizar o tipo da ESME que está solicitando o BIND ao SMSC. Por exemplo, "VMS", no caso de um Sistema de Voice Mail, ou "OTA", para um sistema de Over-The-Air activation.

A especificação do system_type é opcional. Alguns SMSC podem não solicitar que a ESME informe este detalhe. Neste caso a ESME pode preencher este campo com o valor nulo.

5.2.4 - Interface_version

Este parâmetro é utilizado para indicar a versão do protocolo SMPP utilizado pela entidade. As seguintes versões de interface são definidas:

Tabela 22 -  Valores disponíveis para o campo interface_version

5.2.5 - addr_ton, source_addr_ton, dest_addr_ton, esme_addr_ton

Estes campos definem o tipo de número ou TON (Type Of Number) para ser utilizado nos parâmetros da SME. Os valores possíveis são apresentados na tabela 23.

Tabela 23 -  Valores possíveis para TON (Type Of Number)

5.2.6 - addr_npi, source_addr_npi, dest_addr_npi, esme_addr_npi

Estes campos definem o indicador de plano numérico, ou NPI (Numeric Plan Indicator) que será utilizado nos parâmetros da SME. Os valores possíveis são apresentados na tabela 24.

Tabela 24 - Valores possíveis para NPI (Numeric Plan Indicator)

5.2.7 - Address_range

O parâmetro address_range é utilizado nas operações de bind_receiver e bind_tranceiver para especificar um conjunto de endereços das SME's servidas pelo cliente ESME. Um endereço único pode ser especificado no parâmetro address_range. A notação de expressão regular do UNIX deve ser utilizada para especificar a faixa de endereços.

5.2.8 - Source_addr

Este campo especifica o endereço da SME que originou a mensagem. Uma ESME que é implementada com um único endereço SME, i.e. Voice Mail, pode preencher este campo com o valor nulo, para permitir que o SMSC preencha este campo com o valor padrão.

5.2.9 - Destination_addr

Este campo especifica o endereço da SME de destino da mensagem. Para mensagens terminadas, este endereço especifica o DN do terminal.

5.2.10 - Esme_addr

Especifica o endereço da ESME para onde as mensagens de alert_notification deverão ser enviadas.

5.2.11- Service_type

O parâmetro service_type pode ser usado para indicar o serviço de aplicação SMS associado à mensagem, permitindo à ESME:

-      Disponibilizar serviços avançados de mensagens, tais como aqueles descritos no item 4.4.1.2;

-      Controlar o teleserviço utilizado na interface aérea (i.e. IS-136/TDMA, IS-95/CDMA)

O SMSC pode associar implicitamente a função "replace if present" do service_type indicado em uma submissão de mensagem. Por exemplo, o SMSC pode sempre repor uma mensagem pendente de entrega que tenha o mesmo originador e destinatário da mensagem submetida. Desta forma, um SMSC pode garantir que um sistema de Voice Mail, utilizando o service_type "VMA" tem no máximo uma notificação por destinatário, invocando automaticamente a função "replace if present".

Os tipos genéricos de service_type estão apresentados abaixo:

““ (NULL) Default

“CMT” Cellular Messaging

“CPT” Cellular Paging

“VMN” Voice Mail Notification

“VMA” Voice Mail Alerting

“WAP” Wireless Application Protocol

“USSD” Unstructured Supplementary Services Data

Outros valores podem ser definidos, bastado apenas um acordo mútuo entre os administradores da ESME e do SMSC.