Baileys Instance icon

Baileys Instance

Use the wa-instance API built on Baileys 7

Batch → Send Media Batch

AI-generated

Summary

Queues a batch of media messages for WhatsApp recipients by sending the configured items to the Baileys Instance API. Optionally checks readiness before sending and uses an idempotency key to help prevent duplicate batch requests.

Inputs

  • Items (required) — Add one or more media entries. Each entry includes To (recipient), Media URL, and optional MIME Type, Caption, File Name, Audio Duration (Ms), and Client Ref. The node maps these to the batch API payload; blank optional values are omitted.
  • Additional Options: Generate Automatically — Defaults to true. Generates an X-Idempotency-Key for the request when no manual key is provided.
  • Additional Options: Idempotency Key — Optional manual idempotency key. When supplied, it takes precedence over automatic generation.
  • Additional Options: Preflight Readiness Check — Defaults to false. When enabled, checks readiness before sending.
  • Additional Options: Readiness Check Mode — Defaults to Dependencies Health, which checks /health/deps. Status checks /status and proceeds if readiness is detected or unknown; it fails if the payload suggests the WhatsApp session is not open.

Output shape

A single item containing the API response for the batch request.

Each incoming n8n item triggers its own batch request; the configured media entries are sent together in that request. Errors fail the node unless Continue On Fail is enabled.

Links

Discussion