Configurações de conta externa SMPP

Configurações de canal de SMPP

Autorizar transliteração de caracteres

A transliteração é o processo de encontrar caracteres equivalentes aos que faltam. Por exemplo, o caractere francês "ê" (e com acento circunflexo) está ausente da codificação GSM, mas pode ser substituído por "e" sem prejudicar muito a leitura.

Quando essa caixa estiver desmarcada, a codificação de texto falhará se não conseguir codificar a string exatamente como está.

Quando essa caixa estiver marcada, a codificação de texto tentará converter a string em uma versão aproximada em vez de falhar. Se alguns caracteres não tiverem equivalente na codificação de destino, a codificação do texto falhará.

Consulte Definir um mapeamento específico das configurações de codificações para obter uma explicação mais geral do processo de codificação.

Número de origem

Define o endereço de origem padrão das mensagens. Essa configuração só será aplicada se o número de origem for deixado vazio no delivery. Por padrão, o campo de número de origem não é transmitido. Portanto, o provedor o substituirá pelo código curto.

Isso habilita o recurso de substituição de endereço/oADC do remetente.

TON/NPI de origem, TON/NPI de destino

TON (Tipo de Número) e NPI (Indicador do Plano de Numeração) (descrito na seção 5.2.5 da especificação SMPP 3.4). Esses valores devem ser definidos para o que for necessário ao provedor.

Eles são transmitidos como estão nos campos source_addr_ton, source_addr_npi, dest_addr_ton e dest_addr_npi do PDU SUBMIT_SM.

Tipo de serviço

Esse campo é transmitido como está no campo service_type da PDU SUBMIT_SM. Defina isso de acordo com o que for necessário ao provedor.

Taxa de transferência e atrasos

Essas configurações controlam todos os aspectos de tempo do canal SMPP. Alguns provedores exigem controle muito preciso da taxa de mensagens, da janela e dos tempos de novas tentativas, portanto, essas configurações devem ser definidas com valores que correspondam à capacidade do provedor e às condições indicadas no contrato.

Janela de envio

A janela é o número de PDUs SUBMIT_SM que podem ser enviados sem esperar por um SUBMIT_SM_RESP correspondente.

Exemplo de uma transmissão com uma janela máxima de 4:

A janela ajuda a aumentar a taxa de transferência quando o link da rede tem uma latência alta. O valor da janela deve ser pelo menos o número de SMS/s multiplicado pela latência do link (em segundos) para que o conector nunca aguarde um SUBMIT_SM_RESP antes de enviar a próxima mensagem.

Se a janela for muito grande, você poderá enviar mais mensagens duplicadas em caso de problemas de conexão (caso raro). Além disso, a maioria dos provedores tem um limite muito restrito para a janela e recusa mensagens que ultrapassam o limite.

Como calcular a fórmula ideal da janela de envio:

Meça a latência máxima entre SUBMIT_SM e SUBMIT_SM_RESP.
Multiplique esse valor (em segundos) para o rendimento máximo do MT: isso fornecerá o valor ideal da janela de envio.
Exemplo: se você tiver 300 SMS/s definidos com rendimento máximo de MT e houver uma latência de 100 ms entre SUBMIT_SM e SUBMIT_SM_RESP em média, o valor ideal será 300×0.1 = 30.

Na dúvida, prefira uma janela maior para evitar problemas de desempenho.

Taxa de transferência máxima de MT

Número máximo de MT por segundo e por conexão. Essa configuração é estritamente imposta. O MTA nunca encaminhará mensagens mais rapidamente do que esse limite. É útil para provedores que exigem limitação precisa.

Para saber o limite de rendimento total, multiplique esse número pelo número total de conexões (consulte a fórmula acima).

0 significa sem limite. O MTA enviará o MT o mais rápido possível.

É recomendável manter essa configuração abaixo de 1000, pois é impossível garantir rendimento preciso acima desse número, a menos que seja feito o benchmark adequado na arquitetura final e especificamente solicitado pelo provedor de SMPP. Talvez seja melhor aumentar o número de conexões para um valor acima de 1000 MT/s.

Tempo antes da reconexão

Quando a conexão TCP for perdida, o conector aguardará esse número de segundos antes de tentar fazer uma conexão.

Período de vigência do MT

Este é o tempo limite entre SUBMIT_SM e o SUBMIT_SM_RESP correspondente. Se o RESP não for recebido a tempo, a mensagem será considerada como tendo sofrido falha, e a política global de novas tentativas do MTA será aplicada.

Tempo limite da associação

Tempo limite entre a tentativa de conexão TCP e a resposta BIND_*_RESP. Quando o tempo limite for atingido, a conexão será fechada pelo conector do Campaign e aguardará pelo tempo antes da reconexão antes de tentar novamente.

período enquire_link

inquire_link é um tipo especial de PDU enviada para manter a conexão ativa. Esse período é em segundos. O conector do Campaign envia somente inquire_link quando a conexão está ociosa, para conservar a largura de banda. Se não for recebido nenhum RESP após o dobro desse período, a conexão será considerada inoperante, e um processo de reconexão será acionado.

Especificidades do SMSC

Ativar message_payload

Quando desmarcada, o SMS longo será dividido pelo MTA e enviado em várias PDUs SUBMIT_SM com UDH. A mensagem será recomposta pelo telefone celular, seguindo os dados UDH.

Quando marcado, o SMS longo será enviado em uma PDU SUBMIT_SM, colocando o texto no campo opcional message_payload (consulte a especificação SMPP para obter detalhes sobre isso).

Se esse recurso estiver habilitado, o Campaign não poderá contar as partes do SMS individualmente: todas as mensagens serão contadas como enviadas em uma parte.

Enviar o número de telefone completo

Quando essa caixa de seleção não está marcada, somente os dígitos do número de telefone são enviados para o provedor (campo destination_addr do campo SUBMIT_SM). Esse é o comportamento padrão porque o indicador de número internacional (geralmente um prefixo +) é substituído pelos campos TON e NPI no SMPP.

Quando a caixa de seleção é marcada, o número de telefone é enviado como está, sem pré-processamento (e espaços em potencial, prefixo + ou sinais de libra/cerquilha/asterisco).

Esse recurso também afeta o comportamento do recurso de quarentena de resposta automática: quando a caixa de seleção não estiver marcada, um prefixo + será adicionado aos números de telefone inseridos na tabela de quarentena para compensar a remoção do prefixo + do número de telefone pelo próprio protocolo SMPP.

Regex de extração da ID no SR

O formato SR não é estritamente aplicado pela especificação do protocolo SMPP. É apenas uma recomendação descrita no apêndice B da especificação. Por causa disso, alguns implementadores de SMPP formatam esse campo de forma diferente, portanto, o Campaign precisa de uma maneira de extrair o campo correto.

Por padrão, captura até 10 caracteres alfanuméricos após "id:".

O regex deve ter exatamente um grupo de captura (uma parte contida entre parênteses). A parte correspondente à ID deve estar entre parênteses. O formato do regex é PCRE.

Ao ajustar essa configuração, inclua o máximo de contexto possível para evitar acionadores falsos. Se houver prefixos específicos (como "id:" no padrão), inclua-os no regex. Também use o máximo possível de delimitadores de palavras (\b) para evitar a captura de texto no meio de uma palavra.

Não incluir contexto suficiente no regex pode gerar uma pequena falha de segurança: o conteúdo real da mensagem pode ser incluído no SR, portanto, se você apenas corresponder a um formato de ID específico sem contexto (por exemplo, um UUID), ele poderá analisar o conteúdo de texto real (por exemplo, um UUID incorporado no campo de texto) em vez da ID.

Regex de extração do status na SR

Este regex captura o status do campo de texto das mensagens SR.

Por padrão, captura entre 5 e 15 caracteres após "stat:".

O regex deve ter exatamente um grupo de captura (uma parte contida entre parênteses). A parte correspondente ao status deve estar entre parênteses. O formato do regex é PCRE.