> ## 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.
# Opt-in e coleta de SMS
> Colete consentimento de SMS válido para programas promocionais, transacionais e de OTP. Abrange métodos de coleta de opt-in, requisitos de divulgação, validação de audiência e requisitos de formato de número de telefone.
Coletar consentimento válido é a base de um programa de SMS em conformidade. O método e a linguagem de divulgação de que você precisa dependem do tipo de programa que você está executando: promocional, transacional ou OTP.
***
## Opt-ins promocionais
Mensagens promocionais exigem o mais alto padrão de consentimento. O assinante deve tomar uma ação afirmativa para optar pela participação.
### Métodos de coleta de opt-in
#### Formulário de inscrição na web
Um formulário no seu site, landing page ou pop-up onde os assinantes inserem seu número de telefone. Requisitos:
* A caixa de seleção de opt-in de SMS deve estar **desmarcada por padrão**.
* A linguagem de divulgação deve aparecer **no mesmo formulário**, acima do botão de envio, não vinculada a outro local nem enterrada.
* O consentimento de SMS deve ser **coletado separadamente** do consentimento de e-mail.
#### Palavra-chave text-to-subscribe
Os assinantes enviam uma palavra-chave por texto para o número do seu remetente para optar pela participação (por exemplo, "Envie DESCONTO para 58120"). Você define a palavra-chave e a mensagem de confirmação enviada de volta.
Com o iOS 26, mensagens de números não salvos como contatos são filtradas em uma pasta separada de "Remetentes Desconhecidos". Como no text-to-subscribe o assinante envia a primeira mensagem, seu número aparece no histórico de mensagens dele antes de você responder, tornando-o um remetente conhecido. Este é um dos melhores métodos de coleta para visibilidade na caixa de entrada do iOS.
#### Código QR
Um código QR que abre o aplicativo de SMS do assinante com o número do seu remetente e a palavra-chave pré-preenchidos. Ideal para sinalização em loja, embalagens de produtos, recibos e eventos.
Para criar um, use um gerador de código QR de SMS que suporte o formato de URL `sms:` (por exemplo, [QR Code Dynamic](https://qrcodedynamic.com/qr/sms) ou [QRKIT](https://useqrkit.com/sms-qr-code)). O formato de URL subjacente é `sms:+[phone_number]?body=KEYWORD`. Para um agente RCS, use `sms:+[phone_number]?service_id=[your_agent_id]%40rbm.goog&body=MESSAGE`. Você pode encontrar seu número de telefone e o ID do agente em **Settings > Senders**.
Onde quer que você compartilhe o código QR, inclua a linguagem de divulgação na mesma superfície: descrição do programa, frequência de mensagens, "Msg & data rates may apply" e instruções de opt-out.
Assim como o text-to-subscribe, os códigos QR estabelecem seu número como um remetente conhecido antes de você responder, dando a eles a mesma vantagem de visibilidade na caixa de entrada do iOS 26.
#### Checkout e ponto de venda
Colete opt-ins no momento da compra. O opt-in deve ser uma caixa de seleção separada e desmarcada e não pode ser apresentado como obrigatório para confirmações de pedido ou atualizações de entrega.
#### Formulário de inscrição físico
Colete números de telefone em um formulário impresso em lojas físicas, eventos ou balcões de atendimento. Inclua a mesma linguagem de divulgação exigida para opt-ins digitais. Importe esses assinantes via CSV ou API. Consulte [Importando assinantes](./import).
#### E-mail
Um prompt de opt-in em uma campanha de e-mail existente pedindo aos assinantes que também entrem na sua lista de SMS. Ter um endereço de e-mail não implica consentimento de SMS. O assinante deve optar ativamente por meio de uma ação separada.
Para exemplos de código, veja os [exemplos de formulário de inscrição do OneSignal](https://github.com/OneSignalDevelopers/signup-form-examples) e o [exemplo de coleta de e-mail e SMS](https://github.com/OneSignalDevelopers/email-sms-collection-sample) no GitHub.
### Linguagem de divulgação obrigatória
Toda divulgação de opt-in promocional deve abranger:
* O nome da sua marca
* Que o assinante receberá mensagens de **marketing** automatizadas recorrentes
* Frequência de mensagens (aproximada)
* "Msg & data rates may apply"
* Como optar pela saída (STOP)
* Links para seus Termos de Serviço e Política de Privacidade
* Uma declaração de que o consentimento não é condição de compra
A descrição do programa deve **declarar explicitamente que as mensagens são para marketing.** Linguagem vaga como "atualizações" ou "informações" não é suficiente. Caixas de seleção pré-marcadas não estão em conformidade em lugar nenhum.
***
## Opt-ins transacionais
Mensagens transacionais têm um padrão de consentimento menor do que mensagens promocionais. Um usuário inserindo seu número de telefone em um formulário que inclui linguagem de divulgação é opt-in suficiente. Nenhuma caixa de seleção separada é necessária.
A divulgação deve aparecer diretamente no campo de número de telefone ou perto dele. Não pode estar em uma página separada nem enterrada nos termos de serviço.
### Pontos de coleta comuns por caso de uso
| Caso de uso | Onde coletar |
| ------------------------------------------------------ | ---------------------------------------------- |
| Confirmações de pedido e atualizações de envio | Checkout, perto do campo de número de telefone |
| Notificações de conta (alertas de segurança, cobrança) | Formulário de criação de conta ou inscrição |
| Lembretes de compromisso | Formulário de reserva ou agendamento |
| Sequências de onboarding | Criação de conta ou configuração de perfil |
| Preferências de notificação | Página de preferências no aplicativo ou na web |
### Linguagem de divulgação obrigatória
Toda divulgação de opt-in transacional deve incluir:
* O **nome da sua marca**
* Os **tipos específicos de mensagens** que o usuário receberá (por exemplo, "mensagens de texto de confirmação de pedido e atualização de envio", em vez de apenas "mensagens" ou "atualizações")
* **"Msg & data rates may apply"**
* Como **optar pela saída** (por exemplo, "Reply STOP to opt out")
**Um número de telefone sozinho não é consentimento.** Se o seu formulário coletar um número de telefone, mas não tiver texto de divulgação, você não tem consentimento para enviar mensagens de texto.
**O consentimento é restrito ao propósito declarado.** Se um usuário consentiu em receber atualizações de envio no checkout, isso não cobre o envio de lembretes de compromisso de uma parte diferente do seu negócio.
***
## Opt-ins de OTP
O consentimento para mensagens de senha única segue o mesmo padrão das mensagens transacionais. Um usuário inserindo seu número de telefone em um formulário que inclui linguagem de divulgação é suficiente.
Toda divulgação de opt-in de OTP deve incluir:
* O **nome da sua marca**
* Os **tipos específicos de mensagens** que o usuário receberá (por exemplo, "códigos de verificação e alertas de segurança")
* **"Msg & data rates may apply"**
* Como **optar pela saída** (por exemplo, "Reply STOP to opt out")
***
## Validação de audiência
Uma lista de assinantes limpa melhora a entregabilidade, reduz custos e mantém seu programa em conformidade.
### Valide números de telefone com o Lookup
Antes de adicionar um número à sua lista de assinantes, use o Lookup do OneSignal para verificá-lo. O Lookup verifica se um número de telefone é válido, ativo e móvel, filtrando linhas fixas, números VoIP, linhas desconectadas e números digitados incorretamente antes que eles recebam uma mensagem.
Execute o Lookup no ponto de coleta (por exemplo, no envio do formulário) ou como uma operação em lote nos seus assinantes existentes.
### Colete apenas números de regiões para as quais você pode enviar
Certifique-se de coletar apenas números de telefone em regiões geográficas onde você tem um remetente com um recurso de remetente aprovado para aquela região. Se você não tiver um remetente com um recurso de remetente aprovado para um determinado país, as mensagens para números nesse país falharão.
### Verifique a propriedade com uma senha única
O Lookup confirma que um número é válido, mas não confirma que a pessoa que está se inscrevendo realmente é dona daquele número. Para fechar essa lacuna, envie uma senha única imediatamente após o assinante inserir seu número de telefone. Consulte [Senhas únicas](./sms-verify) para saber como configurar OTPs com o OneSignal Verify ou seu próprio backend.
### Colete números no formato E.164
Os números de telefone devem ser armazenados no formato E.164: um código de país seguido do número do assinante, sem espaços, traços ou parênteses (por exemplo, `+14155551234`). Este é o formato que as operadoras e plataformas de mensagens esperam.
Se o seu formulário de inscrição aceitar entrada de telefone em texto livre, valide e normalize o número para E.164 antes de salvá-lo. A API do OneSignal e a importação por CSV esperam o formato E.164.
***
## Dando marca ao seu remetente com um cartão de contato
Um cartão de contato (vCard) permite que os assinantes salvem seu negócio como um contato em seus telefones. Uma vez salvo, o nome e o logotipo da sua marca aparecem no lugar de um número de telefone desconhecido. Isso melhora a visibilidade, reduz a chance de as mensagens serem ignoradas e ajuda você a evitar a caixa de entrada de "Remetentes Desconhecidos" do iOS.
Você entrega um cartão de contato enviando um arquivo `.vcf` como uma mensagem MMS.
### Crie seu arquivo vCard
Crie um arquivo `.vcf` com as informações de contato do seu negócio. Você pode usar um gerador de vCard online ou escrevê-lo em um editor de texto. O formato é texto simples:
```
BEGIN:VCARD
VERSION:3.0
FN:Your Business Name
ORG:Your Business Name
TEL;TYPE=CELL:+15551234567
END:VCARD
```
Use o mesmo número de telefone da sua identidade de remetente de SMS. Você pode, opcionalmente, incluir uma propriedade `PHOTO` com o logotipo da sua marca para que ele apareça ao lado do nome do contato.
### Hospede o arquivo em uma URL pública
O arquivo `.vcf` deve estar acessível por meio de uma URL direta e publicamente acessível, não uma página de download ou visualização. Hospede-o no seu CDN, servidor web ou armazenamento em nuvem (AWS S3, Google Cloud Storage) com acesso de leitura público habilitado.
### Envie o cartão de contato
No painel do OneSignal, crie uma nova mensagem SMS.
No campo **Media URL**, cole a URL pública do seu arquivo `.vcf` hospedado.
Incentive o assinante a salvar seu contato, por exemplo: *"Salve nosso contato para sempre saber que somos nós! Toque no anexo para nos adicionar aos seus contatos."*
Envie quando um novo assinante optar pela participação, para que seu número seja reconhecido antes que quaisquer mensagens futuras cheguem.
Enviar um cartão de contato usa o campo de URL de mídia, o que significa que a mensagem é enviada como MMS e cobrada nas tarifas de MMS.
***
## FAQ
### Qual é a diferença entre consentimento promocional e transacional?
Mensagens promocionais exigem consentimento expresso por escrito, uma ação afirmativa como marcar uma caixa desmarcada ou enviar uma palavra-chave por texto. Mensagens transacionais têm um padrão menor: um usuário inserindo seu número de telefone em um formulário onde a linguagem de divulgação está visível é suficiente. A divulgação deve estar presente e ser específica sobre quais tipos de mensagens eles receberão.
### Preciso de double opt-in para todos os programas promocionais?
O double opt-in é obrigatório para programas de carrinho abandonado nos EUA. Para outros programas promocionais, é opcional, mas fortemente recomendado — ele reduz reclamações de spam, melhora a qualidade da lista e fornece uma documentação de consentimento mais robusta.
### Posso coletar consentimento de SMS e e-mail no mesmo formulário?
Você pode usar o mesmo formulário, mas deve coletar o consentimento para cada canal separadamente. Agrupar o consentimento de SMS com o consentimento de e-mail (por exemplo, uma única caixa de seleção para ambos) não está em conformidade para SMS.
### Posso importar assinantes de outro provedor?
Sim, se eles já tiverem fornecido consentimento válido que atenda aos requisitos para o tipo de programa que você está executando. Consulte [Importando assinantes](./import) para saber como transferir assinantes existentes via CSV ou API.
### O que é o formato E.164?
O E.164 é o formato padrão internacional de número de telefone: um sinal de mais, código de país e número do assinante, sem espaços ou pontuação (por exemplo, `+14155551234` para um número dos EUA). A API do OneSignal e a importação por CSV exigem números nesse formato.
### Por que devo usar o Lookup antes de adicionar assinantes?
Enviar para números inválidos, de linha fixa ou desconectados desperdiça gastos e pode prejudicar sua reputação de remetente junto às operadoras. O Lookup filtra esses números antes que eles cheguem à sua lista, o que melhora a entregabilidade e reduz custos.
***
## Páginas relacionadas
Gerencie palavras-chave STOP, HELP, START e palavras-chave de opt-out personalizadas depois que os assinantes optam pela participação.
Regras das operadoras, horários de silêncio, conteúdo proibido e o quadro regulatório mais amplo.
Configure OTPs com o OneSignal Verify ou seu próprio backend para verificar a propriedade do número.
Padrões específicos de mensagens promocionais: configuração de double opt-in, centrais de preferências e orientações de envio.