SMS con número propio y precios por país

Número propio = el SMS sale del número que contrataste en el workspace. El cliente ve tu prefijo o tu número internacional — no un remitente genérico de la plataforma. Pasa el campo from en la API o elige la línea en el panel.

Dos formas de enviar SMS

	Compartido (sin `from`)	Número propio (con `from`)
Remitente	Línea compartida de la plataforma	Tu número contratado
Precio	Fijo por tipo de envío (`full`, `standard`, `slow`)	Por país del destinatario
Campo en API	Omite `from`; usa `options.speed`	`from` obligatorio; `speed` no aplica
Uso típico	OTP masivo, campañas en escala	Marca con prefijo fijo, soporte, 2FA con tu línea

Analogía: compartido es correo con remitente genérico del transportista; número propio es correo con el nombre y dirección de tu empresa en el sobre. El número debe estar ACTIVE, con SMS habilitado, contratado en Números de teléfono.

Enviar con número propio

POST /v1/sms/messages
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

Con E.164:

{
  "from": "+5511987654321",
  "to": ["5511999887766"],
  "type": "text",
  "payload": {
    "message": "Tu pedido #8842 salió para entrega. Seguimiento: https://tienda.com/r/8842"
  }
}

Con ID interno del número (equivalente):

{
  "from": "clxx_phone_1",
  "to": ["5511999887766"],
  "type": "text",
  "payload": {
    "message": "Código de verificación: 739201. No lo compartas."
  }
}

Respuesta (202)

{
  "success": true,
  "data": {
    "status": "QUEUED",
    "count": 1,
    "messageIds": ["clsms_abc..."],
    "smsIds": ["clsms_abc..."]
  }
}

Con from definido, options.speed se ignora. Full, Standard y Slow existen solo en envío compartido — con tu línea, el precio depende del país del destino, no del tipo de envío.

Cómo se calcula el precio

La API identifica el país del número en to.
Consulta la tarifa en smsOwnNumber.rates (GET /v1/pricing).
Debita créditos (plan) o importe pay-as-you-go por SMS enviado.

Ejemplo de fila en la tabla pública:

{
  "country": "BR",
  "countryName": "Brasil",
  "callingCode": "55",
  "credits": 24,
  "paygCents": 3,
  "available": true,
  "unavailableReason": null
}

País sin fila específica → usa smsOwnNumber.fallbackCountry (ej.: ZZ para resto del mundo). Consulta la tabla completa:

curl -s https://api.notifique.dev/v1/pricing | jq '.data.smsOwnNumber.rates[] | select(.country=="BR")'

Detalles: Consulta de precios.

SMS recibido en tu número

Cuando el cliente responde a tu número, el mensaje entra como inbound:

GET /v1/sms/inbound?page=1&limit=20
Authorization: Bearer sk_live_xxxxx

Webhook: sms.received / sms.replied — Eventos de webhook.

Errores comunes

Situación	HTTP	`code`
`from` inválido o no ACTIVE	400	`INVALID_FROM`
Número sin SMS habilitado	400	—
Destino no disponible en la tabla	400	`DESTINATION_NOT_AVAILABLE`
Saldo/créditos insuficiente	402	`INSUFFICIENT_BALANCE`

Próximos pasos

Introducción SMS: compartido vs número propio
Quick Start: primer envío
Números de teléfono: contratar línea con SMS

API E-mail

E-mail

Domínios

E-mails recebidos

SMS con número propio y precios por país

Dos formas de enviar SMS

Enviar con número propio

Cómo se calcula el precio

SMS recibido en tu número

Errores comunes

Próximos pasos

​Dos formas de enviar SMS

​Enviar con número propio

​Cómo se calcula el precio

​SMS recibido en tu número

​Errores comunes

​Próximos pasos

Dos formas de enviar SMS

Enviar con número propio

Cómo se calcula el precio

SMS recibido en tu número

Errores comunes

Próximos pasos