​

SMS

​

Envíe un SMS

curl -X POST https://api.orbit.devotel.io/api/v1/messages/sms \
  -H "X-API-Key: dv_test_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "from": "+18005551234",
    "body": "¡Hola desde Orbit!"
  }'

import { Devotel } from '@devotel-orbit/node';

const orbit = new Devotel({ apiKey: process.env.ORBIT_API_KEY });

// Canales de solo-cuerpo pasan por el ayudante genérico tipado.
const message = await orbit.messages.send({
  channel: 'sms',
  to: '+14155552671',
  from: '+18005551234',          // remitente explícito — omita para usar el default del inquilino
  body: '¡Hola desde Orbit!',
});

console.log(message.data.id);      // msg_a1b2…
console.log(message.data.status);  // 'queued'

// ¿Sin SDK? fetch simple sirve — la forma de la solicitud se traslada sin cambios.
const res = await fetch('https://api.orbit.devotel.io/api/v1/messages/sms', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    to: '+14155552671',
    from: '+18005551234',
    body: '¡Hola desde Orbit!',
  }),
});
const { data } = await res.json();
console.log(data.id, data.status); // mismo sobre que la respuesta curl abajo

from orbit_sdk import OrbitClient

client = OrbitClient.from_env()  # lee ORBIT_API_KEY

message = client.messages.send_sms(
    to="+14155552671",
    body="¡Hola desde Orbit!",
    from_="+18005551234",  # remitente explícito — omita para usar el default del inquilino
)

print(message["data"]["id"])       # msg_a1b2…
print(message["data"]["status"])   # 'queued'

msg, err := client.Messages().SendSMS(context.Background(), orbit.SendSMSInput{
    To:   "+14155552671",
    Body: "¡Hola desde Orbit!",
    From: "+18005551234",  // remitente explícito — omita para usar el default del inquilino
})
if err != nil {
    panic(err)
}

fmt.Println(msg.Data.ID)      // msg_a1b2…
fmt.Println(msg.Data.Status)  // "queued"

# Una vía de escape HTTP cruda para idiomas sin SDK tipado — cualquier
# cliente o biblioteca funciona siempre que pueda poner encabezado y cuerpo JSON.
send = client.request(
    "POST",
    "/messages/sms",
    json_body: {
        to: "+14155552671",
        from: "+18005551234",
        body: "¡Hola desde Orbit!",
    },
)

puts send.dig("data", "id")       # msg_a1b2…
puts send.dig("data", "status")   # 'queued'

​

Respuesta

{
  "data": {
    "id": "msg_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
    "status": "queued",
    "channel": "sms",
    "segments": 1,
    "encoding": "GSM-7"
  },
  "meta": {
    "request_id": "req_sms_send",
    "timestamp": "2026-03-08T00:00:00Z"
  }
}

• Node.js / fetch (TypeScript) — el SDK o el valor de retorno de res.json() lleva el sobre: message.data.id, message.data.status.
• Python — send_sms devuelve el cuerpo JSON crudo como dict: message["data"]["id"], message["data"]["status"].
• Go — SendSMS desmarca el sobre en un struct tipado: msg.Data.ID, msg.Data.Status.
• Ruby / PHP (vía de escape) — client.request devuelve el cuerpo JSON crudo: send.dig("data", "id") / $send['data']['id'].

​

Patrones comunes

​

Envío idempotente con Idempotency-Key

const message = await orbit.messages.send(
  { channel: 'sms', to: '+14155552671', body: '¡Hola desde Orbit!' },
  { idempotencyKey: 'job-7a3b9d-checkout-reminder' },  // clave estable a través de reintentos
);

message = client.messages.send_sms(
    to="+14155552671",
    body="¡Hola desde Orbit!",
    idempotency_key="job-7a3b9d-checkout-reminder",  # clave estable a través de reintentos
)

​

Paginar GET /messages a través de llamadas de lista SDK

// Bucle de cursor — control explícito.
let cursor: string | undefined;
do {
  const page = await orbit.messages.list({ channel: 'sms', limit: 100, cursor });
  for (const message of page.data) {
    // consumir un mensaje por iteración
  }
  cursor = page.meta.pagination.has_more
    ? page.meta.pagination.cursor
    : undefined;
} while (cursor);

// …o dejéselo el iterador pagine:
for await (const message of orbit.messages.iter({ channel: 'sms' })) {
  console.log(message.id, message.status);
}

# El SDK Python envuelve solo recursos centrales — pagine con la vía de
# escape que acepta un dict `query` junto a `json_body`.
cursor = None
while True:
    query = {"channel": "sms", "limit": 100}
    if cursor:
        query["cursor"] = cursor
    page = client.request("GET", "/messages", query=query)
    for message in page["data"]:
        # consumir un mensaje por iteración
        pass
    pagination = page["meta"]["pagination"]
    if not pagination.get("has_more"):
        break
    cursor = pagination["cursor"]

​

Ejemplo trabajado: envíe, consulte y maneje fallos

​

1. Envíe el mensaje

curl -X POST https://api.orbit.devotel.io/api/v1/messages/sms \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "from": "+18005551234",
    "body": "¡Hola desde Orbit 🚀 — texto normalizado: 160 caracteres aquí serían dos segmentos UCS-2"
  }'

​

2. Lea la respuesta de envío

{
  "data": {
    "id": "msg_e4d5c6b7a8b9c0d1e2f3a4b5c6d7e8f9",
    "status": "queued",
    "channel": "sms",
    "segments": 2,
    "encoding": "UCS-2"
  },
  "meta": {
    "request_id": "req_xK9f3m2h",
    "timestamp": "2026-09-06T12:00:00Z"
  }
}

​

3. Consulte la fila

curl https://api.orbit.devotel.io/api/v1/messages/msg_e4d5c6b7a8b9c0d1e2f3a4b5c6d7e8f9 \
  -H "X-API-Key: dv_live_sk_your_key_here"

{
  "data": {
    "id": "msg_e4d5c6b7a8b9c0d1e2f3a4b5c6d7e8f9",
    "channel": "sms",
    "direction": "outbound",
    "to": "+14155552671",
    "from": "+18005551234",
    "status": "delivered",
    "segments": 2,
    "encoding": "UCS-2",
    "external_id": "dev-smpp-e9a8b7c6",
    "sent_at": "2026-09-06T12:00:01Z",
    "error_code": null,
    "error_message": null,
    "metadata": {}
  },
  "meta": {
    "request_id": "req_poll_002",
    "timestamp": "2026-09-06T12:00:02Z"
  }
}

​

4. Bifurque en fallos

​

Fundamentos de entrega SMS

​

Elija un tipo de remitente

​

Onboarding a través del dashboard

1. Abra Channels → SMS en el dashboard.
2. Haga clic en Attach Sender y elija un tipo de remitente arriba. Orbit valida el formato (número E.164, ID alfanumérico de 3–11, o referencia de grupo) y verifica si el destino que define como default necesita registro.
3. Envíe un mensaje de prueba a un número que posea. El compositor muestra segments y encoding inline, así que ve el costo por segmento estimado antes de enviar.
4. Si su puerta de destino rechaza el adjuntar (US sin campaña 10DLC, un país gated sin aprobación de remitente ID), el asistente lo dirige al flujo de registro — vea las próximas dos secciones.

​

Registro de 10DLC & tipos de campañas (US)

​

Codificación y concatenación

​

GSM-7 vs. UCS-2

• GSM-7 — alfabeto GSM de 7-bit (ASCII más unos pocos extras: @, £, €, algo de griego). Un cuerpo que caba obtiene hasta 160 caracteres por segmento, o 153 caracteres en envío de múltiples partes (7 por segmento van al encabezado UDH de concatenación).
• UCS-2 — cualquier carácter fuera de GSM-7 (emoji, CJK, comillas inteligentes, la mayoría de scripts no-Latin) flipa todo el mensaje a codificación 16-bit. Un cuerpo obtiene hasta 70 caracteres por segmento, o 67 en múltiples partes.

segments = ceil(chars / per_segment_limit)
per_segment_limit = single_limit         si cabe en un segmento
                  = single_limit - header  si no (GSM-7: 153, UCS-2: 67)

​

Ejemplo trabajado

{
  "segments": 2,
  "encoding": "UCS-2"
}

​

Límites de velocidad, volumen y grupos de remitentes

1. Límite de solicitud del lado API. 100 solicitudes/minuto por inquilino por default en POST /messages/sms, keyed por organización. Encima obtiene 429 RATE_LIMITED; vea la Guía de límites de velocidad para encabezados y manejo de reintentos. La tabla completa por canal abajo.
2. Volumen del lado remitente. US 10DLC: un techo de segmento por-día, por-número fijado por su nivel de vetting. En otros lugares: lo que la ruta del destino admite por remitente.

​

Ciclo de vida del estado de mensajes

• submitted_no_receipt — el proveedor aceptó el envío, ninguna DLR volvió dentro de la ventana de 30 minutos SMPP. Etiquetado intermedio (is_terminal: false) porque una delivered tardía o fallo DLR puede todavía aterrizar y sobreescribir. Trátelo como resultado desconocido, no una entrega y no un fallo.
• expired — una DLR llegó después de que se cerró la ventana de llegada tardía. Fila cerrada, resultado no conocible; fan-out en message.failed.
• cancelled — solo alcanzable por usted; ningún webhook nunca dispara por él.

​

Solución de problemas

​

Precios

​

Features

• Mensajes A2P y P2P — soporte aplicación-a-persona y persona-a-persona
• Alcance global — 190+ países a través de la red de agregadores de Devotel
• Informes de entrega — webhooks de estado en tiempo real para cada mensaje
• Mensajes concatenados — SMS multi-parte manejado transparentemente (hasta 10 segmentos)
• Validación E.164 — validación automática del formato del número de teléfono
• Soporte Unicode — codificación GSM-7 y UCS-2 completa con detección automática y normalización de comillas inteligentes
• ID de remitente — IDs de remitente alfanuméricos donde soportan las regulaciones locales, gateados por registro donde se necesita

​

Límites de Velocidad