Conector MCP

Aqui está a listagem completa dos 12 endpoints disponíveis no conector feedbackio-reviews:

Endpoint	Descrição
`list_reviews`	Lista e filtra reviews públicas por source, data, rating, sentimento, texto, etc. Suporta paginação.
`get_review`	Obtém o detalhe completo de uma review individual por ID (reply, tags, historial).
`list_private_feedback`	Lista os feedbacks privados (nunca publicados). Filtrável por rating, data, estado de resposta.
`list_organizations`	Lista as organizações acessíveis, com stats opcionais de reviews e rating médio.
`list_locations`	Lista as localizações acessíveis com contagem de reviews e rating por localização.
`list_campaigns`	Lista campanhas de pedido de review com funil completo (convidados, abertos, clicados, submetidos).
`list_contacts`	Lista contactos de campanhas com estado de subscrição e contadores de engagement.
`get_contact_activity`	Obtém a timeline completa de atividade de um contacto (convites, cliques, feedback, etc.).
`get_metrics`	Agrega métricas (totais, rating médio, distribuição de estrelas, sentimento) com suporte a `group_by` e comparação entre períodos.
`get_ai_insights`	Obtém a análise pré-computada por IA (temas, variações de sentimento, recomendações) por organização ou localização.

Endpoint	Descrição
`draft_review_response`	Cria um rascunho de resposta a uma review — fica em fila de aprovação, nunca é enviado automaticamente.
`tag_reviews`	Adiciona ou remove tags em até 50 reviews por chamada. Útil para classificar reviews por tema.

PII protegido por defeito — os campos name, email e phone em list_contacts, get_contact_activity e list_private_feedback só são desbloqueados com include_pii: true, e requerem a permissão reviews.pii no token.
Escrita controlada — draft_review_response nunca publica automaticamente; o draft vai para uma fila de aprovação humana.
get_ai_insights devolve análise pré-computada (não é gerada em tempo real), pelo que pode não refletir os reviews mais recentes se ainda não tiver sido atualizada.