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

# Introducción

> Envíe códigos de verificación, recordatorios y alertas urgentes por SMS desde el panel o API, con seguimiento de entrega y respuestas.

<Tip>
  Los SMS son la **alarma de bolsillo**: texto corto que llega a cualquier teléfono, sin necesidad de Internet ni aplicaciones. Ideal para OTP, recordatorios y alertas urgentes.
</Tip>

## ¿Qué son los SMS en Notifique?

Es el canal para enviar **textos cortos** (de 9 a 160 caracteres) directamente al teléfono del destinatario. Envías desde el **panel o API**; la plataforma maneja la cola, los reintentos y el estado de cada mensaje.

Puede:

* **Enviar** códigos de verificación (OTP) y contraseñas de un solo uso
* **Recordar** citas, entregas y plazos
* **Llegue** a clientes sin WhatsApp o sin una aplicación instalada
* **Programar** envíos para una fecha y hora futuras
* **Consulta** historial y estado de cada SMS
* **Recibir** respuestas de clientes (MO) y realizar un seguimiento a través de webhook

Piense en una nota en el parabrisas de un automóvil: pocas palabras, léalas inmediatamente, no se necesita ninguna aplicación.

<Note>
  A diferencia de WhatsApp, SMS **no utiliza una instancia** (número emparejado). Solo necesita una clave API con el alcance correcto y destinatarios en formato internacional (por ejemplo, `5511999999999`, no `+`).
</Note>

## ¿Cuándo usarlo?

Funciona muy bien para **códigos de verificación**, **recordatorios urgentes** y **clientes sin WhatsApp**. Para textos largos con imágenes, prefiera [email](/es/emails-api/como-funciona/introducao). Las campañas masivas son posibles, pero los SMS utilizan más créditos; sopese primero el costo.

## Cómo funciona en la práctica

1. **Cree** una clave API con `sms:send` (y `sms:read` / `sms:cancel` si realiza una consulta o cancela)
2. **Enviar** a uno o varios números con `POST /v1/sms/messages` (hasta **100** por llamada)
3. La plataforma **pone en cola, envía y actualiza el estado**; tu backend recibe notificaciones si configuras [webhooks](/es/sms-api/como-funciona/eventos-do-webhooks)

<Note>
  Cada **Clave API** pertenece a **un** espacio de trabajo. En v1 **no enviar** `x-workspace-id`. Si ese encabezado está presente, la API devuelve **400** (`WORKSPACE_HEADER_NOT_ALLOWED`).
</Note>

## Ciclo de vida del mensaje

Después del envío, un SMS pasa por estados como `QUEUED` (en cola), `SENT` (en el operador), `DELIVERED` (confirmado por teléfono) o `FAILED` (número no válido, bloqueo, etc.). Los envíos programados comienzan como `SCHEDULED`; las cancelaciones se convierten en `CANCELLED`.

La cancelación de API funciona mientras el estado sea **`QUEUED`** o **`SCHEDULED`**.

## Qué puedes hacer

* **Enviar** de 1 a 100 números internacionales por llamada
* **Horario** con `schedule.sendAt`
* Historial de **consultas** o envío por ID
* **Cancelar** envíos programados o en cola
* **Leer SMS entrantes** (MO) con `sms:read`
* **Idempotencia** con encabezado `Idempotency-Key` para evitar duplicados
* **Seguimiento de clics** en enlaces cortos (`sms.clicked` webhook)

Cada SMS cuesta **30 créditos** (plan) o **R\$ 0,12** (pago por uso). Ver [Facturación](/es/guides/introducao/cobranca-e-pague-pelo-uso).

Detalles de campo y error: **Referencia API** en la pestaña SMS.

## Después de tu primer envío

* **Seguimiento** de entrega y falla a través de [webhooks](/es/sms-api/como-funciona/eventos-do-webhooks) (`sms.sent`, `sms.delivered`, `sms.failed`)
* **Procesar respuestas** con `sms.received` y `sms.replied`, guía: [Mensajes entrantes](/es/guides/webhooks/mensagens-recibidas-e-respostas)
* **Prueba** en [Sandbox](/es/guides/sandbox/index) con `sk_test_...` antes de la producción

## Próximos pasos

* [Inicio rápido](/es/sms-api/como-funciona/quick-start): primer envío vía API
* [Ámbitos de clave API](/es/sms-api/como-funciona/escopos-da-api-key): permisos
* [Eventos de Webhook](/es/sms-api/como-funciona/eventos-do-webhooks): qué llega a tu URL
* [Comienza aquí](/es/guides/introducao/comece-aqui): integración general de la plataforma