> ## 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 groupe de contacts

> Envoie un message (texte ou média) à tous les contacts d'un groupe

Voir [Contacts & Groupes](/api-reference/contacts) pour créer des groupes de contacts et y ajouter des membres.


## OpenAPI

````yaml api-reference/openapi.json POST /sessions/{sessionId}/bulk/contact-group/{groupId}
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/contact-group/{groupId}:
    post:
      tags:
        - Campagnes
      summary: Envoi en masse — Groupe de contacts
      description: >-
        Envoie un message à tous les contacts d'un groupe de contacts. Supporte
        {name}, {phone} et toute variable contact.
      parameters:
        - name: sessionId
          in: path
          required: true
          schema:
            type: string
        - name: groupId
          in: path
          required: true
          schema:
            type: string
          description: ID du groupe de contacts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                message:
                  type: string
                  description: Requis si type=text (défaut)
                type:
                  type: string
                  enum:
                    - text
                    - image
                    - video
                    - audio
                    - document
                url:
                  type: string
                  description: Requis si type != text
                caption:
                  type: string
                fileName:
                  type: string
                mimetype:
                  type: string
                ptt:
                  type: boolean
                delayMs:
                  type: integer
                  description: 'Recommandé: 2000-3000'
            examples:
              Texte:
                value:
                  message: Bonjour {name}, offre spéciale !
                  delayMs: 2000
              Média:
                value:
                  type: image
                  url: https://example.com/promo.jpg
                  caption: Bonjour {name}, votre commande {commande} est prête !
                  delayMs: 2000
      responses:
        '200':
          description: Résultat de l'envoi en masse
          content:
            application/json:
              example:
                ok: true
                total: 5
                sent: 4
                failed: 1
                errors:
                  - jid: 22997000000@s.whatsapp.net
                    reason: contact_not_on_whatsapp
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````