Webhook é um método de entrega de dados entre diferentes aplicativos.Permite enviar Menções do YouScan para outros aplicativos manual ou automaticamente 🙌.
Se você não conseguir encontrar o aplicativo que precisa na lista de integrações disponíveis, você pode configurar uma integração personalizada via Webhook. Neste artigo, vamos ensinar como fazer isso.
⚠️ Existem limitações de origem?
Dados das seguintes fontes não estão disponíveis:
Reddit
Quora
algumas pequenas fontes
Estamos limitando os dados que podem ser acessados para Menções coletadas do Twitter.Os próximos ajustes são aplicados:
As propriedades de Texto e Texto Completo de Mençõe são removidas
Mençõe URL is removed
URL do Autor, Nome do Autor e Avatar do Autor foram removidos
O ID do perfil do autor é adicionado às informações do autor (o próprio ID é o ID do perfil do Twitter)
O ID da postagem é o ID do Tweet
Combinar o ID do Perfil e o ID da Postagem permite navegar até o Tweet exato que foi coletado como a Mençõe correspondente.
Configurando integrações de Webhook
Há um pouco de configuração necessária no back-end do aplicativo que você gostaria de integrar com o YouScan.
💡 Você pode encontrar informações sobre as configurações do aplicativo em sua Base de Conhecimento ou nas seções de Suporte.
No YouScan, você precisa completar os seguintes 2 passos:
Abra o tópico «Configurações», navegue até a aba Integrações e clique em «Adicionar» ao lado de Webhook.
Especifique uma URL de destino para os alertas do YouScan.
💡 Os alertas do YouScan precisam ser configurados individualmente para cada tópico.Você pode configurar o mesmo destino para cada tópico ou adicionar vários Webhooks a um único tópico.
Trabalhando com uma integração de Webhook
Existem duas maneiras de enviar Menções via Webhook:
Alertas automáticos usando «Regras»;
Trabalho manual no fluxo de Mençõe.
Mençõe estrutura
Webhook permite que você envie parâmetros de Mençõe disponíveis no YouScan, tais como:
Informações do autor;
Fonte de publicação e origem do post;
Mençõe texto;
Métricas de engajamento.
Aqui está a lista completa de parâmetros disponíveis no YouScan:
{ "country":, //país do autor "region":, //região do autor "city":, //cidade do autor "topicId":,//identificação do tópico de monitoramento "topicName":, //nome do tópico de monitoramento "mentionId":, /número de ordem da Mençõe no tópico "sourceName":,//nome da fonte "author": { //informações sobre o autor "url":, //URL do perfil "name":, //nome do autor "nickname": //nome de usuário do autor "avatarUrl":, //imagem de usuário do autor "subscribers": //o público do autor }, "channel": { //fonte da publicação "url":, //link para a página de origem "name":, //título da página "avatarUrl":, //imagem do usuário "subscribers": //audiência }, "tags": [], // tags de menções "title":, // título da postagem "text":, // cópia da postagem (snippet com palavra-chave) "url":, // URL direto da postagem "published":, // hora da publicação "addedAt":, // hora em que a menção foi salva no tópico "sentiment":, // sentimento da postagem "imageUrl":, // um link para a imagem contida na menção "language":, // o idioma detectado automaticamente pela menção "postType":, // tipo de postagem "resourceType":, // tipo de plataforma de publicação "spam":, // determina se a postagem é considerada spam (S/N) "postId":, // ID exclusivo da postagem "parentPostId":, // ID da postagem pai "discussionId":, // ID da discussão "likes":, // o número de curtidas na publicação "reposts":, // o número de compartilhamentos na publicação "comments":, // o número de comentários na publicação "engagement": // um número total de engajamentos (curtidas, comentários, compartilhamentos)Nossa integração de webhook suporta Autenticação Básica. Para definir um nome de usuário e senha, use o URL de callback neste formato:
https://user:password@example.com/callback