Modello di articolo

Generale

Come faccio ad abilitare il mio account di sviluppatore?

Per accedere alle API e alle funzioni correlate, è necessario prima abilitare l’account sviluppatore. Per ulteriori informazioni, vedere Preferenze delle impostazioni personali.

Come posso iniziare a utilizzare le API di Social Connect?

Consultate la guida passo-passo di QUALTRICS Social Connect API.

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

L’accessibilità alle API non è inclusa in tutti i piani tariffari. Contattate il Supporto se avete domande su ciò che è incluso nella vostra licenza.

Avete una libreria client in un linguaggio di programmazione x?

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

Posso testare rapidamente l’API?

È possibile testare l’API tramite la console API. Qui si sceglierà un endpoint e si inseriranno i parametri richiesti. Verrà visualizzato un risultato immediato per verificare se l’API ha prodotto il risultato desiderato.

È possibile aumentare i limiti della velocità API?

Per una panoramica sui limiti di velocità di Api, vedere Limitazione della velocità. I nostri limiti tariffari attuali sono più che sufficienti per i casi d’uso standard. Se tuttavia avete bisogno di limiti tariffari aggiuntivi, contattate il Contatto e descrivete il caso d’uso della vostra applicazione e i limiti tariffari richiesti.

Come funziona il filtro nelle API?

Diversi endpoint dell’API di Social Connect consentono di passare un parametro di stringa di filtro.

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

Il parametro 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 costruisce 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 del filtro. È possibile copiare questo parametro per utilizzarlo nelle chiamate API.

Quale metodo viene utilizzato per firmare i webhook?

Per ulteriori informazioni, vedere Webhooks.

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

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

Autenticità API

Come vengono autenticate le chiamate API?

Qualtrics utilizza il protocollo standard OAuth 2.0. Per ulteriori informazioni, vedere Autenticazione.

Ho davvero bisogno di implementare OAuth per la mia applicazione?

Se non avete bisogno che gli utenti della vostra applicazione si autenticano con il loro account di Qualtrics Social Connect, potete invece generare un token OAuth per il vostro account utente. Accedere alla panoramica delle applicazioni, fare clic su Modifica avanti alla propria applicazione registrata, andare alla scheda Gettoni di accesso. Se si fa clic su Autorizza me stesso, verrà generato un token di accesso per l’utente attualmente collegato (con le relative autorizzazioni). È possibile utilizzare questo token di accesso per firmare le richieste API.

Per quanto tempo sono validi i token di accessibilità?

Per ulteriori informazioni, consultare la pagina Autenticatore.

A quali account e dati posso accedere con un token?

Un token di accesso OAuth viene generato per un utente specifico di Social Connect. Questo utente ha accesso a uno o più account (si possono vedere quali tramite l’endpoint `me/accounts`). I dati a cui si può accedere dipendono dagli account a cui l’utente stesso ha accesso e dal ruolo che ricopre in quell’account.

Lavorare con le menzioni

Come faccio a inserire le menzioni dalla casella di posta elettronica di Social Connect nella mia applicazione?

Utilizzare l’endpoint `/{account_id}/inbox/mentions` per recuperare tutte le menzioni in qualsiasi argomento. Questa pagina di supporto API spiega quali informazioni vengono recuperate per le vostre menzioni.

Si può anche progettare un flusso di lavoro per richiamare i ganci web nella propria applicazione, utilizzando la funzione di ricetta di automazione di Social Connect.

Perché i tweet restituiti dall’API sono privi di dettagli?

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

Poiché si dispone dell’ID del tweet, è possibile accedere all’API di Twitter e utilizzare l’endpoint “/statuses/lookup” per recuperare tutti i dettagli.

Perché alcuni post di Facebook sono anonimi?

I post pubblici di Facebook (raccolti da Social Connect attraverso la ricerca di parole chiave, non i messaggi sulle vostre pagine Facebook) sono anonimizzati. Si tratta di una limitazione dell’API di Facebook.

Posso aggiungere i miei messaggi a Social Connect?

Se avete un modulo di contatto o un forum interno che volete vedere monitorato da Social Contact, potete chiamare l’endpoint “/{account_id}/inbox/add” per aggiungere i vostri messaggi personalizzati a Social Contact. Questi messaggi saranno quindi accessibili nella casella di posta e negli approfondimenti.

I messaggi aggiunti a Social Connect tramite l’API non possono essere replicati dall’interno di Social Connect Se desiderate avere questa integrazione più stretta con il vostro sistema personalizzato, contattate l’assistenza.

È possibile esportare i casi tramite l’API?

Per esportare i casi è possibile utilizzare il normale endpoint delle menzioni (esporta lista / aggiorna singola menzione). Se si desidera restituire solo i casi nella richiesta, è possibile utilizzare il filtro ‘sub_category:case’.

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). Esiste anche il concetto di “Caso”, che è fondamentalmente un insieme di menzioni.

L’uso principale dei casi è quello di raggruppare in conversazioni diversi messaggi di un certo utente e le risposte degli agenti.

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

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

Per ulteriori informazioni su casi e menzioni, consultare la pagina di supporto API.

Posso importare i messaggi nella posta in uscita di Social Connect?

È possibile creare bozze di nuovi post che i social manager potranno verificare, modificare e pubblicare attraverso l’endpoint “/{account_id}/publisher/add”.

Posso modificare una menzione tramite l’API?

È possibile modificare le menzioni esistenti utilizzando l’endpoint “/{account_id}/inbox/mention/{topic_id}/{id}”. La documentazione di questo endpoint contiene esempi per aggiornare i tag di una menzione, aggiungere una nota e altro ancora.

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

Se si desidera eliminare tutti i dati di un determinato cliente presenti nell’account di Social Connect, è necessario eliminare due tipi di dati:

1. Tutte le menzioni di quell’utente nel sistema
2. Qualsiasi informazione sull’utente memorizzata nel CRM di Social Connect.

Per trovare tutte le menzioni di un determinato utente, utilizzare l’endpoint “/{account_id}/inbox/mentions” e filtrare per un determinato authorID, ad esempio “author.id:123”. Una volta ottenuta la lista di menzioni, queste possono essere eliminate tramite l’endpoint “/{account_id}/inbox/mention/{topic_id}/{id}”.

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

Una volta ottenuto l’id del contatto, è possibile eseguire una richiesta DELETE all’endpoint /{account_id}/inbox/contact/{contact_id} per rimuovere tutte le informazioni.

Lavorare con i contatti ​

Come posso trovare i contatti di una menzione o di un caso?

Se l ‘API restituisce una menzione o un caso, questo conterrà una lista di oggetti “action_link”. I link all’azione contengono informazioni sull’oggetto corrente, su quali altri endpoint API o URL dell’applicazione web sono rilevanti per questo oggetto. Per le menzioni e i casi, uno dei link di azione inclusi consente di ottenere i contatti dell’autore della menzione o del caso.

Quando si utilizza l’endpoint /{account_id}/inbox/cases, l’oggetto Contatto dell’autore della menzione viene incluso per impostazione predefinita. Qualtrics non include l’oggetto contatto completo per le menzioni, ma tramite i link alle azioni questo oggetto può essere recuperato con una chiamata API separata.

Pubblicazioni

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

No, le API non consentono di pubblicare direttamente su piattaforme di terze parti. Ciò significa che non è possibile utilizzare la Social Connect API per pubblicare un tweet o un commento su Facebook.

Tuttavia, è possibile utilizzare l’API di Social Connect per creare api o mettere in coda i messaggi per l’approvazione. Questi saranno poi pubblicati una volta approvati o pubblicati attraverso l’interfaccia di Social Connect. L’endpoint per la bozza dei messaggi è /{account_id}/publisher/add.

Manager

È possibile modificare lo stato degli utenti tramite API?

No, non è possibile modificare lo stato degli utenti tramite API. Mentre non è 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 degli utenti tramite API?

È possibile modificare il ruolo di un utente tramite le nostre API. Tuttavia, per motivi di sicurezza non è possibile cambiare il ruolo di un utente in Amministrazione. Tutti gli altri ruoli utente possono essere modificati tramite l’endpoint /{account_id}/settings/user/{id}.

Posso creare nuovi utenti tramite l’API?

Per motivi di sicurezza non è possibile farlo tramite API.

Lavorare con i profili sociali

È possibile recuperare informazioni sui profili sociali nei miei argomenti?

È possibile recuperare informazioni su un determinato profilo sociale tramite l’endpoint “/{account_id}/inbox/contatto/{service}/{service_id}”. Questo includerà tutti i dettagli compilati per quella persona all’interno del CRM Social Connect, come il sesso, l’e-mail o gli attributi personalizzati aggiunti per questo utente.

Lavorare con le intuizioni

Posso ottenere statistiche da Clarabridge Engage?

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

1. L’endpoint “/{account_id}/dashboards/export/{dashboard_id}” restituisce i dati di tutti i widget di una determinata dashboard. Una volta che voi o i vostri utenti avete impostato dashboard personalizzati, potete usare questo endpoint per ottenere i dati che li sottendono.
2. L’endpoint “/{account_id}/insights/facets” è l’equivalente API della funzione Chart Builder di Social Connect.

Problemi

Dove posso trovare l’id del mio account?

Una volta autenticati, si può ottenere una lista di tutti gli account (e dei loro id) a cui un utente ha accesso tramite l’endpoint “/me/accounts”.

Dove posso trovare il mio ID argomento?

Una volta autenticati, si può ottenere una lista di tutti gli argomenti (e dei loro id) a cui un utente ha accesso tramite l’endpoint “/me/accounts”.

Dove posso trovare il mio ID utente?

Una volta effettuata l’autenticazione, è possibile ottenere i dettagli sull’utente che si è autenticato (compreso il suo id) tramite l’endpoint “/me”.