Introducción
La API de WiseParts conecta sistemas externos con su cuenta a través de HTTP. Un único token de integración autentica todas las peticiones, la URL base y las convenciones que se describen abajo se aplican en todo momento, y cada área del producto expone sus propios endpoints.
Voz es el área disponible hoy. Usted envía los eventos de llamada según ocurren — sonando, contestada, completada — y WiseParts los convierte en llamadas. Cada llamada alimenta después tres cosas: la barra de notificación en pantalla, la actividad que se registra automáticamente y las cifras de los Informes de llamadas. Consulte Call Center para ver qué hace el producto con ellas.
/pt, /es, /fr e /it que aquí.URL base
https://app.wiseparts.ai/api/v1
La versión es un segmento de la ruta, no una cabecera ni un parámetro de consulta. Todas las rutas de la referencia son relativas a esa base, sea cual sea el área a la que pertenezcan, y producción es el único servidor.
Operaciones de Voz
Post a call event — POST /voice/call. Crea una llamada, o hace avanzar una que ya existe. Envíe una petición por cada cambio de estado, reutilizando el mismo id durante toda la llamada.
Look up a caller's priority — GET /voice/priority. Dado un número, devuelve la prioridad del segmento al que pertenece el cliente correspondiente, para que su plan de enrutamiento pueda encolar a los clientes conocidos antes de ofrecer la llamada.
List request history — GET /voice. Devuelve lo que WiseParts registró para su cuenta: el payload tal como se recibió, la respuesta, el estado y la duración.
Las dos primeras también responden con el otro verbo — /voice/call acepta GET con los mismos campos en la cadena de consulta y /voice/priority acepta POST — para centralitas que solo pueden invocar una URL.
Su primera llamada
Los pasos siguientes usan los endpoints de Voz, pero el token y las convenciones son los mismos sea cual sea el área que acabe llamando.
1. Obtenga el token. En Integraciones, abra la integración que está conectando y copie su token. Identifica tanto la cuenta como la integración, por lo que no existe un identificador de cuenta aparte. Consulte Autenticación para ver las formas de enviarlo.
2. Envíe un evento.
curl -X POST https://app.wiseparts.ai/api/v1/voice/call \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"id": "CALL-2026-08-12-0042",
"direction": "inbound",
"status": "answered",
"from": "+351210000000",
"caller_id": "201"
}'
id, direction y status son obligatorios, y from es obligatorio cuando la dirección es inbound. La respuesta es una cadena result de 48 caracteres aleatorios que no identifica nada — su propio id es la referencia que debe conservar.
3. Encuéntrelo en el historial.
curl "https://app.wiseparts.ai/api/v1/voice?search=request&search_term=CALL-2026-08-12-0042&sort=-created_at&limit=10" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/json"
search y search_term solo funcionan en pareja, y no hay ordenación por defecto, así que envíe sort cuando el orden importe. Envíe también Accept: application/json: sin esa cabecera, una petición que falla la autenticación responde con un 302 a una página del navegador en lugar de un 401.
limit está definido, el cuerpo es un objeto con data, links y meta. Si omite limit, obtiene en su lugar un array sin envoltorio con todo el historial — las dos formas no son intercambiables.Un 200 en el paso 2 confirma la recepción, no que se haya registrado una llamada: una llamada solo avanza, y un evento que llega fuera de orden se acepta y se descarta. Post a call event enumera los estados y cuáles pueden sobrescribir a cuáles.
Si la llamada nunca aparece, Resolución de problemas explica dónde mirar — empezando por el hecho de que una petición que falla la autenticación no deja ninguna entrada.