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

# Toplu şablon gönder

> Toplu şablon gönder. Bu işlem için parametreleri, örneği ve kullanılabilir yanıtları inceleyin.



## OpenAPI

````yaml tr/api-reference/meta/openapi.json POST /meta/phone-numbers/{phoneNumberId}/messages/template/bulk
openapi: 3.1.0
info:
  title: Eazybe Meta API Katmanı
  version: 1.0.0
  description: >-
    WhatsApp Business Cloud API için kimlik doğrulamalı tek bir Eazybe REST
    yüzeyi.
servers:
  - url: https://cerberus.eazybe.com/staging/api/v2
    description: Bu yer tutucuyu ortamınıza atanmış Eazybe API sunucusuyla değiştirin.
security:
  - bearerAuth: []
tags:
  - name: Telefon numaraları
    description: Bağlı WABA ve telefon numarası kimliklerini bulun.
  - name: Mesajlaşma
    description: WhatsApp mesajları gönderin ve mesaj durumunu güncelleyin.
  - name: Şablonlar
    description: WhatsApp mesaj şablonlarını yönetin.
  - name: Medya
    description: WhatsApp medya dosyalarını yükleyin, görüntüleyin ve silin.
  - name: Webhook'lar
    description: Bir WABA'nın webhook aboneliklerini yönetin.
  - name: Analizler
    description: Mesajlaşma, konuşma, fiyatlandırma ve şablon analizlerini görüntüleyin.
  - name: Profiller ve ayarlar
    description: İşletme profillerini ve telefon numarası ayarlarını yönetin.
  - name: Otomasyon
    description: Karşılama mesajlarını, başlangıç sorularını ve komutları yapılandırın.
  - name: QR kodları
    description: Sohbete yönlendiren QR kodlarını yönetin.
  - name: Flows
    description: WhatsApp Flows yaşam döngüsünü yönetin.
  - name: Numara yönetimi
    description: >-
      Numaraları kaydedin, PIN'leri yönetin ve birlikte kullanım verilerini
      eşitleyin.
  - name: Engellenenler listesi
    description: WhatsApp kullanıcılarını listeleyin, engelleyin ve engellerini kaldırın.
paths:
  /meta/phone-numbers/{phoneNumberId}/messages/template/bulk:
    post:
      tags:
        - Mesajlaşma
      summary: Toplu şablon gönder
      description: >-
        Toplu şablon gönder. Bu işlem için parametreleri, örneği ve
        kullanılabilir yanıtları inceleyin.
      operationId: sendBulkTemplateMessages
      parameters:
        - $ref: '#/components/parameters/PhoneNumberId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - template
                - recipients
                - concurrency
                - marketing
              properties:
                template:
                  type: object
                  required:
                    - name
                    - language
                  properties:
                    name:
                      type: string
                    language:
                      type: object
                      properties:
                        code:
                          type: string
                      required:
                        - code
                recipients:
                  type: array
                  items:
                    type: object
                    required:
                      - to
                      - components
                    properties:
                      to:
                        type: string
                      components:
                        type: array
                        items:
                          type: object
                          required:
                            - type
                            - parameters
                          properties:
                            type:
                              type: string
                            parameters:
                              type: array
                              items:
                                type: object
                                required:
                                  - type
                                  - text
                                properties:
                                  type:
                                    type: string
                                  text:
                                    type: string
                concurrency:
                  type: integer
                marketing:
                  type: boolean
              description: |-
                ```json
                {
                  "template": {
                    "name": "order_update",
                    "language": {
                      "code": "en"
                    }
                  },
                  "recipients": [
                    {
                      "to": "919900000001",
                      "components": [
                        {
                          "type": "body",
                          "parameters": [
                            {
                              "type": "text",
                              "text": "Ravi"
                            }
                          ]
                        }
                      ]
                    },
                    {
                      "to": "919900000002",
                      "components": [
                        {
                          "type": "body",
                          "parameters": [
                            {
                              "type": "text",
                              "text": "Priya"
                            }
                          ]
                        }
                      ]
                    },
                    {
                      "to": "919900000003"
                    }
                  ],
                  "concurrency": 10,
                  "marketing": false
                }
                ```
            example:
              template:
                name: order_update
                language:
                  code: en
              recipients:
                - to: '919900000001'
                  components:
                    - type: body
                      parameters:
                        - type: text
                          text: Ravi
                - to: '919900000002'
                  components:
                    - type: body
                      parameters:
                        - type: text
                          text: Priya
                - to: '919900000003'
              concurrency: 10
              marketing: false
      responses:
        '200':
          description: >-
            Batch processed (check `successful` / `failed`)


            **Failure responses**


            | **Status** | **Meaning** | **Action** |

            | --- | --- | --- |

            | `401` | Missing, invalid, or expired bearer token |
            Re-authenticate |

            | `404` | `phoneNumberId` not linked to your organization | Verify
            the id |

            | `400` | DTO validation failed — empty `recipients`, `concurrency`
            outside 1–50, non-object `template`, or an unknown property | Read
            the `message` array |

            | `500` | The whole batch failed before per-recipient handling |
            Retry the batch |
          content:
            application/json:
              schema:
                type: object
                required:
                  - total
                  - successful
                  - failed
                  - results
                properties:
                  total:
                    type: integer
                  successful:
                    type: integer
                  failed:
                    type: integer
                  results:
                    type: array
                    items:
                      type: object
                      required:
                        - to
                        - status
                        - data
                      properties:
                        to:
                          type: string
                        status:
                          type: boolean
                        data:
                          type: object
                          required:
                            - messaging_product
                            - contacts
                            - messages
                          properties:
                            messaging_product:
                              type: string
                            contacts:
                              type: array
                              items:
                                type: object
                                required:
                                  - input
                                  - wa_id
                                properties:
                                  input:
                                    type: string
                                  wa_id:
                                    type: string
                            messages:
                              type: array
                              items:
                                type: object
                                required:
                                  - id
                                  - message_status
                                properties:
                                  id:
                                    type: string
                                  message_status:
                                    type: string
              example:
                total: 3
                successful: 2
                failed: 1
                results:
                  - to: '919900000001'
                    status: true
                    data:
                      messaging_product: whatsapp
                      contacts:
                        - input: '919900000001'
                          wa_id: '919900000001'
                      messages:
                        - id: wamid.HBgMOTE5OTAwMDAwMDAx...
                          message_status: accepted
                  - to: '919900000002'
                    status: true
                    data:
                      messaging_product: whatsapp
                      contacts:
                        - input: '919900000002'
                          wa_id: '919900000002'
                      messages:
                        - id: wamid.HBgMOTE5OTAwMDAwMDAy...
                          message_status: accepted
                  - to: '919900000003'
                    status: false
                    error: Request failed with status code 400
components:
  parameters:
    PhoneNumberId:
      name: phoneNumberId
      in: path
      required: true
      description: >-
        `GET /meta/phone-numbers` tarafından döndürülen telefon numarası
        kimliği.
      schema:
        type: string
      example: '5647382910'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Eazybe token
      description: >-
        Eazybe bearer tokenı. Token kuruluşu tanımlar ve sunucuda güvenli
        tutulmalıdır.

````