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

# Nomes do painel de retirada

> Evite que um nome ofensivo apareça na tela pública de retirada, sem travar nenhum pedido.

O nome que o cliente digita no quiosque aparece no painel de retirada, a tela do restaurante onde os pedidos são chamados. Basta um insulto, uma mensagem política ou o nome da concorrência para ele ficar à vista de toda a loja, e uma foto dessa tela nas redes sociais custa mais do que qualquer pedido.

Com **Nomes do painel de retirada** você decide quais nomes são aceitos em cada país: o formato, uma lista de termos proibidos e o que acontece quando alguém insiste. O quiosque confere o nome antes do pagamento e o backoffice confere de novo quando o pedido chega.

> [!NOTE]
>
> **O mínimo que você precisa saber**
>
> * As regras e a lista são **por país**: as do país escolhido no seletor no canto superior direito.
> * Sem regras salvas, ou com **Filtro ativo** desligado, o quiosque aceita qualquer nome, como antes.
> * O pedido nunca fica travado: depois das tentativas configuradas, o quiosque usa um nome genérico como **PEDIDO 83K** e segue para o pagamento.

## Antes de começar

* Acesso ao backoffice da Fire com o canal **Canal - Kiosks** e permissão para **Configurações Gerais → Nomes do painel de retirada**.
* O país certo no seletor do canto superior direito. Tudo o que você salvar vale para esse país.

## O caminho simples

1. Em **Canal - Kiosks**, abra **Configurações Gerais → Nomes do painel de retirada**.
2. Ative **Filtro ativo** e clique em **Salvar regras**. Os valores padrão servem para a maioria dos casos: de 2 a 12 caracteres, só o primeiro nome, 3 tentativas e **PEDIDO \{code}** como nome genérico.
3. Em **Termos proibidos**, clique em **Importar lista**, cole os termos (um por linha) e clique em **Importar**.
4. Digite um nome da lista em **Testar um nome** e clique em **Testar** para confirmar que ele é recusado.

![Tela Nomes do painel de retirada com o filtro ativo, as regras, o testador e Como funciona](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/01-overview.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=d46c34285b533317a9141a1da97f4a89)

> [!TIP]
>
> Se você só precisa bloquear uma lista de palavras com as regras padrão, terminou. Não é preciso atualizar os quiosques: a lista fica no backoffice.

## Regras do nome

![Cartão Regras com o formato do nome, as tentativas e a prévia do nome genérico](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/02-rules.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=2e1ee4668c573b2aba8a1f18fc2593f9)

* **Filtro ativo**: liga ou desliga todo o filtro do país. Desligado, o quiosque aceita qualquer nome.
* **Formato do nome**
  * **Tamanho permitido**: mínimo e máximo de caracteres, contando espaços. O quiosque não deixa digitar além do máximo.
  * **Só o primeiro nome**: o quiosque não aceita mais de uma palavra. Se um pedido chegar com duas, o painel mostra só a primeira.
  * Sempre se aceitam só letras, incluindo acentos e ç. Números, símbolos e emojis não podem ser digitados.
* **Se o nome não passar**
  * **Tentativas**: quantos nomes recusados o quiosque aceita em um pedido antes de usar o nome genérico (de 1 a 10).
  * **Nome genérico**: o que aparece no lugar do nome. Precisa incluir `{code}`, que é trocado pelo código curto do pedido: **PEDIDO \{code}** aparece como **PEDIDO 83K**. Até 30 caracteres. A prévia abaixo mostra como fica no painel.

Clique em **Salvar regras** para aplicar as mudanças, ou em **Descartar** para voltar ao que está salvo.

> [!NOTE]
>
> As regras chegam aos quiosques em cerca de 5 minutos: cada quiosque as guarda por um tempo para não consultá-las a cada pedido. Os termos valem em até 1 minuto, porque são consultados toda vez que o cliente aceita um nome.

## Termos proibidos

![Lista de termos proibidos com filtros por categoria, correspondência e estado](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/03-terms.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=46e290fba5da060c82691709924a5f4f)

Antes de comparar, o nome é normalizado: sem acentos nem maiúsculas, com as letras separadas juntadas de novo, o leetspeak traduzido (0→O, 1→I ou L, 3→E, 4→A, 5→S, 7→T, @→A, \$→S, !→I), as letras repetidas reduzidas a uma e o K lido como C. Por isso "Idiota", "I d i o t a", "1d10t4" e "Idiotaaa" são comparados do mesmo jeito.

Para adicionar um termo, digite-o, escolha a **Categoria** e a **Correspondência**, e clique em **Adicionar**.

* **Categoria**: Figura política, Partido político, Palavrão ou insulto, Concorrência ou Outro. Serve para organizar e filtrar a lista; todas bloqueiam igual.
* **Correspondência**
  * **Exata**: o nome, ou uma das suas palavras, é o termo. A partir de 4 letras também o encontra colado a outra palavra: "Burro" bloqueia "BurroTonto", mas não "Burrito".
  * **Contém**: o termo aparece em qualquer parte do nome.
  * **Automática** (só ao adicionar): até 5 letras, exata; a partir de 6, contém.

Em cada linha você pode mudar a categoria e a correspondência, desligar o termo com **Ativo** sem apagá-lo, ou excluí-lo com a lixeira. Os botões de categoria e a busca filtram a lista.

### Importar uma lista

![Diálogo Importar termos com três termos colados](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/04-import.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=acafe6f41a63b56a9fc932e0784be1f7)

Cole um termo por linha, ou separados por vírgula, ponto e vírgula ou tabulação. Se você copiar de uma planilha, vale a primeira coluna. A categoria e a correspondência que você escolher valem para todos os termos dessa importação. Os repetidos são ignorados.

## Testar um nome

![Testador com um nome recusado e o nome genérico que o painel mostraria](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/05-tester.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=9437fb54a87e4b923912fe8ff36bcb17)

Digite qualquer nome e clique em **Testar**. O resultado mostra:

* **Quiosque**: se aceita ou recusa, o motivo e qual termo coincidiu.
* **Painel de retirada (pedido de exemplo 83K)**: o que a tela mostraria se esse nome chegasse em um pedido: igual, cortado ou trocado pelo nome genérico.
* **Formas comparadas**: o nome já normalizado, do jeito que é comparado com a lista.

O testador usa as regras e a lista salvas, não as mudanças sem salvar, e não salva nada. Se o filtro estiver desligado, ele avisa e testa mesmo assim.

## O que o cliente vê no quiosque

![Tela de nome do quiosque com a indicação de só o primeiro nome](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/06-kiosk-name.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=b300a947e5005f2aab743cf1ff10d3c4)

Enquanto digita, o quiosque não deixa inserir números, símbolos nem emojis, nem passar do tamanho máximo, e mostra **Apenas o seu primeiro nome, sem números ou símbolos** (ou **Apenas letras, sem números ou símbolos** se duas palavras forem permitidas). Com **Só o primeiro nome** ativo, se o cliente digitar duas palavras, o quiosque pede **Digite apenas o seu primeiro nome** e não deixa aceitar.

![Quiosque com um nome recusado e as tentativas restantes](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/07-kiosk-rejected.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=0d8b7c6bbb0bf4c7c88cc9d30b24ce98)

Quando o cliente toca em **Aceitar**, o quiosque consulta a lista:

* Se o nome não passar, mostra o motivo e as **Tentativas restantes**, e o cliente pode digitar outro.
* Na última tentativa, mostra **Você será chamado pelo número do seu pedido** e segue para o pagamento com o nome genérico.
* Se o backoffice não responder em 3 segundos, o quiosque aceita o nome para não travar a venda. O backoffice confere mesmo assim quando o pedido chega.

## Quando o pedido chega

O backoffice confere de novo o nome de cada pedido de quiosque antes de ele chegar ao painel, e também quando o pedido é corrigido depois:

* Se tiver um termo proibido, ele é trocado pelo nome genérico com o código desse pedido.
* Se o formato não cumprir as regras, é corrigido: fica a primeira palavra se **Só o primeiro nome** estiver ativo, números e símbolos são removidos, e o nome é cortado no tamanho máximo. "Ana Clara" vira "Ana".
* Nomes vazios, números de localizador (como "07") e o próprio nome genérico ficam como estão.

Essa segunda conferência também cobre os quiosques que ainda não têm a atualização.

## Exemplo: como um nome é comparado

Lista com "Idiota" (Contém) e "Burro" (Exata), com **Só o primeiro nome** ativo e de 2 a 12 caracteres:

| O cliente digita | Comparado como | No painel de retirada |
| - | - | - |
| Idiota | idiota | PEDIDO 83K (bloqueado) |
| Idiotá | idiota | PEDIDO 83K (bloqueado) |
| I d i o t a | idiota | PEDIDO 83K (bloqueado) |
| 1d10t4 | idiota | PEDIDO 83K (bloqueado) |
| Idiotaaa | idiota | PEDIDO 83K (bloqueado) |
| Burro | buro | PEDIDO 83K (bloqueado) |
| BurroTonto | burotonto | PEDIDO 83K (bloqueado) |
| Burrito | burito | Burrito |
| Ana Clara | ana · clara · anaclara | Ana |

No quiosque não é possível digitar números nem símbolos, e com **Só o primeiro nome** não é possível aceitar um nome com espaços. Linhas como "1d10t4" ou "I d i o t a" mostram o que o backoffice faz quando o pedido chega.

## Receitas

> **Ativar o filtro em um país**
>
> 1. Escolha o país no seletor do canto superior direito.
> 2. Abra **Configurações Gerais → Nomes do painel de retirada**.
> 3. Ative **Filtro ativo** e clique em **Salvar regras**.
> 4. Importe a lista de termos com **Importar lista**.
> 5. Confirme com **Testar um nome** usando um termo da lista.

> **Carregar a lista que o cliente envia**
>
> 1. Copie a coluna de termos da planilha.
> 2. Clique em **Importar lista** e cole.
> 3. Escolha a categoria e deixe a correspondência em **Automática**.
> 4. Confira a contagem de termos e clique em **Importar**.
> 5. Repita por categoria se quiser a lista organizada.

> **Um nome real ficou bloqueado**
>
> 1. Digite esse nome em **Testar um nome** e clique em **Testar**.
> 2. Veja qual termo coincidiu no resultado do quiosque.
> 3. Procure esse termo na lista.
> 4. Mude-o para **Exata**, ou desligue-o com **Ativo**.
> 5. Teste o nome de novo.

> **Bloquear uma marca da concorrência**
>
> 1. Digite a marca como ela se escreve, com espaços se tiver.
> 2. Escolha a categoria **Concorrência**.
> 3. Escolha **Contém** se o nome for longo: assim também bloqueia a marca colada a outra palavra.
> 4. Clique em **Adicionar** e teste com e sem espaços.

> **Permitir nome e sobrenome**
>
> 1. Desligue **Só o primeiro nome**.
> 2. Aumente o tamanho máximo, por exemplo para 20.
> 3. Clique em **Salvar regras**.
> 4. Lembre que o painel vai mostrar o texto completo.

> **Usar o nome genérico desde a primeira recusa**
>
> 1. Coloque **Tentativas** em 1.
> 2. Clique em **Salvar regras**.
> 3. A partir daí, o primeiro nome recusado já passa para o nome genérico.

## Erros que saem caros

> [!WARNING]
>
> **Termos curtos com Contém.** "Ana" com Contém também bloqueia "Mariana" e "Juliana". Os clientes não conseguem usar o próprio nome e a fila demora. Para termos de 5 letras ou menos use **Exata**: **Automática** já faz isso.

> [!WARNING]
>
> **Bloquear um nome próprio.** Como o K é lido como C, bloquear "Nikolas" também bloqueia "Nicolas". Antes de adicionar um nome próprio, teste-o junto com as variantes em **Testar um nome**.

> [!WARNING]
>
> **Um tamanho máximo muito curto.** O quiosque não deixa digitar além do máximo e o backoffice corta os nomes mais longos. Com máximo de 5, "Mariana" não cabe inteiro.

> [!WARNING]
>
> **Desligar o filtro "para testar".** Com **Filtro ativo** desligado, qualquer nome é aceito em todos os quiosques do país, inclusive na conferência quando o pedido chega. Para testar, use **Testar um nome**, que funciona com o filtro desligado.

## Glossário

| Termo | O que significa |
| - | - |
| Painel de retirada | Tela pública do restaurante onde os pedidos são chamados para retirada. |
| Nome genérico | Texto que substitui um nome recusado, com o código do pedido. Por exemplo, **PEDIDO 83K**. |
| Código do pedido | Código curto que o quiosque dá a cada pedido, como **83K**. |
| Termo proibido | Palavra da lista que não pode aparecer no nome. |
| Exata | O nome, ou uma das suas palavras, é o termo. |
| Contém | O termo aparece em qualquer parte do nome. |
| Forma comparada | O nome normalizado (sem acentos, em minúsculas, com o leetspeak traduzido) que é comparado com a lista. |
| Tentativa | Cada nome recusado dentro do mesmo pedido. |

## Perguntas frequentes

> **O filtro pode travar uma venda?**
>
> Não. Depois das tentativas configuradas, o quiosque usa o nome genérico e segue para o pagamento. Se o backoffice não responder em 3 segundos, o quiosque aceita o nome e o backoffice confere quando o pedido chega.

> **Quanto tempo leva para uma mudança valer?**
>
> Os termos, até 1 minuto. As regras (filtro ativo, tamanho, tentativas, nome genérico), cerca de 5 minutos.

> **As regras são por loja?**
>
> Não, por país. Todas as lojas do país usam as mesmas regras e a mesma lista.

> **É preciso atualizar os quiosques para mudar a lista?**
>
> Não. A lista fica no backoffice e o quiosque a consulta toda vez que o cliente aceita um nome.

> **E os quiosques que ainda não têm a atualização?**
>
> Eles não conferem o nome enquanto o cliente digita, mas o backoffice confere quando o pedido chega: o painel mostra o nome genérico no lugar de um termo proibido.


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