# Profluxus

> Plataforma de Relacionamento Comercial do Grupo 3DS: Talk (atendimento multicanal com IA), Shop (e-commerce e PDV), Imob (operacao imobiliaria), RADS (anuncios Meta com atribuicao real) e Pipeline Board. Site: https://profluxus.com

## Profluxus Talk

### Primeiros passos no Profluxus Talk
URL: https://profluxus.com/docs/talk/primeiros-passos

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.

## 1. Criar as caixas de entrada

Cada 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.

Um 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.

## 2. Cadastrar os agentes

Convide as pessoas do time em **Configurações → Agentes**. Cada uma recebe um e-mail para criar a senha.

Depois, 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.

## 3. Montar times e distribuição

Um **time** agrupa agentes por assunto (Suporte, Vendas, Financeiro). A conversa pode ser atribuída a um time e qualquer pessoa dele assume.

## 4. Preparar as respostas prontas

Respostas prontas economizam mais tempo que qualquer outro recurso. Comece pelas cinco perguntas que mais chegam.

> Dica: só padronize resposta que você já respondeu umas dez vezes do mesmo jeito. Padronizar cedo demais engessa o atendimento.

## O que vem depois

Com 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.

### Conversas, status e atribuição
URL: https://profluxus.com/docs/talk/conversas-e-atribuicao

## Os status

Toda conversa tem um status, e ele é o que separa o que precisa de ação do que já foi tratado.

- **Aberta** — está em andamento e alguém precisa olhar
- **Pendente** — depende de um terceiro (o cliente, outro setor) e volta depois
- **Adiada** — parada de propósito até uma data
- **Resolvida** — terminou; se o cliente escrever de novo, ela reabre sozinha

A 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.

## Atribuição

A 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.

## Etiquetas

Etiqueta é 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.

Use poucas e bem definidas. Vinte etiquetas parecidas não geram relatório nenhum.

### Respostas prontas e macros
URL: https://profluxus.com/docs/talk/respostas-prontas-e-macros

## Resposta pronta

É 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.

Serve para o que se repete palavra por palavra: horário de funcionamento, dados de pagamento, política de troca.

## Macro

A 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.

Exemplo de macro de fim de atendimento:

1. Envia a mensagem de agradecimento
2. Coloca a etiqueta do assunto
3. Marca a conversa como resolvida

## Qual usar

Se é só texto, resposta pronta. Se envolve mudar alguma coisa na conversa, macro. Na dúvida, comece com resposta pronta — é mais simples de manter.

## Formatação nas mensagens

O texto aceita a marcação do WhatsApp, e ela chega formatada no aparelho do cliente:

- `*negrito*` fica em negrito
- `_itálico_` fica em itálico
- `~riscado~` fica riscado

Linha em branco entre os blocos vale tanto quanto o negrito: mensagem longa sem respiro ninguém lê.


## Profluxus Shop

### Enviar um produto na conversa
URL: https://profluxus.com/docs/shop/enviar-produto-na-conversa

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.

## O que dá para escolher

Antes de enviar, você marca o que entra na mensagem:

- **Foto** — uma ou várias imagens do produto
- **Título**
- **Descrição** — a curta; quando ela está vazia, o app usa a completa, resumida
- **Preço**
- **Link** do produto na loja

O que estiver desmarcado simplesmente não entra — a mensagem não fica com espaço sobrando.

## Preço promocional

Quando 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.

## Produtos relacionados

Dá 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.

### Link de carrinho com cupom
URL: https://profluxus.com/docs/shop/link-de-carrinho-e-cupom

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.

## Como funciona

1. Escolha os produtos e as quantidades
2. Se for o caso, adicione uma oferta (cupom)
3. O sistema gera o link e a mensagem

## As ofertas

A oferta pode ser um desconto nos produtos, no frete ou no carrinho inteiro. O cupom é **criado na hora** e vale para aquele link.

> 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.

## Validade

O 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.

## Cupom que não aparece na lista

A 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.

### Consultar um pedido pelo CPF
URL: https://profluxus.com/docs/shop/consultar-pedido

"Cadê meu pedido?" é a pergunta mais frequente de qualquer loja. A busca por pedido resolve sem sair da conversa.

## Buscar

Informe o **CPF** (ou o identificador do cliente) e a lista de pedidos daquela pessoa aparece. Escolha o pedido.

## O que enviar

Você marca o que vai na mensagem:

- Número do pedido
- Status
- Situação do pagamento
- Total
- Itens
- Código e link de rastreio
- Link do pedido

## Boa prática

Mande status **e** rastreio na mesma mensagem. Enviar só "está a caminho" garante a próxima pergunta em cinco minutos.


## Profluxus Imob

### Enviar um imóvel na conversa
URL: https://profluxus.com/docs/imob/enviar-imovel

O bloco **Profluxus Imob**, dentro da conversa, abre a busca de imóveis da conta. Procure por código, título ou bairro.

## O que vai na mensagem

- **Título** do imóvel
- **Valor**
- **Link** da página do imóvel no site
- Fotos, quando você escolher

Como no Shop, o que estiver desmarcado não entra.

## Vale lembrar

Mandar 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.

### Enviar uma seleção de imóveis
URL: https://profluxus.com/docs/imob/selecao-de-imoveis

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.

## Como montar

Marque 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:

```
https://seusite.com.br/s?ids=P26071C5B,CA-0101
```

Os códigos no fim da URL são os imóveis selecionados. O link abre o site da imobiliária já filtrado.

## Quantos imóveis

De três a seis funciona bem. Acima disso, o cliente não compara — ele desiste.


## RADS

### Conectar a conta de anúncios
URL: https://profluxus.com/docs/rads/conectar-conta-de-anuncios

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.

## Ordem da configuração

1. Autorize o acesso à conta de anúncios
2. Escolha o **Business Manager** e a **conta de anúncios** que serão usados
3. Rode a primeira sincronização

A sincronização traz campanhas, conjuntos e anúncios. Depois dela, o histórico continua atualizando sozinho.

## Se a conta não aparecer

Quase 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.

### Atribuição: ligar a conversa ao anúncio
URL: https://profluxus.com/docs/rads/atribuicao-de-resultado

Relatório de anúncio isolado mostra cliques. O que interessa é outra coisa: **quais conversas** vieram do anúncio e **quantas fecharam**.

## Como a ligação acontece

Quando 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.

## O que olhar

- **Conversas por campanha** — volume real, não impressão
- **Custo por conversa** — o número que decide onde colocar verba
- **Fechamento por campanha** — a campanha mais barata em lead pode ser a mais cara em venda

> 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.


## Pipeline Board

### Montar o funil em quadros
URL: https://profluxus.com/docs/pipeline-board/montar-o-funil

O Pipeline Board é o funil visual: cada negócio é um cartão e cada coluna é uma etapa.

## Definir as etapas

Regra prática: **etapa é o que já aconteceu, não o que você pretende fazer**. "Proposta enviada" é etapa. "Vou ligar" não é.

Um funil comercial simples dá conta da maioria dos casos:

1. Contato
2. Qualificado
3. Proposta enviada
4. Negociação
5. Ganho / Perdido

Cinco a sete etapas é o limite do que um time consegue manter atualizado.

## Responsável e prazo

Todo cartão precisa de responsável. Cartão sem dono para de andar e ninguém percebe.

## Checklist

Dentro 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.

### Ler os relatórios do funil
URL: https://profluxus.com/docs/pipeline-board/relatorios-do-funil

## Tempo por etapa

O 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.

## Conversão entre etapas

Olhe 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.

## Cartões parados

Vale 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.


## Apps PWA, Android e iOS

### Instalar o aplicativo
URL: https://profluxus.com/docs/apps/instalar-o-aplicativo

## Android e iPhone

Os aplicativos nativos do Profluxus Talk trazem o atendimento para o celular, com notificação de mensagem nova.

Na 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.

## PWA

Sem 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.

O 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.

## Notificações não chegam

Confira, nesta ordem:

1. A permissão de notificação do app está ligada nos ajustes do celular
2. A economia de bateria não está suspendendo o app em segundo plano (comum no Android)
3. A conta certa está selecionada no app

### Recursos do app no dia a dia
URL: https://profluxus.com/docs/apps/recursos-do-app

## Encaminhar mensagens

Segure 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.

Encaminhou 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.

## Áudio em sequência

Quando 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**.

## Menu de anexos

O 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.

## Trocar de conta

Quem 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.


## Conta e acesso

### Usuários e permissões
URL: https://profluxus.com/docs/conta/usuarios-e-permissoes

## Os dois papéis básicos

- **Administrador** — configura caixas de entrada, agentes, times, automações e vê todos os relatórios
- **Agente** — atende as conversas das caixas em que foi incluído

## O que controla o que o agente vê

Nã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.

## Ao desligar alguém

Remova 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.

### Segurança da conta
URL: https://profluxus.com/docs/conta/seguranca-da-conta

## Senha

Senha 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.

## Token de API

O 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.

## Suspeita de vazamento

1. Troque a senha
2. Gere um token novo (o antigo deixa de valer)
3. Avise o administrador da conta para revisar os acessos

## Dados de cliente

Nã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.


## API e integrações

### API da documentação (para chatbot e LLM)
URL: https://profluxus.com/docs/api/api-da-documentacao

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.

Todos os endereços são públicos, respondem `GET` e aceitam requisição de qualquer origem (CORS liberado).

## Índice em JSON

```
GET /api/docs
```

Devolve as categorias e a lista de artigos com título, resumo, palavras-chave, data de atualização e URL.

## Um artigo

```
GET /api/docs/{categoria}/{slug}
```

Devolve o artigo com o corpo em markdown. Exemplo: `/api/docs/shop/link-de-carrinho-e-cupom`.

## Busca

```
GET /api/docs/search?q=cupom
```

Devolve os artigos ordenados por relevância, com um trecho do texto em volta do termo. Aceita `limite` (padrão 10) e `categoria`.

## Formato para LLM

```
GET /llms.txt        índice em markdown
GET /llms-full.txt   a documentação inteira, em um arquivo
```

O `/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.

> Estes endpoints são somente leitura e não expõem dado de cliente: eles servem apenas o texto da documentação pública.

### Token de acesso da plataforma
URL: https://profluxus.com/docs/api/token-de-acesso

As integrações com a plataforma se autenticam por um **token de acesso** ligado ao usuário.

## Onde encontrar

No 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.

## Como usar

O token vai no cabeçalho `api_access_token`:

```
curl -H "api_access_token: SEU_TOKEN" \
     https://talk.profluxus.com/api/v1/profile
```

## Cuidados

- Um token por integração, para poder revogar uma sem derrubar as outras
- Nunca no código-fonte de app ou site — qualquer pessoa lê
- Trocou de responsável pela integração? Gere um token novo