RCS - Rich Communication Services

RCS é a evolução do SMS, oferecendo mensagens ricas com imagens, vídeos, botões interativos e confirmação de leitura.

Vantagens RCS: Imagens e vídeos • Botões acionáveis • Confirmação de leitura • Carrosséis • Branding corporativo

Diferenças entre SMS e RCS

Recurso	SMS	RCS
Texto	160 caracteres	Até 3000 caracteres
Imagens/Vídeos	Não	Sim
Botões	Não	Sim
Confirmação de Leitura	Não	Sim
Carrossel	Não	Sim

Enviar Mensagem RCS

O envio de RCS segue a mesma estrutura do SMS, alterando apenas o tipo:

POST /api/v1/integration/send

Parâmetros

Campo	Tipo	Obrigatório	Descrição
`to`	String	Sim	Número de telefone com código do país
`message`	String	Sim	Conteúdo da mensagem (máx. 3000 caracteres)
`type`	String	Sim	Deve ser "RCS"
`media`	Object	Não	Objeto com mídia (imagem, vídeo)
`buttons`	Array	Não	Lista de botões interativos (máx. 4)

Exemplo Básico

{
  "to": "5511999999999",
  "message": "Bem-vindo ao RCS! Mensagens mais ricas e interativas.",
  "type": "RCS"
}

Resposta (200 OK)

{
  "message": "Requisição recebida com sucesso. A campanha foi enviada para análise e processamento.",
  "details": {
    "campaignId": "6584b123c2d3e4f5a6b7c999",
    "status": "UNDER_APPROVAL",
    "type": "RCS",
    "routeName": "Rota RCS Marketing",
    "content": "Bem-vindo ao RCS! Mensagens mais ricas e interativas.",
    "recipients": 1,
    "cost": {
      "perUnit": 0.35,
      "total": 0.35,
      "currency": "BRL"
    }
  }
}

Nota sobre custos: Os valores apresentados nos exemplos são meramente ilustrativos. Os custos reais variam por rota e são definidos individualmente. Consulte seu gerente de conta para informações específicas sobre precificação.

Mensagens com Rich Media

Envie imagens, vídeos e áudios junto com suas mensagens:

Com Imagem

{
  "to": "5511999999999",
  "message": "Confira nossa nova coleção!",
  "type": "RCS",
  "media": {
    "type": "image",
    "url": "https://sua-cdn.com/imagem.jpg",
    "alt": "Nova Coleção Verão 2026"
  }
}

Com Vídeo

{
  "to": "5511999999999",
  "message": "Veja o tutorial completo",
  "type": "RCS",
  "media": {
    "type": "video",
    "url": "https://sua-cdn.com/video.mp4",
    "thumbnail": "https://sua-cdn.com/thumb.jpg"
  }
}

Formatos Suportados

Imagens: JPG, PNG (máx. 5 MB)
Vídeos: MP4, 3GP (máx. 10 MB)
Áudios: MP3, AAC (máx. 5 MB)
Arquivos: PDF (máx. 2 MB)

Botões Interativos

Adicione até 4 botões de ação em suas mensagens:

{
  "to": "5511999999999",
  "message": "Como podemos ajudar você hoje?",
  "type": "RCS",
  "buttons": [
    {
      "type": "url",
      "text": "Visitar Site",
      "url": "https://www.exemplo.com"
    },
    {
      "type": "phone",
      "text": "Ligar Agora",
      "phoneNumber": "+5511999999999"
    },
    {
      "type": "reply",
      "text": "Falar com Atendente",
      "postback": "ATENDIMENTO"
    }
  ]
}

Tipos de Botões

Tipo	Descrição	Campos
`url`	Abre uma URL no navegador	text, url
`phone`	Inicia uma chamada telefônica	text, phoneNumber
`reply`	Envia resposta automática	text, postback
`calendar`	Adiciona evento ao calendário	text, eventData
`location`	Abre localização no mapa	text, latitude, longitude

Carrossel de Cards

Envie múltiplos cards deslizáveis com imagens e botões:

{
  "to": "5511999999999",
  "type": "RCS",
  "carousel": {
    "cards": [
      {
        "title": "Produto A",
        "description": "Descrição do produto A com todos os detalhes",
        "image": "https://cdn.com/produto-a.jpg",
        "buttons": [
          {
            "type": "url",
            "text": "Ver Mais",
            "url": "https://loja.com/produto-a"
          },
          {
            "type": "reply",
            "text": "Adicionar ao Carrinho",
            "postback": "ADD_CART_A"
          }
        ]
      },
      {
        "title": "Produto B",
        "description": "Descrição do produto B com todos os detalhes",
        "image": "https://cdn.com/produto-b.jpg",
        "buttons": [
          {
            "type": "url",
            "text": "Ver Mais",
            "url": "https://loja.com/produto-b"
          },
          {
            "type": "reply",
            "text": "Adicionar ao Carrinho",
            "postback": "ADD_CART_B"
          }
        ]
      },
      {
        "title": "Produto C",
        "description": "Descrição do produto C com todos os detalhes",
        "image": "https://cdn.com/produto-c.jpg",
        "buttons": [
          {
            "type": "url",
            "text": "Ver Mais",
            "url": "https://loja.com/produto-c"
          }
        ]
      }
    ]
  }
}

Playground - Teste RCS

Experimente enviar RCS diretamente pela documentação (simulação):

Modo Simulação: Este playground apenas simula as respostas da API. Nenhuma mensagem real é enviada e nenhuma requisição é feita ao backend.

Testar Envio de RCS

Configuração

API Key

Endpoint

Método

Body (JSON)

Resposta

Preencha os campos e clique em "Enviar Requisição" para ver a resposta simulada.

Limites e Especificações

Limite	Valor	Descrição
Tamanho do Texto	3000 caracteres	Muito maior que SMS
Tamanho da Imagem	5 MB	JPG, PNG
Tamanho do Vídeo	10 MB	MP4, 3GP
Botões por Mensagem	4 botões	Máximo permitido
Cards em Carrossel	10 cards	Recomendado: 3-5 cards
Destinatários por Lote	1000	Máximo por requisição

Compatibilidade e Fallback

Importante: RCS requer que o destinatário tenha um dispositivo e operadora compatíveis. Configure fallback automático para SMS em caso de incompatibilidade.

Configurar Fallback

{
  "to": "5511999999999",
  "message": "Sua mensagem aqui",
  "type": "RCS",
  "fallback": {
    "enabled": true,
    "type": "SMS",
    "message": "Versão simplificada da mensagem para SMS"
  }
}

Verificar Compatibilidade

Antes de enviar, você pode verificar se um número suporta RCS:

GET /api/v1/integration/check-rcs/:phone

Casos de Uso

E-commerce: Catálogo de produtos com carrossel e botões de compra
Bancos: Extratos com imagens e botões de ação
Eventos: Convites ricos com localização e adicionar ao calendário
Suporte: Menu de opções com botões de resposta rápida
Marketing: Campanhas visuais com CTAs diretos
Notificações: Atualizações com confirmação de leitura