Skip to main content
POST
Criar campanha

Autorizações

Authorization
string
header
obrigatório

Authorization: Bearer sk_live_xxxxx

Corpo

application/json

templateId obrigatório. channels ⊆ enabledChannels do template (whatsapp, sms, email, telegram). Com scheduledFor (≥ ~2 min), status inicial SCHEDULED. Sending Pool WhatsApp: configure no painel (a API v1 de create ainda não envia sendingPoolId).

name
string
obrigatório
Maximum string length: 128
templateId
string
obrigatório

Template cujo conjunto de canais habilitados restringe channels.

Minimum string length: 1
channels
enum<string>[]
obrigatório
Minimum array length: 1

Canal na campanha (create/update): whatsapp, sms, email, telegram. Deve ser subconjunto dos canais habilitados no template. Templates podem habilitar RCS/Push/voz; a campanha via API/painel usa estes quatro.

Opções disponíveis:
whatsapp,
sms,
email,
telegram
segmentId
string
audienceContactIds
string[]
scheduledFor
string<date-time>

ISO-8601. Mínimo ~2 minutos no futuro → status SCHEDULED.

instanceId
string | null

Instância WhatsApp (obrigatória na prática se incluir whatsapp e não houver padrão no workspace).

telegramInstanceId
string | null

Instância Telegram (obrigatória na prática se incluir telegram e não houver padrão no workspace).

fromEmail
string | null
variables
object

Mesclado por cima das propriedades do contato no render do template.

Resposta

Criada.

success
boolean
data
object

Campanha multicanal. channels ⊆ canais habilitados do template (whatsapp|sms|email|telegram). Status: DRAFT, SCHEDULED, RUNNING, COMPLETED, FAILED, CANCELLED.