0981 192 6486 +39 379 380 7807
Richiedi preventivo

Sviluppatori

API complete per integrare il centralino nei tuoi sistemi

Il pannello ExoVoIP usa le stesse API pubbliche che mettiamo a tua disposizione: tutto ciò che si fa dal pannello si può fare via API. Documentazione interattiva, chiavi con permessi granulari, webhook firmati e SDK.

Apri la documentazione API Specifica OpenAPI 
# Ricerca di un contatto a partire dal numero chiamante
curl https://centralino.exovoip.it/api/v1/contacts/lookup?number=%2B393331234567 \
  -H "Authorization: Bearer exo_live_…"

# Risposta (esempio indicativo)
{
  "name": "Mario Rossi",
  "company": "Acme Srl",
  "tags": ["cliente", "vip"]
}

Riferimenti

Indirizzi delle API

API REST v1

https://centralino.exovoip.it/api/v1

JSON, paginazione a cursore, filtri, chiave di idempotenza sulle creazioni, errori uniformi.

Documentazione interattiva

https://centralino.exovoip.it/api/docs – consulta ogni endpoint e provalo con la tua chiave API.

Apri la documentazione

Specifica OpenAPI 3.1

https://centralino.exovoip.it/api/openapi.json – generata dagli stessi schemi del servizio, sempre allineata.

Scarica la specifica

Copertura

Ogni funzione ha il suo endpoint

Nessuna funzione esiste solo nel pannello: puoi automatizzare configurazione, operazioni quotidiane e reportistica.

  • Interni, utenti e ruoli
  • Numeri, linee e regole di instradamento
  • Orari, calendari e chiusure
  • Menu vocali, code e gruppi
  • Registrazioni: ascolto, download, cancellazione
  • Trascrizioni e riassunti
  • Storico chiamate e segreteria
  • Musica d’attesa, annunci e messaggi vocali
  • Inoltro al cellulare e codici rapidi
  • Rubrica: contatti, ricerca per numero, importazione
  • Notifiche, webhook e chiavi API
  • Importazione ed esportazione massiva CSV/JSON

Controllo delle chiamate in tempo reale

  • Avvio chiamata (click-to-call)
  • Trasferimento, attesa, parcheggio, chiusura
  • Registrazione attivabile durante la chiamata
  • Stato di interni e code in tempo reale

Gli aggiornamenti sullo stato di interni e code arrivano in streaming, senza interrogazioni continue.

Chiavi API

  • Create dal pannello dall’amministratore dell’azienda
  • Prefisso exo_live_ per la produzione e exo_test_ per le prove
  • Mostrate una sola volta e conservate solo come impronta crittografica (hash)
  • Permessi granulari per risorsa e azione, per esempio cdr:read, extensions:write, calls:control
  • Indirizzi IP consentiti, scadenza e revoca immediata
  • Rotazione senza interruzioni: due chiavi attive in sovrapposizione
  • Limiti di utilizzo e registro delle richieste

Webhook

Il centralino avvisa i tuoi sistemi quando succede qualcosa, senza bisogno di interrogarlo.

  • Chiamata in arrivo, risposta, terminata, persa
  • Nuovo messaggio in segreteria
  • Registrazione disponibile
  • Trascrizione disponibile
  • Interno collegato o scollegato
  • Linea non disponibile

Ogni richiesta è firmata con HMAC-SHA256 e timestamp, per verificarne autenticità e freschezza. In caso di errore l’invio viene ripetuto con intervalli crescenti; dal pannello consulti il registro delle consegne e puoi reinviare manualmente un evento.

Strumenti

SDK, collezioni e guide

SDK ufficiali

Librerie per TypeScript/JavaScript, PHP e Python generate dalla specifica OpenAPI, con tipi sempre allineati alle API.

Scarica gli SDK

Collezioni pronte

Collezione per Postman e Insomnia da importare per provare subito gli endpoint.

Guide ed esempi

Esempi in curl, JavaScript, PHP e Python, casi d’uso per CRM e changelog con politica di deprecazione delle versioni.

Apri il manuale

Gli esempi in questa pagina sono indicativi: per percorsi, parametri e intestazioni fa fede la documentazione interattiva.

Domande degli sviluppatori

Come si ottiene una chiave API?

L’amministratore dell’azienda crea le chiavi dal pannello ExoVoIP, scegliendo permessi, indirizzi IP consentiti e scadenza. La chiave viene mostrata una sola volta.

Esiste un ambiente di prova?

Sono disponibili chiavi di test, con prefisso exo_test_, distinte da quelle di produzione. Per un ambiente dedicato alle prove di integrazione contattaci.

Le API hanno limiti di utilizzo?

Sì, sono previsti limiti per chiave e per azienda a tutela della stabilità del servizio. I valori sono indicati nella documentazione e possono essere concordati per integrazioni con volumi elevati.

Posso far sviluppare l’integrazione a Exobyte?

Sì. Exobyte sviluppa software su misura e può realizzare l’integrazione con il tuo CRM, gestionale o e-commerce.

Hai un’integrazione in mente?

Raccontaci quali sistemi vuoi collegare al centralino: ti indichiamo l’approccio migliore o realizziamo noi l’integrazione.

Richiedi un preventivo 0981 192 6486
WhatsApp +39 379 380 7807 [email protected] Lun–Ven 9:00–19:00 · Sab 9:00–12:00

Pagina aggiornata il · a cura di Exobyte