ReferenceCampanhas
Criar campanha de carrossel
Cria uma campanha de carrossel com 1 a 4 cartões, cada um com imagem, texto e até 2 botões.
x-api-key<token>
Chave de API no formato sk_live_..., no header x-api-key.
In: header
Header Parameters
Idempotency-Key?string
Chave de idempotência (opcional). Reenviar o MESMO POST com a mesma chave devolve a resposta original em vez de re-executar — evita disparo duplicado de campanha quando o cliente re-tenta um POST que deu timeout.
Length
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/external/create-campaign/carousel" \ -H "Content-Type: application/json" \ -d '{ "name": "Catálogo", "id_segment": "segment_xxx", "carousel_data": { "message": "Confira nossos lançamentos", "cards": [ { "image_url": "https://exemplo.com/p1.jpg", "text": "Produto 1", "buttons": [ { "label": "Comprar", "type": "URL", "url": "https://loja.com/p1" } ] } ] } }'{ "success": true, "id_campaign": "string", "name": "string", "status": "pending", "message_type": "carousel", "cards_count": 0, "scheduled_at": "2019-08-24T14:15:22Z", "timestamp": "2019-08-24T14:15:22Z"}{ "success": false, "error": "Bad Request", "message": "O campo \"name\" é obrigatório no body da requisição."}{ "success": false, "error": "Unauthorized", "message": "Chave de API inválida ou ausente."}{ "success": false, "error": "Forbidden", "message": "Limite de canais atingido.", "current": 5, "max": 5}{ "success": false, "error": "Not Found", "message": "Segmento não encontrado."}{ "success": false, "error": "Too Many Requests", "code": "rate_limited", "message": "Muitas requisições. Tente novamente em instantes."}{ "success": false, "error": "Internal Server Error", "message": "Erro interno ao processar a requisição."}