# Canais

## O Que Sao Canais?

Canais sao as plataformas de mensagens as quais seus agentes se conectam. Ao conectar um canal, seu agente pode ouvir mensagens recebidas e responder em tempo real naquela plataforma.

Neotask suporta **mais de 20 plataformas de mensagens** nativamente.

## Canais Suportados

### Canais Principais (Nativos)

| Canal | Descricao |
|-------|-----------|
| **WhatsApp** | Contas pessoais e business via protocolo WhatsApp Web. Grupos, reacoes, midia, threads, editar/cancelar envio, encaminhamento. |
| **Telegram** | Integracao via Bot API. Grupos, canais, threads, reacoes, fixacao. Ingestao opcional por webhook. |
| **Discord** | Integracao completa de servidor. Canais, cargos, threads, percepcao de canal de voz, vinculacao de agente por servidor. |
| **Slack** | App de workspace via OAuth. Canais, threads, reacoes, compartilhamento de arquivos. |
| **Signal** | DMs e grupos criptografados via protocolo Signal. Pareamento de telefone via QR. |
| **Google Chat** | Espacos, threads, reacoes, respostas em card via webhook. |
| **iMessage** | Suporte completo a SMS/iMessage via BlueBubbles no macOS. Editar, cancelar envio, efeitos. |
| **IRC** | IRC classico com canais, DMs, autenticacao SASL, suporte multi-servidor. |

### Canais via Plugin

| Canal | Descricao |
|-------|-----------|
| **Microsoft Teams** | Integracao de workspace via plugin. |
| **Matrix** | Protocolo de mensagens descentralizado. |
| **Nostr** | DMs do protocolo social descentralizado. |
| **Zalo** | Plataforma de mensagens vietnamita (Bot API e conta pessoal). |
| **Feishu/Lark** | Plataforma de mensagens enterprise. |
| **LINE** | Integracao via LINE Messaging API. |
| **Nextcloud Talk** | Mensagens auto-hospedadas via Nextcloud. |
| **Mattermost** | Mensagens de equipe open-source. |
| **Tlon** | Mensagens baseadas em Urbit. |
| **Twitch** | Chat de transmissao ao vivo via IRC. |

## Recursos dos Canais

### Suporte Multi-Conta
Execute multiplas contas por canal. Por exemplo, gerencie varios numeros WhatsApp ou bots Telegram a partir do mesmo Gateway.

### Suporte a Midia
Envie e receba imagens, videos, audio, documentos, stickers e outros tipos de midia. O tratamento de midia varia por plataforma, mas a maioria dos canais suporta midia rica em ambas as direcoes.

### Gestao de Grupos e Canais
Agentes podem participar de conversas em grupo, responder a mencoes, gerenciar threads e interagir com recursos especificos do canal (reacoes, enquetes, fixacoes).

### Threading de Mensagens
Em plataformas que suportam (Slack, Discord, Telegram), agentes podem criar threads, responder dentro de threads e manter contexto especifico da thread.

### Edicao de Mensagens e Reacoes
Agentes podem editar suas proprias mensagens, cancelar envios e adicionar reacoes em plataformas que suportam esses recursos.

### Grupos de Broadcast
Envie anuncios para multiplos canais simultaneamente. Configure grupos de broadcast para manter multiplas plataformas sincronizadas.

## Roteamento de Canais

### Comportamento Padrao
Por padrao, o agente principal recebe todas as mensagens de entrada de todos os canais.

### Roteamento Multi-Agente
Com multiplos agentes, mensagens sao roteadas com base em vinculacoes:

- **Por canal** -- Todas as mensagens do WhatsApp → agente pessoal
- **Por servidor** -- Servidor Discord A → agente de suporte, servidor B → agente de dev
- **Por workspace** -- Workspace Slack → agente de equipe
- **Por tipo de chat** -- DMs privadas → assistente, mensagens de grupo → bot de equipe

### Controle de Acesso a DMs
Configure quais contatos podem enviar mensagens ao seu agente diretamente. As opcoes incluem permitir todas as DMs, apenas contatos conhecidos ou uma lista de permissao especifica.

### Filtro de Mencao em Grupo
Em chats de grupo, configure se os agentes respondem a todas as mensagens ou apenas quando mencionados.

## Pareamento e Autenticacao

Cada canal tem seu proprio metodo de autenticacao:

| Canal | Metodo de Auth |
|-------|---------------|
| WhatsApp | Leitura de QR code |
| Telegram | Token de bot |
| Discord | Token de bot |
| Slack | OAuth (app de workspace) |
| Signal | Pareamento de telefone via QR |
| Google Chat | URL de webhook |
| iMessage | API key do BlueBubbles |
| IRC | Nick + senha opcional |