Enviar uma mensagem

O endpoint que põe um SMS na fila de um dos teus telemóveis.

POSThttps://api.droidsender.com/api/v1/sms/send

A mensagem entra na fila do dispositivo e sai por ordem de chegada. A resposta é imediata e não espera pelo envio: o que ela confirma é que a mensagem foi aceite, não que chegou ao destinatário.

Corpo do pedido

Campo	Tipo	Obrigatório	Descrição
`to`	string	sim	Número em formato E.164, com indicativo de país
`message`	string	sim	Texto da mensagem, até 1530 caracteres (10 segmentos)
`deviceId`	string	não	Telemóvel a usar. Sem ele, escolhemos o que tiver menos fila
`reference`	string	não	O teu identificador, devolvido nos webhooks desta mensagem

Pedido

bash

curl -X POST https://api.droidsender.com/api/v1/sms/send \
  -H "Content-Type: application/json" \
  -H "X-API-Key: DS-live-a-tua-chave" \
  -d '{
    "to": "+351912345678",
    "message": "Confirmamos a sua consulta de dia 10/08 as 11h15.",
    "deviceId": "dev_oppo_cph2577",
    "reference": "consulta_8841"
  }'

Resposta

json

{
  "id": "msg_01H8X2",
  "status": "queued",
  "to": "+351912345678",
  "deviceId": "dev_oppo_cph2577",
  "reference": "consulta_8841",
  "segments": 1,
  "encoding": "GSM-7",
  "createdAt": "2026-08-16T14:22:05Z"
}

Um SMS pode custar mais do que um SMS

Acima de 160 caracteres a mensagem parte-se em segmentos e cada um conta como um envio. E um único ã, õ ou ç força a codificação UCS-2, que baixa o limite de 160 para 70. O campo segments da resposta diz quantos foram mesmo.