Lanzar campaña
POST/broadcasts/:id/launch
Congela el público y pone la campaña a enviar — ahora, o en scheduledAt (hasta un
año adelante). A más de 60 segundos en el futuro, la campaña queda scheduled; si no,
empieza a armar la lista de destinatarios en el momento.
No acepta Idempotency-Key: un segundo lanzamiento responde 409, porque la campaña ya
no es un borrador.
Con una API key restringida a algunos números, el público — guardado o escrito como filtro — queda restringido a los contactos que tienen conversación en esos números, y ese recorte se congela en el lanzamiento junto con el público. Una campaña lanzada por una clave sin restricción va a toda la base.
Request
Responses
- 202
- 401
- 402
- 403
- 404
- 409
- 422
- 429
Campaña lanzada o programada.
Token ausente, mal formado, desconocido o revocado (authentication), o cuenta
suspendida (tenant_inactive).
Sin derecho de uso (payment_required). El cuerpo trae el motivo en reason y la
salida en action: qué hacer (kind) y la página del panel donde se hace (url).
El recurso no pertenece a tu cuenta (forbidden), o la ruta está en la lista de
bloqueo del espejo (forbidden_endpoint), o tu API key está restringida a algunos
números y la operación es de toda la cuenta (forbidden).
El recurso no existe (not_found).
La campaña no está en un estado que permita la acción (broadcast_invalid_state, con status).
La campaña no está lista (los mismos errores de la estimación), o: audience_empty (nadie puede recibirla), broadcast_limit_reached (por encima del techo de destinatarios, con limit), quota_exceeded (el plan no tiene mensajes este mes).
Límite de peticiones superado (rate_limit).
Response Headers
Segundos a esperar antes de reintentar.
Categoría de límite aplicada — send, media o default.
Qué cubo describen las otras cabeceras — key (la API key), session (el panel) o account (el techo de la cuenta).
Techo de peticiones de la categoría en la ventana actual.
Peticiones restantes en la ventana actual.