TOPSEND API

RCS Carousel

Cria uma nova campanha de RCS Carousel para o usuário

POST

/campaign/rcs/carousel

Cria uma nova campanha de RCS carousel. Regra: 1 card vira rich card; 2 ou mais cards viram carousel. Requer autenticação Bearer (JWT); o user_id é extraído do token. Pré-requisito: o usuário precisa ter SupplierType HUNI e credencial RCS configurada, caso contrário retorna erro de validação.

Autorizações:

Bearer Token

Credenciais

Token

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NzYzNzQxNjUsInN1YiI6IjEifQ...

Obs: para pegar o seu token acesse a plataforma da TopSend e gere o token nas configurações de usuário.

Endpoint

/campaign/rcs/carousel

Corpo da Requisição

Dados necessários para criar uma nova campanha de RCS Carousel

{
  "title": "Catálogo",
  "start_date": "2026-06-20T14:30:00",
  "contacts": [
    { "contact": "5511987654321" }
  ],
  "cards": [
    {
      "title": "Produto A",
      "message": "Descrição do produto A",
      "image_url": "https://cdn.topsend.io/a.jpg",
      "buttons": [
        { "name": "Comprar", "text": "Comprar", "type": "URL", "url": "https://loja/a" }
      ]
    }
  ],
  "callback_url": "https://meu-sistema.com/webhook"
}

Resposta

201Retorna os dados da campanha RCS criada. O campo message volta vazio e type é RCS_CAROUSEL

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "Catálogo",
  "message": "",
  "status": "PENDING",
  "type": "RCS_CAROUSEL",
  "quantity": 1,
  "start_date": "2026-06-20T14:30:00Z",
  "created_at": "2026-06-19T10:00:00Z"
}

Possíveis Erros

400 Bad Request

{
  "error": null,
  "message": "string",
  "message_translate": "string",
  "meta": {},
  "type": "NOT_FOUND"
}

422 Unprocessable Entity

{
  "error": null,
  "message": "string",
  "message_translate": "string",
  "meta": {},
  "type": "NOT_FOUND"
}