API referansı

İşletme profili

Numaranızın WhatsApp işletme profilini (hakkında, adres, açıklama, e-posta, sektör, web siteleri) okuyun ve güncelleyin.

#BusinessProfile nesnesi

aboutstring
Hakkında metni (en fazla 139 karakter).
addressstring
Adres (en fazla 256 karakter).
descriptionstring
Açıklama (en fazla 512 karakter).
emailstring
E-posta.
verticalstring
Meta sektör kategorisi.Değerler: AUTO, BEAUTY, APPAREL, EDU, ENTERTAIN, EVENT_PLAN, FINANCE, GROCERY, GOVT, HOTEL, HEALTH, NONPROFIT, PROF_SERVICES, RETAIL, TRAVEL, RESTAURANT, NOT_A_BIZ, OTHER, UNDEFINED
websitesarray
En fazla 2 web sitesi.

BusinessProfile nesnesi

{
  "about": "7/24 müşteri desteği",
  "address": "Çankaya / Ankara",
  "description": "Kurumsal yazılım ve WhatsApp çözümleri.",
  "email": "[email protected]",
  "vertical": "PROF_SERVICES",
  "websites": [
    "https://example.com"
  ]
}

#Profili getir

GET/profile/{phone_number_id}

İşletme profilini Meta'dan canlı okur ve Meta'nın döndürdüğü alanları aynen iletir. Kapsam: profile:read

Yol parametreleri

phone_number_idstringzorunlu
Numaranızın Meta kimliği (yalnız rakam, 5–32 hane).

Hatalar

Durum	Kod	Ne zaman
403	`insufficient_scope`	Anahtarda `profile:read` kapsamı yok.
404	`number_not_found`	Numara bulunamadı.
409	`number_detached`	Numara hesabınızdan ayrılmış; panelden yeniden bağlayın.
422	`meta_error`	Meta isteği reddetti (`meta_code`).

curl -X GET "https://api.verimerkezi.app/wa/profile/1234567890" \
  -H "Authorization: Bearer $VM_API_KEY"

const res = await fetch("https://api.verimerkezi.app/wa/profile/1234567890", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.VM_API_KEY}`,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.verimerkezi.app/wa/profile/1234567890",
    headers={"Authorization": f"Bearer {os.environ['VM_API_KEY']}"},
)
data = res.json()

<?php
$ch = curl_init("https://api.verimerkezi.app/wa/profile/1234567890");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("VM_API_KEY"),
    ],
]);
$data = json_decode(curl_exec($ch), true);

Yanıt 200

{
  "ok": true,
  "profile": {
    "about": "7/24 müşteri desteği",
    "address": "Çankaya / Ankara",
    "description": "Kurumsal yazılım ve WhatsApp çözümleri.",
    "email": "[email protected]",
    "vertical": "PROF_SERVICES",
    "websites": [
      "https://example.com"
    ]
  }
}

#Profili güncelle

PATCH/profile/{phone_number_id}

İşletme profilini günceller. Yalnız gönderdiğiniz alanlar değişir; uzun metinler sınırda kesilir. Kapsam: profile:write

Yol parametreleri

phone_number_idstringzorunlu
Numaranızın Meta kimliği (yalnız rakam, 5–32 hane).

İstek gövdesi

aboutstringisteğe bağlı
En fazla 139 karakter.
descriptionstringisteğe bağlı
En fazla 512 karakter.
addressstringisteğe bağlı
En fazla 256 karakter.
emailstringisteğe bağlı
E-posta.
verticalstringisteğe bağlı
Sektör kodu (bkz. nesne).
websitesarrayisteğe bağlı
En fazla 2 adres; fazlası atılır.

Hatalar

Durum	Kod	Ne zaman
403	`insufficient_scope`	Anahtarda `profile:write` kapsamı yok.
404	`number_not_found`	Numara bulunamadı.
409	`number_detached`	Numara hesabınızdan ayrılmış; panelden yeniden bağlayın.
422	`coexistence_readonly_profile`	Coexistence numarasında profil WhatsApp Business uygulamasından güncellenir.
422	`invalid_request`	En az bir alan gerekli.
422	`meta_error`	Meta isteği reddetti.

curl -X PATCH "https://api.verimerkezi.app/wa/profile/1234567890" \
  -H "Authorization: Bearer $VM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "about": "7/24 müşteri desteği",
    "email": "[email protected]",
    "websites": [
      "https://example.com"
    ]
  }'

const res = await fetch("https://api.verimerkezi.app/wa/profile/1234567890", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.VM_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "about": "7/24 müşteri desteği",
    "email": "[email protected]",
    "websites": [
      "https://example.com"
    ]
  }),
});
const data = await res.json();

import os, requests

res = requests.patch(
    "https://api.verimerkezi.app/wa/profile/1234567890",
    headers={"Authorization": f"Bearer {os.environ['VM_API_KEY']}"},
    json={
        "about": "7/24 müşteri desteği",
        "email": "[email protected]",
        "websites": [
            "https://example.com"
        ]
    },
)
data = res.json()

<?php
$ch = curl_init("https://api.verimerkezi.app/wa/profile/1234567890");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "PATCH",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("VM_API_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "about" => "7/24 müşteri desteği",
        "email" => "[email protected]",
        "websites" => [
            "https://example.com"
        ]
    ]),
]);
$data = json_decode(curl_exec($ch), true);

Yanıt 200

{
  "ok": true,
  "updated": true,
  "fields": [
    "about",
    "email",
    "websites"
  ]
}