Pular para o conteúdo principal

Gerencie respostas por tópico

Por meio do endpoint de ocultar respostas, você pode criar integrações para ajudar pessoas e marcas a manter a conversa dentro do tópico. Esta página mostra como gerenciar uma conversa usando os endpoints de ocultar respostas e pesquisa recente. A pesquisa recente tem funcionalidade para recuperar uma conversa e suas respostas, e o payload de Post retorna anotações de Post para ajudar você a entender o contexto e o tópico de cada Post, independentemente do idioma. O fluxo da App terá controles para exibir e gerenciar uma conversa:
  1. Solicita a permissão do usuário para ler seus Posts e gerenciar suas respostas.
  2. Obtém uma conversa recente a partir de uma URL de Post e verifica se a conversa é do usuário autenticado.
  3. Chama o endpoint de pesquisa recente para exibir cada Post na conversa. A requisição incluirá uma query de pesquisa por ID de conversa e a expansão de annotations para determinar se o Post é relacionado a esportes ou não, de acordo com a interpretação do X sobre o Post.
  4. Chama Ocultar respostas para ocultar uma resposta quando o usuário optar por isso. Também oferecerá uma forma de desfazer essa ação, para que o usuário esteja sempre no controle.
  5. Para conversas mais longas, fornecerá controles para paginar pelos resultados de pesquisa.  

Otimize para o usuário (e para o uso)

Você pode projetar um fluxo que coloque o usuário no controle de qualquer ação que ele queira realizar. Manter esse princípio em mente também ajuda a criar uma integração que otimize o consumo de Posts.
  1. Como o usuário autenticado só pode gerenciar conversas que ele iniciou, seu fluxo deve ser encerrado antecipadamente quando não for esse o caso.
    • Faça uma consulta inicial ao Post. Encerre o fluxo antecipadamente se a URL do Post não for válida ou se a conversa não tiver sido iniciada pelo usuário autenticado.
    • Assim, seu App não precisa fazer uma busca recente se a conversa não puder ser moderada pelo usuário autenticado.
  2. Solicite user e Post fields na mesma requisição para evitar chamadas separadas. Essa abordagem também pode melhorar o desempenho do seu App.
  3. Evite fazer requisições desnecessárias. Este App armazena em cache, no navegador do usuário, o status de ocultação de uma resposta. Isso é útil em conversas longas, nas quais o usuário pode querer retomar a moderação mais tarde, e ajuda seu App a otimizar as requisições para ocultar ou reexibir respostas.
I