Riferimento completo
Il riferimento interattivo con tutti gli endpoint, i parametri, gli schemi di richiesta e risposta e gli esempi è nello Swagger dell'API. Il documento OpenAPI 3.1 è disponibile in openapi.json: puoi importarlo in Postman, Insomnia o in un generatore di client.
Per provare gli endpoint dallo Swagger premi Authorize e inserisci la chiave API.
#Tutti gli endpoint
Elenco generato dal documento OpenAPI, raggruppato per area, con lo scope richiesto e il metodo corrispondente negli SDK.
#Stato servizio
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Stato del servizio | GET /health | — | health() |
#Accesso
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Utente della sessione | GET /auth/me | — | auth.me() |
#Aziende
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Elenco aziende | GET /v1/tenants | tenants:read | tenants.list() |
| Crea azienda (+ primo amministratore) | POST /v1/tenants | tenants:write | tenants.create() |
| Azienda corrente | GET /v1/tenants/current | extensions:read | tenants.current() |
| Dettaglio azienda | GET /v1/tenants/:id | tenants:read | tenants.get() |
| Modifica azienda | PATCH /v1/tenants/:id | tenants:write | tenants.update() |
| Disattiva azienda (status=disabled, nessuna cancellazione dati) | DELETE /v1/tenants/:id | tenants:write | tenants.delete() |
| Limiti interni e chiamate simultanee | PUT /v1/tenants/:id/limits | tenants:write | tenants.limits() |
| Sospendi azienda | POST /v1/tenants/:id/suspend | tenants:write | tenants.suspend() |
| Riattiva azienda | POST /v1/tenants/:id/resume | tenants:write | tenants.resume() |
| Avvia impersonificazione (audit) e restituisce X-Tenant-Id | POST /v1/tenants/:id/impersonate | tenants:impersonate | tenants.impersonate() |
| Server voce e host SIP dell’azienda | GET /v1/tenants/:id/voice-node | tenants:read | tenants.getVoiceNode() · py: tenants.get_voice_node() |
| Assegna server voce e host SIP dei telefoni | PUT /v1/tenants/:id/voice-node | tenants:write | tenants.setVoiceNode() · py: tenants.set_voice_node() |
#featureCodes
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Impostazioni codici funzione (PIN forzatura orari) | GET /v1/feature-codes/settings | extensions:read | featureCodes.getSettings() · py: feature_codes.get_settings() |
| Imposta il PIN per la forzatura orari (*90 / *91 / *92) | PUT /v1/feature-codes/settings | extensions:write | featureCodes.setSettings() · py: feature_codes.set_settings() |
#Interni
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Elenco interni | GET /v1/extensions | extensions:read | extensions.list() |
| Crea interno (password SIP mostrata una volta) | POST /v1/extensions | extensions:write | extensions.create() |
| Dettaglio interno | GET /v1/extensions/:id | extensions:read | extensions.get() |
| Modifica interno | PATCH /v1/extensions/:id | extensions:write | extensions.update() |
| Elimina interno (e relativi endpoint SIP) | DELETE /v1/extensions/:id | extensions:write | extensions.delete() |
| Deviazione su cellulare | PUT /v1/extensions/:id/follow-me | extensions:write | extensions.followMe() · py: extensions.follow_me() |
| Stato non disturbare | GET /v1/extensions/:id/dnd | extensions:read | extensions.getDnd() · py: extensions.get_dnd() |
| Attiva / disattiva non disturbare (comportamento chiamate, scadenza) | PUT /v1/extensions/:id/dnd | extensions:write | extensions.setDnd() · py: extensions.set_dnd() |
| Orari e stato acceso / spento dell’interno | GET /v1/extensions/:id/availability | extensions:read | extensions.getAvailability() · py: extensions.get_availability() |
| Imposta gli orari dell’interno o lo accende / spegne (come *95 / *94) | PUT /v1/extensions/:id/availability | extensions:write | extensions.setAvailability() · py: extensions.set_availability() |
| Rigenera password SIP | POST /v1/extensions/:id/password | extensions:write | extensions.resetPassword() · py: extensions.reset_password() |
| Credenziali SIP/WebRTC (telefono e softphone) | GET /v1/extensions/:id/sip-credentials | extensions:write | extensions.sipCredentials() · py: extensions.sip_credentials() |
#Linee
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Linee in attesa di verifica (sovrapposizione di reti) | GET /v1/trunks/approvals | security:read | trunks.approvals() |
| Approva linea in attesa di verifica | POST /v1/trunks/:id/approve | security:write | trunks.approve() |
| Rifiuta linea in attesa di verifica (motivo obbligatorio) | POST /v1/trunks/:id/reject | security:write | trunks.reject() |
| Elenco linee | GET /v1/trunks | trunks:read | trunks.list() |
| Crea linea (condivisa solo superadmin) | POST /v1/trunks | trunks:write | trunks.create() |
| Dettaglio linea | GET /v1/trunks/:id | trunks:read | trunks.get() |
| Modifica linea | PATCH /v1/trunks/:id | trunks:write | trunks.update() |
| Elimina linea (IN_USE se usata) | DELETE /v1/trunks/:id | trunks:write | trunks.delete() |
#Numeri
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Elenco numeri | GET /v1/numbers | numbers:read | numbers.list() |
| Aggiunge numero al pool | POST /v1/numbers | numbers:write | numbers.create() |
| Aggiunta massiva numeri | POST /v1/numbers/bulk | numbers:write | numbers.bulkCreate() · py: numbers.bulk_create() |
| Dettaglio numero | GET /v1/numbers/:id | numbers:read | numbers.get() |
| Destinazione e descrizione del numero | PATCH /v1/numbers/:id | numbers:write | numbers.update() |
| Rimuove numero dal pool (solo se libero) | DELETE /v1/numbers/:id | numbers:write | numbers.delete() |
| Assegna/libera numero e linea | PUT /v1/numbers/:id/assignment | numbers:write | numbers.assign() |
| Calendario e destinazione di chiusura del numero | GET /v1/numbers/:id/calendar | numbers:read | numbers.getCalendar() · py: numbers.get_calendar() |
| Assegna calendario e destinazione di chiusura al numero | PUT /v1/numbers/:id/calendar | numbers:write | numbers.setCalendar() · py: numbers.set_calendar() |
#Regole in entrata
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Elenco regole in entrata | GET /v1/inbound-routes | inbound_routes:read | inboundRoutes.list() · py: inbound_routes.list() |
| Crea regola in entrata | POST /v1/inbound-routes | inbound_routes:write | inboundRoutes.create() · py: inbound_routes.create() |
| Riordina priorità | PUT /v1/inbound-routes/order | inbound_routes:write | inboundRoutes.reorder() · py: inbound_routes.reorder() |
| Dettaglio regola | GET /v1/inbound-routes/:id | inbound_routes:read | inboundRoutes.get() · py: inbound_routes.get() |
| Modifica regola (steps sostituisce la catena) | PATCH /v1/inbound-routes/:id | inbound_routes:write | inboundRoutes.update() · py: inbound_routes.update() |
| Elimina regola | DELETE /v1/inbound-routes/:id | inbound_routes:write | inboundRoutes.delete() · py: inbound_routes.delete() |
#Regole di uscita
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Elenco regole di uscita | GET /v1/outbound-routes | outbound_routes:read | outboundRoutes.list() · py: outbound_routes.list() |
| Crea regola di uscita | POST /v1/outbound-routes | outbound_routes:write | outboundRoutes.create() · py: outbound_routes.create() |
| Riordina priorità | PUT /v1/outbound-routes/order | outbound_routes:write | outboundRoutes.reorder() · py: outbound_routes.reorder() |
| Blocchi chiamate per categoria | GET /v1/outbound-routes/policy | outbound_routes:read | outboundRoutes.getPolicy() · py: outbound_routes.get_policy() |
| Imposta blocchi per categoria e destinazioni di inoltro | PUT /v1/outbound-routes/policy | outbound_routes:write | outboundRoutes.setPolicy() · py: outbound_routes.set_policy() |
| Simula instradamento di un numero | POST /v1/outbound-routes/simulate | outbound_routes:read | outboundRoutes.simulate() · py: outbound_routes.simulate() |
| Dettaglio regola | GET /v1/outbound-routes/:id | outbound_routes:read | outboundRoutes.get() · py: outbound_routes.get() |
| Modifica regola | PATCH /v1/outbound-routes/:id | outbound_routes:write | outboundRoutes.update() · py: outbound_routes.update() |
| Elimina regola | DELETE /v1/outbound-routes/:id | outbound_routes:write | outboundRoutes.delete() · py: outbound_routes.delete() |
#Segreteria
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Impostazioni segreteria azienda | GET /v1/voicemail/settings | voicemail:read | voicemail.getSettings() · py: voicemail.get_settings() |
| Modifica impostazioni segreteria | PUT /v1/voicemail/settings | voicemail:write | voicemail.setSettings() · py: voicemail.set_settings() |
| Caselle segreteria | GET /v1/voicemail/boxes | voicemail:read | voicemail.listBoxes() · py: voicemail.list_boxes() |
| Casella di un interno | GET /v1/voicemail/boxes/:extensionId | voicemail:read | voicemail.getBox() · py: voicemail.get_box() |
| Modifica casella | PUT /v1/voicemail/boxes/:extensionId | voicemail:write | voicemail.updateBox() · py: voicemail.update_box() |
| Messaggi in segreteria | GET /v1/voicemail/boxes/:extensionId/messages | voicemail:read | voicemail.listMessages() · py: voicemail.list_messages() |
| Ascolto messaggio (audio/wav o audio/mpeg) | GET /v1/voicemail/boxes/:extensionId/messages/:messageId/audio | voicemail:read | voicemail.messageAudio() · py: voicemail.message_audio() |
| Sposta messaggio (letto/archiviato) | PATCH /v1/voicemail/boxes/:extensionId/messages/:messageId | voicemail:write | voicemail.updateMessage() · py: voicemail.update_message() |
| Elimina messaggio | DELETE /v1/voicemail/boxes/:extensionId/messages/:messageId | voicemail:write | voicemail.deleteMessage() · py: voicemail.delete_message() |
| Nome in rubrica, stato trascrizione ed email | GET /v1/voicemail/boxes/:extensionId/messages/:messageId/meta | voicemail:read | voicemail.messageMeta() · py: voicemail.message_meta() |
| Trascrizione del messaggio | GET /v1/voicemail/boxes/:extensionId/messages/:messageId/transcript | voicemail:read | voicemail.messageTranscript() · py: voicemail.message_transcript() |
| Richiede la trascrizione del messaggio | POST /v1/voicemail/boxes/:extensionId/messages/:messageId/transcribe | voicemail:write | voicemail.transcribeMessage() · py: voicemail.transcribe_message() |
| Reinvia l’email con audio e trascrizione | POST /v1/voicemail/boxes/:extensionId/messages/:messageId/email | voicemail:write | voicemail.resendEmail() · py: voicemail.resend_email() |
#Registro chiamate
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Registro chiamate (una voce per chiamata) | GET /v1/cdr | cdr:read | cdr.list() |
| Esporta CSV | GET /v1/cdr/export.csv | cdr:read | cdr.export() |
| Chiamata completa (tutte le tratte) | GET /v1/cdr/:linkedid | cdr:read | cdr.get() |
#Chiavi API
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Elenco chiavi API | GET /v1/api-keys | api_keys:read | apiKeys.list() · py: api_keys.list() |
| Crea chiave (segreto mostrato una volta) | POST /v1/api-keys | api_keys:write | apiKeys.create() · py: api_keys.create() |
| Dettaglio chiave | GET /v1/api-keys/:id | api_keys:read | apiKeys.get() · py: api_keys.get() |
| Modifica nome, scope, IP, scadenza | PATCH /v1/api-keys/:id | api_keys:write | apiKeys.update() · py: api_keys.update() |
| Rotazione con periodo di sovrapposizione | POST /v1/api-keys/:id/rotate | api_keys:write | apiKeys.rotate() · py: api_keys.rotate() |
| Revoca immediata | POST /v1/api-keys/:id/revoke | api_keys:write | apiKeys.revoke() · py: api_keys.revoke() |
| Log di utilizzo | GET /v1/api-keys/:id/usage | api_keys:read | apiKeys.usage() · py: api_keys.usage() |
| Consumi giornalieri (30 giorni) | GET /v1/api-keys/:id/usage/stats | api_keys:read | apiKeys.usageStats() · py: api_keys.usage_stats() |
#Sicurezza
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Riepilogo tentativi bloccati sugli interni dell’azienda | GET /v1/security/summary | extensions:read | security.summary() |
| Stato fail2ban/nftables/GeoIP e contatori | GET /v1/security/status | security:read | security.status() |
| IP bannati | GET /v1/security/bans | security:read | security.bans() |
| Ban manuale IP/subnet | POST /v1/security/bans | security:write | security.ban() |
| Sblocca IP | POST /v1/security/bans/unban | security:write | security.unban() |
| Parametri jail | GET /v1/security/jails | security:read | security.jails() |
| Modifica jail | PUT /v1/security/jails/:name | security:write | security.updateJail() · py: security.update_jail() |
| Paesi consentiti per servizio | GET /v1/security/geo | security:read | security.geo() |
| Modifica paesi consentiti | PUT /v1/security/geo/:service | security:write | security.updateGeo() · py: security.update_geo() |
| Whitelist | GET /v1/security/whitelist | security:read | security.whitelist() |
| Aggiunge eccezione (IP/rete o paese, anche temporanea) | POST /v1/security/whitelist | security:write | security.addWhitelist() · py: security.add_whitelist() |
| Rimuove eccezione | DELETE /v1/security/whitelist/:id | security:write | security.deleteWhitelist() · py: security.delete_whitelist() |
| Rate limit SIP, User-Agent bloccati, alert | GET /v1/security/settings | security:read | security.getSettings() · py: security.get_settings() |
| Modifica impostazioni sicurezza | PUT /v1/security/settings | security:write | security.setSettings() · py: security.set_settings() |
| Log sicurezza filtrabili | GET /v1/security/logs | security:read | security.logs() |
#Sistema
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Stato servizi, Asterisk, host, reload | GET /v1/system/status | system:read | system.status() |
| Accoda reload configurazione | POST /v1/system/reload | system:write | system.reload() |
| Storico reload | GET /v1/system/reload-jobs | system:read | system.reloadJobs() · py: system.reload_jobs() |
| Dettaglio reload | GET /v1/system/reload-jobs/:id | system:read | system.reloadJob() · py: system.reload_job() |
#Tempo reale
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Fotografia completa in tempo reale (chiamate, interni, linee, code, parcheggio, stato servizio) | GET /v1/live/snapshot | live:read | live.snapshot() |
| Chiamate in corso | GET /v1/live/channels | live:read | live.channels() |
| Stato interni (registrazione, disponibilità, dispositivi) | GET /v1/live/extensions | live:read | live.extensions() |
| Dispositivi registrati (IP, porta, trasporto, latenza, raggiungibilità) | GET /v1/live/devices | live:read | live.devices() |
| Stato linee (registrazione, raggiungibilità, chiamate attive) | GET /v1/live/trunks | live:read | live.trunks() |
| Code: chiamanti in attesa e stato operatori | GET /v1/live/queues | live:read | live.queues() |
| Stato del servizio (dettaglio tecnico solo piattaforma) | GET /v1/live/health | live:read | live.health() |
| Eventi in tempo reale (SSE), filtrabili con ?types= | GET /v1/live/events | live:read | live.stream() |
| Eventi in tempo reale (WebSocket), filtrabili con ?types= | GET /v1/live/ws | live:read | live.websocket() (TS) |
#Webhook
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Tipi di evento sottoscrivibili | GET /v1/webhooks/event-types | webhooks:read | webhooks.eventTypes() · py: webhooks.event_types() |
| Elenco webhook (piattaforma senza X-Tenant-Id) | GET /v1/webhooks | webhooks:read | webhooks.list() |
| Crea webhook (segreto di firma mostrato una sola volta) | POST /v1/webhooks | webhooks:write | webhooks.create() |
| Dettaglio webhook | GET /v1/webhooks/:id | webhooks:read | webhooks.get() |
| Modifica webhook | PATCH /v1/webhooks/:id | webhooks:write | webhooks.update() |
| Elimina webhook e storico invii | DELETE /v1/webhooks/:id | webhooks:write | webhooks.delete() |
| Nuovo segreto di firma (mostrato una sola volta) | POST /v1/webhooks/:id/rotate-secret | webhooks:write | webhooks.rotateSecret() · py: webhooks.rotate_secret() |
| Invio di prova (evento webhook.test) | POST /v1/webhooks/:id/test | webhooks:write | webhooks.test() |
| Registro invii (esito, codice risposta, tentativi) | GET /v1/webhooks/:id/deliveries | webhooks:read | webhooks.deliveries() |
| Nuovo invio di un evento già registrato | POST /v1/webhooks/:id/deliveries/:deliveryId/retry | webhooks:write | webhooks.redeliver() |
#Orari e chiusure
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Elenco calendari con stato corrente | GET /v1/calendars | calendars:read | calendars.list() |
| Crea calendario (festività nazionali precaricate) | POST /v1/calendars | calendars:write | calendars.create() |
| Anteprima festività di un anno e patroni disponibili | GET /v1/calendars/holidays | calendars:read | calendars.holidays() |
| Dettaglio calendario | GET /v1/calendars/:id | calendars:read | calendars.get() |
| Modifica calendario | PATCH /v1/calendars/:id | calendars:write | calendars.update() |
| Elimina calendario (IN_USE se assegnato) | DELETE /v1/calendars/:id | calendars:write | calendars.delete() |
| Sostituisce le fasce settimanali | PUT /v1/calendars/:id/hours | calendars:write | calendars.setHours() · py: calendars.set_hours() |
| Stato attuale e prossima transizione | GET /v1/calendars/:id/status | calendars:read | calendars.status() |
| Forza aperto/chiuso con scadenza | POST /v1/calendars/:id/force | calendars:write | calendars.force() |
| Ripristina orari automatici | DELETE /v1/calendars/:id/force | calendars:write | calendars.clearForce() · py: calendars.clear_force() |
| Storico forzature | GET /v1/calendars/:id/overrides | calendars:read | calendars.overrides() |
| Simulatore: cosa succede il giorno X all’ora Y | POST /v1/calendars/:id/simulate | calendars:read | calendars.simulate() |
| Carica festività nazionali e patrono | POST /v1/calendars/:id/holidays | calendars:write | calendars.preloadHolidays() · py: calendars.preload_holidays() |
| Eccezioni (chiusure e aperture straordinarie) | GET /v1/calendars/:id/exceptions | calendars:read | calendars.listExceptions() · py: calendars.list_exceptions() |
| Crea eccezione | POST /v1/calendars/:id/exceptions | calendars:write | calendars.createException() · py: calendars.create_exception() |
| Modifica eccezione | PATCH /v1/calendars/:id/exceptions/:exceptionId | calendars:write | calendars.updateException() · py: calendars.update_exception() |
| Elimina eccezione | DELETE /v1/calendars/:id/exceptions/:exceptionId | calendars:write | calendars.deleteException() · py: calendars.delete_exception() |
| Importa eventi iCal (file o indirizzo) | POST /v1/calendars/:id/ical/import | calendars:write | calendars.importIcal() · py: calendars.import_ical() |
| Esporta in formato iCal | GET /v1/calendars/:id/ical/export.ics | calendars:read | calendars.exportIcal() · py: calendars.export_ical() |
| Sincronizza ora dall’indirizzo iCal configurato | POST /v1/calendars/:id/ical/sync | calendars:write | calendars.syncIcal() · py: calendars.sync_ical() |
#Registrazioni
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Registrazioni (filtri e ricerca nelle trascrizioni) | GET /v1/recordings | recordings:read | recordings.list() |
| Conservazione, formato e permessi di ascolto | GET /v1/recordings/settings | recordings:read | recordings.getSettings() · py: recordings.get_settings() |
| Modifica impostazioni registrazioni | PUT /v1/recordings/settings | recordings:write | recordings.setSettings() · py: recordings.set_settings() |
| Regole di registrazione per livello | GET /v1/recordings/policies | recordings:read | recordings.listPolicies() · py: recordings.list_policies() |
| Regola effettiva per interno / numero / coda | GET /v1/recordings/policies/effective | recordings:read | recordings.effectivePolicy() · py: recordings.effective_policy() |
| Imposta la regola di un livello (targetId 0 = azienda) | PUT /v1/recordings/policies/:scope/:targetId | recordings:write | recordings.upsertPolicy() · py: recordings.upsert_policy() |
| Rimuove la regola (torna a ereditare) | DELETE /v1/recordings/policies/:scope/:targetId | recordings:write | recordings.deletePolicy() · py: recordings.delete_policy() |
| Registro ascolti, download e cancellazioni | GET /v1/recordings/access-log | recordings:write | recordings.accessLog() · py: recordings.access_log() |
| Dettaglio registrazione | GET /v1/recordings/:id | recordings:read | recordings.get() |
| Elimina registrazione (audit) | DELETE /v1/recordings/:id | recordings:write | recordings.delete() |
| Ascolto / download (registrato nel registro ascolti) | GET /v1/recordings/:id/audio | recordings:read | recordings.audio() |
| Trascrizione e riassunto | GET /v1/recordings/:id/transcript | recordings:read | recordings.transcript() |
| Richiede la trascrizione | POST /v1/recordings/:id/transcribe | recordings:write | recordings.transcribe() |
| Richiede il riassunto | POST /v1/recordings/:id/summarize | recordings:write | recordings.summarize() |
#Inoltro al cellulare
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Modalità di inoltro al cellulare | GET /v1/extensions/:id/invisible-forwarding | extensions:read | forwarding.get() |
| Imposta conferma / silenziosa / sussurro | PUT /v1/extensions/:id/invisible-forwarding | extensions:write | forwarding.update() |
| Deviazione presso il provider (solo Exobyte) | GET /v1/extensions/:id/provider-divert | tenants:write | forwarding.getProviderDivert() · py: forwarding.get_provider_divert() |
| Imposta deviazione presso il provider (solo Exobyte) | PUT /v1/extensions/:id/provider-divert | tenants:write | forwarding.setProviderDivert() · py: forwarding.set_provider_divert() |
#Notifiche
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Regole di notifica (superadmin senza azienda: piattaforma) | GET /v1/notifications/settings | notifications:read | notifications.getSettings() · py: notifications.get_settings() |
| Modifica regole di notifica | PUT /v1/notifications/settings | notifications:write | notifications.setSettings() · py: notifications.set_settings() |
| Registro notifiche inviate | GET /v1/notifications/log | notifications:read | notifications.log() |
| Invio di prova | POST /v1/notifications/test | notifications:write | notifications.test() |
#Lavori in corso
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Stato di un lavoro in background | GET /v1/jobs/:id | media:read | jobs.get() |
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Menu vocali | GET /v1/ivrs | ivrs:read | ivrs.list() |
| Crea menu vocale | POST /v1/ivrs | ivrs:write | ivrs.create() |
| Dettaglio menu vocale | GET /v1/ivrs/:id | ivrs:read | ivrs.get() |
| Modifica menu vocale (options sostituisce) | PATCH /v1/ivrs/:id | ivrs:write | ivrs.update() |
| Elimina menu vocale (IN_USE se usato) | DELETE /v1/ivrs/:id | ivrs:write | ivrs.delete() |
| Testo del messaggio suggerito dalle opzioni | POST /v1/ivrs/:id/greeting-text | ivrs:read | ivrs.greetingText() · py: ivrs.greeting_text() |
#Gruppi di squillo
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Gruppi di squillo | GET /v1/ring-groups | ring_groups:read | ringGroups.list() · py: ring_groups.list() |
| Crea gruppo di squillo | POST /v1/ring-groups | ring_groups:write | ringGroups.create() · py: ring_groups.create() |
| Dettaglio gruppo | GET /v1/ring-groups/:id | ring_groups:read | ringGroups.get() · py: ring_groups.get() |
| Modifica gruppo | PATCH /v1/ring-groups/:id | ring_groups:write | ringGroups.update() · py: ring_groups.update() |
| Elimina gruppo (IN_USE se usato) | DELETE /v1/ring-groups/:id | ring_groups:write | ringGroups.delete() · py: ring_groups.delete() |
#Code
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Code | GET /v1/queues | queues:read | queues.list() |
| Crea coda | POST /v1/queues | queues:write | queues.create() |
| Dettaglio coda | GET /v1/queues/:id | queues:read | queues.get() |
| Modifica coda (members sostituisce) | PATCH /v1/queues/:id | queues:write | queues.update() |
| Elimina coda (IN_USE se usata) | DELETE /v1/queues/:id | queues:write | queues.delete() |
| Chiamanti in attesa e stato operatori | GET /v1/queues/:id/live | live:read | queues.live() |
| Pausa / ripresa operatore | PUT /v1/queues/:id/members/:extensionId/pause | queues:write | queues.pauseMember() · py: queues.pause_member() |
| Richiamate richieste dai chiamanti | GET /v1/queues/:id/callbacks | queues:read | queues.callbacks() |
#Musica d’attesa
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Classi musica d’attesa (azienda + Exobyte) | GET /v1/moh | media:read | moh.list() |
| Crea classe musica d’attesa | POST /v1/moh | media:write | moh.create() |
| Dettaglio classe | GET /v1/moh/:id | media:read | moh.get() |
| Modifica classe (tracce e annunci) | PATCH /v1/moh/:id | media:write | moh.update() |
| Elimina classe (IN_USE se usata) | DELETE /v1/moh/:id | media:write | moh.delete() |
#Messaggi vocali
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Messaggi vocali e tracce | GET /v1/prompts | media:read | prompts.list() |
| Crea messaggio da testo (voce AI o provvisorio) | POST /v1/prompts | media:write | prompts.createTts() · py: prompts.create_tts() |
| Carica audio (normalizzato e convertito) | POST /v1/prompts/upload | media:write | prompts.upload() |
| Dettaglio messaggio | GET /v1/prompts/:id | media:read | prompts.get() |
| Modifica testo / voce (rigenera) | PATCH /v1/prompts/:id | media:write | prompts.update() |
| Elimina messaggio (IN_USE se usato) | DELETE /v1/prompts/:id | media:write | prompts.delete() |
| Rigenera l’audio | POST /v1/prompts/:id/generate | media:write | prompts.generate() |
| Anteprima audio | GET /v1/prompts/:id/audio | media:read | prompts.audio() |
#Rubrica
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Rubrica aziendale e personale | GET /v1/contacts | contacts:read | contacts.list() |
| Crea contatto | POST /v1/contacts | contacts:write | contacts.create() |
| Ricerca per numero (nome sul display) | GET /v1/contacts/lookup | contacts:read | contacts.lookup() |
| Importa CSV / vCard | POST /v1/contacts/import | contacts:write | contacts.import() |
| Esporta CSV / vCard | GET /v1/contacts/export | contacts:read | contacts.export() |
| Impostazioni ricerca nome e blacklist | GET /v1/contacts/settings | contacts:read | contacts.getSettings() · py: contacts.get_settings() |
| Modifica impostazioni rubrica | PUT /v1/contacts/settings | contacts:write | contacts.setSettings() · py: contacts.set_settings() |
| Dettaglio contatto | GET /v1/contacts/:id | contacts:read | contacts.get() |
| Modifica contatto (numbers sostituisce) | PATCH /v1/contacts/:id | contacts:write | contacts.update() |
| Elimina contatto | DELETE /v1/contacts/:id | contacts:write | contacts.delete() |
#Operatività
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Stato backup, firewall, lavori in background e servizi esterni | GET /v1/ops/status | system:read | ops.status() |
#voiceNodes
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Server voce collegati e stato | GET /v1/voice-nodes | system:read | voiceNodes.list() · py: voice_nodes.list() |
| Aggiunge un server voce (codice di attivazione mostrato una volta) | POST /v1/voice-nodes | system:write | voiceNodes.create() · py: voice_nodes.create() |
| Dettaglio server voce | GET /v1/voice-nodes/:id | system:read | voiceNodes.get() · py: voice_nodes.get() |
| Modifica nome, host SIP, note | PATCH /v1/voice-nodes/:id | system:write | voiceNodes.update() · py: voice_nodes.update() |
| Elimina server voce (solo senza aziende assegnate) | DELETE /v1/voice-nodes/:id | system:write | voiceNodes.delete() · py: voice_nodes.delete() |
| Nuovo codice di attivazione (installazione o reinstallazione) | POST /v1/voice-nodes/:id/enrollment-code | system:write | voiceNodes.enrollmentCode() · py: voice_nodes.enrollment_code() |
| Disattiva il server voce e ne revoca le credenziali | POST /v1/voice-nodes/:id/revoke | system:write | voiceNodes.revoke() · py: voice_nodes.revoke() |
#voices
| Descrizione | Richiesta | Scope | Metodo SDK |
|---|
| Voci disponibili (la predefinita per prima) | GET /v1/voices | media:read | voices.list() |
| Aggiorna subito il catalogo delle voci | POST /v1/voices/sync | system:write | voices.sync() |
| Voce predefinita dell’azienda (null = quella della piattaforma) | PUT /v1/voices/default | media:write | voices.setTenantDefault() · py: voices.set_tenant_default() |
| Voce predefinita della piattaforma | PUT /v1/voices/platform-default | system:write | voices.setPlatformDefault() · py: voices.set_platform_default() |
| Ascolto di esempio della voce (mp3) | GET /v1/voices/:voiceId/preview | media:read | voices.preview() |
| Ascolta la voce con un testo a scelta (max 200 caratteri, prove giornaliere limitate) | POST /v1/voices/:voiceId/sample | media:write | voices.sample() |
