Integrazione REST API: introduzione
La REST API del Contact Center è un insieme di interfacce web che consente a clienti e partner di interagire in modo programmatico con i dati e le operazioni del Contact Center e di gestirli. Permette a sistemi esterni come piattaforme CRM, strumenti di reportistica o applicazioni personalizzate di integrarsi con il Contact Center senza interventi manuali nel portale di amministrazione.
La REST API usa i metodi HTTP standard e restituisce risposte strutturate, ed è quindi adatta ad automazioni, integrazioni ed estensioni delle funzionalità del Contact Center.
Funzioni principali
Sezione intitolata “Funzioni principali”La REST API del Contact Center dà accesso a diverse funzioni operative e amministrative, tra cui:
- Gestione degli agenti: recupero delle informazioni sugli agenti, delle loro competenze (skill) e dei gruppi di competenze combinati, e assegnazione delle competenze agli agenti in modo programmatico.
- Notifiche dinamiche: gestione degli endpoint delle notifiche dinamiche, che permettono di filtrare i contatti in base a parametri come nome dell’elenco, data di creazione e data di consegna.
- Integrazione ed estensibilità: integrazione dei dati del Contact Center con sistemi di terze parti come piattaforme CRM, strumenti di analisi e applicazioni aziendali interne.
- Supporto ad automazione e rilascio: supporto a flussi di lavoro e rilasci automatizzati nei diversi ambienti, inclusi sviluppo, QA, pre-produzione e produzione.
Accesso all’API e autenticazione
Sezione intitolata “Accesso all’API e autenticazione”Per accedere alla REST API del Contact Center serve un token di accesso.
I token di accesso si generano nel portale di amministrazione del Contact Center e servono ad autorizzare le richieste API. È consentito un solo token attivo alla volta: generando un nuovo token, il precedente viene revocato automaticamente. I token scadono se non vengono usati per sei mesi.
Per generare un token di accesso, andare in: portale di amministrazione del Contact Center > Integrations > REST API
Documentazione dell’API
Sezione intitolata “Documentazione dell’API”La REST API del Contact Center dispone di una documentazione basata su Swagger, con informazioni dettagliate sugli endpoint disponibili, sui parametri richiesti e con esempi di richieste e risposte.
Per essere certi di usare l’URL di base corretto per il proprio account, aprire la documentazione dell’API dall’interno del portale di amministrazione del Contact Center:
portale di amministrazione del Contact Center > Integrations > REST API
Questa pagina mostra l’URL di base dell’API corretto per l’account e dà accesso diretto all’interfaccia Swagger del proprio ambiente.
Ambienti supportati
Sezione intitolata “Ambienti supportati”La REST API pubblica è disponibile in più ambienti, ad esempio:
- sviluppo (DEV);
- controllo qualità (QA);
- pre-produzione;
- produzione (Prod).
In questo modo clienti e partner possono testare le integrazioni in sicurezza prima di portarle in produzione.
Supporto dei caratteri speciali
Sezione intitolata “Supporto dei caratteri speciali”L’API supporta i caratteri speciali nelle notifiche dinamiche, per una maggiore flessibilità nella configurazione delle notifiche tramite integrazioni basate su API.