API de Mensajería
POSThttps://api.getincloud.online/raven/v3/messages/batch

Envío de campaña SMS masivo (batch)

Permite enviar un mismo mensaje SMS a varios destinatarios en una sola petición.

API de Mensajería
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.

Envía una campaña de SMS masivo a una lista de destinatarios.

Endpoint

POST https://api.getincloud.online/raven/v3/messages/batch

Encabezados

EncabezadoValor
AuthorizationBearer API KEY de la cuenta
Content-Typeapplication/json
Acceptapplication/json

Parámetros del cuerpo

CampoTipoObligatorioDescripción
fromstringSíRemitente del mensaje. En el ejemplo: 87070.
textstringSíTexto del mensaje.
toarray de objetosSíLista de destinatarios. Cada objeto contiene to (número en formato internacional) y clientId.
typestringSíTipo de mensaje. En el ejemplo: MT.
requestDRbooleanNoEn el ejemplo se envía true.
externalIdstringNoIdentificador externo de la campaña.
callbacksarray de stringsNoURLs de callback.

Ejemplo de petición

{
 "from": "87070",
 "text": "Test envio SMS via API Batch 13-04-2026",
 "to": [
  {"to": "+573001234567","clientId":"+573001234567"},
  {"to": "+573001234567","clientId":"+573001234567"}
 ],
 "type": "MT",
 "requestDR": true,
 "externalId": "sms-bach-13-04-2026-890024-getincloud",
 "callbacks":["https://tu-servidor.com/api/webhook/sms"]
}

Límites

La plataforma cuenta con una tasa de envío de 100 TPS para el canal de SMS.

AnteriorEnvío de SMS OTP / transaccionalSiguienteEnvío de flujo estático
¿Te sirvió esta página?