Skip to main content
SMS é o alarme no bolso: texto curto que chega em qualquer celular, sem internet e sem app. Ideal para OTP, lembrete e aviso urgente.

​
O que é SMS na Notifique?

É o canal para mandar texto curto (9 a 160 caracteres) direto no celular do destinatário. Você envia pelo painel ou API; a plataforma cuida da fila, das tentativas e do status de cada mensagem. Você pode:
  • Enviar códigos de verificação (OTP) e senhas de uso único
  • Lembrar consultas, entregas e prazos importantes
  • Avisar quem não usa WhatsApp ou não tem app instalado
  • Agendar envio para data e hora futuras
  • Consultar histórico e status de cada SMS
  • Receber respostas do cliente (MO) e acompanhar por webhook
Pense num bilhete colado no vidro do carro: poucas palavras, leitura imediata, sem depender de app.
Diferente do WhatsApp, SMS não usa instância (número pareado). Basta uma API Key com o escopo certo e os destinatários em formato internacional (ex.: 5511999999999, sem +).

​
Quando usar?

Funciona muito bem para código de verificação, lembrete urgente e cliente sem WhatsApp. Para texto longo com imagens, prefira e-mail. Campanha massiva é possível, mas SMS consome mais créditos, avalie o custo antes.

​
Como funciona na prática

  1. Crie uma API Key com sms:send (e sms:read / sms:cancel se for consultar ou cancelar)
  2. Envie para um ou vários números com POST /v1/sms/messages (até 100 por chamada)
  3. A plataforma enfileira, envia e atualiza o status; seu backend recebe avisos se configurou webhooks
Cada API Key pertence a um workspace. Na v1 não envie x-workspace-id. Se o header vier preenchido, a API retorna 400 (WORKSPACE_HEADER_NOT_ALLOWED).

​
Ciclo da mensagem

Depois do envio, o SMS passa por status como QUEUED (na fila), SENT (na operadora), DELIVERED (confirmado no celular) ou FAILED (número inválido, bloqueio, etc.). Agendamentos começam em SCHEDULED; cancelamentos viram CANCELLED. Cancelamento pela API funciona enquanto o status for QUEUED ou SCHEDULED.

​
O que dá para fazer

  • Enviar para 1 a 100 números internacionais por chamada
  • Agendar com schedule.sendAt
  • Consultar histórico ou um envio pelo id
  • Cancelar envio na fila ou agendado
  • Ler SMS recebidos (MO) com sms:read
  • Idempotência com header Idempotency-Key para evitar duplicata
  • Rastrear cliques em link curto (webhook sms.clicked)
Cada SMS consome 30 créditos (plano) ou R$ 0,12 (pague pelo uso). Veja Cobrança. Detalhe de campos e erros: referência da API na aba SMS.

​
Depois do primeiro envio

  • Acompanhe entrega e falha por webhooks (sms.sent, sms.delivered, sms.failed)
  • Processe respostas com sms.received e sms.replied, guia: Mensagens recebidas
  • Teste no Sandbox com sk_test_... antes de ir para produção

​
Próximos passos