Overview
O envio de SMS para o Egito geralmente falha por três motivos: um ID de remetente não registado, formatação incorreta do número ou texto em árabe enviado com a codificação errada. A NTRA, órgão regulador do Egito, exige que os IDs de remetente A2P sejam pré-registados por meio de uma rota local licenciada — remetentes não registados são bloqueados ou têm os seus IDs de remetente sobrescritos. Registe o ID de remetente, envie os números como 20XXXXXXXXXX sem o sinal de + ou 00 e use type=4 para árabe.
ID do remetente não registado (causa mais comum)
O Egito só entrega tráfego A2P em rotas licenciadas e aprovadas pela NTRA, e cada ID de remetente alfanumérico deve ser pré-registado. Enviar com um ID de remetente não registado fará com que o gateway devolva HTTP 06 (ID de Remetente Inválido), ou a mensagem será aceita, mas bloqueada/sobrescrita em destinos posteriores, de modo que nunca chegará com a sua marca. Registe o ID de remetente com a BroadNet antes de enviar e passe-o no parâmetro `sid` exatamente como foi aprovado. Os nomes de parâmetros (sid, mno, type) e os códigos de erro HTTPxx desta página são os da API HTTP legada (/websmpp); na API REST com token Bearer (POST /sms/sendSms), os equivalentes são senderId, destinationNumber e messageType (UNICODE para árabe).
- O serviço de transporte aéreo A2P egípcio opera apenas em rotas licenciadas pela NTRA.
- ID do remetente não registado → HTTP06 ou um bloqueio silencioso subsequente.
- Primeiro, registe o ID do remetente; em seguida, defina o valor de `sid` para o valor aprovado.
- Verifique o código devolvido — HTTP06 aponta diretamente para o ID do remetente.
Formato de número incorreto
Os números de destino no MNO devem estar no formato internacional completo, apenas com dígitos: código do país 20 para o Egito, seguido do número nacional, sem o sinal de +, 00 ou 0 à esquerda na parte nacional. Um número malformado ou não encaminhável será rejeitado com o código HTTP 09 (Endereço de Destino Inválido). Normalize o endereço antes de enviar.
- Formato: 20 + número nacional, somente dígitos (ex.: 201001234567).
- Liste +, 00, espaços e o líder nacional 0.
- Números malformados devolvem HTTP09 (Endereço de destino inválido).
- O método GET aceita até 100 destinatários, e o método POST, até 10.000.
Árabe enviado com codificação incorreta
O texto em árabe deve ser enviado com o tipo correto. Use type=4 para árabe (até 70 caracteres por segmento) ou type=2 para Unicode/UCS-2 geral; enviar árabe com type=1 (inglês GSM-7) corrompe o texto, transformando-o em pontos de interrogação ou caracteres ilegíveis. Envie o corpo do texto codificado em UTF-8 e URL, e lembre-se de que os segmentos UCS-2/árabe têm 70 caracteres, portanto, mensagens mais longas são divididas em mais partes (cobráveis).
- Árabe: tipo=4 (70 caracteres/segmento); Unicode geral: tipo=2.
- type=1 (GSM-7) irá corromper o texto árabe.
- Enviar em UTF-8 e codificado em URL.
- Segmentos de 70 caracteres — mensagens longas em árabe custam mais peças.
Confirme com o relatório de entrega.
Uma mensagem aceita no envio ainda pode falhar na rede. Configure o seu webhook DLR (ou, na API HTTP legada, consulte o status em /websmpp/websmsstatus) e leia o Status: DELIVRD significa que a mensagem chegou ao dispositivo, UNDELIV significa que não chegou. Compare os relatórios por MessageId ou BatchId e verifique o HTTP18 (créditos insuficientes) se um lote inteiro travar.
- Aceito ≠ entregue — verifique sempre o DLR.
- Status ENTREGUE vs NÃO ENTREGUE; correspondência por MessageId / BatchId.
- Consulte o status a pedido (API HTTP legada: /websmpp/websmsstatus).
- Um lote travado pode ser devolvido pelo código HTTP18 — créditos insuficientes.