> ## 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 mensagens ricas no celular por RCS pelo painel ou API, com imagem, botões e rastreamento de entrega.

<Tip>
  RCS é o **SMS turbinado**: quando o aparelho e a operadora suportam, você manda **imagem, botões e carrossel**, ainda assim para um **número de telefone**.
</Tip>

## O que é RCS na Notifique?

É o canal para **mensagens ricas no celular** (Rich Communication Services). O destino continua sendo um **número internacional** (E.164, sem `+`), como no SMS, mas o conteúdo pode ir além do texto puro.

Você pode:

* **Enviar** texto (**BASIC**), card com imagem e botões (**CARD**), carrossel (**CAROUSEL**) ou arquivo por URL (**FILE**)
* **Disparar** para 1 a 100 números por chamada (uma mensagem por número)
* **Agendar** envio para data e hora futuras
* **Consultar** status de cada envio pelo id
* **Cancelar** enquanto estiver na fila ou agendado
* **Rastrear** cliques em link curto ou botão via webhook

Pense num panfleto digital no bolso: mais visual que SMS, mas só chega onde a rede RCS está disponível.

<Note>
  Diferente do WhatsApp, RCS **não usa instância** de canal. Basta API Key com os escopos certos e números em formato internacional (ex.: `5511999999999`).
</Note>

## Quando usar?

Funciona muito bem para **campanha com imagem e botões**, **aviso promocional** e **mais conversão** que SMS puro, para quem recebe RCS. Para **OTP** que precisa chegar em **qualquer** celular, prefira [SMS](/sms-api/como-funciona/introducao). Nem todo aparelho entrega RCS; tenha plano B (SMS, WhatsApp ou e-mail) quando a entrega precisar ser garantida.

## Tipos de mensagem

* **BASIC**, só texto
* **CARD**, imagem, título, descrição e botões
* **CAROUSEL**, vários cards na mesma mensagem
* **FILE**, arquivo por URL pública + nome

Detalhe de campos por tipo: **referência da API** na aba RCS.

## Como funciona na prática

1. **Crie** uma API Key com `rcs:send` (e `rcs:read` / `rcs:cancel` se for consultar ou cancelar)
2. **Envie** com `POST /v1/rcs/messages`, `to` em array, `type` e `payload` conforme o formato
3. A plataforma **enfileira, envia e atualiza o status**; seu backend recebe avisos se configurou [webhooks](/rcs-api/como-funciona/eventos-do-webhooks)

<Info>
  Cada **API Key** pertence a **um** workspace. Na v1 **não envie** `x-workspace-id`.
</Info>

## Ciclo da mensagem

Depois do envio, o RCS passa por status como `QUEUED`, `SCHEDULED`, `PROCESSING`, `SENT`, `DELIVERED`, `CLICKED`, `FAILED` ou `CANCELLED`. Cancelamento pela API funciona enquanto o status for **`QUEUED`** ou **`SCHEDULED`**.

Com **links curtos** ativos, o primeiro clique em um link **clicar.co** do envio pode marcar **`CLICKED`**, webhook **`rcs.clicked`**.

## O que dá para fazer

* **Enviar** para 1 a 100 números por chamada (**60 créditos** por mensagem)
* **Agendar** com `schedule.sendAt`
* **Consultar** um envio pelo id retornado
* **Cancelar** na fila ou agendado
* **Idempotência** com header `Idempotency-Key`
* **Webhook por envio** em `options.webhook` (só aquele lote)

Veja [Cobrança](/guides/introducao/cobranca-e-pague-pelo-uso). Detalhe de erros: **referência da API** na aba RCS.

## Depois do primeiro envio

* **Acompanhe** entrega, clique e falha por [webhooks](/rcs-api/como-funciona/eventos-do-webhooks) (`rcs.sent`, `rcs.delivered`, `rcs.clicked`, `rcs.failed`)
* **Trate `FAILED`** com fallback para SMS ou outro canal quando a rede não entregar RCS
* **Teste** no [Sandbox](/guides/sandbox/index) com `sk_test_...` antes de produção

## Próximos passos

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