> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bevits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cashback por unidade

> Configure as unidades da rede, o WhatsApp de cada loja e a automação de cashback de cada uma.

## Como funciona?

Cada loja da rede vira uma **unidade** na conta da marca. A unidade tem o
próprio número de WhatsApp, a própria equipe e a própria automação de cashback.

Quando a unidade registra uma venda, a Bevits cria o cashback e envia a
mensagem para o cliente **pelo WhatsApp da unidade onde ele comprou**. A matriz
acompanha as vendas de todas as unidades em um só lugar. A equipe de cada
unidade vê apenas os clientes e as vendas da própria unidade.

A unidade pode registrar a venda de dois jeitos:

* **Pela tela de vendas da Bevits:** em **Vendas** → **Nova venda**, no
  computador ou no celular.
* **Pelo WhatsApp da unidade:** a equipe manda os dados da venda para o agente
  de vendas da Bevits, sem abrir o painel.

```mermaid theme={null}
flowchart LR
    A[Venda no balcão] --> B{Como a unidade registra?}
    B -->|Nova venda no painel| C[Bevits registra a venda]
    B -->|Mensagem para o agente| C
    C --> D[Automação de cashback da unidade]
    D --> E[Cliente recebe o cupom no WhatsApp da unidade]
```

## Antes de começar

Tenha em mãos:

* Acesso de **owner** ou **administrador** na conta da marca (matriz), com
  permissão de integrações e de configurações da loja.
* A lista das unidades, com nome, endereço e o responsável de cada uma.
* Um celular por unidade, com o **WhatsApp Business App** ativo no número da
  unidade.
* Acesso à conta Meta que administra o **portfólio de negócio** da marca.
* As regras do cashback: percentual, trava de segurança, validade e valor
  mínimo da próxima compra. Veja como cada regra funciona em
  [Giftback](https://docs.bevits.com/pt-BR/features/giftback.md).

> [!TIP]
>
> Com mais de duas unidades, verifique o negócio na Meta Business Suite antes
> de conectar o terceiro número. O portfólio verificado aceita até 20 números.
> Detalhes em
> [Coexistência do WhatsApp](https://docs.bevits.com/pt-BR/send-methods/whatsapp-oficial-coexistencia.md#conectar-mais-numeros).

## Visão geral da configuração

A matriz repete as etapas abaixo para cada unidade.

| Etapa | O que fazer | Onde |
| - | - | - |
| 1 | Conectar o WhatsApp da unidade | Configurações → WhatsApp → API Oficial |
| 2 | Criar a unidade | Configurações → Loja → Unidades |
| 3 | Criar a automação de cashback da unidade | Automações |
| 4 | Liberar o registro de vendas pelo WhatsApp (opcional) | Configurações → Loja → Unidades |
| 5 | Dar acesso à equipe da unidade | Configurações → Equipe |

## Passo a passo

**1. Conecte o WhatsApp da unidade**

Conecte o número da unidade em coexistência, seguindo o guia
[Coexistência do WhatsApp](https://docs.bevits.com/pt-BR/send-methods/whatsapp-oficial-coexistencia.md).
O número continua funcionando no WhatsApp Business App do celular da
unidade e também passa a enviar mensagens pela API oficial.

Conecte todos os números no **mesmo portfólio de negócio** da marca.

**2. Crie a unidade**

Clique no seu e-mail no canto inferior esquerdo e vá em **Configurações** →
**Loja** → aba **Unidades** → **Nova unidade**.

Preencha:

* **Nome da unidade:** use o nome que a equipe reconhece, por exemplo
  `Loja Centro`.
* **Endereço (opcional):** rua, número, bairro, cidade e estado.
* **Membros do time (opcional):** as pessoas da unidade que já têm acesso
  à Bevits. Quem ainda não tem acesso entra pelo convite da etapa 5, já
  com a unidade marcada.
* **Números do WhatsApp oficial:** selecione o número conectado na etapa 1.

Clique em **Salvar unidade**.

![Janela Nova unidade com nome, endereço, membros e números do WhatsApp oficial](https://bucket.bevits.com/docs/cashback-por-unidade/nova-unidade.png)

A unidade aparece na lista com a quantidade de membros e de números
vinculados.

![Aba Unidades com a unidade criada](https://bucket.bevits.com/docs/cashback-por-unidade/unidades.png)

**3. Crie a automação de cashback da unidade**

Vá em **Automações** e crie uma automação para a unidade. Dê um nome que
identifique a unidade, por exemplo `Cashback · Loja Centro`.

Monte a automação com estes blocos:

1. **Gatilho:** origem **Loja física** e evento **Venda manual**.
2. **Cupom:** defina o percentual do cashback, a trava de segurança e a
   validade.
3. **WhatsApp:** clique em **Adicione o template** e crie a mensagem de
   cashback. Em **Conta oficial do WhatsApp**, escolha o **número da
   unidade**: é por ele que o cliente recebe a mensagem.
4. **Timer**, **Condicional** e um segundo **WhatsApp** (opcional): um
   lembrete alguns dias antes do cupom vencer. Na **Condicional**, confira
   se o cupom ainda não foi usado, para lembrar só quem não voltou à loja.

![Gatilho da automação com a origem Loja física e o evento Venda manual](https://bucket.bevits.com/docs/cashback-por-unidade/gatilho-loja-fisica.png)

No template, use as variáveis da venda e do cupom:

| Variável | Exemplo |
| - | - |
| Nome do cliente | Maria |
| Código do cupom | `MARIA20` |
| Valor do cashback | R\$ 20,00 |
| Validade do cupom | 30/12/2026 |
| Valor mínimo da próxima compra | R\$ 80,00 |
| Valor da compra | R\$ 200,00 |

Exemplo de texto:

> Oi, \[nome do cliente]! Obrigado pela compra na Loja Centro. Você ganhou
> \[valor do cashback] de cashback para usar até \[validade]. É só apresentar
> o cupom \[código do cupom] na sua próxima compra.

Envie o template para aprovação da Meta. Quando ele aparecer como
**Aprovado**, ative a automação. Ela passa a aparecer no campo
**Automação de cashback** da tela de vendas.

> [!TIP]
>
> Repita esta etapa para cada unidade, escolhendo sempre o número da
> própria unidade nos templates. A Bevits mostra para cada unidade apenas
> as automações com templates do número dela, e o cashback de uma unidade
> nunca sai pelo número de outra.

> [!NOTE]
>
> Cada venda gera um cupom. Use um único bloco **Cupom** por automação.

**4. Libere o registro de vendas pelo WhatsApp (opcional)**

Faça esta etapa se a unidade for registrar vendas mandando mensagem para o
agente de vendas da Bevits. Se ela só usa a tela de vendas, pule para a
próxima etapa.

Em **Configurações** → **Loja** → aba **Unidades**, role até
**Lançamento de vendas pelo WhatsApp**. Em **Lojas autorizadas**, para cada
unidade:

1. Confira o **Número que envia as vendas**. Se a unidade tiver um número
   só, ele já vem selecionado.
2. Em **Automação de cashback desta loja**, escolha a automação criada na
   etapa anterior. Se a unidade tiver só uma, ela já vem selecionada.
3. Clique em **Autorizar**. A unidade passa a aparecer como **Autorizada**.

![Lançamento de vendas pelo WhatsApp com o número e a automação da unidade](https://bucket.bevits.com/docs/cashback-por-unidade/vendas-whatsapp.png)

O agente reconhece a unidade pelo número que enviou a mensagem, executa a
automação dessa unidade, e o cliente recebe o cashback pelo WhatsApp da
unidade. Para pausar o registro pelo WhatsApp de uma unidade, clique em
**Remover autorização**.

Salve o número do agente de vendas da Bevits nos contatos do celular de
cada unidade: **+55 11 95213-1664**.

**5. Dê acesso à equipe da unidade**

Em **Configurações** → **Equipe**, clique em **Adicionar** e preencha:

1. O **Email** e a **Função** da pessoa.
2. Em **Escopo de acesso**, escolha **Somente unidades vinculadas**.
3. Marque as unidades da pessoa e clique em **Convidar**.

Quando aceitar o convite, a pessoa já entra com acesso só a **Vendas** e
**Clientes**, e vê somente os registros das unidades marcadas. A equipe da
matriz fica com **Toda a organização** e acompanha a rede inteira.

Para mudar o escopo de quem já entrou, abra o menu da pessoa em
**Configurações** → **Equipe** e clique em **Permissões personalizadas**.

![Permissões personalizadas com o Escopo de acesso](https://bucket.bevits.com/docs/cashback-por-unidade/permissoes-escopo.png)

> [!NOTE]
>
> Uma pessoa pode fazer parte de mais de uma unidade. Isso é útil para quem
> cuida de várias lojas ou para um supervisor regional.

## Rotina da unidade

### Registrar a venda pela tela de vendas

1. Em **Vendas**, clique em **Nova venda**.
2. Digite o **telefone com DDD**. Se o cliente já está cadastrado na sua
   unidade, a Bevits preenche o nome.
3. Informe o **valor da compra**.
4. Em **Unidade da venda**, confira a unidade. Para quem tem acesso a uma única
   unidade, ela já vem selecionada.
5. Se o cliente usou um cupom de cashback, informe o código em
   **Cupom utilizado**.
6. Marque **Disparar automação de cashback**. A tela mostra só as automações
   da unidade selecionada; se houver uma, ela já vem escolhida. Clique em
   **Salvar**.

![Janela Nova venda com telefone, nome, valor, cupom, unidade e automação de cashback](https://bucket.bevits.com/docs/cashback-por-unidade/nova-venda.png)

O cliente recebe o cashback em seguida, sempre pelo WhatsApp da unidade
selecionada em **Unidade da venda**.

### Registrar a venda pelo WhatsApp

No WhatsApp Business App da unidade, mande uma mensagem para o agente de vendas
da Bevits. Comece com **nova venda** e envie, **em uma mensagem só**, o nome do
cliente, o telefone com DDD e o valor da compra:

```text theme={null}
Nova venda, Maria Souza, (47) 99999-1234, R$ 200,00
```

Se o cliente usou um cupom de cashback nessa compra, inclua o código na mesma
mensagem. A Bevits marca o cupom como usado:

```text theme={null}
Nova venda, Maria Souza, (47) 99999-1234, R$ 200,00, cupom MARIA20
```

Se faltar algum dado, o agente pergunta. Quando a venda está completa, o agente
confirma, a venda aparece em **Vendas** e o cliente recebe o cashback pelo
WhatsApp da unidade.

> [!NOTE]
>
> Se a unidade mandar uma venda com o mesmo telefone e valor de outra das
> últimas 24 horas, o agente pede uma confirmação antes de disparar. Responda
> **confirmo a venda** para registrar uma nova compra ou **é outra compra** se
> for um registro diferente.

### Cliente que compra em outra unidade da rede

O cadastro do cliente é da marca. Se ele comprar em outra unidade, a Bevits
reconhece o telefone e adiciona a nova unidade ao cadastro, sem duplicar o
cliente.

Cada unidade vê apenas o que aconteceu nela: as compras, os cupons e os totais
do cliente naquela unidade. O histórico completo na rede fica visível só para
a matriz.

## Acompanhar os disparos

A matriz acompanha tudo em dois lugares:

* **Vendas:** todas as vendas da rede, com a unidade de cada uma.
* **Configurações** → **Loja** → **Unidades** → **Últimos disparos de
  cashback:** os últimos disparos de cashback e o estado de cada um.

| Estado | O que significa |
| - | - |
| Aguardando início | A venda foi registrada e o cashback está na fila. |
| Automação iniciada | A automação está enviando a mensagem. |
| Execução concluída | O cashback foi criado e enviado. |
| Requer revisão | Confira a automação e o número da unidade e clique em **Tentar novamente**. |

## Checklist para cada nova unidade

* [ ] Número da unidade conectado em coexistência no portfólio da marca.
* [ ] Unidade criada com nome, endereço e número de WhatsApp.
* [ ] Automação `Cashback · nome da unidade` ativa, com o template aprovado no
  número da unidade.
* [ ] Se a unidade usar o WhatsApp para registrar vendas: unidade
  **Autorizada** em **Lançamento de vendas pelo WhatsApp** e número do
  agente salvo no celular da unidade.
* [ ] Gerente e vendedores convidados com escopo **Somente unidades
  vinculadas** e a unidade marcada.
* [ ] Venda de teste registrada e cashback recebido no WhatsApp.

## Problemas comuns

| Sintoma | O que fazer |
| - | - |
| O número da unidade não aparece ao criar a unidade | Conecte o número em **Configurações** → **WhatsApp** → **API Oficial** e abra a unidade de novo. |
| A automação não aparece em **Nova venda** | Confira se a automação está ativa, usa o evento **Venda manual** e tem templates aprovados do número da unidade selecionada em **Unidade da venda**. |
| A automação aparece desabilitada na configuração do agente | Leia a mensagem abaixo do campo: ela indica o bloco ou o template que precisa de ajuste. |
| O agente não responde à mensagem da unidade | Confira se a unidade aparece como **Autorizada** e se a mensagem saiu do número da unidade. |
| A venda não é registrada e a Bevits avisa que a unidade não tem número de WhatsApp | Vincule o número da unidade em **Configurações** → **Loja** → **Unidades**. Se a unidade tiver mais de um número, escolha o **Número que envia as vendas** em **Lançamento de vendas pelo WhatsApp**. |
| O agente avisa que o cupom não foi encontrado ou já foi usado | Confira o código com o cliente e mande a venda de novo. Cada cupom vale para uma compra só. |
| A equipe da unidade vê clientes de outras unidades | Confira em **Permissões personalizadas** se o escopo está em **Somente unidades vinculadas**. |
| A pessoa não vê nenhum cliente | Adicione a pessoa em **Membros do time** da unidade. |
| A conexão de um número caiu | Abra o WhatsApp Business no celular da unidade. O app precisa de uso pelo menos a cada 13 dias. |

Para dúvidas sobre a configuração da rede, fale com a gente em
**[hey@bevits.com](mailto:hey@bevits.com)** ou use o chat de suporte na plataforma.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.