Skip to main content
POST
Preview a transmission

Autorizaciones

Authorization
string
header
requerido

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

Encabezados

business-id
string<uuid>
requerido

Cuerpo

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
requerido

Human label for the transmission.

Required string length: 1 - 255
recipients
Recipients · object[]
requerido

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
requerido

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
predeterminado:60

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

Rango requerido: 1 <= x <= 200
phone_column
string
predeterminado: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
predeterminado:pt_BR

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

Required string length: 2 - 15
timezone
string
predeterminado:America/Sao_Paulo

IANA timezone used to interpret a naive 'scheduled_at'.

transmission_type
string
predeterminado: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

Respuesta

Successful Response

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