> ## 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.
# Configuração de SMS
> Configure o envio de mensagens de texto com o OneSignal. Entenda o modelo de brand, sender e sender resource, escolha entre OneSignal SMS e Twilio e aprenda a migrar de um provedor existente.
Há duas maneiras de configurar o envio de mensagens de texto com o OneSignal: uma integração direta com o Twilio ou o OneSignal SMS (que gerencia a infraestrutura das operadoras em seu nome). A integração com o Twilio é ideal para clientes que conseguem fazer a solicitação do sender resource e a configuração do sender por conta própria. O OneSignal SMS é ideal para clientes que querem que nossa equipe de conformidade cuide das solicitações junto às operadoras, do registro e do suporte contínuo.
Configurar o envio de mensagens de texto envolve três conceitos centrais: **brands**, **senders** e **sender resources**. Acertar essa estrutura desde o início impacta diretamente quais regiões você pode atingir, com que rapidez suas mensagens são enviadas e que tipo de conteúdo você pode enviar.
***
## Conceitos centrais
### Brand
Um brand é a informação de identidade compartilhada (nome da empresa, site, CNPJ/identificação fiscal e logotipo) que identifica a organização por trás das suas mensagens durante a aprovação do sender resource. No OneSignal, um brand corresponde a um único app do OneSignal.
### Sender
Um sender é um sender resource ou um grupo de sender resources. Cada programa de mensagens de texto (promocional, transacional ou OTP) requer um sender dedicado.
A razão mais importante para usar um sender dedicado por programa é o **gerenciamento de consentimento**. Quando cada sender corresponde a um único programa, os opt-outs permanecem com escopo bem definido. Se um destinatário cancelar a inscrição no seu sender promocional, ele para de receber mensagens de marketing, mas continua recebendo confirmações de pedido, atualizações de envio ou códigos de segurança dos seus outros senders.
Agrupar múltiplos sender resources em um único sender é útil para:
* **Envio geográfico:** Encaminhe mensagens pelo melhor sender resource para a localização geográfica de cada destinatário sem segmentar seu público por localização. Por exemplo, um sender com um short code dos EUA e um short code do Reino Unido entrega automaticamente do número dos EUA para destinatários nos EUA e do número do Reino Unido para destinatários no Reino Unido.
* **Escalonamento de throughput:** Combine múltiplos sender resources para multiplicar sua taxa de envio efetiva. Por exemplo, 10 sender IDs, cada um com 1 mensagem por segundo (MPS), oferecem 10 MPS. O escalonamento de throughput não é permitido nos EUA e pode ter restrições em outras regiões.
* **Gerenciamento de fallbacks:** Combine sender resources de RCS e SMS para que, se o RCS falhar na entrega, o SMS seja usado automaticamente como fallback.
Agrupar sender resources em um sender não interrompe a experiência do usuário final. Um usuário que primeiro recebe de um resource do grupo continua recebendo mensagens futuras desse mesmo resource.
Você pode compartilhar um sender entre vários programas de mensagens de texto e usar palavras-chave personalizadas para gerenciar os opt-outs, mas não recomendamos isso. STOP é uma palavra-chave protegida que automaticamente cancela a inscrição do usuário em todo o sender. Se um sender compartilhado for usado para um programa de marketing e um programa transacional, um usuário que enviar STOP em resposta a uma mensagem de marketing também deixará de receber notificações importantes da conta.
### Sender resources
Um sender resource é o número provisionado ou agente subjacente necessário para enviar mensagens por uma rede de operadora.
Os sender resources ficam restritos a uma única localização geográfica e devem ser dedicados a um único sender. Cada sender resource tem um throughput máximo, ou seja, o número de mensagens que pode enviar por segundo.
Todos os tipos de sender resource exigem aprovação para cada combinação de localização geográfica e caso de uso. Por exemplo, um 10DLC dos EUA aprovado para mensagens promocionais e um agente RCS do Reino Unido aprovado para mensagens transacionais são dois sender resources separados, cada um exigindo sua própria aprovação com informações do brand e mensagens de exemplo.
### Tipos de sender resource
| Tipo | Ideal para | Prazo de aprovação | Throughput | Preço |
| -------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------- | --------------------------------- | -------- |
| **Alphanumeric sender ID** | Nome de sender com marca e throughput médio; requer gerenciar o consentimento (opt-out) separadamente | Rápido (disponível apenas em certas localizações) | Moderado (10 MPS por padrão) | Incluído |
| **Toll-free** | Todos os tipos de mensagens | Dias | Baixo (3 MPS por padrão, até 25+) | Incluído |
| **Long codes** | Todos os tipos de mensagens | Semanas | Moderado–Alto (3–225 MPS) | Incluído |
| **Short code** | Mensagens de alto volume | Semanas–Meses | Alto (100+ MPS) | Premium |
| **RCS** | Mensagens com marca, ricas e semelhantes a apps, ou mensagens de alto volume | 8–16 semanas | Alto (100 MPS) | Premium |
Disponibilidade por país, prazos de aprovação, revisores e notas adicionais para cada tipo de sender resource.
***
## Escolha seu caminho de configuração
Navegue para **Settings > SMS > Set up SMS** no seu dashboard do OneSignal.
O OneSignal gerencia a infraestrutura das operadoras em seu nome, com uma equipe de conformidade dedicada que aproveita a experiência de centenas de solicitações de sender resource. Escolha esta opção se:
* Você envia mais de 5.000 SMS por mês
* Você está em um plano pago do OneSignal (veja [preços](https://onesignal.com/pricing))
Clique em **Book Demo with SMS Expert** para obter ajuda da nossa equipe. Seu gerente de conta também pode reservar um horário com nossa equipe de conformidade para iniciar as solicitações de sender resource.
Enquanto aguarda a verificação, você pode começar a criar templates de SMS e MMS e garantir que atende aos [requisitos de solicitação de sender resource](./sms-registration-requirements).
Você gerencia sua conta Twilio e seus sender resources diretamente pelo Twilio e depois os conecta ao OneSignal. Escolha esta opção se:
* Você envia menos de 5.000 SMS por mês
* Você quer controle total da sua conta Twilio
Isso é ideal para testes ou envios em pequena escala. Solicite os sender resources que atendem às necessidades do seu negócio no Twilio e adicione-os a um messaging service antes de conectar. Certifique-se de que seu sender resource do Twilio suporta SMS (e MMS, se necessário).
**Configure o Twilio:**
Adicione seu **Twilio Account SID** e **Auth Token** do seu dashboard do Twilio e clique em **Next: Add Phone Numbers**.
Após a verificação, o OneSignal recupera todos os sender resources do Twilio vinculados à sua conta. Selecione um **sender resource padrão** para usar ao enviar. Você pode substituí-lo durante a criação da mensagem.
Para confirmar a configuração, insira seu número de telefone e clique em **Send Test SMS**. Se a mensagem não chegar, confirme se o sender resource padrão suporta SMS e verifique os logs do Twilio em busca de erros.
Contas de teste do Twilio exigem que os números dos destinatários sejam [pré-registrados](https://www.twilio.com/docs/usage/tutorials/how-to-use-your-free-trial-account).
***
## Migrando de um provedor existente
Se você quer transferir programas de mensagens de texto existentes para o OneSignal SMS a partir de outro provedor, será necessário migrar seus sender resources e suas automações de SMS existentes.
* **Do Twilio:** Sem tempo de inatividade. O OneSignal transfere seus números para a nova conta. Dependendo do tipo de número e do processo de registro, isso normalmente leva cerca de 3 semanas.
* **De outro provedor:** Há algum risco de tempo de inatividade. Dependendo dos tipos de número e da complexidade da conta, isso normalmente leva cerca de 4 semanas ou mais.
Entre em contato com seu gerente de conta para reservar um horário com nossa equipe de implementação e iniciar sua migração.
***
## FAQ
### Qual é a diferença entre o OneSignal SMS e a integração com o Twilio?
Com a integração com o Twilio, você gerencia sua própria conta Twilio, seus sender resources e seus relacionamentos com as operadoras. Com o OneSignal SMS, o OneSignal gerencia a infraestrutura das operadoras em seu nome, incluindo solicitações de sender resource, orientação de conformidade e suporte. O OneSignal SMS é recomendado para clientes que enviam mais de 5.000 mensagens por mês.
### Posso usar múltiplos sender resources para o mesmo sender?
Sim. Você pode agrupar múltiplos sender resources em um único sender para envio geográfico, escalonamento de throughput ou fallback de RCS/SMS. Um usuário que recebe de um sender resource dentro de um sender continua recebendo desse mesmo sender resource no futuro.
### O que é throughput e por que ele importa?
Throughput é o número de mensagens que um sender resource (ou sender) pode enviar por segundo. Se você precisar enviar para um público grande rapidamente, talvez precise de um tipo de sender resource com throughput mais alto (por exemplo, um short code) ou agrupar múltiplos sender resources em um único sender. O escalonamento de throughput entre múltiplos sender resources não é permitido nos EUA.
### Quanto tempo leva a aprovação do sender resource?
Os prazos variam conforme o país e o tipo de sender resource. Alphanumeric sender IDs na maioria dos países levam de 1 a 5 dias úteis. O 10DLC nos EUA leva de 1 a 3 semanas. Short codes e RCS normalmente levam de 8 a 16 semanas. Veja [Solicitações de sender resource](./sms-registration-requirements) para detalhes específicos por país.
***
## Páginas relacionadas
Processos de aprovação por país, tipos de sender resource e leis aplicáveis.
Métodos de coleta, linguagem de divulgação obrigatória e validação de público.
Padrões de consentimento, horários de silêncio, conteúdo proibido e prevenção de fraudes.
Limites de caracteres, MMS, links rastreáveis e conteúdo rico de RCS.