Enviar un SMS

Envía un SMS transaccional. Refleja POST /v1/send: clave secreta con el permiso sms:send, y cabecera Idempotency-Key si quieres que un reintento sea seguro.

El remitente no lo eliges tú. Se resuelve a partir del país del destinatario y de los remitentes que tu proyecto tenga registrados, porque lo que es un remitente válido cambia según el país — un ID alfanumérico sirve en España y se rechaza en Estados Unidos.

Se paga por segmentos, no por mensajes. Un mensaje GSM-7 se parte cada 160 caracteres; uno Unicode, cada 70. La respuesta te dice en cuántos se convirtió antes de que se te facturen.

Devuelve 202: aceptado para entrega, no entregado. El estado llega por webhook.

Authorization

ApiKeyAuth

AuthorizationBearer <token>

Autenticación mediante clave de API. Las claves secretas (sk_*) son obligatorias en todos los endpoints excepto /v1/track. Las claves públicas (pk_*) solo funcionan con el endpoint /v1/track para el seguimiento de eventos desde el cliente. El proyecto se deriva automáticamente de la clave.

In: header

Header Parameters

Idempotency-Key?string

Request Body

application/json

to*string

Destino en formato E.164, p. ej. +34600000000.

body*string

Texto del mensaje. Hasta 1600 caracteres; un cuerpo más largo se rechaza, no se recorta.

Length1 <= length <= 1600

contactId?string

Asocia el mensaje a un contacto que ya tienes, en vez de emparejar por número.

Formatuuid

Response Body

`application/json`

curl -X POST "https://api.bitelio.com/v1/sms/send" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+34600000000",
    "body": "string"
  }'

curl -X POST "https://api.bitelio.com/v1/sms/send" \  -H "Content-Type: application/json" \  -d '{    "to": "+34600000000",    "body": "string"  }'

{
  "id": "string",
  "to": "string",
  "from": "string",
  "country": "string",
  "encoding": "GSM7",
  "segments": 0,
  "status": "string"
}

Empty