Una API de SMS permite que su propio sistema (una tienda en línea, un ERP, una app) envíe mensajes de texto sin que nadie los escriba a mano. Sirve para confirmaciones, recordatorios, códigos de verificación y alertas.
Qué necesita para empezar
- Una llave de API con permiso para enviar SMS.
- Un número de origen habilitado para SMS en el país donde va a enviar.
- Un paquete de mensajes o saldo para el consumo.
- Consentimiento de las personas a quienes les va a escribir.
Cómo es un envío
- Su sistema hace una solicitud HTTPS al endpoint de envío con su llave, el número de destino en formato internacional y el texto.
- El proveedor valida la llave, la IP permitida, el número de origen y los límites.
- Devuelve un identificador del mensaje y lo entrega a la red.
- Los cambios de estado (enviado, entregado, fallido) le llegan por webhook o se consultan por API.
Estados de entrega y respuestas
«Enviado» no es lo mismo que «entregado». Un número mal escrito, un teléfono apagado por días o un filtro del operador pueden hacer que el mensaje falle. Guarde el identificador de cada envío y actualice su sistema con el estado final.
Los clientes también responden. Si su caso lo necesita (confirmar una cita con «SI», por ejemplo), pida que las respuestas le lleguen por webhook o que entren a una bandeja donde alguien las atienda.
Límites y seguridad
- Llaves con permisos mínimos: si la llave solo envía SMS, que no pueda hacer nada más.
- IPs permitidas: que la llave solo funcione desde sus servidores.
- Límites por minuto y cuotas: protegen su saldo si un error en su sistema dispara miles de mensajes.
- Registro de uso: cada solicitud queda registrada para auditar.
Reglas por país
El SMS no es igual en todas partes:
- Estados Unidos: para enviar desde números locales de 10 dígitos se exige el registro 10DLC, y los números toll-free requieren verificación.
- Costa Rica y el resto de América: las tarifas y las reglas de remitente cambian por país y por operador; conviene confirmarlas antes de una campaña.
Buenas prácticas de consentimiento
- Escriba solo a quien lo autorizó, y guarde la evidencia de ese permiso.
- Identifique a su empresa en el mensaje.
- Respete las palabras de baja como STOP y deje de enviar de inmediato.
- Evite horarios de madrugada para mensajes no urgentes.
SMS o WhatsApp por API
El SMS llega a cualquier teléfono sin aplicación y es ideal para códigos y alertas cortas. WhatsApp permite botones, imágenes y conversación, pero exige plantillas aprobadas fuera de la ventana de 24 horas. Muchas empresas usan los dos: WhatsApp para conversar y SMS como respaldo.
Con la API de TelHarbor envía SMS, WhatsApp y correo desde su sistema, con llaves, IPs permitidas, límites y webhooks incluidos. Los precios de los paquetes están en planes.
Preguntas frecuentes
¿Puedo enviar SMS a Costa Rica y a Estados Unidos con la misma llave?
Sí, siempre que tenga números de origen habilitados y saldo para cada destino.
¿Cuántos caracteres tiene un SMS?
Hasta 160 caracteres sin tildes ni emojis; con tildes o emojis el límite baja a 70 y los textos largos se cobran como varios mensajes.
¿Puedo enviar códigos de verificación?
Sí. En TelHarbor también existe un servicio de verificación que genera y comprueba el código por usted.
¿Cómo sé si el mensaje llegó?
Por el estado de entrega, que le llega por webhook o se consulta por API.