Skip to main content
POST
Preview a transmission

Autorizações

Authorization
string
header
obrigatório

Personal access token (izap_pat_…) sent as Authorization: Bearer ; dashboard session JWTs are also accepted.

Cabeçalhos

business-id
string<uuid>
obrigatório

Corpo

application/json

Validate CSV recipients against a template and create a DRAFT transmission.

No messages are sent. recipients are parsed CSV rows (header -> value); each row must contain phone_column and the columns that fill the template's variables. Confirm the returned draft id with confirm_transmission to send.

name
string
obrigatório

Human label for the transmission.

Required string length: 1 - 255
recipients
Recipients · object[]
obrigatório

Parsed CSV rows; each row maps a string column header to its string cell value. Must include the phone column and the columns that supply the template's variables.

Required array length: 1 - 5000 elements
template_name
string
obrigatório

Name of the pre-approved WhatsApp Cloud API template to send.

Required string length: 1 - 512
business_id
string<uuid> | null
max_messages_per_minute
integer
padrão:60

Sending pace cap. Must be between 1 and 200 messages per minute.

Intervalo obrigatório: 1 <= x <= 200
phone_column
string
padrão:phone

Name of the CSV column holding the recipient phone number (E.164 or local).

Required string length: 1 - 255
scheduled_at
string<date-time> | null

When to send. Omit or null to send immediately on confirm. If the value has no timezone offset it is interpreted in 'timezone'.

template_language
string
padrão:pt_BR

Template language/locale code as registered with Meta, e.g. 'pt_BR'.

Required string length: 2 - 15
timezone
string
padrão:America/Sao_Paulo

IANA timezone used to interpret a naive 'scheduled_at'.

transmission_type
string
padrão:whatsapp_template

Only 'whatsapp_template' is supported for now.

Allowed value: "whatsapp_template"
variable_columns
string[] | null

For positional templates ({{1}}, {{2}}, ...): the ordered CSV header names mapping to {{1}}, {{2}}, ... If omitted, the first non-phone columns are used in order. Ignored for templates with named placeholders.

Maximum array length: 50

Resposta

Successful Response

business_id
string<uuid>
obrigatório
column_mapping
Column Mapping · object
obrigatório
duplicate_count
integer
obrigatório
estimated_duration_seconds
integer
obrigatório
invalid_count
integer
obrigatório
name
string
obrigatório
phone_column
string
obrigatório
recipient_count
integer
obrigatório
sample_errors
PreviewRowErrorOut · object[]
obrigatório
scheduled_at
string<date-time> | null
obrigatório
status
string
obrigatório
template_language
string
obrigatório
template_name
string
obrigatório
transmission_id
string<uuid>
obrigatório
transmission_type
string
obrigatório
uses_named_variables
boolean
obrigatório
valid_count
integer
obrigatório
warnings
string[]
obrigatório
not_on_whatsapp_count
integer
padrão:0