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 naquela plataforma e responder em tempo real.

Conceitos-chave:

• Configuracao por agente -- Cada conexao de canal e configurada no nivel do agente. Um agente pode ser conectado ao Slack enquanto outro cuida do Discord, ou um unico agente pode ser 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 do mesmo tipo de canal (ex.: dois workspaces diferentes do Slack ou varios enderecos de email).

Canais Suportados

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

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

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

Bot Token

Usado por: Discord, Telegram

1. 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.
2. Abra a aba Canais do agente e clique em Conectar ao lado do canal.
3. Cole o bot token no campo de token.
4. Clique em Salvar para estabelecer a conexao.

Codigo QR

Usado por: WhatsApp

1. Abra a aba Canais do agente e clique em Conectar ao lado do WhatsApp.
2. Um codigo QR aparecera na tela.
3. Abra o WhatsApp no seu celular, va em Dispositivos Conectados e escaneie o codigo QR.
4. A conexao e estabelecida assim que seu celular confirmar o link.

API Key

Usado por: SMS

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

Token

Usado por: Matrix, Line, Zalo

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

Configuracao de Servidor

Usado por: IRC

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

Aplicativo Local

Usado por: Signal, iMessage

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

Teste de Conexao

Apos conectar qualquer canal, o Neotask executa automaticamente 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 inacessivel).

Voce pode executar novamente 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 na aba Canais do agente.

Ativar / Desativar

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

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

Testar Conectividade

Execute um teste de conectividade sob demanda para verificar se o canal esta acessivel 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 / Sair

Para remover completamente uma conexao de canal:

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

Para reconectar apos desconectar, siga as etapas de conexao originais novamente.