Broadcasts

Crea una difusión (queda programada / "ahora")

Crea la difusión, ya sea programada o para salir de inmediato. Recuerda que fuera de la ventana de 24 horas WhatsApp solo entrega plantillas aprobadas, así que una difusión a base fría necesita plantilla.

Ojo con el piloto automático: si al momento del envío un contacto tiene el piloto en pausa (alguien del equipo le escribió hace poco), apagado o el chat en «Hablar con humano», su flujo corre igual pero los pasos que le envían mensajes se omiten en silencio —el paso queda con { sent: false, silenced: true, reason }, sin error— y no le llega nada. No hay forma de saltarse esa pausa desde la difusión. POST /broadcasts/preview-count te dice en silenced_count cuántos están así ahora mismo.

post/workspaces/{workspaceId}/broadcasts

Request

  • Base URL: https://api.met.meteor.com.co/api/v1
  • URL: https://api.met.meteor.com.co/api/v1/workspaces/{workspaceId}/broadcasts
  • Auth: one of:
    • bearer (a scheme the document does not define)
    • HTTP bearer

Path parameters

workspaceIdnumber required

ID numérico del workspace. Debe ser el mismo workspace de tu API key: pedir otro devuelve 401.

Request body

flow_idstring required

UUID del flujo publicado a ejecutar por cada contacto.

namestring required
recurrence'none' | 'daily' | 'weekly' | 'monthly'
recurrence_domnumber

Día del mes 1..31 (se clampa a meses cortos). Solo monthly.

recurrence_downumber

Día de la semana 0..6 (dom..sáb). Solo weekly.

recurrence_timestring

Hora local del disparo, formato 'HH:MM' (24h).

scheduled_atstring nullable

ISO 8601. Solo aplica a send_mode='scheduled'.

send_mode'now' | 'scheduled' | 'manual' | 'recurring'

Cuándo/cómo se envía: now — la toma el próximo tick (default). scheduled — espera scheduled_at. manual — plantilla disparable desde un nodo broadcast.run (nace en draft). recurring — plantilla que se dispara sola cada día/semana/mes a una hora.

throttle_per_minutenumber
timezonestring

Zona horaria del negocio (IANA). Default lógico: America/Bogota.

Response

successtrue required

Siempre true en una respuesta 2xx.

Example response

{
  "data": {
    "created_at": "2026-07-28T16:04:11.220Z",
    "created_by": 42,
    "failed_count": 3,
    "flow_id": "9c0d5f2a-11b8-4f3e-8f22-6d3a7c4e1b90",
    "id": "3f2b1c9e-7a41-4d0c-9c11-8a2f0e5d6b77",
    "name": "Recordatorio de renovación · julio",
    "next_run_at": "2026-07-31T13:00:00.000Z",
    "recurrence": "none",
    "recurrence_time": "08:00",
    "scheduled_at": "2026-08-01T14:00:00.000Z",
    "send_mode": "now",
    "sent_count": 640,
    "status": "scheduled",
    "throttle_per_minute": 60,
    "timezone": "America/Bogota",
    "total_recipients": 812,
    "updated_at": "2026-07-28T16:04:11.220Z",
    "workspace_id": 134
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.