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?
Os 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 na 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