> ## 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.

# Genel Bakış

> Kuruluşa ait bir numaradan metin, medya, konum veya etkileşimli WhatsApp mesajı gönderin.

## Serbest biçimli mesaj gönder

Bir alıcıya tek bir mesaj gönderir. Sekiz içerik türünün tamamı bu uç noktayı paylaşır; `type` alanı diğer hangi alanların gerekli olduğuna karar verir.

### Uç Nokta

```http theme={null}
POST /broadcast/public/send-freeform
```

### Ortak alanlar

| Alan              | Tür  | Gerekli | Açıklama                                    |
| ----------------- | ---- | ------- | ------------------------------------------- |
| `fromPhoneNumber` | dize | Gerekli | WABA numaranız                              |
| `toPhoneNumber`   | dize | Gerekli | Ülke kodunu içeren alıcı, yalnızca rakamlar |
| `type`            | dize | Gerekli | Aşağıdaki sekiz türden biri                 |

### Türe özgü alanlar

| `type`        | Gerekli                 | İsteğe bağlı      | Kabul edilen dosya uzantıları             |
| ------------- | ----------------------- | ----------------- | ----------------------------------------- |
| `text`        | `text`                  | —                 | —                                         |
| `image`       | `url`                   | `caption`         | jpg, jpeg, png                            |
| `document`    | `url`                   | `name`, `caption` | pdf, txt, doc, docx, ppt, pptx, xls, xlsx |
| `audio`       | `url`                   | —                 | aac, amr, mp3, m4a, mp4, ogg, opus        |
| `video`       | `url`                   | `caption`         | mp4, 3gp                                  |
| `sticker`     | `url`                   | —                 | webp                                      |
| `location`    | `latitude`, `longitude` | `name`, `address` | —                                         |
| `interactive` | `interactive`           | —                 | —                                         |

<Warning>
  **Uzantı, dosyadan değil, URL yolundan okunur.** `.webp` ile biten bir URL'den sunulan gerçek bir PNG, `image` için reddedilir ve hiçbir uzantısı olmayan bir URL, her medya türü için reddedilir. Sorgu dizeleri göz ardı edildiğinden `…/photo.png?v=2` uygundur.
</Warning>

## Mesaj türleri

<CardGroup cols={2}>
  <Card title="Metin Mesajı" href="/tr/api-reference/endpoints/broadcast-api/send-free-form-message/text-message">Bu mesaj türünün alanlarını ve örneğini inceleyin.</Card>
  <Card title="Resim Mesajı" href="/tr/api-reference/endpoints/broadcast-api/send-free-form-message/image-message">Bu mesaj türünün alanlarını ve örneğini inceleyin.</Card>
  <Card title="Belge Mesajı" href="/tr/api-reference/endpoints/broadcast-api/send-free-form-message/document-message">Bu mesaj türünün alanlarını ve örneğini inceleyin.</Card>
  <Card title="Ses Mesajı" href="/tr/api-reference/endpoints/broadcast-api/send-free-form-message/audio-message">Bu mesaj türünün alanlarını ve örneğini inceleyin.</Card>
  <Card title="Video Mesajı" href="/tr/api-reference/endpoints/broadcast-api/send-free-form-message/video-message">Bu mesaj türünün alanlarını ve örneğini inceleyin.</Card>
  <Card title="Çıkartma Mesajı" href="/tr/api-reference/endpoints/broadcast-api/send-free-form-message/sticker-message">Bu mesaj türünün alanlarını ve örneğini inceleyin.</Card>
  <Card title="Konum Mesajı" href="/tr/api-reference/endpoints/broadcast-api/send-free-form-message/location-message">Bu mesaj türünün alanlarını ve örneğini inceleyin.</Card>
  <Card title="Etkileşimli Mesaj" href="/tr/api-reference/endpoints/broadcast-api/send-free-form-message/interactive-message">Bu mesaj türünün alanlarını ve örneğini inceleyin.</Card>
</CardGroup>

## Başarılı yanıt

Uç nokta bu içerik türü için aynı başarılı yanıt biçimini döndürür.

```json theme={null}
{
  "status": true,
  "status_code": 200,
  "message": "Free-form message queued successfully",
  "data": {}
}
```

## Hatalar

| Durum            | Neden                                            | Kontrol edilecekler                                    |
| ---------------- | ------------------------------------------------ | ------------------------------------------------------ |
| `400`            | Ortak veya türe özgü alan geçersiz               | Bu sayfadaki zorunlu alanları kontrol edin             |
| `400`            | Medya URL'si veya uzantısı desteklenmiyor        | `http` veya `https` ile kabul edilen uzantıyı kullanın |
| `400`            | Koordinat, düğme veya liste satırı sınırı aşıldı | Yük sınırlarını düzeltin                               |
| `401`            | Anahtar veya gönderen kuruluşa ait değil         | Aynı anahtarla döndürülen göndereni kullanın           |
| `429`            | 20 istek sınırı aşıldı                           | Yanıtta belirtilen süreyi bekleyin                     |
| `500` veya `503` | Geçici hizmet hatası                             | Üstel geri çekilmeyle yeniden deneyin                  |