> ## 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ı ilet

> Yerel sohbet deposunda bulunan bir mesajı, mesaj kimliğiyle başka bir sohbete iletir.
Metin ve standart medya türleri (görsel, video, video notu, ses, belge, çıkartma) desteklenir.
Mümkün olduğunda medya referansları yeniden kullanılır; eski referanslar otomatik yeniden yüklemeyi tetikler.
Kaynak medyanın WhatsApp sunucularındaki süresi dolmuşsa, yeniden yükleme için önce dosya telefondan istenir;
bu işlem için telefonun çevrimiçi olması gerekir ve işlem 30 saniyeye kadar sürebilir.




## OpenAPI

````yaml /tr/openapi.yml post /message/{message_id}/forward
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:
  /message/{message_id}/forward:
    post:
      tags:
        - message
      summary: Mesajı ilet
      description: >
        Yerel sohbet deposunda bulunan bir mesajı, mesaj kimliğiyle başka bir
        sohbete iletir.

        Metin ve standart medya türleri (görsel, video, video notu, ses, belge,
        çıkartma) desteklenir.

        Mümkün olduğunda medya referansları yeniden kullanılır; eski referanslar
        otomatik yeniden yüklemeyi tetikler.

        Kaynak medyanın WhatsApp sunucularındaki süresi dolmuşsa, yeniden
        yükleme için önce dosya telefondan istenir;

        bu işlem için telefonun çevrimiçi olması gerekir ve işlem 30 saniyeye
        kadar sürebilir.
      operationId: forwardMessage
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
        - in: path
          name: message_id
          schema:
            type: string
          required: true
          description: Sohbet deposundaki kaynak mesajın kimliği
          example: 3EB0123456789ABCDEF
      requestBody:
        content:
          application/json:
            schema:
              type: object
              allOf:
                - $ref: '#/components/schemas/ScheduleOptions'
              required:
                - phone
              properties:
                phone:
                  type: string
                  example: 6289685024051@s.whatsapp.net
                  description: Hedef telefon numarası veya grup JID değeri
                duration:
                  type: integer
                  example: 0
                  description: >-
                    İsteğe bağlı kaybolan mesaj süresi geçersiz kılma değeri (0,
                    86400, 604800, 7776000)
                force_reupload:
                  type: boolean
                  example: false
                  description: >-
                    Medya referansını yeniden kullanmayı atla ve göndermeden
                    önce medyayı yeniden yükle
      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

- [Mesajı sil](https://gowa-docs.mintlify.site/tr/api-reference/message/mesajı-sil.md)
- [Mesajı yıldızla](https://gowa-docs.mintlify.site/tr/api-reference/message/mesajı-yıldızla.md)
- [Mesajı geri al](https://gowa-docs.mintlify.site/tr/api-reference/message/mesajı-geri-al.md)
- [Mesajı okundu olarak işaretle](https://gowa-docs.mintlify.site/tr/api-reference/message/mesajı-okundu-olarak-işaretle.md)
- [Sesli mesajı oynatıldı olarak işaretle](https://gowa-docs.mintlify.site/tr/api-reference/message/sesli-mesajı-oynatıldı-olarak-işaretle.md)


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