> ## 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 mensajes móviles enriquecidos a través de RCS desde el panel o API, con imágenes, botones y seguimiento de entrega.

<Tip>
  RCS es **SMS con superpoderes**: cuando el dispositivo y el operador lo admiten, envías **imágenes, botones y carruseles**, siempre a un **número de teléfono**.
</Tip>

## ¿Qué es RCS en Notifique?

Es el canal para **mensajes móviles enriquecidos** (Servicios de comunicación enriquecidos). El destino sigue siendo un **número de teléfono internacional** (E.164, sin `+`), como los SMS, pero el contenido puede ir más allá del texto sin formato.

Puede:

* **Enviar** texto (**BASIC**), tarjetas de imágenes con botones (**CARD**), carruseles (**CAROUSEL**) o archivos a través de URL (**FILE**)
* **Envío** de 1 a 100 números por llamada (un mensaje por número)
* **Programar** envíos para una fecha y hora futuras
* **Consulta** estado de cada envío por id.
* **Cancelar** mientras esté en cola o programado
* **Seguimiento** de clics en enlaces cortos o botones mediante webhook

Piense en un folleto digital en el bolsillo: más visual que un SMS, pero solo llega a los dispositivos en redes compatibles con RCS.

<Note>
  A diferencia de WhatsApp, RCS **no utiliza una instancia de canal**. Solo necesita una clave API con los alcances y números correctos en formato internacional (por ejemplo, `5511999999999`).
</Note>

## ¿Cuándo usarlo?

Funciona muy bien para **campañas con imágenes y botones**, **alertas promocionales** y **mejor conversión** que los SMS simples, para destinatarios compatibles con RCS. Para **OTP** que debe llegar a **cualquier** teléfono, prefiera [SMS](/es/sms-api/como-funciona/introducao). No todos los dispositivos ofrecen RCS; tener un plan B (SMS, WhatsApp o correo electrónico) cuando se debe garantizar la entrega.

## Tipos de mensajes

* **BÁSICO**, solo texto
* **TARJETA**, imagen, título, descripción y botones
* **CARRUSEL**, varias tarjetas en un mensaje
* **ARCHIVO**, archivo a través de URL pública + nombre de archivo

Detalles de campo por tipo: **Referencia API** en la pestaña RCS.

## Cómo funciona en la práctica

1. **Crea** una clave API con `rcs:send` (y `rcs:read` / `rcs:cancel` para consultar o cancelar)
2. **Enviar** con `POST /v1/rcs/messages`, `to` como matriz, `type` y `payload` por formato
3. La plataforma **pone en cola, envía y actualiza el estado**; tu backend recibe alertas si configuraste [webhooks](/es/rcs-api/como-funciona/eventos-do-webhooks)

<Info>
  Each **API Key** belongs to **one** workspace. On v1 **do not send** `x-workspace-id`.
</Info>

## Ciclo de vida del mensaje

Después del envío, RCS pasa por estados como `QUEUED`, `SCHEDULED`, `PROCESSING`, `SENT`, `DELIVERED`, `CLICKED`, `FAILED` o `CANCELLED`. La cancelación de API funciona mientras el estado sea **`QUEUED`** o **`SCHEDULED`**.

Con los **enlaces cortos** habilitados, el primer clic en un enlace **clicar.co** del envío puede marcar **`CLICKED`**, webhook **`rcs.clicked`**.

## Qué puedes hacer

* **Enviar** de 1 a 100 números por llamada (**60 créditos** por mensaje)
* **Horario** con `schedule.sendAt`
* **Consulta** un envío por ID devuelto
* **Cancelar** mientras esté en cola o programado
* **Idempotencia** con encabezado `Idempotency-Key`
* **Webhook por envío** en `options.webhook` (solo ese lote)

Ver [Facturación](/es/guides/introducao/cobranca-e-pague-pelo-uso). Detalles del error: **Referencia de API** en la pestaña RCS.

## Después de tu primer envío

* **Seguimiento** de entregas, clics y fallas a través de [webhooks](/es/rcs-api/como-funciona/eventos-do-webhooks) (`rcs.sent`, `rcs.delivered`, `rcs.clicked`, `rcs.failed`)
* **Manejar `FAILED`** con SMS u otro canal cuando la red no entrega RCS
* **Prueba** en [Sandbox](/es/guides/sandbox/index) con `sk_test_...` antes de la producción

## Próximos pasos

* [Quick Start](/es/rcs-api/como-funciona/quick-start): primer envío BÁSICO
* [Ámbitos de clave API](/es/rcs-api/como-funciona/escopos-da-api-key): permisos
* [Eventos de webhook](/es/rcs-api/como-funciona/eventos-do-webhooks): qué llega a tu URL
* [Comenzar](/es/guides/introducao/comece-aqui): integración general de la plataforma