La plataforma del operador,
lista en API.
Hablame Colombia S.A. E.S.P. es un operador colombiano de telecomunicaciones con infraestructura propia. Nuestra plataforma se integra desde una única superficie HTTP autenticada con Bearer, pensada para producción.
# 1. Haz la llamada
curl -i -H 'Authorization: Bearer hk_...' \
https://developers.hablame.co/api/v6/utilities/ping
# 2. Revisa las cabeceras que devuelve Hablame
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
RateLimit-Limit: 20
RateLimit-Remaining: 19
RateLimit-Reset: 47
RateLimit-Policy: 20;w=60;name="endpoint"
# 3. Y la envoltura uniforme
{
"success": true,
"data": {
"pong": true,
"apiVersion": "v6",
"client": { "ip": "203.0.113.45" },
"account": { "id": 10000003, "status": "active" }
},
"meta": {
"requestId": "b9b1704baffab21150213c02fd853975",
"timestamp": "2026-06-04T19:43:59+00:00",
"responseTimeMs": 4.24
}
}Operador habilitado
Servicios autorizados por el Ministerio TIC de Colombia.
Cumplimiento CRC
Sujetos a la regulación de la Comisión de Regulación de Comunicaciones.
Infraestructura propia
Operamos la red en Colombia, no la revendemos.
Hablame Colombia S.A. E.S.P.
Empresa de Servicios Públicos constituida en Colombia.
Lo que puedes integrar hoy
32 endpoints documentados en 9 servicios. Misma autenticación, misma envoltura y la misma semántica de límites para todos.
Utilidades
Endpoints de diagnóstico, disponibles para cualquier API key. Sirven para verificar que tus credenciales quedaron bien conectadas.
Herramientas
Catálogos de propósito general que puedes consumir desde tu aplicación. Disponibles para cualquier API key.
Number Insight
Resuelve un número telefónico: país, tipo de línea, operador actual (en Colombia siguiendo portabilidad) y área. Uno a uno o por lote.
Acortador de URLs
Crea y administra enlaces cortos en tus dominios y consulta su analítica de clics.
Text-to-Speech
Convierte texto en audio con voces naturales, reutiliza automáticamente un audio idéntico ya generado y consulta el estado de cada solicitud.
Call Blasting
Llamadas de voz salientes con audio pregrabado o texto a voz, con reintentos configurables y estado por intento.
Cuenta
Resumen de facturación de la organización: saldo o cupo, topes de gasto y movimientos. Información financiera sensible.
Organización
Perfil de la organización, centros de costo y usuarios. Incluye datos personales.
Plataforma
Estado operativo de los servicios y catálogo de lo que tu cuenta tiene habilitado.
Una superficie que respeta tu tiempo
Códigos de error estables, límites con ventana deslizante y una envoltura única en todos los endpoints. Tu integración se ve igual el día 1 y el día 1000.
Autenticación Bearer
Una sola cabecera: Authorization: Bearer hk_TU_API_KEY. Sin parámetros de consulta, sin alternativas en el cuerpo.
Envoltura predecible
Cada respuesta es { success, data | error, meta }. Una sola rama en tu cliente, cero adivinanzas de forma.
Errores legibles
Códigos estables en UPPER_SNAKE (AUTH_REQUIRED, RATE_TPS_EXCEEDED) con enlace directo a la documentación en cada respuesta.
Límites honestos
Cabeceras RateLimit-* según RFC 9598 en cada respuesta y Retry-After en cada 429. Tu cliente se regula sin adivinar.
Lo que todavía no está
La v6 se libera endpoint por endpoint. Estos están anunciados pero aún no tienen contrato publicado, así que no los encontrarás en la referencia. El changelog avisa cuando entran.
/api/v6/sms/sendSMS transaccionalPróximamente/api/v6/whatsapp/sendWhatsApp BusinessPróximamente/api/v6/email/sendCorreo transaccionalPróximamente/api/v6/callblasting/otpOTP por llamadaPróximamente¿Listo para integrar el operador?
Empieza por la documentación, abre la referencia completa o revisa el estado de la plataforma.