Visão Geral da Integração

A integração com plataformas de chat é um componente essencial do Capellaris, permitindo que os usuários interajam com os agentes através de interfaces familiares e já utilizadas no dia a dia da empresa.

Arquitetura de Integração

graph TB
    subgraph Platforms["📱 Plataformas de Chat"]
        SLACK[fa:fa-slack Slack]
        TEAMS[fa:fa-microsoft Microsoft Teams]
    end
    
    subgraph Connectors["🔌 Conectores"]
        SC[Conector Slack]
        TC[Conector Teams]
    end
    
    subgraph Core["⚙️ Sistema Capellaris"]
        ROUTER[Roteador de
Mensagens]
        CONFIRM[Confirmação
Humana]
        AGENTS[Agentes
Especializados]
    end
    
    subgraph Formatters["📝 Formatadores"]
        BLOCKS[Blocos
Interativos]
        CARDS[Cards
Adaptativos]
    end
    
    SLACK --> SC
    TEAMS --> TC
    SC --> ROUTER
    TC --> ROUTER
    ROUTER --> CONFIRM
    CONFIRM --> AGENTS
    AGENTS --> BLOCKS
    AGENTS --> CARDS
    BLOCKS --> SC
    CARDS --> TC
    
    style Platforms fill:#e3f2fd
    style Core fill:#fff3e0
    style Connectors fill:#e8f5e9
    style Formatters fill:#f3e5f5
Interfaces familiares
Colaboração em canais
Contexto de conversas
Notificações integradas
Histórico preservado
Segurança empresarial

Plataformas Suportadas

Slack

Integração completa

Integração completa permitindo interações em canais públicos, privados e mensagens diretas, com suporte a rich messages.

Menções @agente_nome
Mensagens diretas
Organização em threads
Blocos interativos
Feedback por reações

Microsoft Teams

Integração completa

Integração com canais e chats do Teams, com suporte a cards adaptativos e botões de ação.

Menções @agente_nome
Chats privados
Cards adaptativos
Botões de ação
Abas personalizadas

Próximas Integrações (Roadmap)

Discord Telegram WhatsApp Business

Fluxo de Interação

Veja como funciona uma interação típica entre um usuário e um agente através das plataformas de chat integradas.

Exemplo de Interação

sequenceDiagram
    participant U as 👤 Usuário
    participant S as 💬 Slack/Teams
    participant C as 🔌 Conector
    participant A as 🤖 Agente
    participant H as ✅ Aprovador
    
    U->>S: @agente_marketing analise a campanha
    S->>C: Encaminha mensagem
    C->>A: Processa solicitação
    A->>C: Solicita aprovação
    C->>S: Envia card de aprovação
    S->>H: Notifica aprovador
    H->>S: Clica em "Aprovar"
    S->>C: Confirmação recebida
    C->>A: Executa tarefa
    A->>C: Retorna análise
    C->>S: Formata resposta
    S->>U: Exibe resultado

1. Solicitação do Usuário

JD
João da Silva 10:30

@agente_marketing analise os resultados da nossa campanha de email do último trimestre

2. Solicitação de Aprovação

Solicitação de Aprovação

O agente de marketing gostaria de analisar dados de campanha.

Processo de Confirmação Humana

O processo de confirmação humana garante que os agentes não realizem ações não autorizadas, mantendo o controle nas mãos dos operadores.

Fluxo de Confirmação

flowchart LR
    A[📋 Solicitação
de Tarefa] --> B[🔍 Análise de
Complexidade]
    B --> C{Nível de
Aprovação?}
    C -->|Baixo| D[👤 Usuário
Aprova]
    C -->|Médio| E[👨‍💼 Gerente
Aprova]
    C -->|Alto| F[👔 Diretoria
Aprova]
    D --> G[⚡ Execução]
    E --> G
    F --> G
    G --> H[📊 Relatório]
    
    style A fill:#e3f2fd
    style G fill:#e8f5e9
    style H fill:#fff3e0

Níveis de Aprovação

Nível Baixo

Tarefas simples sem acesso a dados sensíveis.

Exemplos: Análises básicas, resumos gerais

Nível Médio

Tarefas com acesso a dados internos não sensíveis.

Exemplos: Relatórios detalhados, recomendações

Nível Alto

Tarefas com acesso a dados sensíveis ou confidenciais.

Exemplos: Análises financeiras, dados de clientes

Segurança e Controle

Todas as aprovações são registradas e auditáveis. Solicitações não respondidas em 30 minutos são automaticamente escaladas ou canceladas, garantindo que nenhuma tarefa fique pendente indefinidamente.