Preguntas frecuentes
Respuestas cortas a lo que más se pregunta. Cada una enlaza a la página donde está el detalle.
¿Hay un entorno de pruebas?
No. La API que usas para probar es la misma de producción y lo que se cobra, se cobra de verdad. Puedes llamar sin gastar nada a las consultas, como el ping. Lee Cómo probar sin sorpresas.
¿Dónde obtengo mi clave de API?
Se crea en Cloud, en la pantalla Claves API. Los pasos y las opciones están en Tu clave de API.
¿Qué hago si pierdo mi clave?
No se puede recuperar: Hablame guarda solo una huella de la clave y la muestra completa una sola vez, al crearla. Elimina la clave perdida y crea otra. Cómo hacerlo.
¿Qué significan los errores 401 y 403?
Un 401 dice que la clave falta (AUTH_REQUIRED) o no se reconoce (AUTH_INVALID_KEY). Un 403 dice que la clave es válida pero no alcanza: no tiene el servicio (AUTH_SERVICE_NOT_ALLOWED) o la capacidad (AUTH_CAPABILITY_NOT_ALLOWED) del endpoint, o llamaste desde una red que no tiene permitida (AUTH_IP_NOT_ALLOWED). Cada código está explicado en el catálogo de errores.
¿Cuántas peticiones puedo hacer?
Cada endpoint tiene su propio límite por organización, que dice su página en la referencia; el ping, por ejemplo, admite 20 por minuto. Cada respuesta con límite trae las cabeceras RateLimit-*, y al superarlo la API responde 429 con Retry-After. Mira Límites de uso.
¿Cómo evito crear dos veces el mismo enlace?
Manda una Idempotency-Key al crear el enlace, o el lote. Si la petición se corta y la repites con la misma llave y el mismo cuerpo, recibes el enlace de la primera vez, sin crear ni cobrar otro. Lee Idempotencia.
¿Qué se cobra y cuánto?
Las consultas no se cobran. Crear un enlace corto sí, y también cada visita de una persona a ese enlace (las de robots y las vistas previas no). El almacenamiento se cobra por GB al mes. Esta documentación no publica precios: cada producto tiene un endpoint de tarifa (acortador y almacenamiento), o escribe a comercial@hablame.co.
¿Hay SDK?
Todavía no hay ningún SDK oficial que puedas instalar. Mientras tanto tienes la especificación OpenAPI, la colección de Postman y ejemplos de código en nueve lenguajes en cada endpoint de la referencia. El estado de cada lenguaje está en SDKs.
¿Cómo envío SMS?
Por SMPP 3.4. La cuenta la crea soporte, que te entrega el servidor, el puerto y tus credenciales. Empieza en SMS.
¿Cómo recibo los SMS que me escriben?
Por webhook: cuando una persona le escribe a tu código corto, te llega un aviso firmado con el remitente y el texto. Mientras Cloud no tenga una pantalla para hacerlo, el equipo de Hablame registra tu destino a pedido. Mira Activar los webhooks.
¿Qué zona horaria usan las fechas?
Las marcas de tiempo de la API van en formato ISO 8601 con su desplazamiento de zona. Los días y las horas de las estadísticas del acortador son de Colombia (America/), y un expiresAt sin zona se interpreta en hora de Colombia (-05:).
¿Qué hago si aparece un campo nuevo en una respuesta?
Ignóralo. La API añade campos sin avisar y los que ya existen no cambian de tipo, así que tu cliente debe ignorar lo que no conoce. Mira la envoltura de respuesta.
No con tu clave real: cualquiera que abra las herramientas del navegador la vería. Haz la llamada desde tu servidor y entrega a tu página solo el resultado.
¿Cómo sé si el servicio está funcionando?
En la página de estado ves el estado de los servicios públicos de Hablame.
¿A quién le escribo si algo falla?
Para dudas técnicas, a developers@hablame.co. Si tienes una incidencia en producción, por WhatsApp al +57 319 660 0002, las 24 horas. Incluye el meta. de la respuesta y no envíes tu clave completa. Más en Soporte.
¿No encuentras tu pregunta? Escríbenos desde la página de soporte.