TOPSEND API

RCS Text

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

POST

/campaign/rcs/text

Cria uma nova campanha de RCS de texto. 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/text

Corpo da Requisição

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

{
  "title": "Promoção Junho",
  "start_date": "2026-06-20T14:30:00",
  "message": "Olá! Confira nossa oferta.",
  "contacts": [
    { "contact": "5511987654321", "message": "msg opcional por contato" }
  ],
  "buttons": [
    { "name": "Acessar", "text": "Ver site", "type": "URL",  "url": "https://topsend.io" },
    { "name": "Ligar",   "text": "Falar conosco", "type": "CALL", "number": "551130000000" },
    { "name": "Sim",     "text": "Quero!", "type": "QUICK_RESPONSE" }
  ],
  "callback_url": "https://meu-sistema.com/webhook"
}

Resposta

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

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "Promoção Junho",
  "message": "",
  "status": "PENDING",
  "type": "RCS_TEXT",
  "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"
}