Preguntas frecuentes sobre API de conexión a redes sociales

General

¿Cómo activo mi cuenta de desarrollador?

Para acceder a la API y a las funciones relacionadas, primero debe activar la cuenta de desarrollador. Consulte Parametrizaciones personales Preferencias para obtener más información.

¿Cómo empiezo con la API de Social Connect?

Consulte la guía paso a paso de la API de conexión social de Qualtrics.

¿Qué tipo de cuenta necesito para utilizar la API de Social Connect?

El acceso a la API no está incluido en todos los planes de determinación de precios. Póngase en contacto con el servicio de asistencia de si tiene preguntas sobre lo que incluye su licencia.

¿Tienes una biblioteca cliente en lenguaje de programación x?

Qualtrics no ofrece bibliotecas de clientes, pero las bibliotecas para el protocolo OAuth existen en casi todos los idiomas, consulte http://oauth.net/code/.

¿Puedo probar rápidamente la API?

Puede probar la API a través de la consola de API. Aquí, seleccionará un punto final y rellenará los parámetros necesarios. Aparecerá un resultado inmediato para que vea si la API resultó en el resultado deseado.

¿Se pueden aumentar los límites de la tasa de API?

Consulte Limitación de tarifa para obtener un resumen de los límites de tasa de API. Nuestros límites de tarifas actuales son más que suficientes para los casos de uso estándar. Sin embargo, si necesita límites de tarifa adicionales, póngase en contacto con el servicio de asistencia de y describa el caso de uso de su aplicación y los límites de tarifa solicitados.

¿Cómo funciona el filtrado en la API?

Varios puntos finales de la API de conexión social le permiten pasar un parámetro de cadena de filtro.

Por ejemplo, supongamos que está obteniendo una lista de menciones. Puede filtrar las menciones para que solo se devuelvan menciones con una determinada etiqueta.

El parámetro de filtro siempre es una cadena. Su sintaxis admite la búsqueda de varias propiedades de los datos (palabras mencionadas, etiquetas, estado, tiempo de resolución, etc.) y combinarlas mediante una sintaxis booleana y anidada.

Cuando crea un filtro en la plataforma Social Connect, el filtro tiene una representación textual asociada. Esta representación aparecerá en la ventana de filtro después de seleccionar los campos de filtro. Puede copiar este parámetro para utilizarlo en sus llamadas API.

¿Qué método se utiliza para firmar webhooks?

Consulte Webhooks para obtener más información.

¿Por qué la tarifa está limitada a 20 llamadas API por hora?

Si se utiliza la Consola API, el límite de tasa es de 20 llamadas autenticadas por hora, en lugar de las 350 llamadas estándar por hora para otros clientes de API. Si está experimentando este límite de 20 llamadas, asegúrese de utilizar el token de acceso para su aplicación API, no la Consola API.

Autenticación de API

¿Cómo se autentican las llamadas a la API?

Qualtrics utiliza el protocolo estándar OAuth 2.0. Consulte Autenticación para obtener más información.

¿Realmente necesito implementar OAuth para mi aplicación?

Si no necesita que los usuarios de su aplicación autentiquen su cuenta de Qualtrics Social Connect, puede generar un token OAuth para su propia cuenta de usuario. Vaya al resumen de la aplicación, haga clic en Editar junto a la aplicación registrada y vaya a la pestaña Tokens de acceso. Si hace clic en Autorizar a sí mismo, se generará un token de acceso para su usuario conectado actualmente (con sus permisos). Puede utilizar este token de acceso para firmar solicitudes de API.

¿Durante cuánto tiempo son válidos los tokens de acceso?

Consulte la página Autenticación para obtener más información.

¿A qué cuentas y datos puedo acceder con un token?

Se genera un token de acceso OAuth para un usuario de Social Connect específico. Este usuario tiene acceso a una o más cuentas (puede ver cuáles a través del punto final `/me/cuentas`). Los datos a los que puede acceder dependen de a qué cuentas tiene acceso el propio usuario y cuál es su función de usuario en esa cuenta.

Trabajar con menciones

¿Cómo puedo obtener menciones de mi bandeja de entrada de Social Connect en mi propia aplicación?

Utilice el extremo `/{account_id}/inbox/mentions` para recuperar todas las menciones de cualquiera de sus temas. Esta página de soporte de API cubre qué información se recupera para sus menciones.

También puede diseñar un flujo de trabajo para llamar enlaces web en su aplicación mediante la función de receta de automatización de Social Connect.

¿Por qué faltan detalles en los Tweets devueltos por la API?

En el caso de los tweets, Qualtrics solo puede devolver los datos específicos de Social Connect y el ID de Tweet de Twitter. Esta es una restricción de los Términos de la API de Twitter.

Como tiene el ID de Tweet, puede acceder a la API de Twitter y utilizar el punto de acceso “/status/lookup”  para obtener todos los detalles.

¿Por qué algunas publicaciones de Facebook son anónimas?

Las publicaciones públicas de Facebook (recogidas por Social Connect a través de su búsqueda por palabra clave, no mensajes en sus páginas de Facebook) se anonimizan. Esta es una limitación de la API de Facebook.

¿Puedo añadir mis propios mensajes a Social Connect?

Si tiene un formulario de contacto o un foro interno que le gustaría ver supervisado por Social Connect, puede llamar al punto final “/{account_id}/inbox/add” para añadir sus mensajes personalizados a Social Connect. Estos mensajes estarán accesibles en su bandeja de entrada y en los análisis.

Los mensajes añadidos a Social Connect a través de la API no se pueden responder desde Social Connect Si desea tener una integración más estrecha con su sistema personalizado, póngase en contacto con el servicio de asistencia de.

¿Puedo exportar casos a través de la API?

Puede utilizar el punto final de mención normal (lista de exportación/actualización de mención individual) para exportar casos. Si solo desea devolver casos en su solicitud, puede utilizar el filtro “sub_category:case”.

¿Cuál es la diferencia entre casos y menciones para la API?

En Social Connect una “mención” es el objeto central de un mensaje (un solo tweet, un solo mensaje privado, un solo comentario). También existe el concepto de un “Caso” que básicamente es una colección de menciones.

El uso principal para los casos es agrupar varios mensajes de un determinado usuario y las respuestas de los agentes en conversaciones.

Desde una perspectiva técnica, una “conversación de caso” consiste en:

• El propio caso (que también es un objeto de mención).
• Un caso puede tener etiquetas, un estado, un título, etc.
• Una lista de menciones que forman parte de la conversación.
• Las menciones que se han agrupado en el caso.

Consulte esta página de soporte de API para obtener más información sobre casos y menciones.

¿Puedo importar mensajes a la bandeja de salida de Social Connect?

Puede crear borradores de nuevas publicaciones para que los gestores sociales verifiquen, editen y publiquen a través del punto final “/{account_id}/publisher/add”.

¿Puedo editar una mención a través de la API?

Puede editar menciones existentes utilizando el punto final “/{account_id}/inbox/mención/{topic_id}/{id}”. La documentación para este punto final tiene ejemplos para actualizar las etiquetas de una mención, añadir una nota y más.

¿Cómo elimino todos los datos de un determinado usuario en Engage a través de la API?

Si desea eliminar todos los datos de un determinado cliente que está en su cuenta de Social Connect, debe eliminar dos tipos de datos:

1. Todas las menciones de ese usuario en el sistema
2. Cualquier información sobre ese usuario que esté almacenada en Social Connect CRM.

Para buscar todas las menciones de un determinado usuario, utilice el punto final “/{account_id}/inbox/mentions” y filtre por un ID de autorización determinado, p. ej. “auth.id:123”.Una vez que tenga esa lista de menciones, las menciones se pueden eliminar mediante el punto final “/{account_id}/inbox/mención/{topic_id}/{id}”.

Para saber si sus agentes han grabado o no más datos de contacto en Social Connect CRM para un contacto, realice una solicitud GET a “/{account_id}/inbox/contact/{service}/{service_id}”. Si el objeto de respuesta contiene un ID de contacto, significa que existe un contacto para este usuario. Si la respuesta no contiene una propiedad contact.id, significa que no se han almacenado datos en Social Connect CRM.

Una vez que tenga un ID de contacto, puede realizar una solicitud DELETE en el punto de acceso /{account_id}/inbox/contact/{contact_id} para eliminar toda la información.

Trabajar con contactos  ​

¿Cómo puedo encontrar detalles de contacto de una mención o caso?

Si la API devuelve una mención o un caso, contendrá una lista de objetos “action_link”. Los enlaces de acción contienen información del objeto actual sobre qué otros puntos finales de API o URL de la aplicación Web son relevantes para este objeto. Para menciones y casos, uno de los enlaces de acción incluidos es donde puede obtener los datos de contacto del autor de la mención o caso.

Al utilizar el punto final /{account_id}/inbox/cases, se incluye por defecto el objeto de contacto del autor de la mención. Qualtrics no incluye el objeto de contacto completo para las menciones, pero a través de los enlaces de acción se puede obtener este objeto mediante una llamada API separada.

Publicación

¿Puedo utilizar la API Clarabridge Engage para publicar en un canal social?

No, la API no permite publicar directamente en plataformas de terceros. Esto significa que no puede utilizar la API de conexión social para publicar un tweet o un comentario en Facebook.

Sin embargo, puede utilizar la API de conexión social para crear borradores o mensajes de cola para su aprobación. Estas se publicarán cuando se aprueben o se publiquen a través de la interfaz de Social Connect. El extremo para los mensajes de borrador es /{account_id}/publisher/add.

Gestión de usuarios

¿Puedo modificar el estado de los usuarios a través de la API?

No, no puede modificar el estado de los usuarios mediante la API. Aunque no puede modificar el estado, puede modificar el nombre, la empresa, el correo electrónico, el avatar y la programación de horario de trabajo a través del punto de acceso /{account_id}/settings/user/{id}.

¿Puedo modificar el rol de usuario de los usuarios a través de la API?

Es posible cambiar el rol de usuario de un usuario a través de nuestra API. Sin embargo, por motivos de seguridad, no es posible cambiar un rol de usuario a Administrador. Todos los demás roles de usuario están disponibles para cambiar a mediante el punto final /{account_id}/settings/user/{id}.

¿Puedo crear nuevos usuarios a través de la API?

Por motivos de seguridad, esto no es posible a través de la API.

Trabajar con perfiles sociales

¿Puedo recuperar información sobre los perfiles sociales en mis temas?

Puede obtener información sobre un determinado perfil social mediante el punto final “/{account_id}/inbox/contact/{service}/{service_id}”. Esto incluirá todos los detalles que haya rellenado para esa persona en Social Connect CRM, como el sexo, el correo electrónico o los atributos personalizados que haya añadido para este usuario.

Trabajar con análisis

¿Puedo obtener estadísticas de Clarabridge Engage?

Puede extraer datos de Análisis utilizando 2 puntos finales de API diferentes:

1. El punto final “/{account_id}/dashboards/export/{dashboard_id}” devuelve los datos de todos los widgets en un dashboard determinado. Una vez que usted o sus usuarios hayan configurado dashboards personalizados, puede utilizar este punto final para obtener los datos detrás de ellos.
2. El punto final “/{account_id}/insights/facets” actúa como el equivalente de API de la función Creador de gráficos en Social Connect.

Problemas

¿Dónde puedo encontrar mi ID de cuenta?

Una vez autenticado, puede obtener una lista de todas las cuentas (y sus ID) a las que tiene acceso un usuario a través del punto final “/me/Accounts”.

¿Dónde puedo encontrar mi ID de tema?

Una vez autenticado, puede obtener una lista de todos los temas (y sus ID) a los que tiene acceso un usuario a través del punto final “/me/Accounts”.

¿Dónde puedo encontrar mi ID de usuario?

Una vez autenticado, puede obtener detalles sobre el usuario de autenticación (incluido su ID) mediante el punto final “/me”.