> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> Envie códigos de verificação, lembretes e avisos urgentes por SMS pelo painel ou API, com acompanhamento de entrega e respostas.

<Tip>
  SMS é o **alarme no bolso**: texto curto que chega em qualquer celular, sem internet e sem app. Ideal para OTP, lembrete e aviso urgente.
</Tip>

## 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.

<Note>
  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 `+`).
</Note>

## 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](/emails-api/como-funciona/introducao). 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](/sms-api/como-funciona/eventos-do-webhooks)

<Note>
  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`).
</Note>

## 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](/guides/introducao/cobranca-e-pague-pelo-uso).

Detalhe de campos e erros: **referência da API** na aba SMS.

## Depois do primeiro envio

* **Acompanhe** entrega e falha por [webhooks](/sms-api/como-funciona/eventos-do-webhooks) (`sms.sent`, `sms.delivered`, `sms.failed`)
* **Processe respostas** com `sms.received` e `sms.replied`, guia: [Mensagens recebidas](/guides/webhooks/mensagens-recebidas-e-respostas)
* **Teste** no [Sandbox](/guides/sandbox/index) com `sk_test_...` antes de ir para produção

## Próximos passos

* [Quick Start](/sms-api/como-funciona/quick-start): primeiro envio pela API
* [Escopos da API Key](/sms-api/como-funciona/escopos-da-api-key): permissões
* [Eventos dos webhooks](/sms-api/como-funciona/eventos-do-webhooks): o que chega na sua URL
* [Comece aqui](/guides/introducao/comece-aqui): integração geral da plataforma