Agente
Uma inteligência configurável que raciocina, usa ferramentas, consulta dados e conversa com pessoas. É passivo por natureza: só age quando recebe uma mensagem ou um gatilho.
Documentação oficial da Julia
Como podemos ajudar você hoje?
Tudo o que você precisa para criar, treinar e colocar a Julia para trabalhar: agentes, canais de atendimento, base de conhecimento, integrações e automações.
5canais de atendimento
14+ferramentas nativas
24/7a Julia não dorme
Resultados para
Sua Julia no ar em 4 etapas
Do zero ao primeiro atendimento automático. Siga na ordem — cada etapa depende da anterior.
-
01
Crie o agente
Um agente é a Julia com uma função específica. Ele nasce com dois campos: o Role (identidade e propósito, em uma frase) e o Prompt (as instruções completas de comportamento, tom e regras — até 15.000 caracteres).
Ver guia de agentes -
02
Ensine o que ela precisa saber
Crie uma Base de Conhecimento com seus textos e PDFs (produtos, preços, políticas, FAQ) e vincule ao agente pela ferramenta de conhecimento. É daqui que a Julia tira as respostas confiáveis.
Ver guia de conhecimento -
03
Conecte um canal
Ligue a Julia ao WhatsApp, Instagram, Telegram ou ao Widget do seu site. Cada canal aponta para um agente ou squad responsável.
Ver guia de canais -
04
Teste, publique e acompanhe
Valide tudo no Chat Interno, publique a versão em produção e acompanhe as conversas no Inbox, onde sua equipe assume o atendimento quando for necessário.
Ver guia do Inbox
O vocabulário da Julia
Entenda estes termos e o resto da plataforma fica simples.
Squad
Um time de agentes trabalhando junto. Use quando um único agente teria instruções demais — cada especialista cuida de uma parte da jornada.
Role
A identidade do agente em uma frase curta: “Especialista em agendamento de consultas”. Define o propósito, não o passo a passo.
Prompt
As instruções detalhadas: tom de voz, objetivos, o que fazer em cada situação e o que nunca fazer. Suporta até 15.000 caracteres.
Temperatura
Criatividade x consistência. Baixa (0–20%) para regras, preços e compliance. Alta para brainstorming e textos livres. Atendimento costuma ficar entre 10% e 30%.
Effort
Profundidade de raciocínio e número de iterações (escala de 10 a 100). Mais effort = respostas mais elaboradas, porém mais lentas e caras.
Capacidades
O que o agente tem permissão de acessar e executar: ferramentas, MCPs e workflows. Sem a capacidade ativa, o agente não usa o recurso.
Ferramentas (Tools)
Extensões que vão além de responder texto: consultar API, ler PDF, buscar na web, gravar em tabela, abrir ticket para humano, agendar follow-up.
Base de Conhecimento
Onde a Julia aprende o que dizer e em qual informação confiar. Aceita texto e PDF, é reutilizável e pode ser vinculada a vários agentes.
Tabelas
Banco de dados nativo e leve. A Julia lê e escreve em tempo real: leads, pedidos, dúvidas sem resposta, feedbacks — com busca semântica.
Workflows
Camada de automação em nós, montada visualmente. Ideal para processos de múltiplas etapas e integrações — sem escrever código.
Canais
As interfaces por onde a Julia fala com o cliente final: WhatsApp (Oficial e não oficial), Instagram, Telegram e Widget de site.
Inbox
O centro operacional. Reúne o histórico das conversas automáticas e os tickets de atendimento humano em uma única tela, em tempo real.
MCPs
Conectores para sistemas externos (agenda, CRM, planilhas). Permitem que a Julia execute ações em ferramentas que você já usa.
Memória contextual
Variáveis persistentes que guardam informações do usuário — nome, plano, orçamento — e voltam nas próximas conversas.
Versionamento
Você edita em Draft, testa, publica em Produção e pode voltar (rollback) para qualquer versão anterior.
Documentação por tema
Clique em um tema para abrir. Use a busca no topo para encontrar um assunto específico.
Agentes e configurações
O que é um agente
Não é um chatbot de árvore de decisão. É uma entidade de IA configurável que raciocina sobre o pedido, decide se precisa usar uma ferramenta, busca dados e responde. Ele é passivo: só entra em ação a partir de uma mensagem do usuário ou de um gatilho interno.
As configurações, uma a uma
| Configuração | O que faz | Recomendação |
|---|---|---|
| Model Selection | Escolhe o provedor e o modelo de linguagem que vai raciocinar. | Modelos mais fortes para vendas e diagnóstico; modelos rápidos para triagem simples. |
| Role | Identidade e propósito do agente. | Uma frase. Específica. Sem lista de tarefas. |
| Prompt | Tom, lógica e regras de comunicação (até 15.000 caracteres). | Estruture em blocos: objetivo, tom, regras, o que nunca fazer, exemplos. |
| Temperature | Criatividade x previsibilidade. | Baixa para preços, prazos e regras. Média para copy e relacionamento. |
| Effort | Profundidade do raciocínio e número de iterações (10 a 100). | Comece no meio da escala e suba só se as respostas estiverem rasas. |
| Capacidades | Quais ferramentas, MCPs e workflows o agente pode executar. | Ative apenas o necessário. Menos capacidade = comportamento mais previsível. |
| Conditional Prompts | Instruções que só valem em situações específicas. | Use para exceções (cliente inadimplente, fora do horário, canal específico). |
| Internal Name | Nome interno para você organizar — o cliente não vê. | Padronize: [Canal] – [Função] – [Versão]. |
| Internal Chat | Ambiente de teste para validar o comportamento antes de publicar. | Teste sempre aqui antes de publicar em produção. |
Não existe botão “Salvar”.
As configurações do agente salvam sozinhas: campos de texto após ~1,25 segundo sem digitar,
e controles (sliders, seletores) após ~0,3 segundo.
Recursos que ampliam o agente
- Memória — guarda informações do usuário entre conversas.
- Bases de Conhecimento — FAQs, políticas e documentação de produto.
- Tabelas — leads, clientes, pedidos e registros consultáveis.
- Workflows — processos de várias etapas com lógica complexa.
- MCPs — conexões com sistemas externos (agenda, CRM, planilhas).
Squads: quando usar
Quando um agente só começa a errar porque tem contexto demais. Divida em especialistas — triagem, vendas, suporte técnico, financeiro — e deixe o squad coordenar a passagem de bastão.
Base de Conhecimento — treinando a Julia
A Base de Conhecimento é onde a Julia aprende o que dizer, como dizer e em qual informação confiar. Ela é independente do agente: você cria uma vez e vincula a quantos agentes ou squads quiser.
Formatos aceitos
- Texto — conteúdo escrito direto na interface. Ideal para FAQ, políticas e definições.
- PDF — manuais, tabelas de preço, materiais de treinamento.
O ciclo completo
- Defina a base e o propósito dela (ex.: “Produtos e preços 2026”).
- Adicione os itens em texto ou PDF.
- Aguarde o processamento e a indexação do conteúdo.
- Vincule a base ao agente pela ferramenta de conhecimento.
- Atualize sempre que a informação mudar — apague a versão antiga antes.
Boas práticas que fazem diferença real
Faça
- Use títulos e subtítulos claros para segmentar o conteúdo.
- Um assunto por item — não misture preço, onboarding e suporte no mesmo bloco.
- Mantenha parágrafos abaixo de ~1.500 caracteres: trechos curtos são melhor indexados.
- Inclua sinônimos naturais (“plano”, “pacote”, “mensalidade”) para cobrir variações de pergunta.
- Centralize o que é comum a todos os agentes em uma base compartilhada.
- Marque o idioma quando houver conteúdo bilíngue:
(PT)/(EN).
Evite
- Blocos de mais de 2.000 caracteres sem quebra ou estrutura.
- Informação duplicada ou conflitante entre itens — é a causa nº 1 de resposta errada.
- Repetir palavra-chave artificialmente: a busca é semântica, não por palavra exata.
- Excesso de emojis, símbolos decorativos e formatação irregular.
- Deixar o item antigo no ar depois de atualizar o preço ou a política.
A Julia respondeu errado?
Antes de mexer no prompt, procure na base por duas informações que se contradizem.
Na maioria dos casos o problema não é o agente — é a base com duas versões da mesma verdade.
Canais de atendimento
Canais são as interfaces em que a Julia conversa com o cliente final. Cada canal é ligado a um agente ou squad responsável, pode ter um prompt próprio e pode ser ativado ou desativado a qualquer momento.
WhatsApp Oficial
Integração pela API oficial da Meta. É a opção recomendada para operação séria: estável, com número verificado e sem risco de bloqueio por uso indevido.
WhatsApp (não oficial)
Conexão alternativa por leitura de QR Code. Rápida de subir, útil para testes e volumes pequenos.
Responde ao Direct da conta comercial conectada. Não aceita anexo de documentos.
Telegram
Integração direta via bot do Telegram.
Widget de site
Chat embutido no seu site, com tema claro/escuro, cores personalizáveis e histórico de conversa.
Conectando o WhatsApp Oficial — passo a passo
- Tenha uma conta no Meta Business e um número de telefone (novo ou já usado no WhatsApp Business).
- Vá em Configurações do workspace → Conexões → Nova conexão.
- Selecione WhatsApp (Oficial), dê um nome e clique em conectar. Libere os pop-ups do navegador.
- No fluxo da Meta: escolha ou crie o portfólio de negócios.
- Escolha o tipo de conexão: número novo, número existente do app, ou modo coexistência (App + API).
- Digite o número com o código do país. Se for um número já usado, os dados precisam bater com os do app.
- Verifique o número por QR Code ou código de acesso.
- Confirme fuso horário e permissões e finalize.
Verificação do portfólio. Portfólios novos precisam ser verificados pela Meta
(documento de constituição da empresa e comprovante de endereço). O prazo costuma ser de
2 a 5 dias úteis. Você verifica uma vez e depois pode adicionar até 40 números sem repetir o processo.
Colocando o Widget no seu site
- Crie um canal do tipo Widget e escolha o agente ou squad que vai responder.
- Ajuste tema (claro/escuro), cores das bolhas, do texto e dos botões — com pré-visualização ao vivo.
- Configure o atraso de resposta, se quiser um ritmo mais humano.
- Copie o snippet JavaScript gerado e cole antes do fechamento do
</body>do seu site. - Use o Widget de Teste para validar o rascunho com outras pessoas antes de publicar.
Anexos no widget: PDF, Markdown e texto, até 10 MB por arquivo. O conteúdo de um PDF é lido até 50.000 caracteres.
Ferramentas, MCPs e integrações
Sozinho, um agente só sabe responder com o que está no prompt. As ferramentas são o que ampliam isso: acessar dados, executar ações, integrar com sistemas e escalar para um humano. A Julia decide sozinha quando usar cada ferramenta, com base na descrição dela — e, se faltar alguma informação obrigatória, ela pergunta ao cliente antes de executar.
Busca na Base de Conhecimento
Consulta a documentação que você cadastrou.
Requisição HTTP
Chama APIs externas (GET, POST, PUT, DELETE, PATCH).
Busca na Web
Traz informação atualizada da internet.
Leitor de PDF
Extrai e interpreta conteúdo de documentos.
Execução de Código
Cálculos e transformações de dados sob demanda.
Execução de Workflow
Dispara um processo automatizado de várias etapas.
Envio de Mensagem
Envia notificações para números específicos.
Follow-up
Retoma a conversa automaticamente após um período de inatividade.
Ferramentas de Tabela
Insere, atualiza e busca registros no banco nativo.
Criação de Ticket
Transfere a conversa para um atendente humano.
Etiquetagem de Chat
Classifica a conversa por tags, sem abrir ticket.
Memória Contextual
Guarda e recupera dados do usuário entre conversas.
Execução Agendada
Roda rotinas em horários definidos.
Bloqueio de Usuário
Impede interação entre robôs e conversas indesejadas.
Menos é mais. Crie ferramentas só quando forem realmente necessárias.
Agente com configuração enxuta tem comportamento muito mais previsível.
MCPs
MCPs são conectores para plataformas externas — agenda, CRM, planilhas, sistemas próprios. Você conecta uma vez nas configurações e libera o acesso nas capacidades do agente.
Workflows e automações
Workflow é uma tela em branco onde você arrasta e conecta nós para montar um processo automatizado, visualmente e sem código. Começa por um gatilho (um webhook, uma chamada do agente) e segue encadeando ações.
Agente ou workflow?
| Use agente quando… | Use workflow quando… |
|---|---|
| a tarefa é conversar, interpretar e decidir dentro do diálogo. | a tarefa é orquestrar um processo com etapas fixas e integrações. |
| a resposta depende de contexto e linguagem natural. | a lógica é determinística: se A, faça B, depois C. |
Tipos de nó disponíveis
- Webhook Request / Response — recebe e devolve dados para sistemas externos.
- Agent Request / Response — comunicação entre agente e workflow.
- Requisição HTTP — chama APIs externas.
- Variáveis — guarda valores para usar nas etapas seguintes.
- LLM — processa ou gera texto no meio do fluxo.
- Envio de Mensagem — dispara mensagem no WhatsApp ou Instagram.
- Switch — bifurca o fluxo por condição.
- Gatilho de Evento Externo — inicia o fluxo a partir de um evento de fora.
Tabelas e dados
Tabelas são o banco de dados nativo da Julia: estruturas leves que o agente lê e escreve em tempo real. São formadas por colunas (a estrutura), linhas (os registros) e busca semântica (consulta por significado, não por palavra exata).
Para que servem no dia a dia
- Registrar leads e contatos capturados na conversa.
- Guardar as perguntas que a Julia não soube responder — sua lista de melhorias da base.
- Coletar feedback e notas de atendimento.
- Compartilhar a mesma base de dados entre vários agentes.
- Alimentar workflows com dados estruturados.
Tabela x Base de Conhecimento. A base guarda conteúdo para responder
(texto, PDF, políticas). A tabela guarda registros para consultar e atualizar
(linhas com campos). Se o dado muda a cada cliente, é tabela.
Inbox e atendimento humano
O Inbox é o centro operacional das conversas. Ele une, na mesma tela e em tempo real, o histórico do que a Julia atendeu sozinha e os tickets que precisaram de uma pessoa. As conversas ficam ordenadas por atividade mais recente.
Filas do atendimento humano
- Não respondido — entrou na fila e ninguém assumiu.
- Em andamento — alguém do time está atendendo.
- Finalizado — o ticket foi concluído.
Finalizar o ticket não encerra a conversa. O cliente pode voltar a qualquer momento
e novas mensagens continuam atualizando a lista. Uma mesma conversa pode acumular vários tickets ao longo do tempo.
Recursos de organização
- Visões rápidas — todas, atribuídas a mim, fila humana, não atribuídas, por tag, por time.
- Filtros avançados — canal, status do ticket, responsável, tags e busca. O filtro fica salvo na URL, então dá para compartilhar a visão com o time.
- Kanban — quadros configuráveis a partir das tags da conversa.
- Times e distribuição — roteia a conversa para o grupo certo.
- Papéis e permissões — controla o que cada pessoa pode ver e fazer.
- Custo estimado de IA — visibilidade do custo por conversa.
Como a Julia passa o bastão
Quando o agente chega no limite do que pode resolver — ou quando o próprio prompt manda escalar — ele usa a ferramenta de criação de ticket, a conversa entra na fila humana e o time assume de onde parou, com todo o histórico à vista.
Versionamento: publicar sem quebrar
Toda alteração acontece primeiro em um ambiente de rascunho, sem afetar quem está sendo atendido agora.
- Draft — seu espaço privado de edição. Nada aqui chega ao cliente.
- Produção — a versão ativa, que responde em todos os canais.
- Histórico — todas as versões publicadas ficam guardadas para comparação e rollback.
Fluxo seguro
- Edite no Draft.
- Teste no Chat Interno.
- Revise e publique.
- Se algo sair errado, faça rollback para a versão anterior.
| É versionado | Fica sempre ativo (não versiona) |
|---|---|
| Agentes, squads, ferramentas, MCPs, vozes, componentes e tarefas. | Canais, conversas, tickets, tags, execuções, bases de conhecimento, tabelas, usuários, conexões e cobrança. |
Versionamento muda o comportamento, não os dados.
Publicar ou fazer rollback nunca apaga histórico de conversa nem registros armazenados.
Planos, consumo e limites
A cobrança não é por funcionalidade, e sim por uso: o custo acompanha a atividade dos seus agentes.
Os três pilares de consumo
- Execuções externas — a métrica central. Cada turno de conversa com um cliente real, em um canal ativo, conta como uma execução.
- Uso interno de teste — o chat de testes tem cota própria, para você iterar sem medo.
- Uso do construtor com IA — criar e diagnosticar agentes por linguagem natural tem limite separado.
Limites secundários por plano
Membros da equipe, integrações externas, quantidade de tabelas e de linhas, bases de conhecimento, execuções simultâneas de workflow e histórico de versões disponíveis para rollback.
Custo do modelo de IA é separado. O consumo de tokens dos provedores de modelo
é cobrado diretamente por eles. A plataforma mede o uso; o provedor cobra o token.
Deu ruim? Comece por aqui
Os cenários mais comuns, com sintoma, causa provável e o que fazer.
A conexão do WhatsApp caiu sozinha
Sintoma: a conexão foi desativada automaticamente e chegou um aviso de erro.
Causas mais comuns, na ordem:
- Forma de pagamento. No portfólio da Meta, vá em Contas do WhatsApp → Configurações de pagamento e confirme que o cartão é válido, está atualizado e não foi recusado.
- Nome de exibição reprovado. No Gerenciador do WhatsApp, aba Perfil: o nome precisa ter relação real com o negócio e seguir as diretrizes da Meta.
- Verificação de negócio pendente. Em Informações do negócio, complete país, tipo de empresa, razão social, CNPJ e endereço.
- Conta suspensa ou com alerta. Verifique Faturamento e a Central de Segurança da Meta.
Passe o mouse sobre o aviso em Conexões para ver o detalhe do erro — e confira o e-mail, que costuma trazer a mensagem completa.
Não consigo enviar mensagens
Sintoma: a conexão parece ativa, mas nada sai.
Verifique nesta ordem: 1) a conexão está ativa; 2) existe um canal vinculado a essa conexão; 3) esse canal tem um agente ou squad ativo respondendo. Se qualquer um dos três estiver faltando, a mensagem não sai.
A verificação do número falha
Sintoma: o QR Code ou o código de acesso não é aceito.
Contas novas costumam precisar de 15 a 30 minutos antes de uma nova tentativa. Espere e tente o outro método (se usou QR, tente o código). Se a janela de conexão nem abre, o problema é o bloqueador de pop-up — libere os pop-ups e prefira o Chrome.
O histórico antigo não apareceu
Sintoma: depois de conectar, as conversas anteriores não estão lá.
É uma limitação da própria API do WhatsApp: só as conversas novas, a partir da conexão, aparecem. Não há como importar o histórico anterior.
O follow-up não dispara
Sintoma: a Julia deveria retomar a conversa e não retoma.
O ponto que quase todo mundo erra: o agente avalia a condição do follow-up no momento em que envia a mensagem — ele não prevê o futuro.
- Descreva o estado atual, não uma hipótese futura.
“Se o usuário não responder…”
“O usuário perguntou o preço mas ainda não escolheu o plano” - Dê tempo + ação concretos.
“Enviar um follow-up depois”
“Após 30 minutos, perguntar se ele quer ajuda para escolher” - Respeite a janela de 24 horas do WhatsApp e do Instagram: follow-up agendado além disso não é entregue.
- Se o cliente responder antes do horário agendado, os follow-ups pendentes são cancelados. Isso é esperado.
A Julia respondeu algo errado ou inventado
Sintoma: informação incorreta, desatualizada ou que não existe.
- Procure informação duplicada ou conflitante na base de conhecimento. É a causa mais frequente.
- Confirme que o item antigo foi apagado depois da atualização — não basta adicionar o novo.
- Baixe a temperatura do agente se o tema exige precisão (preço, prazo, regra).
- Reforce no prompt: “se a informação não estiver na base, não invente — abra um ticket para o time”.
- Verifique se a capacidade de busca na base está ativa no agente.
A Julia ignora a base de conhecimento
Sintoma: ela responde “genérico” mesmo com a base cadastrada.
Checklist: a base está processada e indexada? Está vinculada ao agente pela ferramenta de conhecimento? A capacidade correspondente está ativa? O conteúdo está segmentado em blocos curtos com títulos claros? Um bloco gigante e sem estrutura é indexado mal e raramente é recuperado.
Mudei o agente e nada mudou no atendimento
Sintoma: a alteração funciona no teste mas não no canal real.
Você editou o Draft e não publicou. O canal usa sempre a versão em Produção. Revise as alterações e publique. Se a nova versão piorar o atendimento, faça rollback para a anterior pelo histórico.
Ficou com dúvida? Pergunte aqui
Escreva sua pergunta na caixa abaixo. Se a Julia não resolver, ela leva você direto para um humano do time.
Julia
Online agora
Enter envia · Shift + Enter quebra linha
Dúvidas que chegam todo dia
A Julia funciona 24 horas por dia?
Sim. O agente responde em qualquer horário, todos os dias. Você pode configurar comportamentos diferentes para fora do horário comercial usando prompts condicionais — por exemplo, informar que um humano retorna pela manhã e já registrar o contato.
Preciso saber programar para usar?
Não. Agentes, bases de conhecimento, canais e workflows são configurados por interface. Programação só aparece se você quiser usar recursos avançados como requisições HTTP para sistemas próprios ou execução de código.
Quanto tempo leva para colocar no ar?
A configuração do agente e da base leva de algumas horas a poucos dias, dependendo do volume de conteúdo. O prazo maior costuma ser externo: a verificação do portfólio de negócios na Meta, que leva de 2 a 5 dias úteis para o WhatsApp Oficial.
Posso usar o mesmo número que já uso no WhatsApp Business?
Pode. Na conexão, escolha a opção de conectar um número existente do aplicativo — ou o modo coexistência (App + API), que mantém o app funcionando enquanto a automação atua. Os dados informados precisam bater com os do aplicativo.
Quantos números posso conectar?
Até 40 números por portfólio. E a verificação é feita uma única vez: depois de verificado, você adiciona os demais números sem repetir o processo.
Como faço a Julia passar a conversa para minha equipe?
Pela ferramenta de criação de ticket. Ative a capacidade no agente e descreva no prompt em quais situações escalar (pedido de desconto fora da política, reclamação, assunto jurídico, cliente pedindo humano). A conversa entra na fila do Inbox com todo o histórico.
A Julia inventa resposta?
Ela responde com base no prompt e na base de conhecimento vinculada. Para reduzir ao mínimo o risco de resposta imprecisa: mantenha a base limpa e sem contradições, baixe a temperatura em temas sensíveis e instrua explicitamente o agente a escalar para um humano quando não tiver a informação.
Consigo testar antes de o cliente ver?
Sim, e é o fluxo recomendado. Edite no Draft, valide no Chat Interno e só depois publique em produção. Para o widget, existe ainda um widget de teste que pode ser compartilhado externamente sem afetar a versão publicada.
Se eu publicar algo errado, dá para voltar?
Dá. Todas as versões publicadas ficam no histórico e você pode fazer rollback. Importante: o rollback muda o comportamento do agente, mas nunca apaga conversas, tickets ou dados armazenados.
Como funciona a cobrança?
Por uso. A métrica principal são as execuções externas — cada turno de conversa com um cliente real em um canal ativo. Testes internos e o construtor com IA têm cotas próprias. O consumo de tokens dos provedores de modelo de IA é cobrado separadamente, direto por eles.
A Julia atende em outros idiomas?
Sim. Defina o idioma no prompt e, se a base for bilíngue, marque os blocos por idioma — (PT) e (EN) — sem misturar frases de idiomas diferentes dentro da mesma seção.
Posso ter mais de uma Julia?
Pode, e em muitos casos é o certo. Um agente por função (triagem, vendas, suporte, financeiro) rende mais do que um único agente com instruções demais. Quando eles precisam atuar juntos, monte um squad.