Tudo o que vale a pena saber, nada do que não vale.
O pedido
O gateway da BroadNet aceita um POST para https://api.broadnet.me/sms/sendSms com um token no cabeçalho Authorization: Bearer e um corpo JSON: senderId (o ID do remetente), destinationNumber (o número de destino em formato internacional, somente dígitos, sem o sinal +), message (o texto) e messageType (TEXT para GSM-7, UNICODE para árabe, emojis e outros alfabetos não latinos). Uma chamada bem-sucedida devolve 200 OK com o ID da mensagem no corpo da resposta.
Codificação e comprimento
Uma mensagem GSM-7 comporta 160 caracteres por segmento (153 quando a mensagem ocupa vários segmentos); ao mudar para Unicode por causa de emojis ou alfabetos não latinos, o limite cai para 70 (67 em mensagens concatenadas). Defina messageType como TEXT para GSM-7 simples e UNICODE quando o texto precisar de Unicode ou árabe, para que os caracteres não fiquem corrompidos; POST /sms/identify devolve a codificação e o número de segmentos antes do envio.
Acompanhe a entrega, não presuma nada.
O ID da mensagem devolvida é o identificador dos relatórios de entrega (DLRs). Configure um webhook para receber o status final da operadora — entregue, falha ou expirado — em vez de considerar um código 200 no envio como prova de que o aparelho recebeu a mensagem.
Passando para a produção
Use números E.164 internacionais, registe o seu ID de remetente em cada mercado de destino antes de expandir e envie por rotas diretas da operadora para obter latência consistente. Para alto volume, a mesma conta pode ser acedida via SMPP e REST, permitindo que você comece com HTTP e alterne entre os tipos de vinculação sem precisar realizar um novo processo de integração.