{ "fonte": "Documentação oficial da Profluxus", "categorias": [ { "nome": "Profluxus Talk", "slug": "talk", "resumo": "Atendimento multicanal: caixas de entrada, conversas, times e relatórios.", "simbolo": "💬" }, { "nome": "Profluxus Shop", "slug": "shop", "resumo": "Catálogo, pedidos, cupons e link de carrinho dentro da conversa.", "simbolo": "🛒" }, { "nome": "Profluxus Imob", "slug": "imob", "resumo": "Cadastro de imóveis, vitrine e envio de seleção para o cliente.", "simbolo": "🏠" }, { "nome": "RADS", "slug": "rads", "resumo": "Campanhas de anúncios, sincronização de contas e atribuição de resultado.", "simbolo": "📈" }, { "nome": "Pipeline Board", "slug": "pipeline-board", "resumo": "Funil em quadros: etapas, responsáveis, checklists e relatórios.", "simbolo": "🗂" }, { "nome": "Apps PWA, Android e iOS", "slug": "apps", "resumo": "O atendimento no celular, com notificação de mensagem nova.", "simbolo": "📱" }, { "nome": "Conta e acesso", "slug": "conta", "resumo": "Usuários, perfis de permissão, troca de conta e segurança.", "simbolo": "🔑" }, { "nome": "API e integrações", "slug": "api", "resumo": "Token de acesso, webhooks e a API pública da documentação.", "simbolo": "🔌" }, { "nome": "Studio", "slug": "studio", "resumo": "Construtor de fluxo para WhatsApp, site, e-mail, API e Telegram.", "simbolo": "🎛️" }, { "nome": "SocialFlow", "slug": "socialflow", "resumo": "Portão de qualificação, fluxos, comentários e agenda no Instagram e Facebook.", "simbolo": "📲" }, { "nome": "Lead Conversions", "slug": "lead-conversions", "resumo": "Cruza os leads do Talk com as vendas e mede conversão por consultor, canal e mês.", "simbolo": "📈" }, { "nome": "Bridge", "slug": "bridge", "resumo": "Automação por hora, webhook ou evento, ligando o Talk a sistemas de fora.", "simbolo": "🔗" } ], "artigos": [ { "slug": "primeiros-passos", "categoria": "talk", "titulo": "Primeiros passos no Profluxus Talk", "resumo": "O que configurar na primeira semana, na ordem que faz sentido.", "palavras_chave": [ "começar", "configurar", "onboarding", "instalação", "início" ], "url": "https:\/\/www.profluxus.com\/docs\/talk\/primeiros-passos", "atualizado_em": "2026-08-12", "conteudo": "O Profluxus Talk junta todas as conversas da empresa em uma caixa de entrada só. Antes de colocar o time para atender, vale configurar quatro coisas — nesta ordem.\n\n## 1. Criar as caixas de entrada\n\nCada canal vira uma **caixa de entrada**: WhatsApp, Instagram, Facebook, Telegram, e-mail ou o chat do site. É a caixa que define por onde a mensagem sai quando o agente responde.\n\nUm número de WhatsApp = uma caixa. Se a empresa tem dois números, são duas caixas, e cada uma pode ter um time diferente.\n\n## 2. Cadastrar os agentes\n\nConvide as pessoas do time em **Configurações → Agentes**. Cada uma recebe um e-mail para criar a senha.\n\nDepois, em cada caixa de entrada, escolha quem tem acesso. Agente que não está na caixa não vê aquelas conversas — é assim que se separa suporte de comercial.\n\n## 3. Montar times e distribuição\n\nUm **time** agrupa agentes por assunto (Suporte, Vendas, Financeiro). A conversa pode ser atribuída a um time e qualquer pessoa dele assume.\n\n## 4. Preparar as respostas prontas\n\nRespostas prontas economizam mais tempo que qualquer outro recurso. Comece pelas cinco perguntas que mais chegam.\n\n> Dica: só padronize resposta que você já respondeu umas dez vezes do mesmo jeito. Padronizar cedo demais engessa o atendimento.\n\n## O que vem depois\n\nCom isso rodando, vale olhar etiquetas (para relatório por assunto), macros (para sequência de ações repetidas) e os aplicativos de celular, para o time não ficar preso ao computador." }, { "slug": "conversas-e-atribuicao", "categoria": "talk", "titulo": "Conversas, status e atribuição", "resumo": "Como uma conversa anda de aberta a resolvida, e quem responde por ela.", "palavras_chave": [ "status", "resolvida", "pendente", "adiada", "responsável", "fila" ], "url": "https:\/\/www.profluxus.com\/docs\/talk\/conversas-e-atribuicao", "atualizado_em": "2026-08-12", "conteudo": "## Os status\n\nToda conversa tem um status, e ele é o que separa o que precisa de ação do que já foi tratado.\n\n- **Aberta** — está em andamento e alguém precisa olhar\n- **Pendente** — depende de um terceiro (o cliente, outro setor) e volta depois\n- **Adiada** — parada de propósito até uma data\n- **Resolvida** — terminou; se o cliente escrever de novo, ela reabre sozinha\n\nA fila de trabalho do agente são as conversas **abertas atribuídas a ele**. Se esse número não cabe num dia, o problema é de distribuição, não de esforço.\n\n## Atribuição\n\nA conversa pode ser atribuída a uma pessoa, a um time, ou às duas coisas. Vale uma regra simples: **conversa sem responsável é conversa de ninguém**. Atribua na entrada, nem que seja para um time.\n\n## Etiquetas\n\nEtiqueta é o que transforma atendimento em informação. \"Troca\", \"Orçamento\", \"Reclamação de entrega\" — depois o relatório por etiqueta mostra o que mais consome o time.\n\nUse poucas e bem definidas. Vinte etiquetas parecidas não geram relatório nenhum." }, { "slug": "respostas-prontas-e-macros", "categoria": "talk", "titulo": "Respostas prontas e macros", "resumo": "A diferença entre as duas e quando usar cada uma.", "palavras_chave": [ "canned response", "atalho", "automação", "macro", "modelo" ], "url": "https:\/\/www.profluxus.com\/docs\/talk\/respostas-prontas-e-macros", "atualizado_em": "2026-08-12", "conteudo": "## Resposta pronta\n\nÉ um texto guardado com um atalho. Na conversa, o agente digita a barra e o atalho, e o texto entra no campo de mensagem — dá para editar antes de enviar.\n\nServe para o que se repete palavra por palavra: horário de funcionamento, dados de pagamento, política de troca.\n\n## Macro\n\nA macro faz **várias ações de uma vez**: envia uma mensagem, coloca uma etiqueta, muda o status, atribui a alguém. É um roteiro inteiro num clique.\n\nExemplo de macro de fim de atendimento:\n\n1. Envia a mensagem de agradecimento\n2. Coloca a etiqueta do assunto\n3. Marca a conversa como resolvida\n\n## Qual usar\n\nSe é só texto, resposta pronta. Se envolve mudar alguma coisa na conversa, macro. Na dúvida, comece com resposta pronta — é mais simples de manter.\n\n## Formatação nas mensagens\n\nO texto aceita a marcação do WhatsApp, e ela chega formatada no aparelho do cliente:\n\n- `*negrito*` fica em negrito\n- `_itálico_` fica em itálico\n- `~riscado~` fica riscado\n\nLinha em branco entre os blocos vale tanto quanto o negrito: mensagem longa sem respiro ninguém lê." }, { "slug": "enviar-produto-na-conversa", "categoria": "shop", "titulo": "Enviar um produto na conversa", "resumo": "Como mandar foto, título, descrição, preço e link direto do catálogo.", "palavras_chave": [ "produto", "catálogo", "foto", "preço", "vitrine", "enviar" ], "url": "https:\/\/www.profluxus.com\/docs\/shop\/enviar-produto-na-conversa", "atualizado_em": "2026-08-12", "conteudo": "Dentro da conversa, o bloco **Profluxus Shop** abre a busca do catálogo. Procure pelo nome do produto e escolha o que vai ser enviado.\n\n## O que dá para escolher\n\nAntes de enviar, você marca o que entra na mensagem:\n\n- **Foto** — uma ou várias imagens do produto\n- **Título**\n- **Descrição** — a curta; quando ela está vazia, o app usa a completa, resumida\n- **Preço**\n- **Link** do produto na loja\n\nO que estiver desmarcado simplesmente não entra — a mensagem não fica com espaço sobrando.\n\n## Preço promocional\n\nQuando o produto está em promoção, o preço vai em duas linhas: o valor antigo riscado e o novo em negrito. É a forma que o cliente entende na hora, sem precisar de explicação.\n\n## Produtos relacionados\n\nDá para enviar produtos relacionados junto. Vale para tíquete médio, mas com moderação: três sugestões ajudam, dez viram catálogo e o cliente não responde nenhuma." }, { "slug": "link-de-carrinho-e-cupom", "categoria": "shop", "titulo": "Link de carrinho com cupom", "resumo": "Montar um carrinho pronto, com desconto já aplicado, e mandar na conversa.", "palavras_chave": [ "carrinho", "cupom", "desconto", "frete grátis", "checkout", "oferta" ], "url": "https:\/\/www.profluxus.com\/docs\/shop\/link-de-carrinho-e-cupom", "atualizado_em": "2026-08-12", "conteudo": "O link de carrinho monta a compra inteira do jeito que foi combinado no atendimento. O cliente clica e cai no checkout com tudo dentro.\n\n## Como funciona\n\n1. Escolha os produtos e as quantidades\n2. Se for o caso, adicione uma oferta (cupom)\n3. O sistema gera o link e a mensagem\n\n## As ofertas\n\nA oferta pode ser um desconto nos produtos, no frete ou no carrinho inteiro. O cupom é **criado na hora** e vale para aquele link.\n\n> O cupom já vai aplicado no link. O cliente não precisa digitar código nenhum — e a mensagem diz isso, porque \"onde eu coloco o código?\" é a pergunta que mais volta.\n\n## Validade\n\nO cupom gerado tem prazo. A mensagem informa o dia em que ele expira, no fuso do aparelho de quem lê. Prazo curto ajuda a fechar; prazo curto demais irrita.\n\n## Cupom que não aparece na lista\n\nA lista de cupons mostra os que você pode reutilizar. Cupons gerados automaticamente por outros links e cupons inativos ficam de fora — senão a lista cresce sem parar e nenhum deles serve." }, { "slug": "consultar-pedido", "categoria": "shop", "titulo": "Consultar um pedido pelo CPF", "resumo": "Achar o pedido do cliente e responder status, pagamento e rastreio.", "palavras_chave": [ "pedido", "cpf", "rastreio", "entrega", "status", "pagamento", "nota" ], "url": "https:\/\/www.profluxus.com\/docs\/shop\/consultar-pedido", "atualizado_em": "2026-08-12", "conteudo": "\"Cadê meu pedido?\" é a pergunta mais frequente de qualquer loja. A busca por pedido resolve sem sair da conversa.\n\n## Buscar\n\nInforme o **CPF** (ou o identificador do cliente) e a lista de pedidos daquela pessoa aparece. Escolha o pedido.\n\n## O que enviar\n\nVocê marca o que vai na mensagem:\n\n- Número do pedido\n- Status\n- Situação do pagamento\n- Total\n- Itens\n- Código e link de rastreio\n- Link do pedido\n\n## Boa prática\n\nMande status **e** rastreio na mesma mensagem. Enviar só \"está a caminho\" garante a próxima pergunta em cinco minutos." }, { "slug": "enviar-imovel", "categoria": "imob", "titulo": "Enviar um imóvel na conversa", "resumo": "Mandar título, valor, foto e link do imóvel para o cliente.", "palavras_chave": [ "imóvel", "imovel", "apartamento", "casa", "enviar", "ficha" ], "url": "https:\/\/www.profluxus.com\/docs\/imob\/enviar-imovel", "atualizado_em": "2026-08-12", "conteudo": "O bloco **Profluxus Imob**, dentro da conversa, abre a busca de imóveis da conta. Procure por código, título ou bairro.\n\n## O que vai na mensagem\n\n- **Título** do imóvel\n- **Valor**\n- **Link** da página do imóvel no site\n- Fotos, quando você escolher\n\nComo no Shop, o que estiver desmarcado não entra.\n\n## Vale lembrar\n\nMandar um imóvel por mensagem funciona melhor que mandar cinco. Se o cliente ainda não decidiu, use a seleção (o artigo ao lado) em vez de despejar fichas soltas." }, { "slug": "selecao-de-imoveis", "categoria": "imob", "titulo": "Enviar uma seleção de imóveis", "resumo": "Um link só com vários imóveis, em vez de várias mensagens.", "palavras_chave": [ "seleção", "lista", "vários", "vitrine", "comparar", "link" ], "url": "https:\/\/www.profluxus.com\/docs\/imob\/selecao-de-imoveis", "atualizado_em": "2026-08-12", "conteudo": "Quando o cliente ainda está escolhendo, a seleção é melhor que a ficha individual: ele compara tudo numa página só e você recebe de volta qual chamou atenção.\n\n## Como montar\n\nMarque os imóveis na busca e envie. A mensagem sai com a lista (título e valor de cada um) e um **link da vitrine** com todos eles:\n\n```\nhttps:\/\/seusite.com.br\/s?ids=P26071C5B,CA-0101\n```\n\nOs códigos no fim da URL são os imóveis selecionados. O link abre o site da imobiliária já filtrado.\n\n## Quantos imóveis\n\nDe três a seis funciona bem. Acima disso, o cliente não compara — ele desiste." }, { "slug": "conectar-conta-de-anuncios", "categoria": "rads", "titulo": "Conectar a conta de anúncios", "resumo": "Ligar a conta de anúncios ao RADS e sincronizar as campanhas.", "palavras_chave": [ "meta", "facebook", "instagram", "business manager", "conectar", "sincronizar" ], "url": "https:\/\/www.profluxus.com\/docs\/rads\/conectar-conta-de-anuncios", "atualizado_em": "2026-08-12", "conteudo": "O RADS lê as campanhas da conta de anúncios e traz os números para dentro da plataforma, junto com as conversas que eles geraram.\n\n## Ordem da configuração\n\n1. Autorize o acesso à conta de anúncios\n2. Escolha o **Business Manager** e a **conta de anúncios** que serão usados\n3. Rode a primeira sincronização\n\nA sincronização traz campanhas, conjuntos e anúncios. Depois dela, o histórico continua atualizando sozinho.\n\n## Se a conta não aparecer\n\nQuase sempre é permissão: o usuário que autorizou precisa ter acesso àquela conta de anúncios no Business Manager. Confira lá e sincronize de novo." }, { "slug": "atribuicao-de-resultado", "categoria": "rads", "titulo": "Atribuição: ligar a conversa ao anúncio", "resumo": "Saber qual campanha trouxe qual conversa — e qual venda.", "palavras_chave": [ "atribuição", "roi", "resultado", "origem", "lead", "conversão" ], "url": "https:\/\/www.profluxus.com\/docs\/rads\/atribuicao-de-resultado", "atualizado_em": "2026-08-12", "conteudo": "Relatório de anúncio isolado mostra cliques. O que interessa é outra coisa: **quais conversas** vieram do anúncio e **quantas fecharam**.\n\n## Como a ligação acontece\n\nQuando o lead chega por um anúncio com destino ao WhatsApp, a origem vem junto com a conversa. O RADS usa isso para juntar o gasto da campanha com o que aconteceu no atendimento.\n\n## O que olhar\n\n- **Conversas por campanha** — volume real, não impressão\n- **Custo por conversa** — o número que decide onde colocar verba\n- **Fechamento por campanha** — a campanha mais barata em lead pode ser a mais cara em venda\n\n> Anúncio que traz muita conversa e pouca venda costuma ter problema de promessa, não de mídia. Vale ler as conversas antes de mexer no orçamento." }, { "slug": "montar-o-funil", "categoria": "pipeline-board", "titulo": "Montar o funil em quadros", "resumo": "Criar o quadro, definir as etapas e mover o negócio.", "palavras_chave": [ "kanban", "funil", "quadro", "etapa", "board", "negócio", "card" ], "url": "https:\/\/www.profluxus.com\/docs\/pipeline-board\/montar-o-funil", "atualizado_em": "2026-08-12", "conteudo": "O Pipeline Board é o funil visual: cada negócio é um cartão e cada coluna é uma etapa.\n\n## Definir as etapas\n\nRegra prática: **etapa é o que já aconteceu, não o que você pretende fazer**. \"Proposta enviada\" é etapa. \"Vou ligar\" não é.\n\nUm funil comercial simples dá conta da maioria dos casos:\n\n1. Contato\n2. Qualificado\n3. Proposta enviada\n4. Negociação\n5. Ganho \/ Perdido\n\nCinco a sete etapas é o limite do que um time consegue manter atualizado.\n\n## Responsável e prazo\n\nTodo cartão precisa de responsável. Cartão sem dono para de andar e ninguém percebe.\n\n## Checklist\n\nDentro do cartão, o checklist guarda o que falta: enviar documento, agendar visita, confirmar dados. É onde mora o detalhe que não cabe no título." }, { "slug": "relatorios-do-funil", "categoria": "pipeline-board", "titulo": "Ler os relatórios do funil", "resumo": "Tempo em cada etapa, conversão e onde o negócio trava.", "palavras_chave": [ "relatório", "conversão", "tempo", "gargalo", "métrica" ], "url": "https:\/\/www.profluxus.com\/docs\/pipeline-board\/relatorios-do-funil", "atualizado_em": "2026-08-12", "conteudo": "## Tempo por etapa\n\nO número mais útil do funil não é o total de negócios — é **quanto tempo eles ficam parados em cada etapa**. Uma etapa com tempo médio muito acima das outras é o gargalo, e é lá que a receita está presa.\n\n## Conversão entre etapas\n\nOlhe a passagem de uma etapa para a seguinte, não só o fechamento final. Perder na qualificação é problema de origem do lead; perder na proposta é problema de preço ou de argumento.\n\n## Cartões parados\n\nVale rever toda semana os cartões sem movimento. Ou o negócio morreu e precisa ser marcado como perdido, ou está esquecido — os dois casos custam caro, e o segundo custa mais." }, { "slug": "instalar-o-aplicativo", "categoria": "apps", "titulo": "Instalar o aplicativo", "resumo": "Android, iPhone e a versão PWA, e como entrar na conta.", "palavras_chave": [ "android", "ios", "iphone", "pwa", "instalar", "baixar", "celular", "app" ], "url": "https:\/\/www.profluxus.com\/docs\/apps\/instalar-o-aplicativo", "atualizado_em": "2026-08-12", "conteudo": "## Android e iPhone\n\nOs aplicativos nativos do Profluxus Talk trazem o atendimento para o celular, com notificação de mensagem nova.\n\nNa primeira abertura o app pede o **endereço do servidor** da sua empresa (por exemplo `talk.profluxus.com`) e depois o e-mail e a senha do agente — os mesmos do computador.\n\n## PWA\n\nSem instalar nada: abra o endereço da plataforma no navegador do celular e use a opção **Adicionar à tela de início**. O atalho abre em tela cheia, parecido com um app.\n\nO PWA depende do navegador para notificação e por isso é menos confiável nesse ponto. Para quem atende o dia inteiro, o app nativo é a melhor escolha.\n\n## Notificações não chegam\n\nConfira, nesta ordem:\n\n1. A permissão de notificação do app está ligada nos ajustes do celular\n2. A economia de bateria não está suspendendo o app em segundo plano (comum no Android)\n3. A conta certa está selecionada no app" }, { "slug": "recursos-do-app", "categoria": "apps", "titulo": "Recursos do app no dia a dia", "resumo": "Encaminhar mensagens, áudio em sequência, anexos e troca de conta.", "palavras_chave": [ "encaminhar", "áudio", "audio", "velocidade", "anexo", "reação", "conta" ], "url": "https:\/\/www.profluxus.com\/docs\/apps\/recursos-do-app", "atualizado_em": "2026-08-12", "conteudo": "## Encaminhar mensagens\n\nSegure uma mensagem para entrar no modo de seleção e toque nas outras que quer levar junto. Ao encaminhar, elas chegam **na ordem original**, uma sequência, não um amontoado.\n\nEncaminhou para uma conversa só? O app abre essa conversa. Para várias? Ele fica onde está e avisa quantas receberam. Mensagem encaminhada aparece marcada como tal.\n\n## Áudio em sequência\n\nQuando o cliente manda vários áudios seguidos, o app emenda um no outro sem você tocar em nada — desde que não haja outra mensagem no meio. Dá para ouvir em **1x, 1,5x ou 2x**.\n\n## Menu de anexos\n\nO botão **+** abre os blocos de envio: foto, câmera, arquivo, documento e, para quem tem o plano, **Profluxus Shop** e **Profluxus Imob**. Quem não tem o módulo contratado vê o bloco desativado.\n\n## Trocar de conta\n\nQuem atende mais de uma conta troca pelo menu de ajustes. A conta escolhida no celular é lembrada pelo aparelho — abrir outra conta no computador não muda mais a do app." }, { "slug": "usuarios-e-permissoes", "categoria": "conta", "titulo": "Usuários e permissões", "resumo": "Quem é administrador, quem é agente e o que cada um enxerga.", "palavras_chave": [ "permissão", "administrador", "agente", "acesso", "usuário", "papel" ], "url": "https:\/\/www.profluxus.com\/docs\/conta\/usuarios-e-permissoes", "atualizado_em": "2026-08-12", "conteudo": "## Os dois papéis básicos\n\n- **Administrador** — configura caixas de entrada, agentes, times, automações e vê todos os relatórios\n- **Agente** — atende as conversas das caixas em que foi incluído\n\n## O que controla o que o agente vê\n\nNão é o papel, é a **caixa de entrada**. Um agente só enxerga conversas das caixas em que está. É assim que se separa suporte de comercial, ou uma filial da outra.\n\n## Ao desligar alguém\n\nRemova o acesso no mesmo dia. As conversas continuam na conta — o histórico é da empresa, não do agente, e nada se perde quando a pessoa sai." }, { "slug": "seguranca-da-conta", "categoria": "conta", "titulo": "Segurança da conta", "resumo": "Senha, sessões, token de API e o que fazer se algo vazar.", "palavras_chave": [ "senha", "segurança", "token", "sessão", "vazamento", "2fa" ], "url": "https:\/\/www.profluxus.com\/docs\/conta\/seguranca-da-conta", "atualizado_em": "2026-08-12", "conteudo": "## Senha\n\nSenha longa e exclusiva desta plataforma. A conta dá acesso ao histórico de conversas de clientes — é um dado sensível, e reaproveitar senha de outro serviço é o jeito mais comum de perdê-lo.\n\n## Token de API\n\nO token de acesso vale tanto quanto a senha: quem tem o token faz o que o usuário faz. Guarde em cofre de senhas, nunca em planilha compartilhada, e jamais em código publicado.\n\n## Suspeita de vazamento\n\n1. Troque a senha\n2. Gere um token novo (o antigo deixa de valer)\n3. Avise o administrador da conta para revisar os acessos\n\n## Dados de cliente\n\nNão copie conversa de cliente para grupo de WhatsApp, print público ou apresentação. Se precisar de exemplo, use dados fictícios — é exigência de LGPD e evita problema real." }, { "slug": "api-da-documentacao", "categoria": "api", "titulo": "API da documentação (para chatbot e LLM)", "resumo": "Endpoints públicos que entregam esta documentação em JSON e em texto.", "palavras_chave": [ "api", "json", "llm", "chatbot", "ia", "integração", "llms.txt", "rag" ], "url": "https:\/\/www.profluxus.com\/docs\/api\/api-da-documentacao", "atualizado_em": "2026-08-12", "conteudo": "Esta documentação é publicada também em formato de máquina, para que um chatbot ou um assistente de IA responda dúvidas de cliente com o texto oficial em vez de improvisar.\n\nTodos os endereços são públicos, respondem `GET` e aceitam requisição de qualquer origem (CORS liberado).\n\n## Índice em JSON\n\n```\nGET \/api\/docs\n```\n\nDevolve as categorias e a lista de artigos com título, resumo, palavras-chave, data de atualização e URL.\n\n## Um artigo\n\n```\nGET \/api\/docs\/{categoria}\/{slug}\n```\n\nDevolve o artigo com o corpo em markdown. Exemplo: `\/api\/docs\/shop\/link-de-carrinho-e-cupom`.\n\n## Busca\n\n```\nGET \/api\/docs\/search?q=cupom\n```\n\nDevolve os artigos ordenados por relevância, com um trecho do texto em volta do termo. Aceita `limite` (padrão 10) e `categoria`.\n\n## Formato para LLM\n\n```\nGET \/llms.txt índice em markdown\nGET \/llms-full.txt a documentação inteira, em um arquivo\n```\n\nO `\/llms.txt` segue a convenção de mesmo nome: um índice enxuto para o modelo saber o que existe. O `\/llms-full.txt` traz tudo, e serve para carregar num contexto ou indexar num banco vetorial.\n\n> Estes endpoints são somente leitura e não expõem dado de cliente: eles servem apenas o texto da documentação pública." }, { "slug": "token-de-acesso", "categoria": "api", "titulo": "Token de acesso da plataforma", "resumo": "Onde encontrar o token e como usá-lo nas chamadas.", "palavras_chave": [ "token", "api_access_token", "autenticação", "integração", "curl" ], "url": "https:\/\/www.profluxus.com\/docs\/api\/token-de-acesso", "atualizado_em": "2026-08-12", "conteudo": "As integrações com a plataforma se autenticam por um **token de acesso** ligado ao usuário.\n\n## Onde encontrar\n\nNo perfil do usuário, na área de configurações da plataforma. Ele é pessoal: as ações feitas com esse token aparecem no histórico como daquele usuário.\n\n## Como usar\n\nO token vai no cabeçalho `api_access_token`:\n\n```\ncurl -H \"api_access_token: SEU_TOKEN\" \\\n https:\/\/talk.profluxus.com\/api\/v1\/profile\n```\n\n## Cuidados\n\n- Um token por integração, para poder revogar uma sem derrubar as outras\n- Nunca no código-fonte de app ou site — qualquer pessoa lê\n- Trocou de responsável pela integração? Gere um token novo" }, { "slug": "modulos-de-automacao", "categoria": "talk", "titulo": "Os módulos de automação: qual usar em cada caso", "resumo": "SocialFlow, Studio, Bridge e Lead Conversions — o que cada um faz e onde um termina e o outro começa.", "palavras_chave": [ "automação", "studio", "socialflow", "bridge", "lead conversions", "módulos" ], "url": "https:\/\/www.profluxus.com\/docs\/talk\/modulos-de-automacao", "atualizado_em": "2026-09-16", "conteudo": "Quatro módulos cuidam de automação e conversão no Talk. Eles se dividem pelo canal e pelo momento em que agem.\n\n| Módulo | Para quê | Canal | Quem usa |\n|---|---|---|---|\n| **SocialFlow** | Portão de qualificação, fluxos, comentários e agenda | Instagram, Facebook | Marketing e atendimento |\n| **Studio** | O mesmo construtor de fluxo, nos demais canais | WhatsApp, site, e-mail, API, Telegram | Atendimento |\n| **Bridge** | Automação por hora, webhook ou evento | Nenhum: roda por trás | Operação e integração |\n| **Lead Conversions** | Cruza leads com vendas e mede conversão | Nenhum: lê o Talk e as fontes | Gestão e diretoria |\n\n## Onde um termina e o outro começa\n\nSocialFlow e Studio são o mesmo motor de fluxo, com caixas que não se cruzam: um fluxo de Instagram nunca roda numa caixa de WhatsApp, e vice-versa. A separação é proposital — cada canal tem capacidades diferentes, e misturar geraria fluxo que quebra no meio.\n\nO **Bridge** é o braço que os dois chamam quando precisam falar com um sistema de fora. Dentro de um fluxo de conversa existe um bloco \"Bridge\": ele entrega a integração para o módulo que foi feito para isso, e devolve o resultado ao fluxo.\n\nO **Lead Conversions** fecha o ciclo. Ele responde se o lead que entrou por esses fluxos virou venda, e devolve a resposta para a distribuição de leads, que passa a considerar a taxa de conversão de cada consultor ao repartir a fila.\n\n## Conexões e APIs é de todos\n\nOs quatro compartilham um cadastro só de conexões: APIs e bancos de dados registrados uma vez, escolhidos pelo nome dentro dos blocos. Trocar o token do ERP é mexer em um lugar, não em cada fluxo." }, { "slug": "conexoes-e-apis", "categoria": "studio", "titulo": "Conexões e APIs: o cadastro compartilhado", "resumo": "Uma API ou banco cadastrado uma vez, usado pelos quatro módulos. Modelos prontos, importação de Postman e como liberar o acesso remoto ao banco.", "palavras_chave": [ "conexão", "api", "banco de dados", "postman", "swagger", "dsn", "token" ], "url": "https:\/\/www.profluxus.com\/docs\/studio\/conexoes-e-apis", "atualizado_em": "2026-09-16", "conteudo": "A aba **Conexões e APIs** aparece dentro de SocialFlow, Studio, Bridge e Lead Conversions. É a mesma tabela nos quatro: cadastrar em um faz aparecer nos outros.\n\nCada conexão guarda nome, projeto, endereço, tipo de autenticação e credencial. Os blocos de fluxo escolhem a conexão pelo nome. Trocar o token do ERP é mexer em um lugar só.\n\n**A chave nunca volta para a tela.** Ela é gravada criptografada; a tela mostra \"chave guardada\" e um campo para substituir.\n\n## Modelos prontos\n\n| Modelo | Quando usar | O que preencher |\n|---|---|---|\n| Banco Postgres (leitura) | Painel, ERP ou CRM em Postgres | DSN: `postgres:\/\/leitor:senha@db.exemplo.com.br:5432\/erp` |\n| Banco MySQL (leitura) | CyberPanel, MariaDB, boa parte dos ERPs | DSN: `mysql:\/\/leitor:senha@db.exemplo.com.br:3306\/erp` |\n| API REST com token (Bearer) | APIs modernas | Endereço base e o token |\n| API com chave no cabeçalho | Sistemas que pedem `X-Api-Key` | Endereço base, nome do cabeçalho e a chave |\n| API com usuário e senha (Basic) | Sistemas antigos | Endereço base, usuário e senha |\n\nTambém é possível **importar uma coleção do Postman (v2.1) ou um arquivo Swagger\/OpenAPI**: as chamadas viram uma lista pronta para usar nos blocos. O token não é importado de propósito — ele é colado depois, para não ficar registrado no arquivo de coleção.\n\n---\n\n# Liberar o acesso ao banco em outra VPS\n\nO caso comum tem o Talk numa VPS, o painel de vendas em outra e um CRM antigo numa terceira. A conexão parte do Talk e chega ao banco de origem, que por padrão não aceita conexão de fora. São quatro camadas para abrir, e esquecer uma delas é a causa de quase toda falha.\n\n## Passo 0: o IP a liberar\n\nTodas as camadas abaixo liberam um endereço só — o IP de saída do Talk:\n\n```\n{{ip_talk}}\n```\n\n**Esse é o IP mesmo com o domínio atrás do Cloudflare.** Quando a conexão parte do Talk em direção ao banco do cliente, ela sai direto do servidor: o Cloudflare fica no caminho de quem *chega* ao Talk, não de quem o Talk *procura*. Ligar ou desligar a nuvem laranja não muda o endereço a liberar.\n\nPor isso, não descubra o IP por `dig` ou `nslookup` no domínio: com a nuvem laranja ligada, a consulta devolve endereços do Cloudflare, e liberar aqueles não faz a conexão funcionar. Se precisar confirmar, rode no próprio servidor do Talk:\n\n```bash\ncurl -s https:\/\/ifconfig.me\n```\n\nNos exemplos abaixo o endereço aparece como `{{ip_talk}}`.\n\n## Postgres\n\n**1. Criar os usuários.** Conecte como superusuário no banco de origem:\n\n```sql\n-- leitor: só consulta\nCREATE USER leitor WITH PASSWORD 'senha-longa-aqui';\nGRANT CONNECT ON DATABASE erp TO leitor;\nGRANT USAGE ON SCHEMA public TO leitor;\nGRANT SELECT ON ALL TABLES IN SCHEMA public TO leitor;\n\n-- tabelas criadas depois também entram\nALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO leitor;\n```\n\n**2. Aceitar conexão de fora.** No `postgresql.conf`:\n\n```\nlisten_addresses = '*'\n```\n\n**3. Autorizar o IP.** No `pg_hba.conf`, acrescente uma linha — e coloque antes das regras genéricas:\n\n```\n# TIPO BANCO USUÁRIO ORIGEM MÉTODO\nhostssl erp leitor {{ip_talk}}\/32 scram-sha-256\n```\n\nUse `hostssl`, não `host`: assim a senha não trafega em claro. Se o Postgres ainda não tem certificado, `host` funciona, mas trate como solução temporária.\n\n**4. Recarregar** e conferir que subiu:\n\n```bash\nsudo systemctl reload postgresql\n# ou, em container:\ndocker exec -it psql -U postgres -c 'SELECT pg_reload_conf();'\n```\n\n**5. Firewall.** Libere a porta apenas para o IP do Talk:\n\n```bash\nsudo ufw allow from {{ip_talk}} to any port 5432 proto tcp\nsudo ufw status numbered # confira que não existe um \"5432 ALLOW Anywhere\"\n```\n\n**6. Docker.** Se o banco roda em container, a porta precisa estar publicada no host. No `docker-compose.yml`:\n\n```yaml\nservices:\n postgres:\n ports:\n - \"5432:5432\"\n```\n\nNo Portainer: **Containers › o container › Duplicate\/Edit › Port mapping**, host `5432` para container `5432`.\n\n## MySQL e MariaDB\n\n**1. Criar os usuários**, já amarrados ao IP de origem:\n\n```sql\nCREATE USER 'leitor'@'{{ip_talk}}' IDENTIFIED BY 'senha-longa-aqui';\nGRANT SELECT ON erp.* TO 'leitor'@'{{ip_talk}}';\nFLUSH PRIVILEGES;\n```\n\nO `@'{{ip_talk}}'` é a trava principal: esse usuário não consegue entrar de nenhum outro lugar, nem que a senha vaze.\n\n**2. Aceitar conexão de fora.** No `my.cnf` ou `50-server.cnf`:\n\n```\nbind-address = 0.0.0.0\n```\n\nReinicie o serviço depois de mudar.\n\n**3. Firewall:**\n\n```bash\nsudo ufw allow from {{ip_talk}} to any port 3306 proto tcp\n```\n\n**4. CyberPanel.** O painel tem trava própria: **Databases › Remote MySQL**, informe o `{{ip_talk}}` e salve. Sem isso, o usuário existe, o firewall está aberto e a conexão continua recusada.\n\n## Testar antes de cadastrar\n\nRode **a partir do servidor do Talk** — é o teste que reproduz o caminho real:\n\n```bash\n# Postgres\npsql \"postgres:\/\/leitor:senha@db.exemplo.com.br:5432\/erp\" -c 'SELECT 1'\n\n# MySQL\nmysql -h db.exemplo.com.br -u leitor -p erp -e 'SELECT 1'\n\n# só a porta, quando nem o cliente está instalado\nnc -zv db.exemplo.com.br 5432\n```\n\nFuncionando aqui, cadastre a conexão no Talk e use \"Testar com 5 registros\" no bloco Consulta SQL.\n\n## Quando não conecta\n\n| Mensagem | Onde está o problema |\n|---|---|\n| `Connection timed out` | Firewall, ou a porta não está publicada no host |\n| `Connection refused` | O serviço não escuta no IP externo — `listen_addresses` ou `bind-address` |\n| `no pg_hba.conf entry for host` | Falta a linha no `pg_hba.conf`, ou o IP mudou |\n| `Access denied for user ... @` | No MySQL, o usuário existe para outro IP, ou falta o Remote MySQL do CyberPanel |\n| `password authentication failed` | Senha errada, ou método diferente do configurado no `pg_hba` |\n| Conecta e não vê tabela | Faltou o `GRANT SELECT`, ou o schema não é o `public` |\n\n---\n\n# Usuário editor: escrever de volta no ERP\n\nLer do ERP e devolver informação para ele é um caso legítimo — gravar no CRM que o consultor recebeu determinado número de leads, marcar um pedido como atendido, atualizar um campo de status. Duas coisas precisam ficar claras antes.\n\n## O bloco Consulta SQL não escreve\n\nO motor de SQL aceita apenas `SELECT` e `WITH`, e abre **transação somente leitura**. Um `UPDATE` colocado ali é recusado antes de chegar ao banco. Isso é proposital: uma consulta de leitura que roda a cada 15 minutos, com erro de `WHERE`, não pode ter poder de apagar a base do ERP.\n\n**O caminho da escrita é o bloco Chamar API**, contra um endpoint do próprio ERP, usado dentro de um fluxo do Bridge ou do Studio. Se o ERP não tem endpoint de escrita, o caminho é criar um — um pequeno serviço com uma rota só, que recebe o dado e faz o `UPDATE`. Fica mais seguro do que abrir o banco para escrita pela rede, e deixa registro de quem chamou.\n\n## Criando o usuário editor mesmo assim\n\nQuando existe esse serviço intermediário, é ele que usa o usuário editor — e o princípio é dar o mínimo, tabela por tabela, nunca `ALL PRIVILEGES`.\n\nPostgres:\n\n```sql\nCREATE USER editor WITH PASSWORD 'outra-senha-longa';\nGRANT CONNECT ON DATABASE erp TO editor;\nGRANT USAGE ON SCHEMA public TO editor;\n\n-- leitura ampla, escrita só onde é necessário\nGRANT SELECT ON ALL TABLES IN SCHEMA public TO editor;\nGRANT INSERT, UPDATE ON consultores_metricas TO editor;\nGRANT UPDATE (leads_recebidos, atualizado_em) ON consultores TO editor;\n\n-- sequências, para o INSERT conseguir gerar id\nGRANT USAGE ON ALL SEQUENCES IN SCHEMA public TO editor;\n```\n\nO `GRANT UPDATE (coluna)` é a forma mais restrita: o editor altera aquelas duas colunas da tabela `consultores` e mais nenhuma.\n\nMySQL e MariaDB:\n\n```sql\nCREATE USER 'editor'@'IP_DO_SERVICO' IDENTIFIED BY 'outra-senha-longa';\nGRANT SELECT ON erp.* TO 'editor'@'IP_DO_SERVICO';\nGRANT INSERT, UPDATE ON erp.consultores_metricas TO 'editor'@'IP_DO_SERVICO';\nFLUSH PRIVILEGES;\n```\n\nRepare no que **não** foi concedido em nenhum dos dois: `DELETE`, `DROP`, `TRUNCATE`, `ALTER`. Um erro de fluxo passa a custar um registro errado, não uma tabela perdida.\n\n## Recomendações\n\n- **Um usuário por finalidade.** O `leitor` do Lead Conversions e o `editor` do serviço de escrita são usuários diferentes, com senhas diferentes. Vazou um, o outro continua fechado.\n- **Chave de idempotência.** Se o fluxo roda a cada 15 minutos e pode repetir, grave um identificador do evento e ignore repetido. Sem isso, uma reexecução soma duas vezes.\n- **Coluna de origem.** Uma coluna `origem = 'profluxus'` na tabela de destino deixa claro o que veio de automação quando alguém for auditar.\n- **Teste em cópia.** Rode a escrita primeiro contra uma base de homologação. O `Testar com 5 registros` protege a leitura, não a escrita por API.\n\n## Limites do motor\n\nToda consulta abre transação **somente leitura** e é interrompida aos 30 segundos. Endereços de rede interna — `10.x`, `172.16.x`, `192.168.x`, `localhost` — são bloqueados, a menos que a instalação tenha `PROFLUXUS_FLUXO_REDE_INTERNA=1`. Blocos de código rodam em sandbox, sem rede e sem acesso a arquivo." }, { "slug": "lead-conversions-como-funciona", "categoria": "lead-conversions", "titulo": "Como o Lead Conversions liga lead e venda", "resumo": "Os conceitos do módulo: o que conta como lead, o que é venda atribuída e as três chaves que fazem o encontro.", "palavras_chave": [ "lead", "venda", "conversão", "cpf", "atribuição", "cruzamento" ], "url": "https:\/\/www.profluxus.com\/docs\/lead-conversions\/lead-conversions-como-funciona", "atualizado_em": "2026-09-16", "conteudo": "\"Quantos leads de agosto fecharam em agosto?\" é uma pergunta que não se responde chamando API: são dezenas de milhares de contatos no Talk, centenas de milhares de vendas na fonte e, muitas vezes, um CRM antigo no meio. O módulo espelha tudo em duas tabelas locais, num formato só, e a pergunta passa a ser uma consulta de um segundo.\n\n## Conceitos\n\n**Lead (entrada)** é a primeira conversa de um contato no Talk. As conversas seguintes da mesma pessoa são **toques**, não leads novos.\n\n**Venda** é um registro vindo de uma fonte: ERP, painel ou planilha.\n\n**Venda atribuída** é a venda cuja pessoa tem um lead no Talk. É ela que entra no cálculo da taxa de conversão.\n\n**Sem lead** é a venda que não encontrou ninguém. Ela **não desaparece**: fica no painel, em \"Qualidade do cruzamento\", porque é justamente a parte que mais diz sobre o estado do cadastro.\n\n**Consultor da venda** é quem atendeu o lead no Talk, na primeira conversa. O vendedor que a fonte registrou aparece ao lado, para comparação.\n\n**Canal e caixa**: o canal é WhatsApp, Instagram, Facebook ou Site; a caixa é a sub-trilha dentro dele — cada número de WhatsApp, cada conta de Instagram.\n\n## As três chaves\n\nO encontro entre lead e venda é tentado nesta ordem:\n\n1. **CPF ou CNPJ**, só dígitos. No Talk fica em `contact.identifier`.\n2. **Telefone**, com e sem o nono dígito. Não é chave reserva: metade dos leads não tem CPF.\n3. **E-mail.**\n\nQuando encontra, o módulo **enriquece o cadastro**: a pessoa que só tinha telefone ganha o CPF que veio da venda. A venda seguinte dela, mesmo chegando só com CPF, encontra o lead.\n\n## Segurança\n\nO módulo é visível apenas para administradores da conta. Credenciais de banco e API ficam criptografadas e não voltam para a tela. O SQL aceita apenas `SELECT` e `WITH`, em transação somente leitura, com teto de 30 segundos. Blocos de código rodam em sandbox sem rede e sem acesso a arquivo. Endereços de rede interna são bloqueados por padrão." }, { "slug": "lead-conversions-primeiro-uso", "categoria": "lead-conversions", "titulo": "Primeiro uso: ligar as fontes e cruzar", "resumo": "Passo a passo da primeira carga: sincronizar o Talk, cadastrar a fonte de vendas e montar o fluxo de leitura.", "palavras_chave": [ "primeiro uso", "fonte", "sincronizar", "sql", "cursor", "mapear campos" ], "url": "https:\/\/www.profluxus.com\/docs\/lead-conversions\/lead-conversions-primeiro-uso", "atualizado_em": "2026-09-16", "conteudo": "Abra **Lead Conversions** no menu — só administradores enxergam o módulo.\n\n## 1. Sincronizar o Talk\n\nEm **Fontes**, mande sincronizar o **Talk**. A carga inicial roda em fatias de quatro minutos, na fila de baixa prioridade, para não disputar recurso com o atendimento. O sino avisa quando termina. Depois disso a agenda padrão, a cada 15 minutos, mantém tudo em dia.\n\n## 2. Cadastrar a fonte de vendas\n\nEm **Conexões e APIs**, cadastre a origem das vendas pelo modelo certo — banco ou API — e cole a credencial.\n\n## 3. Montar o fluxo de leitura\n\nEm **Fontes › Nova fonte**, tipo **Vendas**, monte no construtor:\n\n- **Consulta SQL**, **Chamar API** ou **Planilha**, apontando para a conexão. Use `:cursor` no SQL, ou `{{ultimo_cursor}}` na API, para ler só o que mudou desde a última vez.\n- **Para cada item**, quando a resposta for uma lista dentro de um objeto, como `dados.data`.\n- **Mapear campos**: qual campo é documento, telefone, e-mail, nome, **data do evento** (obrigatória), valor, vendedor, status e cursor. O botão \"Ver os campos da fonte\" lê 5 registros reais e transforma os campos numa lista para escolher.\n- **Gravar evento**, tipo venda, com o id de origem — o código da venda na fonte.\n\nSalve. **Testar com 5 registros** executa de verdade e mostra o que seria gravado, sem gravar nada.\n\n## 4. Agendar\n\nTodo dia às 6h costuma bastar para uma fonte de vendas. Um CRM antigo entra como fonte de **leads**, por planilha ou SQL, com agenda manual: é carga única, não precisa repetir." }, { "slug": "lead-conversions-painel-e-relatorio", "categoria": "lead-conversions", "titulo": "Painel, cruzamentos e relatório da diretoria", "resumo": "O que cada número do painel significa, as perguntas prontas e a folha A4 para a reunião mensal.", "palavras_chave": [ "painel", "kpi", "relatório", "diretoria", "csv", "cruzamento" ], "url": "https:\/\/www.profluxus.com\/docs\/lead-conversions\/lead-conversions-painel-e-relatorio", "atualizado_em": "2026-09-16", "conteudo": "## Filtros\n\nNo topo: mês, consultores (vários, com busca) e canais com sub-trilhas por caixa — dá para marcar \"WhatsApp\" inteiro e mais uma conta específica de Instagram. O bloco recolhe num clique.\n\n## Painel\n\n- **KPIs**: leads, vendas atribuídas, taxa, dias até fechar (mediana) e VGV atribuído, cada um com a variação sobre o mês anterior.\n- **Séries de nove meses**: leads, vendas atribuídas e taxa.\n- **Qualidade do cruzamento**: quanto foi encontrado por CPF, por telefone, por e-mail, quanto foi encontrado depois pelo enriquecimento e quanto ficou sem lead.\n- **Por canal e por caixa.**\n- **Por consultor**, com ficha individual: taxa por mês e últimas vendas, cada uma mostrando a chave que a encontrou.\n\n## Cruzamentos\n\nAs três perguntas do mês vêm prontas, e há a pergunta livre \"entrou em X e fechou em Y\" — onde X pode ser \"qualquer mês\" ou \"antes do Talk\". Tudo exporta em CSV.\n\n## Relatório da diretoria\n\nUma folha pronta para A4: resumo executivo em texto, KPIs, evolução, ranking, de onde vieram as vendas e qualidade do cruzamento. \"Exportar PDF\" usa a impressão do navegador. Os filtros do topo valem no relatório.\n\n## Casos de uso\n\n**Reunião mensal.** Todo dia 1º, abrir o relatório com o mês anterior e exportar o PDF.\n\n**Campanha de anúncio.** Filtrar pela caixa de WhatsApp da campanha e comparar a taxa dela com a média da conta.\n\n**Consultor que \"não recebe lead bom\".** A ficha mostra leads, taxa por mês e dias até fechar, lado a lado com o time.\n\n**Cliente que voltou.** A pergunta \"fechou em agosto e entrou antes do Talk\" mostra quanto do faturamento vem da base antiga." }, { "slug": "lead-conversions-distribuicao", "categoria": "lead-conversions", "titulo": "Taxa de conversão como peso na distribuição de leads", "resumo": "Como ligar o peso por conversão, o que acontece com consultor novo e por que ninguém cai a zero.", "palavras_chave": [ "distribuição", "fila", "peso", "conversão", "mérito" ], "url": "https:\/\/www.profluxus.com\/docs\/lead-conversions\/lead-conversions-distribuicao", "atualizado_em": "2026-09-16", "conteudo": "Em **Distribuição**, é possível ligar o peso por conversão. A taxa de cada consultor no período escolhido — último mês, trimestre, semestre, ano ou faixa de datas, sempre em meses fechados — vira um **fator** entre 1 e a força escolhida: 1,5x, 2x, 3x ou 5x. Quem converte no topo passa a receber até esse múltiplo de leads.\n\n## As regras que protegem a fila\n\n- Quem tem **menos leads que o mínimo** no período fica **neutro**, com fator 1. Consultor novo não é punido por não ter histórico.\n- **Ninguém cai a zero.** Tirar alguém da fila continua sendo decisão humana, na aba de suspensões da distribuição.\n- Vale nos três modos da distribuição do Talk: fila igualitária, por contagem e cascata online\/ausente\/offline.\n- A tabela de fatores é recalculada a cada 20 minutos.\n\nA tela mostra a tabela de fatores **antes** de ligar, para a diretoria ver o efeito sobre o time real antes de decidir.\n\nUma configuração comum: peso por conversão no trimestre, força 2x, mínimo de 20 leads." }, { "slug": "lead-conversions-mcp", "categoria": "lead-conversions", "titulo": "Perguntar em português: as ferramentas MCP do módulo", "resumo": "As oito ferramentas que o servidor MCP da conta expõe, para consultar conversão sem abrir o painel.", "palavras_chave": [ "mcp", "ia", "assistente", "ferramentas", "automação" ], "url": "https:\/\/www.profluxus.com\/docs\/lead-conversions\/lead-conversions-mcp", "atualizado_em": "2026-09-16", "conteudo": "Quando uma leitura termina, o sino do módulo avisa: quantos registros lidos, quantos atribuídos e quantos ficaram sem lead. O bloco \"Avisar ao terminar\" também aceita um webhook.\n\nO servidor MCP da conta expõe o módulo como ferramentas, o que permite perguntar em português em vez de abrir o painel. \"Qual a taxa de conversão de agosto por consultor?\" vira uma pergunta direta ao assistente.\n\n| Ferramenta | O que faz |\n|---|---|\n| `leadconversions_painel` | Os números do painel no período escolhido |\n| `leadconversions_cruzamentos` | As perguntas prontas do mês |\n| `leadconversions_livre` | A pergunta \"entrou em X e fechou em Y\" |\n| `leadconversions_consultor` | A ficha de um consultor |\n| `leadconversions_fontes_list` | As fontes cadastradas e o estado de cada uma |\n| `leadconversions_fonte_sincronizar` | Dispara a leitura de uma fonte |\n| `leadconversions_distribuicao` | A tabela de fatores da distribuição |\n| `leadconversions_distribuicao_update` | Altera a configuração do peso por conversão |\n\nComo ligar o servidor MCP da conta está em [Servidor MCP](\/docs\/mcp)." }, { "slug": "socialflow-portao-e-fluxos", "categoria": "socialflow", "titulo": "Portão de qualificação e construtor de fluxo", "resumo": "Como o portão coleta os dados antes de ocupar um consultor, e os blocos disponíveis no construtor.", "palavras_chave": [ "portão", "qualificação", "fluxo", "instagram", "facebook", "direct" ], "url": "https:\/\/www.profluxus.com\/docs\/socialflow\/socialflow-portao-e-fluxos", "atualizado_em": "2026-09-16", "conteudo": "O SocialFlow cuida de Instagram e Facebook: portão de qualificação antes do consultor, fluxos com botões e perguntas, resposta a comentários, agenda de publicação e sequências.\n\n## O portão\n\nQuem chama no direct passa primeiro pelo portão, que coleta nome, telefone, e-mail e os campos personalizados que a conta definir — o CPF vai direto para o identificador do contato. Só depois de completo é que a conversa entra na fila do consultor.\n\nNo WhatsApp, via Studio, há um complemento: quando o nome do perfil não serve — emoji, um número de telefone, \"Eu\" — o portão pergunta o nome.\n\n## Blocos do construtor\n\nGatilho (primeira mensagem, palavra-chave ou qualquer mensagem), texto, botões, cartão, mídia, pergunta com validação, condição, espera, etiqueta, código, IA classifica, IA responde, responsável, prioridade, situação, guardar, nota, funil, Bridge, ação, API, entregar e portão.\n\nA pergunta com validação aceita CPF, CNPJ, telefone, e-mail, data, número, lista de opções, padrão livre e validação por API.\n\nO botão direito abre menu no bloco — testar até aqui, duplicar, apagar — e na ligação entre blocos, para removê-la.\n\n## Variáveis\n\n`{{nome}}`, `{{telefone}}`, `{{contact.identifier}}` (CPF), `{{contact.identifier.pj}}` (CNPJ), `{{campo:x}}` para campo personalizado, `{{conversa:x}}` para atributo da conversa e `{{dados.x.y}}` para o que uma chamada de API trouxe. O spintax `{oi|olá}` sorteia uma das variações a cada envio.\n\n## Testar\n\n\"Testar o fluxo\" roda o motor de verdade com um contato real, sem enviar nada e sem gravar. A conversa pode ser localizada por nome, telefone, CPF ou número.\n\n## Resgate no WhatsApp\n\nPara o lead do direct que sumiu, a conversa tem o botão \"Chamar no WhatsApp\": ele envia um template aprovado de utilidade para o telefone da ficha e abre a conversa no WhatsApp, atribuída ao mesmo consultor, com um resumo do que já havia sido conversado. Uma vez por agente; quem supervisiona não tem limite.\n\n## Casos de uso\n\n- Qualificar todo lead do Instagram antes de ocupar um consultor.\n- Responder comentário por regra de palavra-chave e puxar a pessoa para o direct.\n- Agendar posts e stories com variação de texto, para não repetir a mesma frase.\n- Recuperar pelo WhatsApp o lead que parou de responder no direct." }, { "slug": "studio-fluxos-fora-do-meta", "categoria": "studio", "titulo": "Studio: o construtor nos demais canais", "resumo": "O mesmo motor do SocialFlow para WhatsApp, site, e-mail, API e Telegram, e o que muda em cada canal.", "palavras_chave": [ "studio", "whatsapp", "fluxo", "telegram", "typebot", "n8n" ], "url": "https:\/\/www.profluxus.com\/docs\/studio\/studio-fluxos-fora-do-meta", "atualizado_em": "2026-09-16", "conteudo": "O Studio usa o mesmo construtor do SocialFlow, aplicado a WhatsApp (oficial e não oficial), site, e-mail, API e Telegram. As caixas são separadas: o Studio nunca enxerga uma caixa de Instagram, e um fluxo do SocialFlow nunca roda numa caixa de WhatsApp.\n\n## O que muda em relação ao SocialFlow\n\n**Capacidades por canal.** Botões e listas existem na API oficial do WhatsApp; onde não há botão, o bloco vira texto simples. O construtor mostra o que cada canal suporta.\n\n**Custo por mensagem.** No WhatsApp oficial, o Studio avisa quando um bloco gera cobrança, antes de você publicar o fluxo.\n\n**Gatilhos por caixa.** Palavra-chave, primeira mensagem ou qualquer mensagem, configurados caixa a caixa.\n\n**Saída para fora.** Quando o fluxo precisa continuar em outro lugar, há saída para Typebot e n8n.\n\n## Casos de uso\n\n- Menu de atendimento no WhatsApp — \"Quero comprar \/ Já sou cliente \/ Outro assunto\" — com cada saída entregando para um time diferente.\n- Pergunta de CPF que consulta o ERP pelo bloco API, usando uma conexão cadastrada, e responde com os dados do cliente.\n- Fila igualitária por caixa depois que o portão completa o cadastro." }, { "slug": "bridge-automacao-sem-conversa", "categoria": "bridge", "titulo": "Bridge: automação sem conversa", "resumo": "Gatilhos por hora, webhook ou evento do Talk, com ações que chamam serviços de fora e agem dentro do Talk.", "palavras_chave": [ "bridge", "webhook", "automação", "integração", "cron", "evento" ], "url": "https:\/\/www.profluxus.com\/docs\/bridge\/bridge-automacao-sem-conversa", "atualizado_em": "2026-09-16", "conteudo": "O Bridge é o módulo de automação que não depende de conversa. Os gatilhos são por hora, por webhook recebido ou por evento do Talk. As ações chamam serviços de fora, pelas conexões cadastradas, e agem dentro do Talk: etiqueta, atribuição, nota, campanha, funil.\n\n## Casos de uso\n\n**Rotina diária.** Todo dia às 7h, buscar no ERP os boletos vencidos e etiquetar os contatos correspondentes.\n\n**Lead vindo do site.** O webhook do site cria o lead, o Bridge atribui ao time certo e dispara o primeiro template.\n\n**Pós-atendimento.** O evento \"conversa resolvida\" dispara uma pesquisa de satisfação por outro canal.\n\n**Braço dos fluxos de conversa.** SocialFlow e Studio chamam um fluxo do Bridge pelo bloco \"Bridge\" quando precisam de uma integração que não cabe dentro do fluxo de conversa." }, { "slug": "modulos-operacao-e-verificacao", "categoria": "conta", "titulo": "Operação dos módulos de automação", "resumo": "Como os módulos entram na imagem, os scripts de verificação por conta e as variáveis de ambiente.", "palavras_chave": [ "operação", "deploy", "verificação", "variáveis de ambiente", "script" ], "url": "https:\/\/www.profluxus.com\/docs\/conta\/modulos-operacao-e-verificacao", "atualizado_em": "2026-09-16", "conteudo": "Os quatro módulos são overlays do Talk: entram na imagem no momento do build, pelo `.\/profluxus.sh` — etapas IMAGEM, DEPLOY e, quando há migração, BANCO.\n\n## Verificar uma conta\n\nRodados dentro do container do Rails:\n\n```bash\nbundle exec rails runner \/app\/scripts\/verificar_leadconversions.rb \nbundle exec rails runner \/app\/scripts\/verificar_laboratorio.rb # SocialFlow e Studio\nbundle exec rails runner \/app\/scripts\/verificar_bridge.rb \nbundle exec rails runner \/app\/scripts\/verificar_studio.rb \n```\n\n## Variáveis de ambiente\n\n| Variável | Efeito |\n|---|---|\n| `PROFLUXUS_FLUXO_REDE_INTERNA=1` | Libera endereços de rede interna nos blocos de API e SQL |\n| `PROFLUXUS_LEADCONVERSIONS=0` | Desliga o cron do Lead Conversions |\n| `PROFLUXUS_LEADCONVERSIONS_CRON` | Expressão cron do módulo; o padrão é a cada 5 minutos |" } ] }