Webhook é um método de entrega de dados entre diferentes aplicações.Permite que você envie Menções do YouScan para outros aplicativos manualmente ou automaticamente 🙌
Se você não consegue 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 fonte?
Os dados das seguintes fontes estão indisponí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 da Mençõe foram removidas
Mençõe URL foi removida
URL do Autor, Nome do Autor e AvatarUrl do Autor foram removidos
O ID do perfil do autor foi adicionado às informações do Autor (o ID em si é o ID do Perfil do Twitter)
O ID do Post é o ID do Tweet
Combinar o ID do Perfil e o ID do Post permite que você navegue 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 ao YouScan.
💡 Você pode encontrar informações sobre as configurações do aplicativo em sua Base de Conhecimento ou 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 stream.
Mençõe structure
Webhook permite que você envie Mençõe parâmetros disponíveis no YouScan, como:
Informações do autor;
Fonte de publicação e origem da postagem;
Mençõe text;
Métricas de engajamento.
Aqui está a lista completa de parâmetros disponíveis através do 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)
Nossa integração de webhook suporta Autenticação Básica. Para definir um nome de usuário e senha, use a URL de callback neste formato:
https://user:password@example.com/callback