> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waaconnect.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Envoi en masse — Par tag

> Envoie un message (texte ou média) à tous les contacts portant un tag donné

<Info>
  **Groupe vs Tag** — Pour l'envoi par groupe, le `groupId` est dans l'URL
  (`.../bulk/contact-group/:groupId`). Pour l'envoi par tag, le tag est dans
  l'URL (`.../bulk/tag/:tag`). Les deux acceptent les mêmes champs dans le
  corps. Voir les variables `{name}`, `{phone}`, `{clé}` dans [Contacts &
  Groupes](/api-reference/contacts#variables-de-personnalisation).
</Info>


## OpenAPI

````yaml api-reference/openapi.json POST /sessions/{sessionId}/bulk/tag/{tag}
openapi: 3.1.0
info:
  title: WaaConnect API
  description: >-
    API WhatsApp multi-sessions de WaaConnect. Toutes les routes de messagerie
    sont préfixées par /sessions/:sessionId/ et nécessitent le header x-api-key.
  version: 1.0.0
servers:
  - url: https://api.waaconnect.com/v1
security:
  - apiKey: []
paths:
  /sessions/{sessionId}/bulk/tag/{tag}:
    post:
      tags:
        - Campagnes
      summary: Envoi en masse — Par tag
      description: >-
        Envoie un message à tous les contacts portant un tag spécifique
        (sensible à la casse). Supporte {name}, {phone} et toute variable
        contact.
      parameters:
        - name: sessionId
          in: path
          required: true
          schema:
            type: string
        - name: tag
          in: path
          required: true
          schema:
            type: string
          example: vip
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                message:
                  type: string
                type:
                  type: string
                  enum:
                    - text
                    - image
                    - video
                    - audio
                    - document
                url:
                  type: string
                caption:
                  type: string
                fileName:
                  type: string
                mimetype:
                  type: string
                ptt:
                  type: boolean
                delayMs:
                  type: integer
            example:
              message: Bonjour {name}, offre VIP disponible !
              delayMs: 2000
      responses:
        '200':
          description: Résultat de l'envoi en masse
          content:
            application/json:
              example:
                ok: true
                total: 28
                sent: 27
                failed: 1
                errors:
                  - jid: 22996000000@s.whatsapp.net
                    reason: send_failed
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````