> ## 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.
# Compondo mensagens
> Componha mensagens SMS, MMS e RCS no OneSignal. Aborda os editores de SMS e RCS, limites de caracteres e codificação, segmentos de mensagem, links rastreáveis, personalização e como o conteúdo afeta a cobrança.
Há dois lugares para compor uma mensagem no OneSignal: **Templates** e **Messages** (o Dashboard). Ambos usam o mesmo editor. A diferença é que os Templates permitem salvar mensagens reutilizáveis que você pode referenciar em campanhas, Journeys ou chamadas de API, enquanto Messages é onde você compõe e envia uma mensagem única diretamente.
Ao compor a partir de Messages, o fluxo de trabalho é:
1. Selecione um público.
2. Selecione o remetente para o seu caso de uso.
3. Componha sua mensagem.
Em Templates, você compõe a mensagem sem selecionar um público ou remetente — esses são escolhidos no momento do envio, quando o template é referenciado em uma campanha, Journey ou chamada de API.
O editor que você vê depende do remetente que você selecionou. Se o seu remetente usa recursos de remetente SMS/MMS, você obtém o editor de SMS. Se o seu remetente inclui um recurso de remetente RCS, você obtém o editor de RCS. Em Templates, se qualquer remetente da sua conta tiver um recurso de remetente RCS, o editor abre na visualização RCS por padrão — o template não fica travado em RCS, e o formato real é decidido pelo remetente que você escolhe ao enviar.
***
## SMS e MMS
O editor de SMS permite escrever texto simples e, opcionalmente, anexar mídia.
* **SMS:** Apenas texto. Os limites de caracteres dependem da codificação (veja abaixo).
* **MMS:** Acionado quando você anexa uma imagem, GIF, vídeo ou arquivo de áudio. Limites principais:
* Até 1.600 caracteres de texto
* Até 10 anexos de mídia por mensagem (5MB no total em todos os anexos)
* Formatos suportados: JPEG, PNG, GIF, vídeo e áudio
* Disponível apenas nos EUA, Canadá e Austrália
* Cobrado a uma tarifa fixa de MMS por mensagem (não por segmento)
### Codificação e limites de caracteres
As mensagens SMS usam uma de duas codificações, determinada automaticamente pelos caracteres da sua mensagem:
| Codificação | Caracteres por segmento | Usado para |
| ----------- | ---------------------------------- | ---------------------------------------------------- |
| **GSM-7** | 160 (153 para múltiplos segmentos) | Caracteres latinos padrão e símbolos comuns |
| **UCS-2** | 70 (67 para múltiplos segmentos) | Emojis, caracteres acentuados e escritas não latinas |
Quando uma mensagem excede o limite por segmento, ela é dividida em vários segmentos, cada um cobrado separadamente. As mensagens de múltiplos segmentos reservam um pequeno cabeçalho por segmento para remontagem, e é por isso que o limite é ligeiramente menor para mensagens mais longas.
O editor mostra uma contagem de caracteres ao vivo e uma estimativa de segmentos enquanto você digita. Um único emoji pode levar uma mensagem de um segmento para três segmentos, então verifique o contador antes de enviar.
### Adicionando um link rastreável
Você pode adicionar links rastreáveis às suas mensagens para medir taxas de cliques e atribuir conversões a uma campanha específica. Quando você insere uma URL, o OneSignal pode automaticamente encurtá-la e envolvê-la em um link de rastreamento. Os cliques são reportados nas análises da sua mensagem.
Use um domínio personalizado da marca para qualquer link curto em SMS. Não use domínios de encurtadores gratuitos ou públicos como `bit.ly`, `tinyurl.com` ou `goo.gl` em SMS de produção — as principais operadoras dos EUA filtram ou bloqueiam ativamente mensagens que contêm esses domínios.
Gere URLs encurtadas, rastreáveis e seguras para operadoras a partir do dashboard.
Encurte e rastreie URLs programaticamente usando a API do OneSignal.
### Rastreando vários links ou links personalizados
O OneSignal suporta um link rastreável por mensagem SMS e não suporta personalização em links rastreados. Se você precisar rastrear mais de um link ou um link personalizado, use uma destas opções:
**Opção 1: Parâmetros UTM**
Adicione parâmetros UTM às suas URLs para rastrear cada link individualmente no Google Analytics (GA4). Como a URL é texto simples no corpo da mensagem, as tags Liquid funcionam diretamente dentro dela. Você pode personalizar a URL com valores específicos do assinante, como `{{ subscription_id }}`, e o OneSignal renderiza o valor real para cada destinatário no momento do envio.
```
https://example.com/sale?utm_source=onesignal&utm_medium=sms&utm_campaign=spring_sale&utm_content=cta
```
URLs marcadas com UTM podem ser longas (150+ caracteres), o que pode empurrar sua mensagem para segmentos de SMS adicionais e aumentar os custos de mensageria.
**Opção 2: Ferramentas de gerenciamento de links de terceiros**
Ferramentas de terceiros (Rebrandly, Short.io, Branch.io, AppsFlyer) podem rastrear cliques, encurtar URLs e personalizar o link com a marca.
Para links personalizados (URL única por destinatário), procure ferramentas que suportem **parameter passthrough**, encaminhando os parâmetros de consulta até a URL de destino. Com o parameter passthrough, você pode usar tags Liquid diretamente no link curto (por exemplo, `https://go.yourbrand.com/offer?sub_id={{ subscription_id }}`).
**Opção 3: Rastreamento de cliques no lado do site**
Rastreie cliques em links de SMS instrumentando seu site para enviar dados de volta ao OneSignal quando um assinante chega à sua página por meio de um link de SMS.
1. Inclua uma URL no seu SMS que identifique o assinante usando tags Liquid (por exemplo, `https://yourbrand.com/offer?uid={{ onesignal_id }}`).
2. Quando o assinante clica no link e chega ao seu site, dispare uma chamada à API do OneSignal para registrar o engajamento:
* **Evento personalizado:** Envie um evento personalizado (por exemplo, `sms_click`) vinculado ao assinante. Use como gatilho em Journeys ou como filtro de segmentação.
* **Tag de usuário:** Atualize o perfil do assinante com uma tag (por exemplo, `last_sms_click = `). Use para segmentar pela recência do engajamento.
***
## Conteúdo RCS
Se o seu remetente inclui um recurso de remetente RCS, o editor desbloqueia recursos de conteúdo rico:
* **Cards:** Um card rico independente com uma imagem, título, descrição e até três ações.
* **Carrosséis:** Um conjunto de cards roláveis horizontalmente. Cada card pode ter sua própria imagem, texto e botões. Útil para exibir vários produtos, locais ou opções em uma única mensagem.
* **Ações:** Botões tocáveis anexados aos cards. Três tipos são suportados:
* **Botões de link:** Abrem qualquer URL http ou https. Você pode definir se ela abre no aplicativo de mensagens ou em uma nova aba. Isso inclui iOS Universal Links e Android App Links, que abrem diretamente no seu aplicativo quando ele está instalado.
* **Respostas por palavra-chave:** Quando um assinante toca em uma ação de resposta por palavra-chave, ela envia aquele texto de volta como resposta dele sem exigir que ele digite. Simplifica interações bidirecionais.
* **Número de telefone:** Inicia uma chamada telefônica diretamente a partir da mensagem.
### Proporções de imagem do RCS
Ao adicionar uma imagem a um card rico, as proporções recomendadas dependem do layout do card:
* **Mídia no topo** (card vertical): 2:1, 16:9 ou 7:3
* **Mídia à esquerda** (card horizontal): 3:4
Mantenha o texto, os logotipos e os elementos visuais principais afastados das bordas e centralizados dentro do quadro. Cada dispositivo e tamanho de tela pode recortar e centralizar com zoom a sua imagem de forma ligeiramente diferente.
### Fallback de SMS
Você pode definir uma mensagem de fallback de SMS para quando o RCS falhar na entrega — por exemplo, quando o dispositivo ou a operadora do destinatário não suporta RCS. O OneSignal envia o fallback automaticamente. Observe que as mensagens RCS **somente de texto** sempre usam o texto definido pela mensagem RCS e não usam o texto de fallback de SMS.
***
## Personalização
Mensagens promocionais e transacionais são mais eficazes quando incluem informações individualizadas, como códigos de desconto, o nome de um usuário, um horário de compromisso ou um número de pedido.
Use tags Liquid para inserir dados específicos do assinante em mensagens SMS e RCS.
***
## Como o conteúdo afeta a cobrança
O tipo de conteúdo que você envia afeta diretamente seus custos de mensageria.
### Segmentos de SMS
As mensagens SMS são cobradas pelo número de **segmentos** enviados, não por mensagem. O limite de caracteres por segmento depende da codificação — veja [Codificação e limites de caracteres](#encoding-and-character-limits) acima para o cálculo de GSM-7 e UCS-2.
Exemplo de cobrança:
* Mensagem GSM-7 de 200 caracteres = 2 segmentos
* Mensagem GSM-7 de 500 caracteres = 4 segmentos
* Mensagem de 100 caracteres com um emoji = 2 segmentos (a codificação muda para UCS-2)
### MMS
O MMS é cobrado a uma tarifa fixa por mensagem, independentemente do comprimento do texto. Veja [SMS e MMS](#sms-and-mms) acima para limites de mídia e regiões suportadas.
### RCS
As mensagens RCS são agrupadas em quatro categorias de cobrança com base no conteúdo e no comprimento:
| Categoria de cobrança | Público | Descrição |
| --------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Rich** | EUA | Mensagens somente de texto, ou um título com texto de corpo. Não pode incluir ações ou mídia. Mensagens com mais de 160 caracteres são divididas em segmentos e cobradas por segmento. |
| **Rich Media** | EUA | Mensagens que incluem quaisquer ações (respostas rápidas, discagens ou links), um título com ações, um título com mídia, mídia independente ou conteúdo de carrossel. |
| **Basic** | Internacional | Mensagens de texto de até 160 caracteres UTF-8. Não inclui nenhuma ação, mídia ou carrossel. |
| **Single** | Internacional | Mensagens de texto com mais de 160 caracteres UTF-8, até o comprimento máximo de mensagem de 3.072 caracteres. Também pode incluir ações, mídia ou carrosséis. |
A tabela de cobrança usa o vocabulário da fatura da operadora: **quick replies** são ações de resposta por palavra-chave, **dials** são ações de número de telefone e **links** são botões de link no editor do OneSignal.
***
## FAQ
### Por que minha mensagem virou 2 segmentos quando adicionei um emoji?
Os emojis exigem a codificação UCS-2, que reduz o limite de caracteres por segmento de 160 para 70 caracteres (67 para mensagens de múltiplos segmentos). Uma mensagem que cabe em um segmento como texto simples pode facilmente virar 2 a 3 segmentos com um emoji adicionado. Monitore a contagem de segmentos no editor antes de enviar.
### Posso usar um encurtador de URL público como o bit.ly?
Não. As principais operadoras dos EUA filtram ou bloqueiam ativamente mensagens que contêm domínios de encurtadores públicos. Use o encurtador de links integrado do OneSignal, um domínio personalizado da marca ou deixe a URL completa no corpo da mensagem.
### O MMS suporta todos os tipos de mídia?
O MMS suporta imagens (JPEG, PNG, GIF), vídeo e áudio. O tamanho total da mídia deve ser inferior a 5MB em até 10 URLs de mídia. Para uma lista completa de tipos MIME aceitos, veja a [documentação da Twilio](https://www.twilio.com/docs/sms/accepted-mime-types#accepted-mime-types). Observe que o MMS é suportado apenas nos EUA, Canadá e Austrália.
### Qual é o comprimento máximo de mensagem para RCS?
O RCS suporta até 3.072 caracteres. Mensagens com mais de 160 caracteres UTF-8 caem na categoria de cobrança "Single" para destinatários internacionais.
### Como sei se o meu remetente usa o editor de SMS ou de RCS?
O editor é determinado pelo remetente que você seleciona ao compor uma mensagem. Se o seu remetente inclui um recurso de remetente RCS, você obtém o editor de RCS. Se o seu remetente usa apenas recursos de remetente SMS/MMS, você obtém o editor de SMS. Em Templates, o RCS é o formato padrão se você tiver quaisquer remetentes RCS.