🌐 यह पृष्ठ अभी तक हिंदी में अनुवादित नहीं किया गया है। पुर्तगाली (BR) संदर्भ दिखाया जा रहा है। अनुवाद में मदद करें।
Canais (WhatsApp) Server Mode
Os Canais conectam um número de WhatsApp a um agente ou fluxo salvo. Quando alguém manda uma mensagem, o agente responde usando tudo que ele já sabe fazer: suas instruções, skills, conhecimento (RAG) e as ferramentas que você liberou. É a mesma inteligência do AI Studio, agora atendendo direto no WhatsApp.
Por que isso é útil
Você monta um agente rico uma vez (no Agentes) e o coloca para atender no WhatsApp em minutos: um assistente de suporte, um consultor que responde perguntas sobre seus documentos, um bot que consulta o estado do seu servidor. Sem escrever integração nenhuma, é só apontar o canal para o agente ou fluxo.
Requer Server Mode
Os Canais precisam de um RoqueOS Server conectado (é onde a sessão do WhatsApp roda, com as credenciais criptografadas, e onde o agente é executado). Veja Primeiros Passos para conectar um servidor, ou use o servidor DEMO pré-configurado para experimentar.
WhatsApp não oficial
A conexão é self-hosted (a sessão vive no seu servidor, pareada como um "dispositivo conectado" do seu WhatsApp). Não é a API oficial da Meta. Use com bom senso: um volume muito alto de mensagens pode levar o número a ser bloqueado pelo WhatsApp. Para uso pessoal ou de baixo volume, funciona bem.
Criando um canal
Abra o AI Studio, vá até a seção Canais e clique em + Novo canal. Preencha:
- Nome, como o canal aparece na sua lista (ex.: "Atendimento", "Consultor de Documentos").
- Responder com, se o canal responde com um agente ou um fluxo. Fluxo é útil quando você quer orquestrar vários agentes/passos por mensagem.
- Qual, o agente ou fluxo salvo que vai atender.
- Quem pode falar, a postura de segurança do canal (veja abaixo).
- Ferramentas, o perfil de ferramentas que o canal permite (veja abaixo).
Depois de salvar, você conecta o número (pareamento) para o canal começar a atender.
Segurança: quem pode falar
Um canal de WhatsApp é uma porta de entrada para o seu agente, então você escolhe por canal quem pode usá-lo:
- Lista de permitidos (recomendado): só os números que você aprovar conversam com o bot. Informe um número por linha, com código do país (ex.:
5511999990000). Qualquer outro número é ignorado. - Público: qualquer número que mandar mensagem é atendido. Por segurança, um canal público é sempre limitado ao perfil de ferramentas Conversacional (seguro) e você não consegue trocar isso, é a trava que impede um estranho de fazer o seu agente executar ações destrutivas.
Ferramentas: o que o canal pode fazer
O perfil de ferramentas define quais ações o agente pode executar quando acionado por este canal, sempre como um subconjunto do que o próprio agente já permite:
- Conversacional (seguro): apenas ferramentas de leitura e busca (listar/ler arquivos, buscar na web, ver o estado do servidor e dos apps). Sem apagar/renomear/mover arquivos, sem terminal, sem ações destrutivas. É o perfil obrigatório para canais públicos.
- Completo: todas as ferramentas que o agente permite. Use apenas com a lista de permitidos, já que dá ao remetente o mesmo alcance do agente.
Além disso, cada canal tem uma cota diária por número, para que uma pessoa não dispare mensagens sem limite (cada mensagem consome uma execução de IA).
Conectando o número (pareamento)
Ao conectar um canal, você tem duas formas de parear, escolha a aba mais conveniente:
- Código QR: no aparelho onde o WhatsApp está, abra WhatsApp > Dispositivos conectados > Conectar um dispositivo e escaneie o QR mostrado na tela. Ideal quando você está no computador e o WhatsApp está no celular.
- Código por número: quando você está no próprio celular (não dá para escanear um QR na mesma tela). Informe o número, toque em Obter código e digite o código de 8 caracteres em WhatsApp > Dispositivos conectados > Conectar com número de telefone. Sem escanear nada.
A tela acompanha o status em tempo real; assim que o WhatsApp confirma, o canal aparece como Conectado e passa a responder. Para encerrar, use Desconectar, isso remove a sessão do WhatsApp (o canal continua salvo, é só reconectar depois).
Perguntas frequentes
Preciso de um número separado? Não é obrigatório, mas é recomendado: o canal parea como um dispositivo conectado do WhatsApp daquele número. Muita gente usa um chip dedicado para o bot.
Funciona com grupos? No momento o canal responde conversas 1:1 de texto. Grupos e mídia (imagem/áudio/PDF) estão no roadmap.
O agente lembra da conversa? Sim, cada contato tem um histórico rolante que entra como contexto, então o agente responde levando em conta as mensagens anteriores daquele número.
As credenciais do WhatsApp ficam seguras? Sim. A sessão é criptografada em repouso no seu servidor (mesmo padrão dos outros segredos do RoqueOS). Elas nunca são retornadas para o navegador.