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

# Etiquetas

> Organize e gerencie mensagens através de canais push, email, SMS e in-app com Etiquetas no OneSignal. Filtre, categorize e otimize facilmente seu fluxo de trabalho de campanha.

## Visão geral

Labels no OneSignal ajudam você a categorizar e organizar mensagens através de canais push, email, SMS e in-app. Labels facilitam filtrar mensagens, localizar templates e colaborar entre equipes.

Uma vez que um label é aplicado, ele pode ser usado para filtrar e agrupar conteúdo, melhorando a visibilidade e navegação dentro do seu painel.

<Frame caption="Nova coluna de labels no índice de push.">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/6f6e2a6-Labels.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=d823f7c25262b7952fce3e43c8fcca52" width="1325" height="605" data-path="images/docs/6f6e2a6-Labels.png" />
</Frame>

### Casos de uso sugeridos

Organize suas mensagens por:

* Equipe ou criador da mensagem
* Status ou prioridade
* Tópico ou objetivo da campanha
* Idioma ou geografia
* Evento ou tema sazonal
* Tipo de mensagem (promocional, transacional, etc.)
* Top Performers

Para obter o máximo valor dos Labels, recomendamos:

1. Definir critérios claros para quando e por que usar labels.
2. Estabelecer convenções de nomenclatura consistentes.
3. Fazer brainstorming e planejar tipos de labels antes de aplicá-los.
4. Alinhar com membros da equipe e parceiros multifuncionais.
5. Revisar e ajustar labels periodicamente para manter seu painel limpo e útil.

***

## Adicionar ou editar um Label

Você pode aplicar até **cinco labels** por mensagem ou template. Cada label pode ter até **100 caracteres** e deve ser único. Labels são **compartilhados entre todos os canais**, permitindo que você agrupe conteúdo relacionado entre mensagens push, email, SMS e in-app.

### Ao enviar uma mensagem

Use o **dropdown de Labels** ao compor uma nova mensagem. Selecione labels existentes ou comece a digitar para criar novos.

<Frame caption="Dropdown de labels no compositor de mensagem.">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/add-label.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=6e942e68e4ae981d832359d1829064e4" width="1220" height="478" data-path="images/docs/add-label.png" />
</Frame>

### Em uma mensagem existente

Para marcar uma mensagem existente:

<Steps>
  <Step title="Vá para Messages e selecione o canal." />

  <Step title="Encontre a mensagem que você deseja marcar.">
    Clique nos **três pontos** no lado direito da mensagem e selecione **Edit Labels**.

    <Frame caption="Editar labels para cada item do índice através do menu de opções.">
      <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/edit-label.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=2cc70706ef71a0aa77d2aa7fefba2acf" width="1506" height="676" data-path="images/docs/edit-label.png" />
    </Frame>
  </Step>

  <Step title="Escolha labels existentes ou comece a digitar para criar um novo.">
    <img src="https://mintcdn.com/onesignal/4HyuQPBpu-4xjmQC/images/docs/create-label.png?fit=max&auto=format&n=4HyuQPBpu-4xjmQC&q=85&s=588e070d6aaeefa5c320a7453a874eaa" width="872" height="420" data-path="images/docs/create-label.png" />
  </Step>

  <Step title="Clique em Update para salvar." />
</Steps>

***

## Filtrar por label

Aplique filtros para mostrar apenas mensagens com labels selecionados. Você pode usar até **cinco filtros de label** de uma vez. Filtros usam **lógica AND**, significando que apenas mensagens que correspondem a *todos* os labels selecionados aparecerão.

Exemplo: Filtrar por `Label A` e `Label B` mostrará apenas mensagens marcadas com *ambos*.

<Frame caption="Use o filtro para encontrar itens com aquele label aplicado. Limite 5.">
  <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7973ab6-Labels_-_Filter.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=f74887b340a95a333badfdacbd5b1be5" width="1331" height="411" data-path="images/docs/7973ab6-Labels_-_Filter.png" />
</Frame>

### Renomear ou deletar um Label em todas as mensagens

Para alterar ou remover um label globalmente:

1. Use **Add Filter > Label** para encontrar mensagens com um label específico.
2. Clique em **Manage Labels** no canto superior direito.
3. Escolha **Rename Labels** ou **Delete Labels**.
4. Confirme suas alterações:
   * **Rename**: Insira um novo nome e clique em **Rename**.
   * **Delete**: Confirme a remoção para deletar o label de todas as mensagens.

<Frame caption="Renomear ou deletar todas as instâncias de um label no painel.">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/58dd739-Labels_-_Delete.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=7bbd8562d483a39b9ffa9d32aea7a8fe" width="1590" height="524" data-path="images/docs/58dd739-Labels_-_Delete.png" />
</Frame>

***

## FAQ

### Se eu usar o mesmo label em diferentes canais, isso agrupará essas mensagens juntas?

Sim. Labels são compartilhados entre todos os canais de mensagens. Por exemplo, o label "Super Bowl 2023" pode ser usado em push, email ou qualquer outro canal e aparecerá consistentemente nos filtros.

### Posso ver labels quando exporto minhas mensagens?

Sim. Ao exportar suas mensagens de **Delivery > Sent Messages**, os labels para essas mensagens serão incluídos no CSV exportado.

***