> ## 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.
# Relatórios de mensagens SMS
> Veja estatísticas de entrega de SMS e RCS, taxas de cliques e detalhes de falhas no OneSignal. Aborda todas as métricas de mensagens, solução de problemas com códigos de erro, retenção de dados e como exportar dados.
Os relatórios de mensagens SMS fornecem estatísticas de entrega, métricas de engajamento e detalhes no nível do destinatário para cada mensagem que você envia. Os relatórios estão disponíveis tanto para mensagens SMS/MMS quanto RCS.
***
## Referência de métricas
### Métricas no nível da mensagem
| Métrica | Definição |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sent** | O número de mensagens enviadas do OneSignal, incluindo tanto as enviadas com sucesso para a operadora quanto as falhas. |
| **Audience** | O número de inscrições no(s) segmento(s) direcionado(s). |
| **Remaining** | O número de inscrições na audiência-alvo que ainda não receberam a mensagem (na fila ou em trânsito). Aparece no relatório de entrega do dashboard. |
| **Delivered** | O número de mensagens entregues com sucesso à operadora. Mostrado separadamente para SMS/MMS e RCS no relatório. |
| **Failed** | O número de mensagens que falharam ao serem enviadas para a operadora. |
| **Suppressed** | O número de mensagens não enviadas porque a inscrição optou por não receber mensagens do remetente. |
| **Rejected** | O número de mensagens não entregues pela operadora devido a bloqueio de número, bloqueio de velocidade ou uma lista de bloqueio do destinatário. Esta é uma métrica derivada: a soma de Provider Errored e Provider Undelivered. |
| **Provider Errored** | O número de inscrições para as quais a operadora falhou ao enviar a mensagem. |
| **Provider Undelivered** | O número de inscrições para as quais a operadora enviou a mensagem, mas falhou ao entregá-la. |
| **Read** *(apenas RCS)* | O número de inscrições que leram uma mensagem RCS. Disponível porque o RCS oferece suporte a confirmações de leitura. |
| **Total Clicks** | O número total de vezes que um link na mensagem foi clicado, incluindo cliques repetidos. |
| **Unique Clicks** | O número de cliques únicos em links. Contado uma vez por inscrição. |
| **Replied** | O número de respostas recebidas que corresponderam a uma palavra-chave personalizada. Exclui palavras-chave de consentimento (STOP, HELP, START). |
| **Unsubscribed** | O número de respostas recebidas com palavra-chave de cancelamento de inscrição (por exemplo, STOP). |
### Métricas no nível do relatório
| Métrica | Descrição |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Delivery rate** | A porcentagem de mensagens entregues com sucesso. |
| **Failure & rejection rate** | A porcentagem de mensagens não entregues ou suprimidas. |
| **Click-through rate (CTR)** | A porcentagem do total de destinatários que clicaram em um link nesta mensagem. Veja [Links](./links) para mais detalhes sobre o rastreamento de cliques. |
Para definições de métricas em todos os canais, veja o [Glossário de métricas](./analytics-metrics-glossary).
***
## Retenção de dados
As mensagens SMS e os dados de relatório relacionados são mantidos por aproximadamente **30 dias**. Exporte os dados de mensagem ou de audiência se você precisar de registros de longo prazo. Veja [Exportando dados](./exporting-data).
***
## Conversões
Em breve: [Métricas de conversão](./conversion-metrics) nos relatórios de mensagens. Quando estiver disponível, você verá conversões atribuídas e influenciadas para cada mensagem diretamente em seu relatório.
***
## Entendendo as falhas de SMS
Ao solucionar problemas de capacidade de entrega, observe o **texto exato do erro** na Audience Activity.
| Texto do erro | Código do erro | O que geralmente significa | O que fazer |
| ----------------------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Message blocked** | [30004](https://www.twilio.com/docs/api/errors/30004) | A operadora ou uma camada de política bloqueou a mensagem. Causas comuns: filtragem de conteúdo da operadora, reputação do remetente, problemas de 10DLC/registro, estado de cancelamento de inscrição do destinatário ou regras regionais (por exemplo, DLT da Índia). | Confirme o opt-in e o tratamento de STOP. Alinhe o conteúdo com seu caso de uso registrado. Conclua o registro de 10DLC/marca onde for exigido. Evite padrões semelhantes a spam. |
| **Unknown destination handset** | [30005](https://www.twilio.com/docs/api/errors/30005) | O número é desconhecido, inválido ou não está mais ativo (dígitos errados, linha desconectada ou código de país digitado incorretamente). | Valide e normalize os números para E.164 antes de enviar. Remova linhas fixas e números inválidos. Veja [Validação de audiência](./sms-opt-in-and-collection#audience-validation). |
| **Unreachable destination handset** | [30003](https://www.twilio.com/docs/api/errors/30003) | O número pode ser válido, mas o aparelho está desligado, fora de cobertura ou em roaming de uma forma que bloqueia SMS. | Tente novamente mais tarde. |
Outros códigos numéricos podem aparecer. Pesquise no [índice de erros do Twilio](https://www.twilio.com/docs/api/errors) o código mostrado na Audience Activity. O OneSignal SMS usa a infraestrutura do Twilio, portanto esses códigos se aplicam a ambas as configurações.
### Mensagens sem texto de erro
Algumas falhas não retornam texto de erro ou retornam um campo de motivo vazio quando a operadora ou o provedor não fornece um código detalhado. No dashboard, essas falhas geralmente são agrupadas em **Failed to Send**. Etapas recomendadas:
1. Confirme que o número é um E.164 válido e que a inscrição é elegível para SMS e não optou por sair.
2. Tente novamente após um atraso, no caso de problemas transitórios do provedor ou da operadora.
3. Se o problema for generalizado, colete exemplos de SIDs de mensagem ou de entrega e entre em contato com o suporte do OneSignal.
***
## Faturamento
### Clientes do OneSignal SMS
Veja seu uso em **Settings > Usage > SMS > See breakdown**. O detalhamento mostra os segmentos (não as mensagens) enviados por tipo de mensagem, filtráveis por país. O detalhamento é atualizado diariamente.
A contagem inclui todos os segmentos de saída, incluindo respostas automáticas enviadas em resposta a palavras-chave de consentimento (STOP, HELP, START) ou outras respostas com palavras-chave personalizadas. As mensagens com falha não estão incluídas na contagem de segmentos.
### Clientes da integração com o Twilio
Você paga o Twilio diretamente. Para questões de faturamento, consulte seu dashboard do Twilio.
***
## FAQ
### Por que minha taxa de entrega aparece mais baixa do que o esperado?
As causas comuns incluem números de telefone inválidos, assinantes que optaram por sair (mostrados como Suppressed), filtragem de conteúdo pelo lado da operadora ou problemas de registro (mostrados como Rejected ou Provider Errored). Verifique o texto do erro na Audience Activity para a causa específica.
### Qual é a diferença entre Failed e Rejected?
Failed significa que o OneSignal não conseguiu enviar a mensagem para a operadora de forma alguma. Rejected significa que a operadora recebeu a mensagem, mas não a entregou, normalmente devido a bloqueio de número, limites de velocidade ou o destinatário estar em uma lista de bloqueio.
### Por quanto tempo os relatórios de mensagens ficam disponíveis?
Os relatórios de mensagens SMS e os dados de atividade da audiência são mantidos por aproximadamente 30 dias. Exporte seus dados se você precisar de retenção por mais tempo.
### Posso ver quais assinantes individuais receberam uma mensagem?
Sim. A seção Audience Activity de cada relatório de mensagem mostra detalhes de entrega e engajamento no nível do destinatário, incluindo quaisquer códigos de erro para mensagens com falha.
### Por que algumas mensagens não têm código de erro?
Algumas operadoras e provedores não retornam códigos de erro detalhados para entregas com falha. Essas aparecem como vazias na Audience Activity. Se você observar falhas generalizadas sem detalhes de erro, colete os SIDs das mensagens e entre em contato com o suporte do OneSignal.
***
## Páginas relacionadas
Codificação, cálculo de segmentos, limites de MMS e como o conteúdo afeta o faturamento.
Validação de audiência e requisitos de formato de número de telefone.
Exporte dados de entrega e engajamento para retenção de longo prazo.
Como o OneSignal rastreia cliques em mensagens SMS, MMS e RCS.