Introduzione
L'API di WiseParts collega sistemi esterni al tuo account via HTTP. Un solo token di integrazione autentica ogni richiesta, l'URL di base e le convenzioni descritte qui sotto valgono ovunque, e ogni area del prodotto espone i propri endpoint.
Voce è l'area disponibile oggi. Invii gli eventi di chiamata man mano che si verificano — squillo, risposta, conclusione — e WiseParts li trasforma in chiamate. Ogni chiamata alimenta poi tre cose: la barra di notifica a schermo, l'attività registrata automaticamente e i dati dei Report Chiamate. Consulta Call Center per sapere cosa ne fa il prodotto.
/pt, /es, /fr e /it esattamente come qui.URL di base
https://app.wiseparts.ai/api/v1
La versione è un segmento del percorso, non un'intestazione né un parametro di query. Ogni percorso della documentazione di riferimento è relativo a questa base, qualunque sia l'area a cui appartiene, e la produzione è l'unico server.
Operazioni Voce
Post a call event — POST /voice/call. Crea una chiamata, oppure fa avanzare una chiamata già esistente. Invia una richiesta per ogni cambio di stato, riutilizzando lo stesso id per tutta la chiamata.
Look up a caller's priority — GET /voice/priority. Dato un numero, restituisce la priorità del segmento a cui appartiene il cliente corrispondente, così il tuo piano di instradamento può mettere in coda i clienti noti prima che la chiamata venga offerta.
List request history — GET /voice. Restituisce ciò che WiseParts ha registrato per il tuo account: il payload così come è stato ricevuto, la risposta, lo stato e la durata.
Le prime due rispondono anche sull'altro verbo — /voice/call accetta GET con gli stessi campi nella query string, /voice/priority accetta POST — per i centralini che possono solo richiamare un URL.
La tua prima chiamata
I passaggi qui sotto usano gli endpoint Voce, ma il token e le convenzioni sono gli stessi qualunque area finirai per chiamare.
1. Ottieni il token. In Integrazioni, apri l'integrazione che stai collegando e copia il suo token. Identifica sia l'account sia l'integrazione, quindi non esiste un identificativo di account separato. Consulta Autenticazione per i modi in cui inviarlo.
2. Invia 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 e status sono obbligatori, e from è obbligatorio quando la direzione è inbound. La risposta è una stringa result di 48 caratteri casuali che non identifica nulla — il riferimento da conservare è il tuo id.
3. Ritrovalo nella cronologia.
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 e search_term funzionano solo in coppia, e non esiste un ordinamento predefinito: passa quindi sort quando l'ordine è importante. Invia anche Accept: application/json: senza di esso, una richiesta che non supera l'autenticazione risponde con un 302 verso una pagina del browser invece che con un 401.
limit è impostato, il corpo è un oggetto con data, links e meta. Togli limit e ottieni invece un semplice array con l'intera cronologia — i due formati non sono intercambiabili.Un 200 al passaggio 2 conferma la ricezione, non che una chiamata sia stata registrata: una chiamata avanza sempre e solo in avanti, e un evento che arriva fuori ordine viene accettato e scartato. Post a call event elenca gli stati e quali di essi possono sovrascriverne altri.
Se la chiamata non compare mai, Risoluzione dei problemi spiega dove cercare — a partire dal fatto che una richiesta che non supera l'autenticazione non lascia alcuna voce.