Webhook es un método de entrega de datos entre diferentes aplicaciones. Permite enviar Menciones desde YouScan a otras apps de forma manual o automática 🙌.
Si no puedes encontrar la aplicación que necesitas en la lista de integraciones disponibles, puedes configurar una integración personalizada a través de Webhook. En este artículo, te enseñaremos cómo hacerlo.
⚠️ ¿Existen limitaciones de origen?
Los datos de las siguientes fuentes no están disponibles:
Reddit
Quora
algunas fuentes pequeñas
Estamos limitando los datos que se pueden acceder para las Menciones recopiladas de Twitter. Se aplican los siguientes ajustes:
Las propiedades de Texto de Mencione y Texto Completo se eliminan
Mencione URL ha sido eliminado
Se han eliminado la URL del autor, el nombre del autor y la URL del avatar del autor.
El ID de perfil del autor se ha añadido a la información del autor (el ID en sí es el ID del perfil de Twitter)
El ID de la publicación es el ID del Tweet
La combinación del ID de perfil y el ID de publicación le permite navegar al Tweet exacto que se recopiló como la Mencione correspondiente.
Configuración de integraciones de Webhook
Se requiere un poco de configuración en el back-end de la aplicación con la que le gustaría integrarse con YouScan.
💡 Puede encontrar información sobre la configuración de la aplicación en su Base de Conocimientos o secciones de Soporte.
En YouScan, necesitas completar los siguientes 2 pasos:
Abre el tema «Configuraciones», navega a la pestaña de Integraciones y haz clic en «Agregar» junto a Webhook.
Especifique una URL de destino para las alertas de YouScan.
💡 Las alertas de YouScan deben configurarse individualmente para cada tema. Puedes configurar el mismo destino para cada tema, o agregar varios Webhooks a un solo tema.
Trabajando con una integración de Webhook
Hay dos formas de enviar Menciones a través de Webhook:
Alertas automáticas utilizando «Reglas»;
Trabajo manual en el Mencione stream.
Mencione estructura
Webhook le permite enviar parámetros de Mencione disponibles en YouScan, tales como:
Información del autor;
Fuente de publicación y origen de la publicación;
Mencione text;
Métricas de interacciones.
Aquí está la lista completa de parámetros disponibles a través de YouScan:
{
"country":, //author's country
"region":, //author's region
"city":, //author's city
"topicId":,//monitoring topic ID
"topicName":, //name of your monitoring topic
"mentionId":, //mention's order number in the topic
"sourceName":,//name of the source
"author": { //information about the author
"url":, //profile URL
"name":, //author's name
"nickname": //author's username
"avatarUrl":, //author's user picture
"subscribers": //author's audience
},
"channel": { //publication source
"url":, //link to the source page
"name":, // page title
"avatarUrl":, //user picture
"subscribers": //audience
},
"tags": [], // mention tags
"title":, // post title
"text":, // post copy (snippet with keyword)
"url":, // direct URL to the post
"published":, // time of publication
"addedAt":, // time when mention was saved to topic
"sentiment":, // post sentiment
"imageUrl":, // a link to the image contained in the mention
"language":, // the mention's auto-detected language
"postType":, // post type
"resourceType":, // type of publication platform
"spam":, // determines whether the post is considered spam (Y/N)
"postId":, // unique post ID
"parentPostId":, // parent post ID
"discussionId":, // discussion ID
"likes":, // the number of likes on the post
"reposts":, // the number of shares on the post
"comments":, // the number of comments on the post
"engagement": // a total number of engagements (likes, comments, shares)
Nuestra integración de webhook admite Autenticación Básica. Para establecer un nombre de usuario y una contraseña, utiliza la URL de callback en este formato:
https://user:password@example.com/callback