Mensageria
Envio de SMS
Em breveRequisição e token
messenger/smsEnvie códigos de verificação (OTP) e avisos transacionais por SMS, sem contrato com operadora. Envie um JSON com `to` em formato internacional (`+5511999999999`) e `message`, até 1600 caracteres. A cobrança é **por unidade de mensagem**: 160 caracteres por unidade, ou 70 quando o texto tem acento fora do alfabeto GSM ou emoji, e mensagem com link soma 1 unidade. O bloco `billing` mostra a conta. Mensagem não entregue não é cobrada.
Fonte dos dados: Provedores parceiros · tempo real
Campos da resposta
Status
statusDetalhedetailDestinatário (mascarado)toID da mensagemmessage_idComposição da cobrançabillingCaracteresbilling.charactersAlfabetobilling.encodingCaracteres por unidadebilling.characters_per_unitUnidades do textobilling.segmentsUnidades por linkbilling.link_surcharge_unitsUnidades cobradasbilling.billable_unitsCasos de uso
Código de verificação
Enviar o código de login ou de confirmação de uma operação por SMS.
Aviso transacional
Confirmar pedido, entrega ou cobrança sem manter contrato com operadora.
Exemplo de resposta
SmsSendOutput{
"success": true,
"code": 200,
"code_message": "A requisição foi processada com sucesso.",
"errors": [],
"header": null,
"data_count": 1,
"data": [
{
"status": "success",
"detail": "Mensagem enviada.",
"to": "+55119****4321",
"message_id": "9182736",
"billing": {
"characters": 38,
"encoding": "gsm-7",
"characters_per_unit": 160,
"segments": 1,
"link_surcharge_units": 0,
"billable_units": 1
}
}
]
}- O número do destinatário nunca volta inteiro na resposta.
- `tokens_in` no bloco `header` é o número de unidades de SMS: é por elas que a mensagem é cobrada.