Webhook é um método de entrega de dados entre diferentes aplicativos.Permite enviar Menções do YouScan para outros aplicativos manual ou automaticamente 🙌.
Se não conseguir encontrar o aplicativo de que precisa na lista de integrações disponíveis, você poderá configurar uma integração personalizada via Webhook. Neste artigo, ensinaremos a você como fazer isso.
⚠️ Menções do Reddit não podem ser solicitadas via Webhook.
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 nas seções de Base de Conhecimento ou Suporte.
No YouScan, você precisa completar os seguintes 2 passos:
Abra o tópico "Settings" (Configurações), navegue até a guia Integrations (Integrações) e clique em "Add" (Adicionar) ao lado de Webhook.
Especifique um 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.
Trabalhar com uma integração de Webhook
Há duas maneiras de enviar menções via Webhook:
Alertas automáticos usando "Regras";
Trabalho manual na Mençõe stream.
Mençõe estrutura
O Webhook permite que você envie parâmetros de menções disponíveis no YouScan, como:
Informações sobre o autor;
Fonte de publicação e origem da postagem;
Menções ao 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 webhooks é compatível com a autenticação básica. Para definir um nome de usuário e uma senha, use o URL de retorno neste formato:
https://user:password@example.com/callback