Domande frequenti sulle API di Social Connect

Generale

Come si abilita l’account sviluppatore?

Per accedere all’API e alle funzionalità correlate, è necessario prima abilitare l’account sviluppatore. Per ulteriori informazioni, consultare Personal Settings Preferences.

Come posso iniziare a utilizzare l’API Social Connect?

Consulta la guida passo-passo Qualtrics Social Connect API.

Di che tipo di account ho bisogno per utilizzare l’API Social Connect?

L’accesso all’API non è incluso in tutti i piani tariffari. Contatta il Supporto in caso di domande su ciò che è incluso nella tua licenza.

Hai una libreria client nel linguaggio di programmazione x?

Qualtrics non offre librerie client, ma le librerie per il protocollo OAuth esistono in quasi tutte le lingue, vedere http://oauth.net/code/.

Posso testare rapidamente l’API?

È possibile testare l’API tramite la console API. Qui si seleziona un punto finale e si compilano i parametri richiesti. Verrà visualizzato un risultato immediato per vedere se l’API ha prodotto il risultato desiderato.

È possibile aumentare i limiti di velocità dell’API?

Vedere Limitazione tariffe per una panoramica dei limiti dei tassi API. I nostri attuali limiti tariffari sono più che sufficienti per i casi di utilizzo standard. Se, tuttavia, sono necessari limiti tariffari aggiuntivi, contattare il Supporto e descrivere il caso di utilizzo della domanda e i limiti di tariffa richiesti.

Come funziona il filtraggio nell’API?

Diversi punti finali dell’API Social Connect consentono di trasmettere un parametro stringa filtro.

Ad esempio, supponiamo che si stia recuperando una lista di menzioni. È possibile filtrare le menzioni in modo che vengano restituite solo le menzioni con un determinato tag.

Il parametro di filtro è sempre una stringa. La sua sintassi supporta la ricerca di diverse proprietà dei dati (parole menzionate, tag, stato, tempo di risoluzione, …) e la loro combinazione utilizzando una sintassi booleana e nidificata.

Quando si crea un filtro nella piattaforma Social Connect, il filtro ha una rappresentazione testuale associata. Questa rappresentazione apparirà nella finestra del filtro dopo aver selezionato i campi di filtro. È possibile copiare questo parametro per utilizzarlo nelle chiamate API.

Quale metodo viene utilizzato per la firma di webhook?

Per ulteriori informazioni, consultare Webhooks.

Perché la tariffa è limitata a 20 chiamate API all’ora?

Se si utilizza la console API, il limite di frequenza è di 20 chiamate autenticate all’ora, invece delle 350 chiamate standard all’ora per altri client API. Se si verifica questo limite di 20 chiamate, assicurarsi di utilizzare il token di accesso per l’applicazione API, non la console API.

Autenticazione API

Come vengono autenticate le chiamate API?

Qualtrics utilizza il protocollo OAuth 2.0 standard. Vedere Autenticazione per ulteriori informazioni.

Devo davvero implementare OAuth per la mia applicazione?

Se non hai bisogno degli utenti della tua applicazione per autenticare il loro account Qualtrics Social Connect, puoi invece generare un token OAuth per il tuo account utente. Passare al riepilogo dell’applicazione, fare clic su Modifica accanto all’applicazione registrata e passare alla scheda Tokens di accesso. Se si fa clic su Autorizza me stesso, verrà generato un token di accesso per l’utente attualmente connesso (con le relative autorizzazioni). È possibile utilizzare questo token di accesso per firmare le richieste API.

Per quanto tempo sono validi i token di accesso?

Consultare la pagina Autenticazione per ulteriori informazioni.

A quali account e dati è possibile accedere con un token?

Viene generato un token di accesso OAuth per uno specifico utente Social Connect. Questo utente ha accesso a uno o più account (puoi vedere quali tramite l’endpoint `/me/account`). I dati a cui è possibile accedere dipendono dagli account a cui l’utente stesso ha accesso e dal ruolo dell’utente in quell’account.

Utilizzo delle menzioni

Come ottengo le menzioni dalla mia casella di posta in entrata Social Connect nella mia applicazione?

Utilizza l’endpoint `/{account_id}/inbox/menions` per recuperare tutte le menzioni in uno qualsiasi dei tuoi argomenti. Questa pagina di supporto API descrive quali informazioni vengono recuperate per le tue menzioni.

È anche possibile progettare un workflow per chiamare gli hook Web nella propria applicazione utilizzando la funzionalità della ricetta di automazione Social Connect.

Perché i Tweet restituiti dall’API mancano di dettagli?

Per i Tweet, Qualtrics può restituire solo i dati specifici di Social Connect e l’ID tweet di Twitter. Si tratta di una restrizione contenuta nei Termini API di Twitter.

Poiché si dispone dell’ID tweet, è possibile accedere all’API Twitter e utilizzare il punto finale “/status/lookup” per recuperare tutti i dettagli.

Perché alcuni post di Facebook sono anonimi?

I post di Facebook pubblici (raccolti da Social Connect attraverso la ricerca delle parole chiave, non i messaggi sulle tue pagine Facebook) vengono resi anonimi. Si tratta di una limitazione derivante dall’API di Facebook.

Posso aggiungere i miei messaggi a Social Connect?

Se si dispone di un modulo di contatto o di un forum interno che si desidera vedere monitorato da Social Connect, è possibile chiamare il punto finale “/{account_id}/inbox/add” per aggiungere i messaggi personalizzati a Social Connect. Questi messaggi saranno quindi accessibili nella Posta in arrivo e nelle analisi.

Non è possibile rispondere ai messaggi aggiunti a Social Connect tramite l’API all’interno di Social Connect Se desideri una maggiore integrazione con il tuo sistema personalizzato, contatta l’assistenza.

Posso esportare casi tramite l’API?

È possibile utilizzare l’endpoint di menzione standard (elenco di esportazione/aggiornamento di una singola menzione) per esportare i casi. Se si intende restituire solo casi nella richiesta, è possibile utilizzare il filtro ‘sottocategoria:caso’.

Qual è la differenza tra casi e menzioni per l’API?

In Social Connect una “menzione” è l’oggetto centrale di un messaggio (un singolo tweet, un singolo messaggio privato, un singolo commento). C’è anche il concetto di “Caso” che fondamentalmente è una raccolta di menzioni.

L’utilizzo principale per i casi è raggruppare diversi messaggi di un determinato utente e le risposte degli agenti in conversazioni.

Da un punto di vista tecnico, una “conversazione sul caso” consiste in:

• Il caso stesso (che è anche un oggetto di menzione).
• Un caso può avere etichette, uno stato, un titolo, ecc.
• Un elenco di menzioni che fanno parte della conversazione.
• Le menzioni che sono state raggruppate nel caso.

Consulta questa pagina di supporto API per maggiori informazioni su casi e menzioni.

È possibile importare messaggi nell’uscita Social Connect?

È possibile creare bozze di nuovi post per i social manager per verificare, elaborare e pubblicare tramite il punto finale “/{account_id}/publisher/add”.

Posso modificare una menzione tramite l’API?

È possibile elaborare le menzioni esistenti utilizzando il punto finale “/{account_id}/inbox/menzione/{topic_id}/{id}”. La documentazione per questo punto finale contiene esempi per l’aggiornamento dei tag di una menzione, l’aggiunta di una nota e altro ancora.

Come si eliminano tutti i dati di un determinato utente in Engage tramite l’API?

Se si intende eliminare tutti i dati di un determinato cliente presente nel proprio account Social Connect, è necessario eliminare due tipi di dati:

1. Tutte le menzioni di quell’utente nel sistema
2. Tutte le informazioni relative all’utente memorizzate nel CRM Social Connect.

Per trovare tutte le menzioni di un determinato utente, utilizzare il punto finale “/{account_id}/inbox/menions” e filtrare in base a un determinato authorID, ad es. “author.id:123”.Una volta ottenuta la lista di menzioni, queste possono essere eliminate tramite il punto finale “/{account_id}/inbox/menzione/{topic_id}/{id}”.

Per sapere se i propri agenti hanno salvato più dati di contatto nel CRM Social Connect per un contatto, effettuare una richiesta GET a “/{account_id}/inbox/contact/{service}/{service_id}”. Se l’oggetto risposta contiene un contact.id, significa che esiste un contatto per questo utente. Se la risposta non contiene una proprietà contact.id, significa che non sono stati memorizzati dati nel Social Connect CRM.

Una volta ottenuto un contact.id, è possibile eseguire una richiesta DELETE al punto finale /{account_id}/inbox/contact/{contact_id} per rimuovere tutte le informazioni.

Utilizzo dei contatti  ​

Come posso trovare i dettagli di contatto da una menzione o da un caso?

Se una menzione o un caso viene restituito dall’API, conterrà un elenco di oggetti “action_link”. I collegamenti alle azioni contengono informazioni per l’oggetto corrente su quali altri endpoint o URL API dell’applicazione Web sono rilevanti per questo oggetto. Per menzioni e casi, uno dei link all’azione inclusi è il punto in cui è possibile recuperare i dettagli di contatto dell’autore della menzione o del caso.

Quando si utilizza il punto finale /{account_id}/inbox/casi, l’oggetto contatto dell’autore della menzione viene incluso di default. Qualtrics non include l’oggetto contatto completo per le menzioni, ma tramite i collegamenti dell’azione questo oggetto può essere recuperato eseguendo una chiamata API separata.

Pubblicazione

Posso utilizzare l’API Clarabridge Engage per pubblicare su un canale social?

No, l’API non consente la pubblicazione diretta su piattaforme di terze parti. Ciò significa che non è possibile utilizzare l’API Social Connect per pubblicare un tweet o un commento Facebook.

Tuttavia, è possibile utilizzare l’API Social Connect per creare bozze o messaggi di coda per l’approvazione. Questi verranno poi pubblicati quando approvati o pubblicati tramite l’interfaccia Social Connect. Il punto finale per i messaggi in bozza è /{account_id}/publisher/add.

Gestione utenti

È possibile modificare lo stato degli utenti tramite l’API?

No, non è possibile modificare lo stato degli utenti tramite API. Sebbene non sia possibile modificare lo stato, è possibile modificare il nome, la società, l’e-mail, l’avatar e l’orario di lavoro tramite l’endpoint /{account_id}/settings/user/{id}.

È possibile modificare il ruolo utente degli utenti tramite l’API?

È possibile modificare il ruolo utente di un utente tramite la nostra API. Tuttavia, per motivi di sicurezza non è possibile modificare un ruolo utente in Amministratore. Tutti gli altri ruoli utente sono disponibili per la modifica in tramite l’endpoint /{account_id}/settings/user/{id}.

È possibile creare nuovi utenti tramite l’API?

Per motivi di sicurezza ciò non è possibile tramite API.

Utilizzo dei profili dei social media

È possibile recuperare informazioni sui profili social nei miei argomenti?

È possibile chiamare informazioni su un determinato profilo sociale tramite il punto finale “/{account_id}/inbox/contact/{service}/{service_id}”. Questo includerà tutti i dettagli inseriti per quella persona all’interno del CRM Social Connect, come genere, e-mail o attributi personalizzati aggiunti per questo utente.

Utilizzo delle analisi

Posso ottenere statistiche da Clarabridge Engage?

È possibile estrarre i dati da Insights utilizzando 2 diversi endpoint API;

1. Il punto finale “/{account_id}/dashboards/export/{dashboard_id}” restituisce i dati di tutti i widget in un determinato dashboard. Una volta che gli utenti hanno configurato dashboard personalizzati, è possibile utilizzare questo endpoint per ottenere i dati sottostanti.
2. Il punto finale “/{account_id}/Insights/facet” funge da equivalente API della funzionalità Chart Builder in Social Connect.

Problemi

Dove posso trovare il mio ID account?

Una volta autenticati, è possibile ottenere un elenco di tutti gli account (e dei relativi ID) a cui un utente ha accesso tramite il punto finale “/me/account”.

Dove posso trovare il mio ID argomento?

Una volta autenticati, è possibile ottenere un elenco di tutti gli argomenti (e i relativi ID) a cui un utente ha accesso tramite l’endpoint “/me/account”.

Dove posso trovare il mio ID utente?

Una volta autenticato, è possibile ottenere dettagli sull’utente di autenticazione (incluso il suo ID) tramite l’endpoint “/me”.