Configuração de SMS

SMS é o canal de reserva — mais lento que WhatsApp, mais caro por mensagem, mas funciona em todo telefone do planeta sem app. O GCM o usa para códigos de verificação em duas etapas, transmissões urgentes e lembretes para membros que não lhe deram o e-mail.

Configure em Settings → Channels → SMS.

Escolher um provedor

Provedor	O que é	Configuração	Custo	Ideal para
Twilio	API SMS em nuvem padrão da indústria	média	por mensagem	a maioria das igrejas nos EUA/CA/UK
smsmobileapi	Serviço de relay por celular (seu Android envia)	baixa	incluso	cobertura global, baixo volume
Padrão da plataforma	Emissor compartilhado da plataforma	nenhuma	incluso no plano	níveis starter / growth

Opção 1 — Twilio

Twilio é o padrão para SMS nos EUA, Canadá e na maior parte da Europa. Você precisará de uma conta Twilio e um número de telefone provisionado no console deles.

Você precisa de:

• Account SID — o identificador da sua conta Twilio, começa com AC….
• Auth token — do seu console Twilio.
• From number — um número de telefone Twilio que você provisionou (ou um ID alfanumérico de remetente onde for suportado).

Callbacks de status

Configuramos automaticamente o Twilio para POSTar atualizações de status de entrega de volta para o GCM em /channel-webhook?provider=twilio&event=status. Nenhuma configuração manual de webhook necessária — a URL é enviada com cada envio e o Twilio cuida do resto. Status delivered / failed / undelivered aparece nos logs de mensagens em poucos segundos.

SMS bidirecional

Se você quer que os membros respondam aos seus textos, aponte o webhook A MESSAGE COMES IN do seu número Twilio para /channel-webhook?provider=twilio no console Twilio. Textos de entrada criarão conversas como o WhatsApp de entrada.

Registro de operadora dos EUA (A2P 10DLC)

As operadoras dos EUA exigem que qualquer empresa enviando SMS se registre pelo programa 10DLC. O Twilio te guia por isso — espere 2-4 semanas para aprovação. Números não registrados ainda podem enviar, mas com filtragem pesada e throughput limitado. Para igrejas de alto volume, registre-se antes de ir para produção.

Opção 2 — smsmobileapi

Um serviço de relay: você instala um app em um celular Android, e a nuvem deles roteia mensagens por esse celular. O celular usa seu chip SIM de verdade, então o SMS sai como se você tivesse enviado do seu próprio aparelho — perfeito para regiões onde o Twilio não tem boa cobertura, ou para igrejas que já têm um telefone dedicado para evangelismo.

Você precisa de:

• API key — do painel do smsmobileapi.

É isso. A mesma chave de API alimenta o serviço de WhatsApp deles se você quiser ambos os canais juntos.

TIP

Configure o celular para "Nunca dormir" e plugue na tomada. O relay não consegue enviar enquanto o celular estiver offline.

Trade-off: o throughput é limitado pelo que seu chip SIM e operadora permitem. Bom para envios abaixo de 1.000 mensagens, doloroso acima disso. Espere 1-2 mensagens por segundo.

Opção 3 — Padrão da plataforma

Alguns planos incluem uma cota compartilhada de SMS — a plataforma envia pela própria conta Twilio dela, faturada contra seu plano. Zero configuração. Você verá sua cota mensal em Settings → Billing.

Trade-off: o número From é do pool de números da plataforma, não o seu. Os membros não vão reconhecer quem está mandando texto até lerem o corpo da mensagem. Para a maioria dos casos de uso de lembrete, está bom; para transmissões com marca, traga seu próprio Twilio.

Recursos por canal

Uma vez configurado, Settings → Channels → SMS permite controlar:

• Max recipients per bulk — padrão 500, aumente com cuidado.
• Merge tokens — personalização no estilo {{first_name}}.
• Two-way conversation routing — textos de entrada roteados para conversas.

Testando a conexão

Clique em Send test message nas configurações do canal SMS. Enviamos um "Hello from GCM" para o celular principal do admin da organização. Se chegar em <30 segundos, está pronto.

Se não chegar:

1. Verifique o log de atividade do provedor (Twilio Messaging Log, histórico do smsmobileapi).
2. Confirme que o número destinatário está no formato E.164 (+18765551234, não 876-555-1234). O GCM normaliza números mas um malformado no registro do membro não vai funcionar.
3. Verifique o faturamento do provedor — o Twilio em particular pausa envios quando o saldo zera.

Limites de caracteres SMS

Um único SMS tem 160 caracteres de GSM-7 ou 70 caracteres de UCS-2 (se sua mensagem inclui emoji ou caracteres não latinos). Mensagens mais longas são divididas em segmentos — cada segmento é cobrado separadamente.

O GCM mostra um contador de caracteres ao vivo enquanto você compõe. Mantenha transmissões abaixo de um segmento quando possível.

Disciplina de custo

SMS é o canal mais caro por mensagem. Alguns hábitos que mantêm os custos sob controle:

1. Use e-mail por padrão para mensagens não urgentes. SMS apenas para tempo-crítico.
2. Use links curtos no corpo — g.cm/event/123 em vez da URL completa — para economizar caracteres.
3. Defina horários de silêncio para envios em massa em Settings → Channels → SMS para evitar disparos acidentais às 3h da manhã.

Referências cruzadas

• Mensageria SMS — compor e enviar textos.
• Configuração do WhatsApp — geralmente mais barato, taxas de abertura mais altas.
• Conversas — gerenciar respostas de entrada.