PRIVATE_GROUPS.md•4.54 kB
# 🔐 Trabalhando com Grupos Privados - Slack MCP Server
## ✅ **SIM! Seu MCP Server consulta mensagens em grupos privados!**
### 🎯 **Funcionalidades que funcionam com grupos:**
---
## 📝 **1. Consultar Histórico de Grupos Privados**
```json
{
"name": "get_slack_channel_history",
"arguments": {
"channel": "G1234567890", // ID do grupo privado (começa com G)
"limit": 50
}
}
```
**Resultado:**
```json
{
"success": true,
"channel": "G1234567890",
"messages_count": 50,
"messages": [
{
"ts": "1704067200.123456",
"user": "U111USER",
"text": "Discussão privada importante...",
"thread_ts": null,
"reply_count": 0
}
]
}
```
---
## 🔍 **2. Listar Seus Grupos Privados**
```json
{
"name": "get_private_channels_with_user",
"arguments": {
"include_history": true // Incluir última mensagem
}
}
```
**Resultado:**
```json
{
"success": true,
"private_channels_count": 5,
"private_channels": [
{
"id": "G1234567890",
"name": "projeto-secreto",
"is_group": true,
"num_members": 3,
"last_message": {
"text": "Vamos finalizar isso hoje",
"user": "U111USER",
"date": "2025-01-01T10:00:00.000Z"
}
}
]
}
```
---
## 🔎 **3. Buscar em Grupos Privados Específicos**
```json
{
"name": "search_in_private_groups",
"arguments": {
"query": "reunião OR meeting",
"group_ids": ["G1234567890", "G0987654321"],
"count": 30
}
}
```
---
## 📊 **4. Analytics de Grupos Privados**
```json
{
"name": "get_channel_analytics",
"arguments": {
"channel": "G1234567890", // Funciona perfeitamente com grupos!
"days": 30
}
}
```
**Resultado:**
```json
{
"success": true,
"analytics": {
"period_days": 30,
"total_messages": 145,
"total_reactions": 89,
"most_active_users": [
["U111USER", 45],
["U222USER", 32]
],
"engagement_rate": 0.61
}
}
```
---
## 🎯 **5. Enviar Mensagens para Grupos**
```json
{
"name": "send_slack_message",
"arguments": {
"channel": "G1234567890", // ID do grupo privado
"text": "Mensagem confidencial para o grupo"
}
}
```
---
## 📋 **6. Listar Todos os Canais (Incluindo Grupos)**
```json
{
"name": "list_slack_channels",
"arguments": {
"types": "public_channel,private_channel,mpim", // Todos os tipos
"limit": 100
}
}
```
**Tipos de canal:**
- `public_channel` - Canais públicos (#geral)
- `private_channel` - Grupos privados (🔒 projeto-x)
- `mpim` - Mensagens diretas em grupo
- `im` - Mensagens diretas 1:1
---
## 🔐 **Permissões Necessárias no Slack App**
Para funcionar com grupos privados, certifique-se de ter:
```
✅ groups:read - Ler grupos privados
✅ groups:history - Histórico de grupos privados
✅ groups:write - Gerenciar grupos privados
✅ mpim:read - Ler mensagens diretas em grupo
✅ mpim:history - Histórico de DMs em grupo
✅ search:read - Buscar em todos os canais
```
---
## 💡 **Dicas Importantes**
### 🎯 **IDs de Grupos vs Canais:**
- **Canais públicos**: começam com `C` (ex: `C1234567890`)
- **Grupos privados**: começam com `G` (ex: `G1234567890`)
- **DMs em grupo**: começam com `G` (ex: `G0987654321`)
- **DMs 1:1**: começam com `D` (ex: `D1122334455`)
### 🔍 **Como descobrir IDs de grupos:**
```json
{
"name": "list_slack_channels",
"arguments": {
"types": "private_channel"
}
}
```
### 🚀 **Cenário Completo: Analisar Grupo de Projeto**
```bash
# 1. Listar grupos privados
get_private_channels_with_user → encontrar ID do grupo
# 2. Analisar atividade do grupo
get_channel_analytics → métricas dos últimos 30 dias
# 3. Buscar discussões específicas
search_in_private_groups → encontrar tópicos importantes
# 4. Consultar histórico detalhado
get_slack_channel_history → ver mensagens recentes
```
---
## ✅ **Resumo: O que funciona com grupos privados**
| Funcionalidade | Canais Públicos | Grupos Privados | Status |
|---|---|---|---|
| `send_slack_message` | ✅ | ✅ | Funciona |
| `get_slack_channel_history` | ✅ | ✅ | Funciona |
| `get_channel_analytics` | ✅ | ✅ | Funciona |
| `search_slack_messages` | ✅ | ✅ | Funciona |
| `list_slack_channels` | ✅ | ✅ | Funciona |
| `get_private_channels_with_user` | ❌ | ✅ | Específico |
| `search_in_private_groups` | ❌ | ✅ | Específico |
**🎉 Resultado: SEU MCP SERVER FUNCIONA PERFEITAMENTE COM GRUPOS PRIVADOS!**