Nesta página
Os dois tipos de agente
| Tipo | O que é | Para quem |
|---|---|---|
| Nativo | a IA da XBASE lê o site, o Instagram e as suas instruções e monta o agente para você | quem quer um agente pronto, sem programar |
| Externo | um agente que já roda fora da XBASE (por exemplo, no n8n ou numa API própria). A XBASE manda cada mensagem para o endereço dele e entrega a resposta ao contato | quem já tem um agente e só quer ligá-lo aos canais da XBASE |
O tipo aparece no card de cada agente, ao lado do status. O agente Externo é configurado fora da XBASE: aqui ficam só o endereço, o token e os canais.
Como o agente Nativo é criado
Na criação, você informa o site, o Instagram e os objetivos do agente, e pode escrever instruções adicionais. A IA da XBASE:
- lê a página inicial do site e até 7 páginas internas;
- lê o perfil público do Instagram: nome, bio e o que aparece sem login;
- monta as instruções do agente, com um roteiro de conversa para cada objetivo.
A tela mostra o andamento. No fim, ela lista O que o agente ainda não sabe e as fontes que não puderam ser lidas. Complete essas lacunas nas instruções do agente.
O modelo de IA do agente Nativo é definido pela XBASE: você não escolhe na criação.
O que dá para configurar
Abra o agente em Agentes IA. No agente Nativo, as principais áreas são:
- Painel: os cards Canais Conectados (onde o agente atende), Instruções do Agente (o texto que define o papel, o tom e as regras do agente), Modelo de Inteligência, Observabilidade & Análise e Objetivos do Agente.
- Memória → Conhecimento: arquivos que o agente consulta para responder, como catálogos e políticas.
- Aprendizados: sugestões de melhoria tiradas das conversas, quando a avaliação automática está ligada.
- Webchat: aparência e código do chat do site.
As instruções têm Histórico de versões: dá para voltar a uma versão anterior.
No agente Externo, o Painel mostra o card Webhook do agente (endereço, token e tempo máximo de resposta, com o botão Testar webhook) e os canais.
Onde o agente atende
| Canal | Nativo | Externo |
|---|---|---|
| WhatsApp (API oficial da Meta) | ainda não | sim |
| Chat do site | sim | não |
| Instagram (mensagens diretas) | ainda não | não |
- Cada número ou conta é atendido por um agente só. Um agente pode atender vários números.
- Para escolher os canais, use o card Canais Conectados, no Painel do agente: um interruptor por número. O botão Adicionar canal conecta um canal novo.
- Ligar o agente num número que já tem outro agente pede confirmação: o novo agente passa a atender o número, inclusive as conversas em andamento.
- Só quem tem permissão para gerenciar integrações muda os canais de um agente.
Para colocar o agente no seu site, veja como colocar o chat no seu site.
Como o agente responde no WhatsApp
Em cada número, o bloco Como o agente responde define:
- Esperar antes de responder (segundos): mensagens seguidas do contato dentro desse tempo são respondidas juntas. No agente Nativo, vem com 10 segundos; no Externo, com 0 (responde na hora). O máximo é 600.
- Formato: Uma mensagem só ou Várias mensagens curtas (um parágrafo por mensagem). No segundo caso, cada mensagem curta é cobrada pela Meta separadamente.
- Pausar quando um atendente assumir: já vem ligada. Com ela, o agente para de responder quando alguém da equipe responde a conversa.
O bloco fica na janela Agente de IA do número, em Canais. Os detalhes de templates e da janela de 24 horas estão em WhatsApp no Chatcenter.
Quando o agente para e a equipe assume
O agente não responde uma conversa quando:
- alguém da equipe assume a conversa: no cabeçalho dela, o seletor IA responde / Humano mostra quem está atendendo;
- a conversa tem a etiqueta "Atendimento Humano";
- o agente está Pausado. O interruptor de status fica no topo da página do agente, e pausar pede confirmação: o agente para de responder em todos os canais até você ativá-lo de novo;
- os créditos de IA do workspace acabaram (veja abaixo).
Para devolver a conversa, clique em IA responde, no cabeçalho da conversa. O agente volta a responder a partir da próxima mensagem do cliente. Mais detalhes em WhatsApp no Chatcenter.
Status do agente
| Status | O que quer dizer |
|---|---|
| Ativo | o agente responde nos canais ligados a ele |
| Pausado | você desligou o agente; ele não responde em nenhum canal |
| Rascunho | o agente Nativo ainda não terminou de ser criado, ou a criação falhou |
| Falha | houve um erro com o agente |
Só um agente Ativo pode ser ligado a um canal.
Créditos e custos
- Agente Nativo: cada resposta usa um modelo de IA e consome créditos de IA do saldo do workspace. A criação do agente com a IA da XBASE também consome créditos. O consumo aparece em Uso e consumo.
- Agente Externo: o processamento é feito fora da XBASE e não consome créditos de IA.
- Sem créditos: o agente Nativo para de responder. A conversa mostra, só para a equipe, o aviso "IA pausada: créditos esgotados", e nada é enviado ao cliente. Quando o saldo volta, o agente responde a partir da próxima mensagem; as mensagens que ficaram para trás não são respondidas.
- Mensagens do WhatsApp: as respostas do agente pelo WhatsApp também seguem a cobrança da Meta, como as da equipe. Veja Cobrança do WhatsApp.
- Avaliação automática: se você ligar a Observabilidade, cada avaliação também consome créditos. Veja Avaliação automática das conversas.
Os planos e a recarga de créditos estão em Planos, créditos e faturamento e na página de preços.
Regras e limites
- Para criar um agente Nativo, informe pelo menos uma fonte: o site, o Instagram ou instruções adicionais com 30 caracteres ou mais.
- Objetivos: de 1 a 5 por agente. O primeiro é o principal.
- Instruções adicionais: até 4.000 caracteres.
- O Instagram precisa ser um perfil público. Perfil privado ou que só abre com login não pode ser lido.
- Agente Externo: o endereço do webhook precisa começar com https://, e o tempo máximo de resposta vai de 1 a 120 segundos (padrão: 60).
- Criar e editar agentes exige permissão para gerenciar agentes no workspace.
Perguntas frequentes
Qual tipo de agente devo escolher?
Escolha Nativo se você quer que a XBASE monte o agente a partir do seu site, do Instagram e das suas instruções. Escolha Externo só se você já tem um agente rodando fora da XBASE, com um endereço de webhook.
Posso escolher o modelo de IA do agente Nativo?
Na criação, não: o modelo é definido pela XBASE. Ele aparece no card Modelo de Inteligência, no Painel do agente.
Posso editar as instruções que a IA escreveu?
Sim. No Painel do agente, abra o card Instruções do Agente e edite em tela cheia. O Histórico de versões guarda as versões anteriores.
Um número de WhatsApp pode ter dois agentes?
Não. Cada número é atendido por um agente só. Ao ligar outro agente, ele passa a atender o número no lugar do anterior.
O agente Externo funciona no chat do site?
Não. O chat do site só funciona com agente Nativo. O agente Externo atende pelo WhatsApp.
O que acontece quando os créditos acabam?
O agente Nativo para de responder e a conversa mostra o aviso IA pausada: créditos esgotados, só para a equipe. Depois da recarga, ele volta a responder a partir da próxima mensagem do cliente.
Como faço o agente parar de responder uma conversa?
No cabeçalho da conversa, clique em Humano e confirme em Assumir. Para parar o agente em todos os canais, pause o agente no interruptor de status, no topo da página dele.