Conexão SMPP¶
Parâmetros¶
| Parâmetro | Valor |
|---|---|
| Host | o domínio que você recebeu do seu provedor |
| Porta | 2775 |
| Versão | SMPP 3.4 |
| Tipos de bind | transceiver (recomendado), transmitter, receiver |
system_id / password |
os da sua credencial SMPP, no portal |
system_type |
vazio |
Liberação de IP
A porta só aceita conexões dos IPs cadastrados na sua credencial. Informe ao seu provedor os IPs de saída do seu servidor antes do primeiro bind; a liberação leva até um minuto.
O número máximo de binds simultâneos e o limite de mensagens por segundo são definidos na sua credencial. Envie enquire_link a cada 30 segundos para manter a conexão.
Envio (submit_sm)¶
| Campo | Como preencher |
|---|---|
source_addr |
Remetente: até 11 letras e números, ou um número. A plataforma ajusta source_addr_ton e source_addr_npi pelo formato. |
destination_addr |
Formato internacional, só dígitos: 5511988887777 |
data_coding |
0 para GSM7, 8 para UCS2 |
registered_delivery |
1 para receber o recibo de entrega |
short_message |
Até 140 bytes por parte |
Mensagens longas podem ser enviadas em partes com UDH de concatenação. Cada parte é cobrada.
A resposta submit_sm_resp traz o message_id. Ele é o mesmo identificador que aparece no recibo de entrega e no portal.
Recibo de entrega¶
Com registered_delivery=1, o recibo chega como deliver_sm na mesma conexão (transceiver ou receiver), com esm_class indicando recibo e o texto no formato padrão:
id:<message_id> sub:001 dlvrd:001 submit date:2610061105 done date:2610061105 stat:DELIVRD err:000 text:
stat |
Significado |
|---|---|
DELIVRD |
Entregue no aparelho |
UNDELIV |
Não entregue |
EXPIRED |
Validade expirou sem entrega |
REJECTD |
Recusada pela operadora |
Responda todo deliver_sm com deliver_sm_resp; sem a resposta, a plataforma reenvia.
Respostas (MO)¶
Quando um aparelho responde a um remetente numérico seu, a resposta chega como deliver_sm comum (sem a marca de recibo) na conexão transceiver ou receiver.
Códigos de erro¶
| Código | Nome | Significado |
|---|---|---|
0x00000045 |
ESME_RSUBMITFAIL |
Mensagem recusada pela plataforma, por exemplo por conteúdo bloqueado |
0x00000058 |
ESME_RTHROTTLED |
Acima do limite de mensagens por segundo; reduza o ritmo e reenvie |
0x0000000D |
ESME_RBINDFAIL |
Bind recusado: usuário ou senha inválidos, ou limite de binds atingido |
Se a conexão TCP nem abre (tempo esgotado), o IP de origem ainda não foi liberado.