Manual

Conectar o Orion

Enquanto não houver um canal conectado, o Orion existe só no painel. Aqui você escolhe por onde ele fala com você — WhatsApp, Telegram ou voz —, deixa que ele mesmo conduza a configuração e dá a ele acesso à sua agenda e à sua caixa de e-mail. É o passo que muda o dia a dia.

Leia em: Inglês · Espanhol

Os canais: WhatsApp, Telegram e voz

O canal é o lugar onde você conversa com o Orion. Existem três portas de entrada, e você pode usar mais de uma ao mesmo tempo:

WhatsApp
o canal principal. É por ali que ele te manda o resumo da manhã, te avisa do que está travado e recebe seus pedidos ao longo do dia.
Telegram
alternativa ao WhatsApp, com um bot que é seu (veja mais abaixo).
Voz no aplicativo do celular
uma conversa falada em tempo real, sem digitar. Faz parte dos planos que incluem voz — veja quais em orionworkers.com/pricing.

Além dos três, o chat "Pergunte ao Orion" acompanha todas as páginas do painel web — mesma conversa, mesmo agente. Ele não conta como canal para o teste grátis: o relógio dos 14 dias começa no primeiro dos três acima.

O teste grátis de 14 dias começa no primeiro canal

Os 14 dias, sem cartão, começam a contar no primeiro canal que você conectar: WhatsApp autorizado, Telegram vinculado ou a primeira sessão de voz — o que acontecer antes. Não é preciso ser o WhatsApp.

Até 14/08/2026 existia um segundo caminho: um canal de cortesia que se liberava sozinho quando a organização mostrava uso do método. Ele foi retirado. Hoje o canal do Orion é assinatura, com o teste de 14 dias como porta de entrada; o período gratuito do Y Managers cobre os assentos do painel, não o canal.

Qual número usar (leia antes de escanear)

Você tem duas opções, e elas dão poderes diferentes ao Orion.

Opção A — um número dedicado ao Orion. Um chip/número só dele. Você conversa com o Orion como conversaria com qualquer contato da sua lista. Esse número pode ganhar um papel público: o Orion atende quem escrever para ele — responde dúvidas, faz triagem, agenda — com uma persona separada da que ele usa com você, e escala para você o que precisar de humano. Ele não enxerga nada do seu WhatsApp pessoal: só existe ali o que você mandar para ele.

Opção B — o seu próprio número. O Orion passa a morar no seu WhatsApp, no chat consigo mesmo ("Mensagem para você mesmo"). As respostas dele vêm com o prefixo *Orion:* — é assim que você distingue o que é ele do que é você. Nesse modo o papel público fica bloqueado**, e a página avisa isso: o número é seu, e o Orion não vai responder aos seus contatos.

O que o seu próprio número liga em troca é o radar de relacionamentos automático. Vale saber exatamente o que isso significa:

  • Ele registra com quem e quando você falou, e usa isso para te avisar quem está esfriando e para criar contatos no CRM sozinho.
  • Das mensagens que você envia em conversas 1:1, ele extrai o texto; para os contatos que você escolheu acompanhar de perto, guarda um resumo curto (até 280 caracteres) do que você mandou, montando o histórico do relacionamento.
  • Ele não responde aos seus amigos, família ou clientes, e não marca suas mensagens como lidas — isso é imposto no código, não é só uma promessa.
  • O que os outros te mandam, ele não responde — e o que fica registrado mudou em 12/08/2026. A mensagem de terceiro no seu número continua sem resposta: ela não vira um turno da inteligência artificial e ele não decide nada em cima dela. O que fica guardado depende de quem é o contato: para as pessoas que você marcou para acompanhar de perto, ele guarda um resumo curto também do que elas te escreveram (antes só o que você escrevia entrava no histórico); para os demais contatos que já estão no seu CRM, fica só o registro de que houve contato naquele dia, sem conteúdo; e de quem não está no seu CRM não fica nada — uma mensagem de desconhecido não cria contato nem deixa rastro.
  • Se você pedir, ele lê qualquer conversa sua. "Resume minha conversa com o Ricardo" traz até 30 mensagens daquele chat; uma exportação por período pode trazer até 1000. Quem manda ler é você, e o que ele lê entra no contexto daquela conversa com ele.

Na primeira conexão em modo próprio número, ele manda no chat um aviso de privacidade. A página Conexão também tem o link "Como o Orion cuida da sua privacidade no WhatsApp", disponível a qualquer momento.

Resumindo
quer um assistente que também atenda seus clientes? Número dedicado. Quer o radar de relacionamentos automático sobre a sua vida real no WhatsApp? Seu próprio número.

Conectar o WhatsApp

  1. No painel, abra Orion → WhatsApp (a página se chama Conexão).
  2. Clique em "Conectar e iniciar teste grátis de 14 dias" — ou "Conectar WhatsApp", se você já tem plano.
  3. O QR code aparece em segundos. No celular: WhatsApp → Dispositivos conectados → Conectar dispositivo, e escaneie. A tela se atualiza sozinha quando você escanear.
  4. Prefere sem QR? Clique em "Conectar com um código", informe o número e digite o código exibido em WhatsApp → Dispositivos conectados → Conectar dispositivo → "Conectar com número de telefone".

Sobre o código, um limite real: o WhatsApp restringe a frequência com que códigos podem ser gerados, e essa restrição vale para a conta inteira, não só para você. Por isso o painel gera um código sob demanda e não oferece botão de "tentar de novo" — se não vier, use o QR, ou recarregue a página mais tarde.

Assim que a conexão fecha, o Orion manda a primeira mensagem e se apresenta. É de lá que segue a configuração que ele mesmo conduz.

Telegram: o bot é seu

Diferente do WhatsApp, o Telegram funciona com um bot que você cria e é dono. Na página Orion → Telegram, o caminho tem três passos:

  1. No Telegram, converse com o @BotFather e crie um bot. Ele devolve um token (algo como `123456:ABC…`).
  2. Cole o token no painel e escolha um PIN de sua preferência.
  3. Envie esse PIN ao seu bot, dentro do Telegram. É assim que o sistema confirma que quem colou o token é você.

Feito isso, o painel mostra o nome do bot e o status "conectado". O canal Telegram faz parte dos planos pagos — veja quais em orionworkers.com/pricing.

Números adicionais de atendimento

Se você quer um número separado para atender o público — recepção, suporte —, ele entra hoje por um caminho só: a API oficial do WhatsApp (Meta), no bloco "Números para atendimento via WhatsApp" da mesma página de Conexão (o bloco se chamava "Números adicionais de WhatsApp" até 11/08/2026). O caminho antigo por QR foi retirado em 05/08/2026, e junto com ele saiu a opção de número de prospecção de vendas: números adicionais existem hoje apenas na função de atendimento.

Cada número adicional é um item cobrado no seu plano, e o painel recusa a conexão antes de abrir o pop-up se a organização não tiver assinatura ativa.

Antes de começar, prepare:

  • Facebook do seu negócio. Você entra com ele, e a conta de WhatsApp criada fica no seu nome. O número e as conversas são seus; a plataforma apenas recebe permissão de uso.
  • Um número livre. Ele não pode estar em uso no WhatsApp hoje. Se estiver, apague primeiro a conta de WhatsApp dele — senão a conexão falha.
  • Como receber o código. Você vai receber um código para provar que o número é seu. Em telefone fixo ou número virtual, peça por chamada: SMS não chega nesse tipo de linha.
  • Uma forma de pagamento na conta do WhatsApp. Sem ela, o WhatsApp bloqueia os envios mesmo com todo o resto pronto.
  • Verificação do negócio (opcional no começo). Ela libera limites maiores e pede documentos da empresa. Dá para começar sem, com limites menores.

E os limites que são do WhatsApp, não nossos — vale ler antes de clicar:

  • Conectar não libera o número na hora. O WhatsApp analisa a conta antes. Costuma levar algumas horas e pode chegar a 24h. Nesse período o número aparece como Em análise e ainda não envia nem recebe.
  • Janela de 24 horas. Respostas livres valem por até 24h depois da última mensagem do cliente. Fora dessa janela, só saem modelos de mensagem pré-aprovados.
  • O número vira linha comercial. Ele deixa de funcionar no aplicativo comum do WhatsApp no celular.
  • Limite diário que escala. Conversas iniciadas pela empresa começam com um teto baixo, que sobe automaticamente conforme o número entrega com qualidade.

Depois de ativo, o número ganha o botão Papel público, onde você define papel, tom, roteiro da conversa e o que ele nunca pode fazer. O uso mais completo de um número de atendimento é o agendamento para os seus clientes — veja Os seus clientes.

Grupos

A lista dos grupos em que o Orion aparece é dividida por canal: os de WhatsApp ficam na página de Conexão, abaixo dos números, no bloco Grupos de WhatsApp; os de Telegram ficam em Orion → Telegram, no bloco Grupos de Telegram. Cada grupo tem duas decisões independentes — uma liga e desliga, a outra tem três posições —, e vale entender a diferença antes de clicar:

Participação
autoriza o Orion a responder ali. O botão Autorizar aparece na linha de qualquer grupo, dos dois canais, e pede uma confirmação antes de valer — você está colocando uma IA e um registro dentro de uma sala de gente que não assinou nada, e o combinado é avisar. Nenhum grupo é autorizado por padrão; você autoriza um a um, e só depois de autorizado aparecem a política de resposta e o campo de papel do grupo, onde você escreve uma persona só para aquele grupo. Uma diferença que vale saber hoje: essa chave governa mesmo os grupos de WhatsApp. Num grupo de Telegram a autorização já fica gravada, mas ainda não é ela que decide se o bot fala — ele responde quando a mensagem chega até ele, sem política de resposta e sem ferramentas naquele turno. A categoria, logo abaixo, é outra chave: o que ela decide sobre captura já vale nos dois canais.

Categoria (WhatsApp e Telegram): diz o que aquele grupo é. São três posições, e você escolhe uma na linha do grupo:

  • Regular (o padrão): nada do conteúdo é capturado. Se o Orion participar ali, responde só com conhecimento público — os documentos marcados como visíveis a convidados —, e nada do grupo vai para a biblioteca da organização.
  • 🏢 Trabalho interno (só colegas da empresa): o conteúdo passa a ser capturado e pode ser compartilhado com outras pessoas da empresa. Em troca, ali o Orion usa o conhecimento interno da organização, documentos podem ser arquivados na biblioteca, e você mexe no plano de trabalho dali mesmo.
  • 🤝 Trabalho externo (clientes, parceiros): o conteúdo é capturado, inclusive o que as pessoas de fora escrevem. O Orion usa só conhecimento público, arquiva na biblioteca apenas quando você pedir, e o plano de trabalho não é acessível a partir daquele grupo.

A categoria não é retroativa, você troca ou retira quando quiser, e o próprio Orion escreve no grupo avisando o que mudou — com um texto diferente para cada caso. Retirar para a captura dali para a frente; o que já foi capturado continua guardado. E no Telegram a captura é parcial por padrão: com a privacidade de grupo do bot ativa (o padrão do BotFather), só chegam até ele as menções e as respostas ao bot.

Uma não implica a outra: um grupo pode ser capturado sem que o Orion responda nele, e responder sem ser capturado. E desfazer uma não desfaz a outra — revogar a participação não retira a categoria, e a captura continua. É um assunto grande o bastante para ter capítulo próprio — está em O time de IA, e a parte de privacidade está no capítulo de segurança e privacidade.

A configuração que o próprio Orion conduz

Você não precisa configurar nada no painel. Logo depois de conectar, o próprio Orion conduz uma conversa de configuração em quatro etapas, direto no canal que você acabou de ligar.

1/4 · Personalidade 🧠 — ele pergunta, numa mensagem só: o que a sua empresa faz, como quer ser chamado e como ele deve soar (formal ou descontraído), e se há algo que ele nunca deve fazer. Um exemplo que ele mesmo dá: "Tenho uma clínica odontológica. Pode me chamar de Dr. Paulo, fale de forma profissional mas amigável. Nunca confirme consultas sem eu aprovar." Ele devolve um resumo e pede seu OK antes de salvar. Se você já tiver uma personalidade definida, ele mostra a atual e pergunta se quer manter ou ajustar.

2/4 · Contato 📇 — seu celular com DDD e seu melhor e-mail. Ele usa o e-mail para te mandar relatórios e te incluir em convites de agenda.

3/4 · Google 🔗 — ele manda um link para conectar sua conta Google. Os detalhes estão em Google e Microsoft 365, adiante.

4/4 · Rotinas automáticas ⏰ — ele propõe três rotinas diárias já adaptadas ao que você contou sobre o seu negócio (por exemplo, um resumo da agenda às 8h e uma revisão do fim do dia às 18h). Você responde "1 e 3", descreve do seu jeito, ou responde pular.

No fim, se o Orion estiver num número dedicado, ele pode perguntar se você quer que ele também atenda seus clientes — é opcional, e responder não deixa tudo como está.

Os comandos da configuração

pular
pula a etapa atual. Dá para retomar depois.
depois
pausa tudo por 3 dias. Também funciona com "mais tarde", "agora não", "pausar".

configurar ou continuar: retoma de onde parou, a qualquer momento.

Se você parar no meio, ele dá um toque gentil de vez em quando — nunca entre 21h e 8h no seu horário local, e no máximo três vezes, depois disso ele para e espera você chamar. Ele não insiste.

Idioma

O Orion fala português, inglês e espanhol. O idioma inicial vem do seu fuso horário: fusos de países de língua portuguesa (e fuso desconhecido) começam em português; os demais começam em inglês. Depois disso ele espelha o idioma em que você escreve — se você escrever em espanhol, ele responde em espanhol.

Se você escrever várias mensagens seguidas num idioma diferente do salvo, ele pergunta uma vez se quer trocar também o idioma das mensagens que ele envia sozinho (lembretes, resumos). E você pode fixar quando quiser: "fala comigo em português".

Google e Microsoft 365

Conectar uma dessas duas contas é o que mais aumenta o que o Orion consegue fazer. Você pode conectar as duas, uma, ou nenhuma — nada aqui é obrigatório.

Google

Duas formas, escolha a mais fácil: pelo link que o Orion envia na etapa 3/4 da configuração, ou pelo painel, em Orion → Google → "Conectar Google". Autorize na tela do Google e a página se atualiza sozinha.

Ele podeExemplo de pedido
Ver, criar, editar e cancelar eventos na Agenda"Como está minha agenda amanhã?" · "Marca reunião com a Ana terça às 15h"
Enviar e-mails pelo Gmail em seu nome"Responde esse e-mail dizendo que fechamos pra sexta"
Criar e editar documentos e planilhas no Drive"Monta uma planilha com esses números"
Consultar seus Contatos (somente leitura)"Qual o e-mail do Ricardo da Acme?"

Três limites que valem estar claros desde já, porque explicam quase todo "por que ele não conseguiu?":

Ele não lê sua caixa de entrada do Gmail. A permissão pedida é de envio, não de leitura. Para o Orion ler o que chega, use o encaminhamento de e-mails, adiante.

No Drive, ele só enxerga o que ele mesmo criou. É o escopo mínimo (`drive.file`). Se você pedir "lista meus arquivos do Drive", vêm apenas os arquivos que o Orion criou — os seus documentos antigos ele não vê, não abre e não edita. Quando tenta, a resposta dele é justamente essa.

Ele não dá acesso a ninguém. Ao criar um documento ou planilha, o Orion te devolve o link; compartilhar com outra pessoa é com você. (No OneDrive, do lado Microsoft, ele consegue gerar link de compartilhamento — a assimetria é real.)

A própria página resume as permissões pedidas: seu endereço de e-mail, Agenda, envio pelo Gmail, arquivos do Drive que ele cria e Contatos somente leitura.

Microsoft 365

Se a sua empresa vive no Outlook e no Teams, este é o seu capítulo. Abra Orion → Microsoft 365 e clique em "Conectar Microsoft 365". Uma janela da Microsoft abre; depois de autorizar, feche-a — a página se atualiza sozinha.

Na maioria das contas isso é um clique e não precisa de administrador de TI. Se a sua empresa desativou o consentimento por usuário, a tela da Microsoft vai dizer "Aprovação necessária". Nesse caso, clique em "Gerar link para o administrador" na mesma página: o link já vem copiado, você manda para o TI, e a aprovação dele libera a organização inteira de uma vez.

Ele podeExemplo de pedido
Ler e triar o Outlook"Tem algo importante no e-mail?"
Enviar e rascunhar e-mails no Outlook"Responde o Ricardo dizendo que fechamos sexta" · "Deixa um rascunho pra eu revisar"
Ver, criar, editar e cancelar eventos na Agenda"Marca reunião com a Ana terça às 15h" · "Cancela a de quinta e avisa os convidados"
Ler e enviar mensagens no Teams — 1:1 e grupo"O que rolou no chat do projeto hoje?" · "Manda no Teams do time que a versão subiu"
Criar e atualizar planilhas no Excel, criar documentos no Word"Monta uma planilha com esses números" · "Escreve a ata dessa reunião"
Listar, organizar e compartilhar arquivos no OneDrive"Cria a pasta Clientes 2026 e me manda o link de compartilhamento"
Criar páginas no OneNote e tarefas no To Do"Anota isso no OneNote" · "Adiciona no To Do: ligar pro contador"

E os limites, que aqui são diferentes dos do Google:

Ele lê a sua caixa de entrada do Outlook — direto, sem encaminhamento. Quem conecta o Microsoft 365 concede leitura de e-mail. É mais poder e é também menos privacidade que o lado Google; a escolha é sua, e desconectar é um botão na mesma página.

Mensagens de canal do Teams não são acessadas. Ele lê e escreve em conversas 1:1 e em chats de grupo. Canais de equipe (aquelas abas dentro de um time) exigiriam uma permissão de administrador que o produto deliberadamente não pede.

Contas pessoais da Microsoft não servem. A conexão é feita para contas corporativas/educacionais (work or school).

Se uma função nova pedir para reconectar, reconecte. As permissões de arquivos, rascunhos, OneNote e To Do foram acrescentadas em 28/07/2026. Quem autorizou antes disso continua com e-mail, agenda e Teams funcionando normalmente, mas as funções novas vão responder pedindo uma reconexão — que é o mesmo botão da primeira vez.

Sobre enviar coisas em seu nome

Vale dizer com precisão, porque é um ponto onde promessa e comportamento precisam bater.

Quando o Orion vai disparar um envio para terceiros (e-mail, WhatsApp, mensagem de Teams, convite de agenda com convidados externos), existe uma retenção automática: o sistema segura o envio, te mostra um rascunho campo a campo — "Confirmação de envio — nada foi enviado ainda" — e só envia depois do seu sim. Esse rascunho é montado pelo próprio sistema, não narrado pelo modelo, e o seu sim fica preso àquele texto exato: mudou uma vírgula, precisa confirmar de novo.

Essa retenção é acionada quando o turno leu conteúdo externo antes de enviar — um e-mail, um anexo, uma página da web, uma mensagem de grupo. É uma defesa contra instrução plantada: o que ele acabou de ler pode ser justamente quem está pedindo o envio.

Num pedido direto seu, num turno limpo — "manda um e-mail pro João dizendo que fechamos sexta" —, não há retenção pelo sistema: ele resolve o contato e envia. E na conversa por voz não há retenção nenhuma, em nenhum caso.

Na prática, o hábito que funciona: quando você quiser revisar antes, separe em dois pedidos. "Escreve o e-mail pro João sobre a proposta, mas não manda ainda." Você lê, ajusta, e só então: "pode mandar."

E-mails encaminhados

Este é o passo opcional que mais muda a rotina de quem vive na caixa de entrada. Ele existe porque o Orion não lê o seu Gmail — a permissão que ele pede no Google é de envio. O encaminhamento é o que dá a ele o outro lado.

  1. No painel, abra Orion → E-mails e clique em Copiar no campo do endereço. Ele tem a forma `[email protected]`.
  2. No seu provedor (Gmail, Outlook, iCloud, Yahoo…), configure o encaminhamento automático para esse endereço.
  3. O Gmail manda um e-mail de confirmação para o endereço encaminhado — que você nunca veria. O Orion confirma sozinho e te avisa no WhatsApp: "✅ Seu e-mail agora está conectado."

A partir daí, a pergunta que destrava tudo é simples: "tem algo importante no e-mail?". Ele resume o que chegou, separa o que importa, lê o e-mail inteiro quando você pede, abre anexos (PDF, imagem, Word, Excel, CSV, texto) e rascunha respostas. O envio da resposta sai pela conta que você conectou — Gmail, se o Google estiver ligado; Outlook, se for o Microsoft.

A página de E-mails mostra o que ele já recebeu, com os contadores de Novo, Lido por cima, Lido e Total.

Se nada chegar, ele te avisa. Quando o Google está conectado mas nenhum e-mail jamais alcançou o endereço do agente, o Orion percebe — porque nem a confirmação do provedor apareceu — e te manda uma mensagem explicando o que falta. Ele faz isso uma vez e repete no máximo mais uma, alguns dias depois. Depois disso, para.

E-mail corporativo pode barrar. Muitos administradores de Google Workspace e Microsoft 365 bloqueiam encaminhamento automático externo. Se for o seu caso, peça ao TI para liberar "encaminhamento automático externo" — ou conecte um e-mail pessoal.

No Microsoft 365 não há encaminhamento. Quem conectou o Microsoft já deu permissão de leitura: o Orion lê o Outlook direto, sem esse passo. Se você usa os dois, o encaminhamento continua servindo para caixas que não estão no Outlook.

Continue lendo