R4 Staff
Config Global
Configurações gerais da plataforma
Evolution API
OpenAI
Modelo padrão usado por todos os agentes. Pode ser sobrescrito por agente nas configurações do agente.
Quantas mensagens anteriores o agente considera em cada resposta (padrão: 20). Menos = mais econômico.
Teto técnico para evitar respostas/custos excessivos. Só é usado quando o agente NÃO tem "Estilo de resposta" definido (padrão: 600). O tamanho da resposta deve ser controlado pelo Estilo de resposta de cada agente (Conciso/Detalhado/Completo) — este valor é apenas um limite de segurança, não a forma de deixar respostas mais curtas.
Notificações Telegram
Token do bot Telegram que envia alertas e diagnósticos. Se em branco, usa TELEGRAM_BOT_TOKEN do .env.
ID do grupo ou chat que recebe as notificações. Se em branco, usa TELEGRAM_CHAT_ID do .env.
Encerramento de transferência
Conversas aguardando humano no portal que não forem assumidas serão encerradas após este número de horas úteis (seg–sex). Use 0 para nunca expirar.
No modo "Notificar e fechar", o agente não reabre o atendimento durante este período. Após o prazo, qualquer mensagem inicia novo atendimento.
Após este número de horas úteis (dias úteis, qualquer hora), o próximo contato do lead inicia uma nova sessão do zero — evitando re-trigger de handoff por contexto antigo.
Mensagem fixa enviada quando o lead faz perguntas após a transferência, durante o período de silêncio. Agradecimentos e confirmações são ignorados automaticamente.
Pesquisa de satisfação
Enviada automaticamente após o lead responder a nota da pesquisa de satisfação.
Conversas & Sistema
Conversa no widget sem resposta por este tempo é encerrada automaticamente (padrão: 30 min).
Conversas encerradas há mais que este número de dias são movidas para o arquivo (padrão: 30 dias).
Regras globais dos agentes
Estas regras têm prioridade inferior às instruções configuradas em cada agente. Use para definir comportamentos base da plataforma.
Usuários
Gerencie usuários com acesso à plataforma R4
| Usuário | Nome exibido | Perfil | Ações |
|---|
Cliente
Agente
📱 WhatsApp
Modo de conexão
Aguardando QR Code...
Número do WhatsApp que será conectado — com DDI e DDD, só dígitos:
Conectado
Conectado via Meta Cloud API
Phone Number ID:
Webhook URL:
Verify Token:
Copie a Webhook URL e o Verify Token para o painel da Meta (Configurações → WhatsApp → Configurações do webhook)
Encontrado em: Meta Business Manager → WhatsApp → Conta de API
Gere em: Meta Business Manager → Usuários do sistema → Token do sistema (escopo: whatsapp_business_messaging)
Conectado via Coex
Phone Number ID:
Heartbeat:
⚠️ O dono do número precisa abrir o WhatsApp Business App no celular pelo menos uma vez a cada ~13 dias, senão a coexistência cai.
Antes de conectar:
• O número já precisa estar ativo no WhatsApp Business App (no celular do dono).
• Você fará login com o Facebook, dará acesso ao Business Manager e escolherá esse número.
• O número continua funcionando no app do celular e passa a ser atendido pela IA — as mensagens são espelhadas entre os dois.
• O número já precisa estar ativo no WhatsApp Business App (no celular do dono).
• Você fará login com o Facebook, dará acesso ao Business Manager e escolherá esse número.
• O número continua funcionando no app do celular e passa a ser atendido pela IA — as mensagens são espelhadas entre os dois.
📸 Instagram Direct
Conectado via Instagram Messaging API
IG User ID:
Webhook URL:
Verify Token:
No app Meta (ID 839543215878246): Webhooks → Instagram → Assinar campo messages. Cole a Webhook URL e o Verify Token.
Encontrado em: Graph API Explorer → GET /me?fields=id,name (com token do app R4 Staff)
Token do sistema com permissão instagram_business_manage_messages (requer aprovação Meta)
Quando a IA acionar transferência, o resumo será enviado a esses números via WhatsApp.
🌐 Widget Web
Quando ativo, o visitante vê o histórico da conversa mesmo após fechar e reabrir o navegador.
Clique no código para copiar. Cole no <head> do site ou no Google Tag Manager como "HTML Personalizado".
Google Drive
Nenhum link adicionado.
Perfil do Agente
Nome que o agente usará ao se apresentar nas conversas.
Objetivo(s) principal(is) *
Instruções adicionais
Pesquisa de satisfação
Follow-ups
Horário de atendimento
Tempo de resposta
Limite de interações
Transferências entre agentes
Transferir para humano
Encerramento automático
Parcelamento
Modelo de IA
Estilo de resposta
Pesquisa de satisfação
Ativar pesquisa de satisfação
Enviada ao encerrar atendimento
Pergunta
Follow-ups
🕐 Horário de Follow-ups
Restringir horário
Não enviar follow-ups fora do horário configurado
Dias da semana
Das
h até
h
Se o follow-up cair fora desse horário, os minutos de atraso serão contados apenas dentro do horário útil.
Horário de atendimento
Restringir horário de atendimento
Tempo de espera antes de responder
Aguarda este tempo após a última mensagem antes de processar. Permite acumular várias mensagens do lead. O indicador "digitando..." no WhatsApp é sempre 10s. Padrão: 10s
Limite de interações
Após atingir o limite, o agente para de responder. Padrão: 100
Transferências entre agentes
Transferir para humano
Quando a IA aciona a transferência, um resumo é enviado ao supervisor via WhatsApp e o atendimento é encerrado. Se o supervisor responder diretamente ao lead pelo WhatsApp, a IA detecta automaticamente e pausa — retomando após o período de inatividade configurado.
Enviada quando o agente pede nome e número antes de transferir. Deixe em branco para usar o padrão.
Encerramento automático
A IA encerrará a conversa automaticamente quando esse critério for atingido. Deixe em branco para desativar.
Após enviar todos os follow-ups, aguarda esse tempo (em horas) sem resposta do lead antes de encerrar automaticamente. Use 0 para desativar.
Parcelamento sem juros
Faixas de valor total da compra → máximo de parcelas sem juros. O sistema usa esta tabela para calcular as parcelas com precisão e corrige automaticamente a resposta do agente se ele oferecer mais parcelas que o permitido. Deixe vazio para desativar (o agente segue só a base de conhecimento).
Valor mínimo (R$)
Valor máximo (R$)
Parcelas
Dica: deixe o "Valor máximo" da última faixa em branco para significar "sem limite" (qualquer valor acima do mínimo).
Exceções por produto
Produtos com regra própria de parcelas (independente do valor). Têm prioridade sobre a tabela acima. Use a quantidade/kit como "condição" para diferenciar (ex: "3 ou 5 frascos" → 12x; "1 frasco" → 8x).
Modelo de IA
Define qual modelo OpenAI este agente usa para gerar respostas. O padrão (gpt-4o-mini) é o mais econômico. Modelos mais avançados geram respostas melhores mas custam mais por mensagem.
Estilo de resposta
Define o tamanho máximo e o estilo das respostas deste agente. Agentes que descrevem produtos com muitos detalhes devem usar Detalhado ou Completo. O padrão é Padrão (600 tok).
🔗
Webhook
Configurar
⚡
Zapier
Em breve
🔄
Make
Em breve
🔀
n8n
Em breve
📅
Google Calendar
Conectar
📊
Google Sheets
Configurar
🤝
R4 CRM
Conectar
🟢
Pipedrive
Conectar
🛒
Carrinho Abandonado
Configurar
📦
Melhor Envio
Configurar
📦 Melhor Envio — Cálculo de Frete
Quando configurado, o agente calcula automaticamente o frete e prazo de entrega assim que o lead informar o CEP. Usa a API oficial do Melhor Envio.
Gere em melhorenvio.com.br → Integrações → Tokens → escopo
shipping-calculateCEP de onde os produtos saem
Usado para cálculo de seguro. Deixe 0 para não declarar.
🤝 Integração com R4 CRM
Conecte este agente ao R4 CRM para criar leads automaticamente, registrar produtos de interesse, mover etapas do pipeline e salvar notas de FUP e resumos de conversa.
Pipeline
Origens
Para cada origem cadastrada no CRM, descreva como o agente deve identificar que o lead veio desta origem.
Produtos e Serviços
Descreva como o agente identifica interesse do lead em cada produto.
Avanço no Pipeline
Descreva o contexto que indica que o lead deve avançar para cada fase.
Notas Automáticas
🟢 Integração com Pipedrive
Conecte este agente ao Pipedrive do cliente para criar Pessoa + Negócio automaticamente, mover etapas do funil, atribuir o vendedor responsável e salvar notas de FUP e resumos de conversa. Um agente usa apenas um CRM por vez.
O endereço que aparece ao acessar o Pipedrive (ex:
empresa.pipedrive.com)Pipedrive → foto do perfil → Configurações da empresa → API pessoal → copie o token
Funil
Avanço no Funil
Descreva o contexto que indica que o negócio deve avançar para cada etapa.
Atribuição de Vendedor
Para cada usuário do Pipedrive, descreva quando o agente deve atribuir o negócio a ele. Deixe em branco para não atribuir automaticamente.
Produtos e Serviços
Descreva como o agente identifica interesse do lead em cada produto (opcional).
Notas Automáticas
📹 Modo Simples — Google Meet
Conecte uma conta Google para criar reuniões Google Meet automaticamente quando o fluxo de atendimento chegar ao passo "Agendar Meet".
Variáveis: {leadName}, {phone}
Esses e-mails serão adicionados como participantes em todas as reuniões.
DISPONIBILIDADE E AGENDAMENTO
Faixa 1:
às
Faixa 2:
às
(opcional)
O evento deve começar E terminar dentro dessas janelas. Feriados nacionais são ignorados automaticamente.
Quantas opções o agente apresenta ao lead (padrão: 3).
Primeiro horário disponível ao lead — evita oferecer reunião imediata (padrão: 120 min).
Até quantos dias à frente o agente pode oferecer horários (padrão: 30).
📊 Google Sheets — Integração via Apps Script
① Escolha quais dados registrar (ordem = colunas A, B, C...)
② Quando registrar uma linha?
③ Gere o código para o Apps Script
④ Cole o código no Google Sheets
Ver passo a passo
1Abra a planilha Google Sheets onde os dados serão salvos (pode ser qualquer planilha).
2No menu superior clique em Extensões → Apps Script.
3Apague todo o código existente na área de edição e cole o código gerado acima.
4Clique em Implantar → Nova implantação. Em tipo selecione App da Web. Em "Quem tem acesso" selecione Qualquer pessoa. Clique em Implantar.
5O Google vai pedir autorização — clique em Autorizar acesso e faça login com a conta Google dona da planilha.
6Copie a URL do App da Web gerada e cole no campo abaixo.
⑤ Cole a URL do App da Web
A URL começa sempre com
https://script.google.com/macros/s/🛒 Recuperação de Carrinho Abandonado
Detecta carrinhos abandonados na Loja Integrada e envia mensagem automática via WhatsApp para recuperar a venda. Requer Loja Integrada configurada na Base de Conhecimento (preset "Pedidos & Rastreio").
Mínimo de horas desde o abandono
Não contatar após este prazo
Variáveis disponíveis:
{nome} {itens} {total}🔗 Webhook — Configuração
Todas
Em Andamento
Em FUP
Transferidas
Encerr.
💬
Selecione uma conversa
🔗 Link de demonstração:
Link externo para demonstração — cada acesso inicia uma nova conversa. Compartilhe com clientes para mostrar o agente em ação.
Conversa de teste — não aparece no histórico
