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

# Mesaj gönder



## OpenAPI

````yaml /tr/openapi.yml post /send/message
openapi: 3.0.0
info:
  title: WhatsApp Çoklu Cihaz API’si
  version: 9.7.0
  description: >
    Bu API, API üzerinden WhatsApp mesajları göndermek için kullanılır.


    Web panosu ayrı bir projedir (gowa-ui); sunucu bu projenin

    en son sürüm dosyasını indirir ve `/` yolunda sunar (veya

    APP_UI_ENABLED=false olduğunda bir JSON başlığı döndürür).


    Cihaz kapsamı:

    - Cihaz kapsamındaki tüm REST çağrılarında `X-Device-Id` gönderin.

    - WebSocket: `/ws?device_id=<id>` adresine bağlanın.

    - WebSocket kimlik doğrulaması (temel kimlik doğrulaması etkinken):
    tarayıcılar WebSocket bağlantılarında
      Authorization üst bilgisi ayarlayamaz; bu nedenle sorgu dizesinde ayrıca
      `&authorization=<base64(user:pass)>` geçirin. Kimlik bilgisi URL’de göründüğünden
      üretim ortamında TLS kullanın.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: WhatsApp sunucusuna ilk bağlantı
  - name: device
    description: Çoklu cihaz desteği için cihaz yönetimi
  - name: user
    description: Bilgi alma
  - name: send
    description: Mesaj gönderme (Metin/Görsel/Dosya/Video).
  - name: message
    description: Mesaj işlemleri (geri alma/tepki verme/güncelleme).
  - name: call
    description: Arama yönetimi (gelen aramaları reddetme)
  - name: chat
    description: Sohbetler ve mesajlaşma
  - name: group
    description: Grup ayarları
  - name: newsletter
    description: Bülten ayarları
  - name: chatwoot
    description: Müşteri desteği için Chatwoot entegrasyonu
paths:
  /send/message:
    post:
      tags:
        - send
      summary: Mesaj gönder
      operationId: sendMessage
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              allOf:
                - $ref: '#/components/schemas/ScheduleOptions'
              properties:
                phone:
                  type: string
                  example: 6289685028129@s.whatsapp.net
                  description: Ülke koduyla birlikte telefon numarası
                message:
                  type: string
                  example: selamat malam
                  description: Gönderilecek mesaj
                reply_message_id:
                  type: string
                  example: 3EB089B9D6ADD58153C561
                  description: Yanıtlamak istediğiniz mesajın kimliği
                is_forwarded:
                  type: boolean
                  example: false
                  description: Bunun iletilmiş bir mesaj olup olmadığı
                duration:
                  type: integer
                  example: 86400
                  description: >-
                    Saniye cinsinden kaybolan mesaj süresi. İzin verilen
                    değerler: 0 (süre sonu yok), 86400 (24h), 604800 (7d),
                    7776000 (90d).
                mentions:
                  type: array
                  items:
                    type: string
                  example:
                    - '628123456789'
                    - '@everyone'
                  description: >
                    Bahsedilecek telefon numaralarının listesi (görünmez
                    bahsetmeler - mesaj metninde @ gerekli değildir).

                    Tüm grup katılımcılarından bahsetmek için özel "@everyone"
                    anahtar sözcüğünü kullanın.
                allow_reshare:
                  type: boolean
                  example: false
                  description: >-
                    Durumu görüntüleyenlere yeniden paylaşma düğmesini göster.
                    `phone` değerinin `status@broadcast` olmasını gerektirir;
                    GOWA diğer tüm alıcılar için bu alanı reddeder.
      responses:
        '200':
          description: Tamam
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SendResponse'
        '400':
          description: Geçersiz İstek
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '500':
          description: Dahili Sunucu Hatası
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
components:
  parameters:
    DeviceIdHeader:
      name: X-Device-Id
      in: header
      required: false
      description: >
        Çoklu cihaz desteği için cihaz tanımlayıcısı. Birden fazla cihaz
        kayıtlıysa zorunludur.

        Yalnızca bir cihaz kayıtlıysa varsayılan olarak kullanılır.

        `device_id` sorgu parametresi olarak da belirtilebilir.
      schema:
        type: string
        example: my-device-id
  schemas:
    ScheduleOptions:
      type: object
      description: >
        Mesajı şimdi göndermek yerine zamanlayan isteğe bağlı alanlar.
        Zamanlamak için

        `scheduled_at` değerini ayarlayın; bu değer yoksa mesaj hemen
        gönderilir.

        Arka plan çalışanı mesajı zamanlanan saatte gönderir, cihaz

        çevrimdışıysa veya oturum açmamışsa yeniden dener. Yüklenen medya,

        zamanlama tamamlanana kadar sunucuda saklanır.

        multipart/form-data gövdelerinde `weekdays` değerini tekrarlanan alan
        olarak

        gönderin (`weekdays=1`, `weekdays=3`).
      properties:
        scheduled_at:
          type: string
          format: date-time
          example: '2026-10-01T09:00:00+07:00'
          description: >-
            İlk gönderimin RFC3339 zamanı. Gelecekte olmalıdır. İlk gönderim,
            `weekdays` veya `day_of_month` dışında kalsa bile her zaman bu
            saatte gerçekleşir; bunlar sonraki tekrarları belirler.
        timezone:
          type: string
          example: Asia/Jakarta
          description: >-
            Tekrarlanan çalıştırmaları hesaplamak için kullanılan IANA saat
            dilimi. scheduled_at ayarlandığında zorunludur.
        recurrence:
          type: string
          enum:
            - once
            - daily
            - weekly
            - monthly
          default: once
          description: Gönderimin ne sıklıkla tekrarlanacağı
        weekdays:
          type: array
          items:
            type: integer
            minimum: 0
            maximum: 6
          uniqueItems: true
          example:
            - 1
            - 3
            - 5
          description: >-
            Gönderim yapılacak günler, 0=Pazar ile 6=Cumartesi arası. recurrence
            weekly olduğunda zorunludur.
        day_of_month:
          type: integer
          minimum: 1
          maximum: 31
          example: 15
          description: >-
            Gönderim yapılacak ayın günü; ayın son gününü aşarsa son gün
            kullanılır. recurrence monthly olduğunda zorunludur.
        end_at:
          type: string
          format: date-time
          example: '2026-12-31T23:59:59+07:00'
          description: >-
            Yalnızca tekrarlanan gönderimler. Bu saatten sonra gönderim
            yapılmaz; scheduled_at sonrasında olmalıdır.
        occurrence_limit:
          type: integer
          minimum: 1
          example: 10
          description: Yalnızca tekrarlanan gönderimler. Bu kadar gönderimden sonra durdur.
    SendResponse:
      type: object
      properties:
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Success
        results:
          type: object
          properties:
            message_id:
              type: string
              example: 3EB0B430B6F8F1D0E053AC120E0A9E5C
              description: Zamanlanmış gönderimlerde dahil edilmez
            status:
              type: string
              example: <feature> success ....
            schedule_id:
              type: string
              example: 0b5c3a8e-7f5d-4d6f-9d1e-2f8c1a7b9e10
              description: >-
                Yalnızca zamanlanmış gönderimler. /send/schedules yollarıyla
                kullanın.
            scheduled_at:
              type: string
              format: date-time
              example: '2026-10-01T02:00:00Z'
              description: Yalnızca zamanlanmış gönderimler. İlk gönderim zamanı.
            next_run_at:
              type: string
              format: date-time
              example: '2026-10-01T02:00:00Z'
              description: >-
                Yalnızca zamanlanmış gönderimler. Çalışanın bir sonraki gönderim
                zamanı.
    ErrorBadRequest:
      type: object
      properties:
        code:
          type: string
          example: 400
          description: HTTP Durum Kodu
        message:
          type: string
          example: field cannot be blank
          description: Ayrıntılı hata mesajı
        results:
          type: object
          example: null
          description: ek veriler
    ErrorInternalServer:
      type: object
      properties:
        code:
          type: string
          example: INTERNAL_SERVER_ERROR
          description: SYSTEM_CODE_ERROR
        message:
          type: string
          example: you are not loggin
          description: Ayrıntılı hata mesajı
        results:
          type: object
          example: null
          description: ek veriler
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Deneysel bir etkileşimli mesaj gönder](https://gowa-docs.mintlify.site/tr/api-reference/send/deneysel-bir-etkileşimli-mesaj-gönder.md)
- [Mesaj Gönderme](https://gowa-docs.mintlify.site/tr/examples/sending-messages.md)
- [Hızlı başlangıç](https://gowa-docs.mintlify.site/tr/quickstart.md)
- [Grup Yönetimi](https://gowa-docs.mintlify.site/tr/examples/group-management.md)
- [Mesaja tepki gönder](https://gowa-docs.mintlify.site/tr/api-reference/message/mesaja-tepki-gönder.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.