🌐 このページはまだ日本語に翻訳されていません。ポルトガル語（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.
Quando ele responde: grupo, conversa e você mesmo
O agente atende em três lugares, e você controla o quanto ele fala em cada um.
Na conversa privada. Quem manda mensagem para o número é atendido direto.
No grupo. O agente participa de grupos, e a sala inteira compartilha uma memória só: ele acompanha o assunto do grupo em vez de manter uma conversa separada com cada pessoa. Para chamar, escreva /bot seguido da pergunta (também funcionam /roque, /ia e @bot).
No seu próprio chat. A conversa "Mensagens para mim" funciona: é o lugar mais natural para testar o agente sozinho.
Escolhendo o comportamento
No formulário do canal você escolhe entre três modos:
| Modo | Na conversa | No grupo |
|---|---|---|
| Só quando eu chamar | só com /bot | só com /bot |
| Autônomo na conversa, chamado no grupo (padrão) | responde sozinho | só com /bot |
| Autônomo em tudo | responde sozinho | responde sozinho |
O padrão é o do meio, e é também o que o canal já fazia antes desta opção existir, então nenhum canal seu muda de comportamento sozinho.
Chamando do seu próprio número
Você mesmo pode usar o /bot, do seu celular, dentro de qualquer grupo ou até numa conversa com outra pessoa: o agente responde ali, por você. É o caso de uso de "responder por mim".
Fora isso, nada do que você escreve é enviado ao agente. Sem o /bot, suas mensagens continuam privadas, mesmo em modo autônomo. Se fosse diferente, o agente acordaria a cada mensagem que você mandasse para qualquer pessoa.
Você também não precisa colocar o seu próprio número na lista de permitidos: ser o dono da linha basta. Os outros participantes do grupo continuam precisando de aprovação.
Grupo sempre exige lista de permitidos
Mesmo em modo público e mesmo em "autônomo em tudo", num grupo só os números da sua lista conseguem acionar o agente. Estar na sala não é consentimento: um grupo pode ter gente que nunca pediu para falar com um robô.
Áudio, imagem e vídeo
Áudio recebido é transcrito e o agente responde ao que foi dito. A transcrição entra no histórico, então ele lembra do assunto nas mensagens seguintes.
Imagem e vídeo ficam registrados na conversa junto com a legenda que vier.
O que é guardado é só o texto (a transcrição e a legenda). O arquivo em si não fica no servidor.
Respondendo por voz
O agente responde por escrito, a não ser que você peça voz. Para pedir, comece a mensagem com /voz (ou /audio):
/voz me explica como funciona o modo servidorTambém funciona escrevendo naturalmente ("me responde em áudio", "manda um áudio explicando"). O comando é removido antes de chegar ao agente, e pedir áudio já conta como chamar o bot, então em grupo você não precisa escrever /bot junto.
Precisa instalar os motores de fala
Transcrição e voz exigem o servidor instalado com --with-voice (ou -WithVoice no Windows). Eles rodam na sua máquina: o áudio que mandam para o seu número não sai do seu servidor. Custa cerca de 2,4 GB de disco e 1,7 GB de memória.
No formulário do canal você escolhe se o agente fala (desligado, só quando pedirem, ou sempre) e com qual voz. As vozes vêm do motor de fala do servidor: filtre por idioma, ouça uma prévia e ajuste a velocidade. Em Gerenciar vozes você baixa vozes novas do catálogo ou desinstala as que não usa mais (libera espaço no servidor; dá para baixar de novo depois).
Precisa que o agente fale com a sua voz? Em Clonar minha voz você grava uns 10 segundos (ou envia um arquivo de áudio), marca o consentimento, e sua voz vira uma opção na lista. A amostra é processada e guardada no seu servidor, nunca sai dele. Isso usa um motor de clonagem à parte, instalado com --with-voice-clone (ou -WithVoiceClone no Windows); sem ele a opção nem aparece. A fala gerada carrega uma marca d'água inaudível (padrão Perth do Chatterbox).
Escolha também o Idioma da voz (aparece logo abaixo quando a voz clonada está selecionada; começa em Português do Brasil). Isso importa: sem o idioma certo o motor pronuncia o texto com fonética inglesa, e o português sai com sotaque estranho. O sotaque em si vem da SUA gravação, então gravando em português do Brasil a voz clonada fala como você.
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.