Saltar al contenido principal
Documentación

Manual de usuario de SMSverifica

La plataforma entera, pantalla a pantalla: enviar un SMS, montar una campaña, importar contactos, verificar con OTP, certificar un mensaje, integrar la API y gestionar tu remitente ante la CNMC. El mismo manual que encontrarás dentro de tu panel, donde además está en seis idiomas.

Plataforma de mensajería SMS, WhatsApp y Telegram para empresas — envío masivo, verificación OTP, mensajería certificada con valor probatorio y API REST, con saldo prepagado en euros que no caduca.

1. Qué es SMSverifica y qué necesitas para empezar

SMSverifica es la plataforma de mensajería de ABARCANDO, S.L., operador inscrito en el Registro de Operadores de la CNMC y proveedor registrado en origen (PRO) en el Registro de Alias. Desde un mismo panel —y una misma API— envías:

  • SMS a más de 200 destinos, con remitente de tu marca en España.
  • WhatsApp por la API oficial de WhatsApp Business (Meta).
  • Telegram mediante tu propio bot.
  • Mensajes certificados con expediente de evidencias y sello de tiempo cualificado, cuando necesitas poder demostrar qué enviaste y qué pasó.

Para empezar solo necesitas una cuenta de correo de empresa y un móvil. El saldo es prepagado, en euros y sin caducidad: cada mensaje tiene un precio fijo según país y canal, se recargue lo que se recargue.

¿Tienes mucho volumen mensual de envíos a un país concreto? Siempre estamos abiertos a negociar, para igualarte o mejorar tu tarifa actual para muy alto volumen en ese país.

Los dos estados de tu cuenta

  1. Modo prueba (sandbox) — al verificar tu correo entras directamente. Todo funciona (panel, API, campañas) pero ningún mensaje sale de verdad y no se gasta un euro: los envíos se simulan y quedan marcados como «Simulado». Es el entorno para integrarte y probar sin riesgo.
  2. Cuenta aprobada: envío real — una persona de la plataforma revisa tu alta y la aprueba. Desde ese momento tus mensajes salen por las redes reales y se cobran de tu saldo, y se abre la parte de dinero: recargar saldo, medios de pago y facturas. Si prefieres seguir probando un tiempo con la cuenta ya aprobada, pídenoslo y la mantenemos en modo prueba.

Mientras estás en modo prueba lo ves siempre indicado con un aviso permanente en el panel; en la API, cada respuesta lleva la cabecera X-Sandbox: true.

Los mensajes de prueba caducan y tienen tope. Tu historial de pruebas se borra a los 30 días —no son envíos reales y no hay nada que conservar— y una cuenta en modo prueba puede simular hasta 10.000 mensajes en total (además de los 200 al día). Cuando se agota, no hay que esperar a mañana: pide la aprobación de tu cuenta y desaparecen todos los topes. El panel y la API te dicen cuántos te quedan antes de llegar al final.


2. El panel de control

Panel de control

Al entrar ves de un vistazo lo que importa:

  • Saldo actual en euros (arriba a la derecha lo tienes siempre visible).
  • Consumo del mes y mensajes de hoy.
  • Tasa de entrega de los últimos 30 días — el porcentaje de mensajes con acuse de entrega confirmado.
  • La gráfica de consumo de 14 días y los últimos movimientos de saldo.

Los dos botones de arriba —Enviar mensaje y Recargar saldo— son las dos acciones que más vas a usar.


3. Remitentes: la marca con la que llegan tus SMS

Remitentes

En España, el nombre que aparece como remitente de un SMS (el alias, por ejemplo MICLINICA) está regulado: desde el 15 de septiembre de 2026, los SMS a España con remitente de marca no inscrito en el Registro de Alias de la CNMC se bloquean en origen. Esta pantalla existe para que eso no te pille.

Solicitar un remitente de marca

  1. Completa antes tus datos de facturación (NIF/CIF): un alias queda inscrito en la CNMC a nombre de un titular, y ese titular eres tú. El NIF tiene que ser correcto: es el que la CNMC comprueba.
  2. En Solicitar un remitente nuevo, escribe tu marca (hasta 11 caracteres, letras y números) y su justificación (tu razón social, tu marca registrada, tu dominio…).
  3. Una persona de la plataforma revisa cada solicitud —formato, vínculo con tu marca y titularidad— y la deja preparada en tu cuenta.
  4. La inscripción en la CNMC la presentas tú, con el certificado digital de tu empresa, en el formulario 213: eliges «Inscripción de alias» (tipo SMS/MMS) y nos declaras como proveedor de origen (ABARCANDO, S.L., NIF B88017173). No lo presentamos nosotros porque la sede exige el certificado de representación de tu empresa y los datos personales de quien firma, que no tenemos ni debemos pedirte. Lo que sí hacemos es acompañarte por teléfono mientras lo rellenas.
  5. La CNMC resuelve. Está tardando semanas y el plazo cuenta desde que la presentas, así que conviene no dejarlo pasar.
  6. Al resolverse, el remitente queda habilitado automáticamente en tu cuenta: lo comprobamos a diario contra la descarga oficial del Registro.

Si tu alias ya está inscrito con otro operador

Es el caso de quien viene de otra plataforma. La buena noticia es doble: no hay que dar de baja a nadie y no tienes que dejar de enviar mientras tanto.

Un mismo alias admite varios proveedores a la vez, y cada uno tiene su propia inscripción —su propio asiento—: el proveedor que ya tengas se queda exactamente como está, y sigues enviando con él hasta que lo nuestro esté activo. Nuestro propio remitente, sin ir más lejos, tiene hoy tres proveedores dados de alta a la vez.

El trámite lo presentas tú, y no por darte trabajo: la sede electrónica exige el certificado de representación de tu empresa y los datos personales de quien firma. Nosotros no los tenemos ni debemos pedírtelos — el trámite lo firma siempre el titular de la marca. Lo que sí hacemos es acompañarte mientras lo haces: llámanos y lo rellenamos juntos por teléfono en diez minutos.

Paso a paso:

  1. Entra con tu certificado de representación en https://tramites.cnmc.gob.es/formulario/213
  2. Elige el tipo de solicitud «Inscripción de alias».
  3. Rellena:
    • Alias: tu remitente, tal y como lo usas hoy.
    • Titular: tu empresa, con su CIF.
    • Proveedor: ABARCANDO, S.L. — N.I.F. B88017173.
    • Vínculo legítimo: tu razón social, tu marca registrada o tu dominio, lo que corresponda en tu caso.
  4. Presenta la solicitud y guarda el justificante.

Cuidado con esto, que es el error caro: tiene que ser una «Inscripción de alias», NO una «Modificación de alias». Aunque tu remitente ya esté inscrito, la modificación sobre un asiento que presentó otro proveedor se registra, te da justificante y no produce ningún efecto. Lo aprendimos nosotros con catorce solicitudes que se quedaron en nada: el asiento del nuevo proveedor no llega a crearse y te enteras semanas después. Cada proveedor necesita su propio asiento, y eso solo lo crea una inscripción.

En cuanto la CNMC lo resuelva, tu remitente queda habilitado en la plataforma sin que tengas que avisarnos: comprobamos el Registro a diario.

El remitente numérico de respaldo

Puedes registrar un móvil tuyo como remitente alternativo, y poder así recibir respuestas: te enviamos un SMS a ese número con un enlace y, al pulsarlo, queda verificado que es tuyo. Si un envío sale con una marca aún no aprobada después del corte de la CNMC, saldrá con ese número en vez de perderse.

Importante, dicho sin adornos: los remitentes numéricos quedan fuera del Registro de Alias (no se pueden inscribir en la CNMC), así que el corte no les aplica — pero tampoco hay regla escrita que garantice su entrega para siempre. Es un respaldo real, no es una garantía.


4. Enviar un mensaje

Enviar mensaje

La pantalla de envío sirve para los tres canales; eliges Canal arriba y el formulario se adapta:

  • Destinatario en formato internacional E.164 (+34612345678). Si no pones prefijo se asume España — y la plataforma vigila los dos errores típicos: un número extranjero sin su prefijo se rechaza con un mensaje que te dice cómo corregirlo, y un número que quede como fijo español (8xx/9xx, que normalmente no recibe SMS) se envía pero con aviso, porque suele ser un móvil extranjero al que le falta el prefijo (el clásico: un móvil portugués 9xx tecleado a pelo). En la importación masiva de contactos, el resumen te dice cuántos números del fichero han quedado así, para que lo corrijas antes de lanzar la campaña.
  • Mensaje con contador de caracteres. Un SMS estándar admite 160 caracteres; los más largos se envían como concatenados y el operador factura cada parte como un SMS (el contador te avisa de cuántas partes van).
  • Las tildes y emojis cuentan: un solo carácter fuera del alfabeto GSM obliga a codificar en Unicode y el SMS pasa de 160 a 70 caracteres por parte. La codificación «Automática» elige siempre la más barata.
  • Plantillas: guarda los textos que repites y reutilízalos con un clic.
  • Enlace de baja: si el mensaje es publicidad, pulsa Enlace de baja (o escribe {BAJA} en el texto). Se convierte en un enlace corto con el que el destinatario deja de recibir tus comunicaciones comerciales en un paso; la ley (LSSI, art. 21) exige ofrecerlo en cada una. Si esa persona ya se dio de baja, el envío se rechaza sin cobrar. Los mensajes sin {BAJA} —códigos, citas, avisos— no se bloquean nunca.
  • Opciones de entrega (solo SMS): el SMS Flash aparece directamente en la pantalla del móvil, sin abrir la bandeja; el plazo de validez hace que el operador lo descarte si no ha podido entregarlo a tiempo, útil para códigos que caducan.
  • Página: elige una de tus páginas y pulsa Página (o escribe {PAGINA}): se convierte en un enlace a ella, distinto para cada destinatario (ver «Páginas» en el apartado 7).
  • El panel de Tarifas por canal a la derecha te dice el coste por destino antes de enviar; el importe exacto se calcula al enviar según el país.

En WhatsApp, si usas una plantilla aprobada por Meta, la categoría que factura Meta (marketing, utilidad, autenticación o servicio) es la que Meta tiene asignada a esa plantilla. Nuestro precio de plataforma es el mismo en las cuatro; la conversación la factura Meta aparte, contra tu cuenta de WhatsApp Business.


5. El historial y los estados

Historial de mensajes

Cada mensaje tiene una fila con su canal, destino, remitente, coste y estado. El menú Columnas te deja ocultar las que no uses. Los estados:

Estado Qué significa
En cola Cobrado y esperando a salir (segundos).
Enviado La red del operador lo aceptó. Aún sin confirmación de entrega.
Entregado Acuse de entrega recibido.
Leído Solo WhatsApp/Telegram: el destinatario lo abrió.
Fallido No se pudo entregar. Si el operador nunca lo aceptó, se reembolsa solo.

Dos matices honestos que conviene saber:

  • «Entregado» no significa lo mismo en todos los países. En muchos destinos, el acuse solo confirma que la red aceptó el mensaje. Cuando el destino tiene acuse poco fiable, te lo avisamos antes de enviar.
  • Un mensaje aceptado por la red que después falla (número apagado semanas, buzón lleno…) se factura igual, porque las redes nos lo facturan a nosotros. El reembolso automático cubre los fallos antes de la aceptación.

Desde el historial puedes abrir el detalle de cada mensaje (partes, coste, acuses con hora exacta) y exportar a CSV el listado filtrado.


6. Contactos y listas

Contactos

La agenda guarda tus destinatarios con nombre, teléfono en E.164 y atributos libres (por ejemplo {nombre}, {cita}) que luego usas para personalizar campañas.

Importar desde fichero

Importar contactos

Sube un CSV con una columna de teléfono (y las que quieras de datos). Reglas que te evitan sustos:

  • Los números se normalizan a E.164 y los duplicados no se crean dos veces.
  • La importación necesita que tu saldo cubra al menos un mensaje a cada contacto que tendrías tras la subida. No se cobra nada: es la puerta que evita subir listados que luego no se pueden usar. Si el saldo no llega, la importación se corta e informa de cuánto falta.

Listas

Listas

Las listas agrupan contactos («Pacientes revisión anual», «Clientes VIP») y son el origen natural de una campaña. Un contacto puede estar en varias.


7. Campañas: el mismo mensaje a cientos o miles

Campañas

Una campaña envía un mensaje —personalizable— a una lista entera, a un fichero subido al momento o a una selección manual.

Crear campaña

  1. Elige canal, origen (lista, fichero o manual) y escribe el texto. Puedes usar campos personalizados: Hola {nombre}, toca revisión anual… {nombre} es el nombre del contacto, y cualquier columna de tu fichero es un campo: «Fecha cita» se escribe {fecha_cita} (las fechas salen como 03/10/2026). Si a un contacto le falta un dato, esa parte le llega vacía.
  2. La plataforma calcula la estimación de coste antes de confirmar: el precio de cada destino por las partes del SMS de cada destinatario —con campos personalizados, cada uno recibe su texto y paga el suyo—. Ahí mismo ves el texto real de los primeros contactos y a cuántos les falta cada campo.
  3. Programa la fecha y hora si no quieres que salga ya.
  4. Confirma. El progreso se ve en vivo: en cola → enviados → entregados, con los fallidos contados aparte y reembolsados cuando toca.

Cada destinatario genera su propio mensaje en el historial, con su coste y su acuse: la campaña es la carpeta, no una caja negra.

Quién hizo clic

Si el texto lleva un enlace (con Acortar los enlaces de la campaña marcado), cada destinatario recibe el suyo, de la misma longitud: no cambia ni el precio ni la velocidad de envío. Así la ficha de la campaña te dice cuántas personas hicieron clic —no solo cuántos clics— y en la ficha de cada mensaje ves si esa persona abrió el enlace y cuándo. Las vistas previas que generan WhatsApp, iMessage o Telegram al recibir un enlace no cuentan como clic.

Volver a escribir

Cuando la campaña ya ha salido, su ficha ofrece volver a escribir a quien hizo clic, a quien no lo hizo o a quien no le llegó. Se crea una lista con esas personas y se abre una campaña nueva con el mismo texto, para que lo cambies; no se envía nada hasta que la confirmes, y quien esté de baja no la recibe.

Envío de prueba

Antes de confirmar, en la ficha de la campaña puedes enviar una prueba a tu móvil: te llega el texto tal y como lo recibirá el primer contacto de la lista, con sus datos y sus enlaces. Se cobra como un mensaje normal y no cuenta en la campaña.

Franja horaria y velocidad

En Franja horaria y velocidad puedes limitar el envío a unas horas y unos días (por ejemplo, de 9:00 a 21:00 de lunes a viernes): fuera de la franja, la campaña espera sola a la siguiente apertura. Y puedes fijar un máximo de mensajes por minuto, para que no se sature tu centralita o tu web si responde mucha gente a la vez.

Recordatorios por fecha: citas y cumpleaños

Si tu fichero tiene una columna con una fecha —la de la cita, la de nacimiento—, en Enviar según una fecha de cada contacto eliges esa columna (fecha_cita), cuántos días antes y a qué hora. Cada contacto recibe el mensaje en su día: con «cita», la fecha tal cual; con «aniversario», su día y mes la próxima vez que llegue. Combínalo con los campos personalizados: Le recordamos su cita del {fecha_cita}.

A quien no tiene fecha, o la tiene ya pasada, no se le envía ni se le cobra: queda anotado con el motivo. La campaña sigue en curso hasta que el último contacto recibe su mensaje, y su ficha dice cuántos esperan todavía su día y cuándo es el próximo envío. El saldo se comprueba al confirmar para toda la lista; si más adelante no alcanza, esos mensajes no salen.

Páginas: formularios y documentos desde el SMS

En Páginas preparas una página con título, texto, imágenes, botones, documentos PDF y un formulario (texto, correo, teléfono, fecha, DNI, desplegable, casillas…), con tu color y tu logo, y la ves en vista previa antes de usarla. Al escribir el mensaje, elige la página y pulsa Página: {PAGINA} se convierte en un enlace distinto para cada destinatario.

Así sabes quién la abrió y quién respondió: las respuestas llegan con el teléfono al que se envió, las ves en la página y las descargas en CSV, y la campaña te deja volver a escribir a quien no respondió. Un documento puede pedir «he leído y acepto» y queda registrada la fecha; si necesitas que la aceptación sirva como prueba, usa la mensajería certificada (apartado 8).

Por seguridad, un formulario no puede pedir contraseñas, PIN ni datos de tarjeta, y las páginas solo se publican cuando tu cuenta está aprobada. Los PDF e imágenes que subes ocupan espacio de tu cuenta (100 MB); lo ves en Ficheros.

Cada página se publica dos años incluidos. Después, mantenerla cuesta una cuota anual según su tráfico: 0,002 € por persona que la abrió el último año, con un mínimo de 5,00 € al año, descontada del saldo. Te avisamos por correo 30 días antes con el importe calculado; si no la necesitas, desmarca «Renovar sola al vencer» y dejará de publicarse sin borrar nada. Si tienes mucho tráfico, el precio por visitante se negocia.

Condiciones con justificante. Añade el bloque Condiciones con tu texto (las condiciones de un servicio, un consentimiento…): quien lo lee marca «he leído y acepto» y se genera un justificante en PDF con el texto exacto que aceptó, la fecha y los datos del formulario. En la página eliges si se lo mandamos por correo a quien acepta (necesita una pregunta de tipo «Correo»), a tu dirección o a los dos; además, se lo puede descargar al momento y tú lo tienes siempre en Respuestas. Si cambias el texto más tarde, lo aceptado antes no cambia. El enlace de cada SMS es personal: una vez aceptado, si la persona vuelve a abrirlo solo ve cuándo lo abrió por primera vez y cuándo aceptó, y no puede aceptar otra vez.

Quien acepta recibe además en su móvil un SMS que confirma lo que ha aceptado, cuándo y la referencia; si llegó por el enlace público, la página le pide el móvil. Se cobra de tu saldo y tú eliges el nivel en cada página: SMS normal (por defecto) o SMS certificado, que le manda todo lo aceptado como comunicación certificada y genera el certificado de evidencias con sello de tiempo de Camerfirma en cuanto se entrega. El certificado cuesta más y da más seguridad jurídica; solo está disponible para móviles españoles. La casilla «he leído y entendido» es obligatoria: sin marcarla no se puede aceptar. Para compartir la página sin enviar un SMS —en un correo, un WhatsApp o un QR del mostrador— crea su enlace público desde el editor.

Firmas: tu cliente firma en la tablet o en su móvil

Firmas

En Firmas registras los datos de la persona (móvil, nombre y, si quieres, las respuestas de la página para que solo tenga que comprobarlas) y eliges qué tiene que firmar: una página con condiciones o con un documento. Le sale su código QR: lo lee la tablet de tu local o su propio móvil y se abre su página de firma, con sus datos ya puestos. Comprueba que el móvil y los datos son correctos, lee, marca la casilla obligatoria y recibe un código por SMS: al escribirlo, firma. Al terminar le llega a su móvil el SMS de confirmación con el enlace a su justificante; en la tablet no queda nada, ni se puede descargar ni volver atrás, y si nadie la toca vuelve sola al principio.

Si emparejas la tablet una vez (Firmas → Tablets), las firmas le aparecen solas, sin leer ningún QR, y puede quedarse bloqueada en el navegador. También puedes mandarle el enlace por SMS para que firme desde casa: como el enlace ya le llega a su móvil, no necesita código. Cada SMS (el del enlace, el del código y el de confirmación) se cobra de tu saldo.

Firma en la tablet

En cada página decides tres cosas: si se firma con el dedo (sale un recuadro para firmar en la pantalla y la firma aparece en el justificante), si al firmar con el QR o en la tablet hace falta el código por SMS (con la firma con el dedo en tu propia tablet puedes prescindir de él) y si al terminar se le manda el SMS de confirmación, que también puedes quitar.

Precio. Cada firma o aceptación con justificante cuesta 0,10 € de tu saldo, se haga en la tablet, con el QR o desde el enlace de la página. Los SMS (el del enlace, el del código y el de confirmación) y el certificado se cobran aparte, cada uno por su tarifa. En modo prueba no se cobra. Si no hay saldo, la página lo avisa antes de que la persona rellene nada.

Bajas: quien no quiere recibir más publicidad

Escribe {BAJA} en el texto (o pulsa Enlace de baja) y se convierte en un enlace corto, distinto para cada destinatario: quien lo abre deja de recibir tus comunicaciones comerciales con un solo botón, tanto en un envío individual como en una campaña.

Las campañas nunca se envían a quien está de baja, lleve o no el enlace: el contacto aparece como no enviado, sin coste. La lista está en Bajas, en el menú: puedes anotar a mano a quien te lo pida por teléfono o en tu tienda, y solo el administrador de la cuenta puede retirar una baja —y solo debe hacerlo si esa persona pide volver a recibir tus mensajes—.


8. Mensajería certificada: cuando necesitas poder demostrarlo

Expedientes certificados

Un mensaje certificado no es un SMS con adorno: es un expediente de evidencias. Al enviarlo:

  1. El contenido íntegro queda fijado con una huella criptográfica (SHA-256) antes de salir.
  2. Cada hecho —envío, aceptación, entrega, apertura del enlace, lectura del contenido, firma si la pides— se registra con fecha y hora al milisegundo, encadenado al hecho anterior.
  3. El destinatario recibe un SMS con un enlace a su portal, donde lee el contenido completo (y firma con un código de un solo uso, si es un contrato).
  4. El PDF de evidencias se emite cuando lo pides y se cierra con un sello de tiempo cualificado de AC Camerfirma, S.A. (art. 42 del Reglamento eIDAS), con presunción legal de exactitud de fecha e integridad (art. 41.2). Lleva un código de verificación pública: cualquiera puede comprobar el certificado sin cuenta.

Enviar certificado

Los límites, por delante: disponible solo a España (+34); es un servicio de entrega electrónica certificada no cualificado (art. 3.36 eIDAS) — lo que sí es cualificado es el sello de tiempo—; y la valoración final de la prueba es siempre del juez. El detalle legal completo, con sus citas, está en smsverifica.com/mensajeria-certificada.html.

Precio: el del canal + 0,25 € de suplemento por certificar (igual en los tres canales).


9. Estadísticas

Estadísticas

Consumo y entregas por día, por canal y por país, con los mismos números que el historial (salen del mismo sitio). Para dirección: cuánto se envía, a dónde, y qué tasa de entrega tiene cada destino.


10. Saldo: recargas, pagos y facturas

Recargar saldo

El modelo es deliberadamente simple:

  • Recargas a la par: 100 € de recarga son 100 € de saldo. El IVA se cobra encima y aparece desglosado en la factura. No hay descuentos por volumen de recarga: el precio por mensaje es el mismo recargues 50 € o 5.000 €.
  • El pago es con tarjeta (Stripe) y el abono es inmediato. Con métodos bancarios diferidos (SEPA), el saldo se abona cuando el banco liquida.
  • El saldo no caduca.

Pagos y facturas

Cada pago tiene su factura española con numeración correlativa, descargable en PDF. Si tu empresa opera con inversión del sujeto pasivo o exención, se refleja según tus datos fiscales.

Auto-recarga

Auto-recarga

Define un umbral («si bajo de 20 €») y un paquete («recarga 100 €»): cuando el saldo cruza el umbral, se recarga solo con tu tarjeta guardada y te llega el aviso con la factura. También puedes fijar tu propio umbral de aviso de saldo bajo sin auto-recarga: te avisamos por email y decides tú.


11. La API REST: todo lo del panel, desde tu software

Credenciales de API

Todo lo que hace el panel se puede hacer por API (https://app.smsverifica.com/api/v1):

  • POST /messages — enviar SMS, WhatsApp o Telegram.
  • GET /messages/{id} y GET /messages — estado e historial.
  • POST /campaigns — campañas completas.
  • POST /verify/start y POST /verify/check — verificación OTP lista para usar: generamos el código, lo enviamos y lo comprobamos nosotros.
  • POST /certified — mensajería certificada.
  • GET /account/balance y GET /pricing/sms — saldo y tarifas vigentes.
  • GET /senders y GET /senders/check — tus remitentes y qué pasaría hoy al enviar con ellos a España: si salen con tu marca, con el remitente de respaldo o se rechazan (Registro de Alias de la CNMC).

Autenticación recomendada: token Bearer creado en esta pantalla (se enseña una sola vez; revocable; con caducidad opcional). Toda petición de creación admite Idempotency-Key, así un reintento de red nunca duplica un envío. Sin saldo, la API responde 402 insufficient_balance — tu integración puede reaccionar recargando o avisando.

La referencia completa con ejemplos curl está en smsverifica.com/api-sms.html.

Si vienes de la API clásica de Altiria: qué tienes que cambiar

Esta sección es para quien ya enviaba SMS llamando directamente a la API clásica de Altiria (cmd=sendsms) y ha pasado su cuenta a SMSverifica. Si tu código sigue apuntando allí, tus envíos no están saliendo, y es el tipo de avería que no da error hasta que alguien reclama.

Lo que cambia es la URL y la autenticación. A quién envías, qué texto y cuándo, no se toca.

Antes (API clásica de Altiria, formulario codificado):

POST https://www.altiria.net:8443/api/http
cmd=sendsms
&domainId=TU_DOMINIO
&login=TU_LOGIN
&passwd=TU_PASSWORD
&dest=+34600111222
&msg=Hola
&senderId=MIMARCA

Ahora (SMSverifica, JSON):

POST https://app.smsverifica.com/api/v1/messages
Content-Type: application/json
X-Api-Key: sk_live_...
X-Api-Secret: ...
Idempotency-Key: 7f3c1e90-...

{
  "channel": "sms",
  "to": "+34600111222",
  "body": "Hola",
  "from": "MIMARCA"
}

La equivalencia campo a campo:

API clásica de Altiria SMSverifica Nota
cmd=sendsms POST /api/v1/messages El verbo va en la ruta, no en un campo
domainId + login + passwd Cabeceras X-Api-Key y X-Api-Secret Dos valores, no tres. Los tienes en Ajustes → API
dest to En E.164 (+34600111222). Si mandas 600111222 lo normalizamos a España
msg body Hasta 1.600 caracteres; te cobramos por partes reales
senderId from Ver el aviso de abajo
cmd=getcredit GET /api/v1/account/balance Devuelve balance_eur: un importe en euros
(no existía) Idempotency-Key Úsalo: un UUID por mensaje. Un reintento de red deja de poder duplicar un envío

Tres cosas que conviene saber antes de tocar el código:

  1. El saldo va en euros. GET /account/balance devuelve balance_eur, un importe en euros. Si tu integración leía otra unidad y la comparaba contra un número, revísalo: aquí cada mensaje cuesta un precio fijo en euros según país y canal.
  2. Sin saldo la respuesta es 402, con code: insufficient_balance. No es un error transitorio: reintentarlo no lo arregla.
  3. El remitente ya no es libre. Desde el 15 de septiembre de 2026, un remitente de marca hacia España tiene que estar inscrito en el Registro de Alias de la CNMC (ver el apartado 3). Si mandas un from no inscrito, la respuesta es 422 sender_alias_not_registered o sale con el remitente de respaldo de tu cuenta. No reintentes ese 422: avisa a quien corresponda y presenta el trámite.

Si prefieres no tocar nada todavía, dínoslo: podemos revisar tu integración contigo por teléfono en media hora y quedarte tranquilo.

Webhooks de estado

Webhooks

En vez de preguntar cada minuto, dinos una URL tuya y te notificamos nosotros cada cambio de estado (enviado, entregado, fallido, leído…), con firma para que verifiques que somos nosotros y reintentos automáticos si tu servidor no responde.


12. Canales: WhatsApp y Telegram con tus credenciales

Canales

  • WhatsApp Business API: conectas tu propia cuenta de Meta (phone number ID, WABA ID y token). Tus plantillas se sincronizan a diario desde Meta con su categoría real, que es la que Meta factura.
  • Telegram: conectas tu bot (token de BotFather). La condición del canal la pone Telegram: el contacto tiene que haber iniciado conversación con tu bot al menos una vez; a partir de ahí, la entrega es inmediata y fiable. El bot captura el chat_id automáticamente cuando el usuario le escribe.

Las credenciales se guardan cifradas y nunca se muestran completas.

WhatsApp: lo que hay que saber antes de empezar

Dicho sin rodeos, porque ahorra disgustos:

  • No existe el «WhatsApp masivo» desde la aplicación normal. Los envíos masivos desde WhatsApp o WhatsApp Business (la app del móvil) están prohibidos por las condiciones de uso. Los servicios que los ofrecen automatizan WhatsApp Web por vías no oficiales y el desenlace habitual es que WhatsApp bloquea el número, a menudo para siempre. Si es el número de tu negocio, pierdes también las conversaciones de tus clientes.
  • El número que conectes a la API deja de funcionar en la app. Un número está en la aplicación o en la API, nunca en las dos. Si vas a usar el número de tu negocio, tenlo en cuenta: lo normal es dedicar uno nuevo.
  • Meta factura sus conversaciones aparte, contra tu propia cuenta. Nuestro precio de plataforma (0,005 € por mensaje) no incluye lo que cobra Meta.
  • Para escribir a alguien que no te ha escrito antes hace falta una plantilla aprobada por Meta. No se puede mandar texto libre a una lista: eso solo vale dentro de las 24 h siguientes a que el cliente te escriba.

Si lo que necesitas es importar un CSV y enviar a tu base de datos sin configurar nada, lo que estás describiendo es SMS, no WhatsApp.

WhatsApp, paso a paso

Es un trámite de una vez, y lleva su tiempo —la verificación de empresa puede tardar días—. Si te atascas en cualquier punto, llámanos y lo hacemos juntos.

  1. Cuenta de empresa en Meta. Entra en business.facebook.com con tu cuenta de Facebook y crea una cuenta de Meta Business a nombre de tu empresa.
  2. Verifica tu empresa. En Configuración del negocio → Centro de seguridad, inicia la verificación: Meta te pedirá documentación que acredite la sociedad (escritura, alta censal, un recibo a nombre de la empresa…). Es el paso más lento: cuenta con días, no horas.
  3. Crea una aplicación. En developers.facebook.com, Mis aplicaciones → Crear aplicación, tipo Empresa, y vincúlala a la cuenta del punto 1.
  4. Añade el producto WhatsApp a esa aplicación. Al hacerlo se crea tu cuenta de WhatsApp Business (WABA).
  5. Añade tu número de teléfono y verifícalo por SMS o llamada. Recuerda: ese número no puede estar dado de alta en la app de WhatsApp; si lo está, hay que borrarlo de la app primero.
  6. Apunta los dos identificadores: el Phone Number ID y el WhatsApp Business Account ID (WABA ID). Los tienes a la vista en la pantalla de configuración de la API.
  7. Genera un token permanente. El que aparece de entrada caduca en 24 h y solo sirve para probar. Para uno definitivo: Configuración del negocio → Usuarios → Usuarios del sistema, crea uno, dale acceso a tu aplicación y a tu WABA, y genera su token con los permisos whatsapp_business_messaging y whatsapp_business_management. Guárdalo: no se vuelve a mostrar.
  8. Añade un método de pago en la cuenta de WhatsApp Business. Sin él, Meta no entrega las conversaciones que factura.
  9. Crea tus plantillas en Administrador de WhatsApp → Plantillas de mensajes y espera su aprobación (suele ser rápido). Elige bien la categoría: es la que Meta te factura.
  10. Conéctalo aquí. En Canales → WhatsApp, pega el Phone Number ID, el WABA ID y el token. Con eso quedas operativo: tus plantillas se sincronizan solas a diario y podrás elegirlas al enviar.

Las pantallas de Meta cambian de sitio con cierta frecuencia; los nombres de los conceptos —WABA, Phone Number ID, usuario del sistema— son los que no cambian, y son los que hay que buscar.


13. Usuarios y roles

Usuarios

Dos roles dentro de tu cuenta:

  • Administrador (admin_cuenta): todo — usuarios, canales, API, saldo.
  • Operador: envía y consulta; no toca configuración ni dinero.

Los usuarios se crean por invitación o con contraseña temporal, se desactivan sin borrarlos (su historial se conserva) y cada uno puede activar su 2FA.


14. Datos de facturación

Datos de facturación

Razón social, NIF/CIF y dirección fiscal: lo que aparece en tus facturas y —importante— el NIF con el que se inscriben tus remitentes en la CNMC. Cada factura congela los datos del momento de emisión, así que un cambio aquí no reescribe facturas pasadas.


15. Seguridad

Seguridad

  • Verificación en dos pasos (2FA) con app autenticadora o código por email, a tu elección. Códigos de recuperación de un solo uso por si pierdes el móvil.
  • Dispositivos recordados: puedes saltarte el segundo factor 30 días en un navegador de confianza (nunca la contraseña). Revocables uno a uno.
  • Cambiar la contraseña cierra todas las demás sesiones abiertas.

16. Actividad de plataforma: qué hacemos nosotros en tu cuenta

Actividad de plataforma

Transparencia por diseño: si alguien del equipo de la plataforma actúa sobre tu cuenta (acceso de soporte, ajuste de saldo, emisión de un token de API…), queda registrado y tú lo ves aquí, además de recibir aviso por email. Sin letra pequeña.


17. Casos de negocio

Clínicas y consultas — recordatorio de cita el día antes (SMS de una parte, 0,039 €) reduce las ausencias de forma medible; confirmación con respuesta; campaña de revisión anual a la lista de pacientes.

Comercio y hostelería — promociones por WhatsApp con plantilla de marketing a clientes con opt-in; aviso de pedido listo por SMS; OTP para validar el teléfono en el registro de la web.

Logística — «su paquete llega hoy entre 10:00 y 12:00» por SMS con acuse; webhook de estado para reintentar por otro canal desde tu backend si no hay entrega.

Software e integradores — verificación OTP con dos llamadas a la API; mensajería transaccional multicliente con tokens revocables por entorno; mensajes certificados para altas de contrato o cambios de condiciones, con el PDF de evidencias archivado en tu expediente del cliente.

Administraciones y despachos — notificaciones que deben poder demostrarse: mensaje certificado con lectura registrada y, si hace falta, firma con OTP.


18. Preguntas operativas frecuentes

¿Por qué mi SMS cuesta el doble? — Tiene más de 160 caracteres (o lleva una tilde/emoji que lo pasa a Unicode, 70 por parte). El contador de la pantalla de envío te lo dice antes de enviar.

¿Por qué un mensaje «Entregado» dice que el cliente no lo recibió? — En algunos países el acuse solo confirma la aceptación de la red. Mira el aviso de fiabilidad del destino en el detalle del mensaje.

¿Puedo probar la API sin gastar? — Sí: en modo prueba, toda la API funciona con envíos simulados y estados realistas. Cero coste.

¿Qué pasa si me quedo sin saldo a mitad de campaña? — Los mensajes ya cobrados salen; los que no llegan a cobrarse quedan sin enviar y la campaña lo refleja. Con auto-recarga, esto no pasa.

¿Cómo cancelo una campaña programada? — Desde su ficha, mientras esté «Programada». Lo ya despachado no se puede retirar de la red.


SMSverifica es un servicio de ABARCANDO, S.L. (CIF B88017173), operador inscrito en el Registro de Operadores de la CNMC y proveedor registrado en origen (PRO) en el Registro de Alias. Soporte: soporte@abarcando.com · 910 054 224.