Canais

O Que Sao Canais?

Canais sao as plataformas de comunicacao que seus agentes do Neotask usam para enviar e receber mensagens. Ao conectar um canal, voce da ao agente a capacidade de ouvir mensagens recebidas nessa plataforma e responder em tempo real.

Conceitos principais:

Configuracao por agente -- Cada conexao de canal e configurada no nivel do agente. Um agente pode estar conectado ao Slack enquanto outro cuida do Discord, ou um unico agente pode estar conectado a multiplos canais simultaneamente.
Bidirecional -- Canais suportam tanto envio quanto recebimento de mensagens. Agentes podem responder a mensagens recebidas, iniciar mensagens de saida, ou ambos.
Multi-conta -- Voce pode conectar multiplas contas para o mesmo tipo de canal (ex.: dois workspaces Slack diferentes ou varios enderecos de email).

Canais Suportados

Canal	Metodo de Auth	Recursos
Slack	OAuth	Mensagens completas, canais, threads, reacoes, upload de arquivos
Discord	Bot token	Mensagens em servidor, canais, DMs, embeds, reacoes
WhatsApp	QR code	Mensagens de texto, mensagens de midia, chats em grupo
Telegram	Bot token	Mensagens de texto, grupos, canais, teclados inline, compartilhamento de arquivos
Signal	App local	Mensagens com criptografia ponta-a-ponta, chats em grupo
Microsoft Teams	OAuth	Teams, canais, chats, adaptive cards, compartilhamento de arquivos
Google Chat	OAuth	Spaces, mensagens diretas, cards, conversas em thread
SMS	API key	Mensagens de texto de entrada e saida via provedores suportados
Email / Gmail	OAuth	Enviar, receber, rascunho, responder, anexos, gerenciamento de labels
Matrix	Token	Mensagens federadas, salas, criptografia ponta-a-ponta
Line	Token	Mensagens de texto, stickers, chats em grupo, menus ricos
Zalo	Token	Mensagens de texto, compartilhamento de midia
IRC	Configuracao	Conexoes de servidor, canais, mensagens privadas
iMessage	Local	Mensagens nativas do macOS (requer host macOS)

Conectando um Canal

O processo de conexao varia dependendo do metodo de autenticacao do canal.

Fluxo OAuth

Usado por: Slack, Microsoft Teams, Google Chat, Email / Gmail

Abra a aba Canais do agente.
Clique em Conectar ao lado do canal que deseja adicionar.
Voce sera redirecionado para a pagina de autorizacao do servico.
Faca login com sua conta e conceda ao Neotask as permissoes solicitadas.
Apos a autorizacao, voce e redirecionado de volta ao dashboard e o canal aparece como conectado.

Para plataformas moveis, uma opcao de QR code esta disponivel. Escaneie o QR code pelo seu celular para completar a autorizacao sem precisar fazer login no navegador do desktop.

Bot Token

Usado por: Discord, Telegram

Crie um bot na respectiva plataforma:
- Discord -- Crie um aplicativo no Portal de Desenvolvedores do Discord e gere um bot token.
- Telegram -- Envie uma mensagem para @BotFather no Telegram para criar um bot e receber um token.
Abra a aba Canais do agente e clique em Conectar ao lado do canal.
Cole o bot token no campo de token.
Clique em Salvar para estabelecer a conexao.

QR Code

Usado por: WhatsApp

Abra a aba Canais do agente e clique em Conectar ao lado do WhatsApp.
Um QR code aparecera na tela.
Abra o WhatsApp no seu celular, va ate Dispositivos Vinculados e escaneie o QR code.
A conexao e estabelecida quando seu celular confirma o vinculo.

API Key

Usado por: SMS

Obtenha uma API key do seu provedor de SMS (ex.: Twilio, Vonage).
Abra a aba Canais do agente e clique em Conectar ao lado de SMS.
Insira sua API key e quaisquer campos adicionais necessarios (ex.: numero de telefone, account SID).
Clique em Salvar para ativar o canal.

Token

Usado por: Matrix, Line, Zalo

Gere um token de acesso nas configuracoes de desenvolvedor ou painel de administracao da respectiva plataforma.
Abra a aba Canais do agente e clique em Conectar ao lado do canal.
Cole o token no campo de token.
Clique em Salvar para estabelecer a conexao.

Configuracao de Servidor

Usado por: IRC

Abra a aba Canais do agente e clique em Conectar ao lado de IRC.
Insira o endereco do servidor, porta, apelido e (opcionalmente) uma senha.
Especifique os canais para entrar ao conectar.
Clique em Salvar para conectar.

Aplicativo Local

Usado por: Signal, iMessage

Certifique-se de que o aplicativo necessario esta instalado e rodando na maquina host:
- Signal -- O Signal Desktop deve estar instalado e vinculado a sua conta Signal.
- iMessage -- Requer um host macOS com Messages.app configurado.
Abra a aba Canais do agente e clique em Conectar ao lado do canal.
O Neotask detectara o aplicativo local e estabelecera uma conexao.
Se o aplicativo nao for detectado, voce sera solicitado a instala-lo ou configura-lo.

Teste de Conexao

Apos conectar qualquer canal, o Neotask automaticamente executa um teste de latencia para verificar a conexao:

Uma mensagem de teste e enviada e recebida pela API do canal.
A latencia de ida e volta e medida e exibida.
Se o teste falhar, uma mensagem de erro descreve o problema (ex.: token invalido, concessao OAuth expirada, servidor inalcancavel).

Voce pode reexecutar o teste de conexao a qualquer momento nas configuracoes do canal.

Operacoes de Canal

Uma vez que um canal esta conectado, voce pode gerencia-lo pela aba Canais do agente.

Habilitar / Desabilitar

Alterne um canal entre ligado e desligado sem desconecta-lo. Quando desabilitado:

O agente para de ouvir mensagens nesse canal.
Nenhuma mensagem de saida e enviada por ele.
As credenciais de conexao sao preservadas para que voce possa rehabilitar a qualquer momento sem reconfigurar.

Testar Conectividade

Execute um teste de conectividade sob demanda para verificar se o canal esta alcancavel e responsivo. O teste:

Envia uma requisicao leve de API para o servico do canal.
Mede a latencia de ida e volta em milissegundos.
Reporta o resultado como Conectado (com latencia) ou Falhou (com detalhes do erro).

Ver Latencia

Cada canal conectado exibe sua leitura de latencia mais recente na aba Canais. Isso ajuda a identificar conexoes lentas ou degradadas rapidamente. A latencia e atualizada:

Automaticamente apos cada teste de conexao.
Periodicamente em segundo plano enquanto o canal esta ativo.

Desconectar / Logout

Para remover completamente uma conexao de canal:

Clique em Desconectar ao lado do canal.
Confirme a acao na caixa de dialogo.
O Neotask revoga ou descarta as credenciais armazenadas (tokens OAuth sao revogados no lado do provedor quando suportado).
O canal e removido da lista de canais ativos do agente.

Para reconectar apos desconectar, siga os passos de conexao originais novamente.