Dashboard

// POST a tu Webhook URL (pestaña Credenciales), Content-Type: application/json // Se envía cuando el mensaje llega a un estado final. // Reintentos: 3 intentos, backoff 5s / 10s / 15s. { "message_id": 29581, "campaign_id": 990033, "client_ref": null, "to": "51987654321", "status": "Delivered", "dlr_code": "delivered", "error_code": null, "segments": 1, "operator": "ENTEL", "country": "Peru", "mcc": "716", "mnc": "17", "cost": 0.028, "currency": "PEN", "message": "Hola, tu codigo es 1234", "timestamp": "2026-08-03T22:58:44.120Z" }

message_id el id que recibiste al enviar ese mensaje. Depende de por dónde lo mandaste (ver "Dos orígenes" abajo). campaign_id campaña a la que pertenece. null si el mensaje se envió por API directa, porque ahí no hay campaña. client_ref tu propio identificador, si lo mandaste al enviar. null en mensajes de campaña. to destino, solo dígitos status Delivered | Undeliverable | Expired | Rejected dlr_code delivered | failed | expired | rejected (enum de la plataforma de envío, NO un código DLR de SMPP tipo "DELIVRD") error_code motivo del rechazo, o null. Lista abierta: maneja los que conozcas y tratá el resto como fallo genérico. segments partes reales facturadas operator nombre del operador country país mcc / mnc códigos de red. mnc viene con 2 dígitos ("06", no "6") cost TOTAL cobrado por este mensaje (ya multiplicado por las partes). 0 si no fue facturable, null si no se registró costo currency moneda del cargo message texto REALMENTE enviado, después de las reglas de contenido — puede diferir del que mandaste timestamp ISO-8601, momento del envío del webhook

// Header: X-SMV-Signature: sha256=<hmac> // HMAC-SHA256 del cuerpo CRUDO, con tu Webhook Secret (pestaña Credenciales). // Solo se envía si tenés un Webhook Secret configurado. const express = require('express'); const crypto = require('crypto'); const app = express(); // IMPORTANTE: firmá sobre el cuerpo CRUDO, no sobre JSON.stringify(req.body). // Al re-serializar, el orden de claves o los espacios pueden cambiar y la // firma deja de coincidir. app.use('/webhook', express.raw({ type: 'application/json' })); app.post('/webhook', (req, res) => { const esperado = 'sha256=' + crypto .createHmac('sha256', process.env.SMV_WEBHOOK_SECRET) .update(req.body) .digest('hex'); const recibido = req.headers['x-smv-signature'] || ''; // Comparación en tiempo constante const ok = recibido.length === esperado.length && crypto.timingSafeEqual(Buffer.from(recibido), Buffer.from(esperado)); if (!ok) return res.status(401).send('firma inválida'); const evento = JSON.parse(req.body); // Respondé 200 rápido y procesá aparte: el timeout es de 10s. res.sendStatus(200); });

El webhook tiene SIEMPRE los mismos campos, los mandes como los mandes. Lo único que cambia es qué viene poblado: Mensajes de CAMPAÑA (wizard del Portal o /api/v1/sms/*) message_id id del mensaje en el Portal (el que devuelve /api/v1/sms/send) campaign_id la campaña client_ref null Mensajes por API DIRECTA (POST /api/http-submit) message_id el id que te devolvió el 202 al enviar campaign_id null <- no hay campaña client_ref el que mandaste en el submit, o null El resto de los campos (status, cost, mcc, mnc, operator, segments, message...) viene igual en los dos casos.

• Sin Webhook URL configurada no se envía nada. • Sin Webhook Secret el POST llega SIN el header de firma. • Timeout 10s. Respondé 200 rápido y procesá en segundo plano. • 3 intentos y se descarta: hacé tu receptor idempotente por message_id — un reintento puede repetir un evento ya procesado. • Sin garantía de orden entre mensajes distintos.