Skip to main content

​
Por que este canal importa

SMS continua sendo o canal que funciona em qualquer celular: confirmação de cadastro, código rápido, lembrete de agendamento ou alerta crítico. Integrar por API evita planilha, gateway próprio e dor de cabeça com fila, retentativas e status — a Notifique centraliza isso para você.

​
O que você encontra no painel

  • API Keys e escopos — liberar só sms:send, leitura de mensagens, cancelamento, etc., conforme o que cada integração precisa.
  • Créditos e Pague pelo uso — o consumo de SMS pesa mais que um e-mail; o painel ajuda a enxergar plano, créditos e saldo (quem está em plano e esgota o mês pode usar saldo automaticamente, conforme a regra da conta).
  • Webhooks (quando configurados) — para o seu sistema acompanhar entrega, falha e mudanças de status sem ficar consultando a API o tempo todo.

​
O que você encontra na API

  • Envio em lote — POST /v1/sms/messages com to como lista de números em E.164 (ex.: 5511999999999), até 100 destinatários por chamada.
  • Agendamento — campo schedule.sendAt em ISO 8601; resposta pode vir com status: "SCHEDULED".
  • Cancelamento — apenas mensagens ainda SCHEDULED podem ser canceladas; depois que entrou na fila ou foi enviada, não dá para desfazer.
  • Idempotência — headers Idempotency-Key / x-idempotency-key evitam duplicar envio se a sua aplicação repetir a mesma requisição.
A referência OpenAPI do canal SMS detalha schemas e códigos HTTP.

​
Regras e status que todo mundo confunde

  • Tamanho do texto — após tirar espaços das pontas, a mensagem precisa ter no mínimo 9 e no máximo 160 caracteres.
  • Cobrança — cada SMS consome muitos créditos em relação a outros canais (ex.: da ordem de 30 créditos por SMS, conforme tabela do produto) ou o equivalente em saldo em reais; a validação ocorre no envio.
  • Prioridade — opcional: options.priority pode ser high, normal ou low (padrão: normal).
Status possíveis: SCHEDULED (pode cancelar) → QUEUED → SENT → DELIVERED ou FAILED; também CANCELLED se você cancelou a tempo.

​
Próximos passos