API — Panel de Aló

Nombre	Clave	Permisos	Modo	Caduca	Último uso	Acciones
Tienda Sol · backendCreada el 3 de octubre · Joaquín	alo_live_···· 7f2c	PedidosCrear llamadasWebhooks	Producción	Nunca	Hace 4 minutos
Pruebas de JoaquínCreada ayer · Joaquín	alo_test_···· a9d1	PedidosCrear llamadasLeer llamadasGrabaciones	Prueba	En 30 días	Ayer, 18:40

Las claves de prueba simulan llamadas y cobros sin marcar a nadie. Las grabaciones y transcripciones necesitan un permiso aparte por ser contenido sensible.

Límites

Por clave: 120 peticiones por minuto
Por tienda: 600 peticiones por minuto
Llamadas en paralelo: Hasta 10 con el plan Pro
Si te pasas: Respuesta 429 con el tiempo de espera; nada se pierde

Seguridad

Clave: Se muestra una sola vez al crearla; después solo los últimos 4 caracteres
Rotación: La clave vieja sigue 24 horas para que cambies tu sistema sin cortes
Registro: Cada petición queda con fecha, clave y origen; lo ves en Cuenta → Actividad

Destino	Eventos	Estado	Última entrega	Acciones
https://tienda-sol.com/aloSecreto whsec_···· 3b7e · creado el 3 de octubre	llamada.terminadapedido.actualizadonovedad.resuelta	Activo · 99,6 % entregado	Hace 4 minutos · 200 OK en 180 ms

Historial de entregasÚltimas 24 horas · 318 avisos

Hora	Evento	Pedido	Respuesta	Intento
10:02	llamada.terminada	4821	200 OK · 180 ms	1
9:58	llamada.terminada	4820	200 OK · 164 ms	1
9:51	pedido.actualizado	4819	200 OK · 201 ms	1
9:47	llamada.terminada	4818	502 · reintento en 10 min	2 de 5
9:40	pedido.actualizado	4817	200 OK · 190 ms	1
9:05	novedad.resuelta	N-76	200 OK · 172 ms	1

Lo que puedes hacerBase: https://api.alovoz.com/v1

POST: /llamadas · crea una llamada para un pedido: teléfono, nombre, producto, valor, dirección y agente
GET: /llamadas/{id} · estado, resultado, duración y coste; con el permiso de grabaciones, la transcripción y el audio
GET: /pedidos · tus pedidos con el estado de su llamada; filtros por origen, estado y fechas
POST: /pedidos/{id}/pausar y /reanudar · detiene o reanuda los intentos de un pedido
POST: /lotes · hasta 500 pedidos de una vez; se llaman en orden con pausa y cancelación
GET: /agentes · tus agentes y su versión publicada
GET: /saldo · saldo, tarifa de tu país y minutos de prueba

Ejemplo

curl -X POST https://api.alovoz.com/v1/llamadas \
  -H "Authorization: Bearer alo_live_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "agente": "ag_valeria_01",
    "referencia": "ORD-3302",
    "telefono": "+573201234455",
    "cliente": "Felipe N.",
    "producto": "Masajeador cervical",
    "valor": 129000,
    "direccion": "Cl. 93 # 15-20, Bogotá"
  }'
{ "id": "ll_8f2c…", "estado": "programada",
  "intento": 1, "sale_a": "2026-10-25T08:45:00-05:00" }

Un botón «Llamar» en cada pedido de tu panel

Pon el botón en tu propio sistema: Valeria llama al pedido y el resultado vuelve a tu panel sin que nadie salga de él. Tu clave nunca llega al navegador: tu servidor pide una sesión corta y el botón la usa.

Sitios autorizados

Solo estos orígenes pueden mostrar el botón. Para pruebas, autoriza http://localhost con su puerto.

https://tienda-sol.comhttp://localhost:3000

Código

<script src="https://api.alovoz.com/boton/v1.js"></script>
<button id="llamar-4821">Llamar</button>
<script>
  AloBoton.montar("#llamar-4821", {
    pedido: "4821",
    sesion: () => fetch("/api/alo/sesion", { method: "POST" })
      .then(r => r.json()).then(d => d.token)
  });
</script>