Skip to main content
POST
/
v1
/
rcs
/
messages
Enviar RCS
curl --request POST \
  --url https://api.notifique.dev/v1/rcs/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "to": [
    "5511999999999",
    "5521988887777"
  ],
  "messageType": "BASIC",
  "payload": {
    "message": "Olá! RCS de teste."
  },
  "schedule": {
    "sendAt": "2025-12-31T14:00:00.000Z"
  }
}
'
{
  "success": true,
  "data": {
    "status": "QUEUED",
    "count": 123,
    "rcsIds": [
      "<string>"
    ],
    "scheduledAt": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

API Key no header Authorization. Exemplo: Authorization: Bearer sk_live_xxxxx

Headers

​
Idempotency-Key
string

Chave única para evitar envio duplicado.

​
x-idempotency-key
string

Chave de idempotência (alternativa).

Body

application/json
​
to
string[]
required

Lista de números no formato E.164 (ex.: 5511999999999). Uma mensagem RCS por número; cada uma consome 60 créditos.

Required array length: 1 - 100 elements
​
messageType
enum<string>
required

Tipo da mensagem: BASIC (texto), CARD (card com imagem/título/botões), CAROUSEL (múltiplos cards), FILE (arquivo por URL).

Available options:
BASIC,
CARD,
CAROUSEL,
FILE
​
payload
object
required

Conteúdo conforme messageType. BASIC: { message }. CARD: { message, cardImage, cardTitle, cardMessage, buttons? }. CAROUSEL: { message, cards } (cada card: cardImage, cardTitle, cardMessage, buttons?). FILE: { message, file, fileName } (file = URL pública).

​
schedule
object
​
refer
string

Referência opcional para correlação (ex.: ID do pedido).

Response

RCS aceito(s). Enfileirado(s) para envio imediato ou agendado.

​
success
boolean
required
Example:

true

​
data
object
required