
Entegrasyon kılavuzları
LinkedIn API kılavuzu
E-posta API kılavuzu
WhatsApp API kılavuzu
Satış ekibiyle iletişime geçin
2026'da Meta'nın Send API kuralları, ardından kullanıcılarınızın kendi hesaplarından mesaj göndermek için tek bir REST çağrısı.
chats
POSTmessages/send
POSTchats/send
200 OK
API ile Facebook Messenger mesajı göndermenin iki yolu vardır. Meta'nın Send API'si, bir Page access token ile bir Facebook Sayfasından ve yalnızca son 24 saat içinde Sayfaya mesaj yazmış kişilere gönderim yapar. Unipile gibi birleşik bir API ise kullanıcınızın bağlı hesabından (kişisel bir hesap veya yönettiği bir Sayfa) tek bir REST çağrısıyla gönderir: POST /v2/{account_id}/chats/{chat_id}/messages/send.
Üç adımda Messenger mesajı gönderin
Bağlayın. Kullanıcınız Facebook hesabını veya Sayfasını Hosted Auth üzerinden bağlar. Meta uygulaması yok, App Review yok.
Gönderin. POST /v2/{account_id}/chats/{chat_id}/messages/send endpoint'ini X-API-KEY anahtarınız ve bir text ile çağırın.
Dinleyin. message.new webhook'u gönderimi doğrular ve yanıtları iletir.
Dört dilde kod: bağlı bir hesaptan gönderin. Referans: Unipile V2 mesaj gönderme dokümantasyonu.
Hemen başlayınMeta'nın Send API'si, uygulamanızın yönettiği bir Sayfa adına hareket eder. Unipile ise son kullanıcınızın bağladığı hesap adına hareket eder.
| Kriter | Meta Send API | Unipile API |
|---|---|---|
| Gönderen | Bir Facebook Sayfası | Kullanıcının kişisel hesabı veya yönettiği bir Sayfa |
| Kurulum | Meta uygulaması, pages_messaging izinli Page token, başka işletmelerin Sayfalarına hizmet vermek için App Review | API anahtarı ve Hosted Auth'tan gelen bir account_id, Meta uygulaması yok |
| İlk mesajı kim yazar | Her zaman kişi | Kişisel hesap yazabilir; Sayfa yalnızca yanıt verir |
| Pencere | 24 saat, Click-to-Messenger reklamından sonra 7 güne kadar | Send API penceresi yok; Facebook bir alıcıyı reddedebilir |
pages_messaging izinli Page token, başka işletmelerin Sayfalarına hizmet vermek için App Reviewaccount_id, Meta uygulaması yokKendi Sayfanız için bir bot Meta'nın yoluna uyar; müşterilerinizin konuşmalarında çalışan bir CRM, helpdesk veya yapay zekâ ajanı ise bağlı bir hesaba ihtiyaç duyar. Tam harita için Facebook API'lerinin birbirine nasıl bağlandığına göz atın.
Meta'nın resmi yolu Messenger Platform'un Send API'sidir: pages_messaging iznine sahip bir Page access token, bir recipient.id, bir messaging_type ve bir message nesnesiyle POST https://graph.facebook.com/v27.0/{PAGE-ID}/messages. Yalnızca Sayfanıza yazmış kişilere yanıt verir.
Messenger'ı ekleyin, Sayfayı bağlayın.
pages_messaging ile; başka işletmelere hizmet vermek için App Review. Facebook API erişim token'ı rehberimize bakın.
Kişiye, messages webhook'undan okunan PSID'si (Page-scoped ID) ile hitap edin.
graph.facebook.com/v27.0/{PAGE-ID}/messages
200 OK
RESPONSE: pencere içinde bir yanıt.UPDATE: pencere içinde sizin başlattığınız bir mesaj.MESSAGE_TAG: pencere dışında, bir etiketle ve tanıtım amaçlı olmayan içerikle.PSID nereden gelir
messages olayında sender.id kişinin PSID'sidir, recipient.id ise Sayfa ID'nizdir. İsteği aşağıdaki kod bloğunun Meta cURL, Node.js, Python ve PHP sekmelerinden kopyalayın.
Kaynaklar: Meta'nın Send a Message ve messages webhook olayı dokümantasyonu. Son doğrulama: 17 Kasım 2026.
Send API yalnızca Sayfaya yazmış kişilere, son mesajlarından sonraki 24 saat boyunca veya bir Click-to-Messenger reklamından sonra 7 güne kadar yazar. Bunun ötesinde HUMAN_AGENT, 7 gün içinde bir insanın yazdığı yanıtı kapsar; üç güncelleme etiketi ise 27 Nisan 2026'dan beri 100 hatasıyla başarısız oluyor.
Standart pencereyi açar.
RESPONSE veya UPDATE ile gönderin.
Bir kişinin yazdığı yanıt için HUMAN_AGENT etiketi.
Yeni bir mesaj bekleyin.
CONFIRMED_EVENT_UPDATE, ACCOUNT_UPDATE veya POST_PURCHASE_UPDATE etiketli istekler artık 100 hata koduyla başarısız oluyor.
Kaynaklar: Meta'nın Send API referansı ve Send a Message. Son doğrulama: Kasım 2026.
Kullanıcınız Facebook hesabını bir kez bağlar ve siz bir account_id alırsınız. Sohbetlerini listeleyin, ardından bir chat_id içinde gönderin. İstekler, Unipile'ın Facebook Messenger API'si üzerinden, anahtarınız X-API-KEY başlığında olacak şekilde https://api.unipile.com adresine gider. Meta sekmeleri aynı yanıtı, yönettiğiniz bir Sayfadan Meta'nın Send API'si ile gönderir.
Kullanıcı bir Hosted Auth sayfasında giriş yapar. Ayrıntılar kişisel hesaplar için Messenger API rehberimizde.
GET /v2/{account_id}/chats sayfa başına en fazla 100 sohbet döndürür.
text alanı içeren tek bir POST.
# 1. List chats
curl --request GET \
--url 'https://api.unipile.com/v2/acc_123456789/chats?limit=20' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'accept: application/json'
# 2. Send a message
curl --request POST \
--url https://api.unipile.com/v2/acc_123456789/chats/CHAT_ID/messages/send \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{ "text": "Thanks, your order ships today." }'
// npm i @unipile/sdk
import { UnipileMessaging } from '@unipile/sdk';
const request_options = {
baseUrl: 'https://api.unipile.com',
headers: { 'X-API-KEY': 'YOUR_API_KEY' },
throwOnError: true,
};
const messagingApi = new UnipileMessaging();
// 1. List chats
const chats = await messagingApi.getChatsList({
...request_options,
path: { account_id: 'acc_123456789' },
query: { limit: 20 },
});
// 2. Send a message
await messagingApi.sendMessage({
...request_options,
path: { account_id: 'acc_123456789', chat_id: 'CHAT_ID' },
body: { text: 'Thanks, your order ships today.' },
});
import unipile
configuration = unipile.Configuration()
configuration.api_key["apiKey"] = "YOUR_API_KEY"
api_client = unipile.ApiClient(configuration)
messaging_api = unipile.MessagingApi(api_client)
# 1. List chats
chats = messaging_api.get_chats_list("acc_123456789", limit=20)
# 2. Send a message
messaging_api.send_message(
"CHAT_ID",
"acc_123456789",
{"text": "Thanks, your order ships today."},
)
<?php
$base = 'https://api.unipile.com/v2/acc_123456789';
$headers = ['X-API-KEY: YOUR_API_KEY', 'accept: application/json'];
// 1. List chats
$ch = curl_init("$base/chats?limit=20");
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => $headers,
CURLOPT_RETURNTRANSFER => true,
]);
$chats = json_decode(curl_exec($ch), true);
curl_close($ch);
// 2. Send a message
$ch = curl_init("$base/chats/CHAT_ID/messages/send");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => array_merge($headers, ['content-type: application/json']),
CURLOPT_POSTFIELDS => json_encode(['text' => 'Thanks, your order ships today.']),
CURLOPT_RETURNTRANSFER => true,
]);
$sent = json_decode(curl_exec($ch), true);
curl_close($ch);
# Meta Send API: reply to a person who messaged your Page
curl -X POST \
"https://graph.facebook.com/v27.0/PAGE_ID/messages?access_token=PAGE_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"recipient": { "id": "PSID" },
"messaging_type": "RESPONSE",
"message": { "text": "Thanks, your order ships today." }
}'
// Node.js 18+: built-in fetch, no SDK
const url = 'https://graph.facebook.com/v27.0/PAGE_ID/messages'
+ '?access_token=' + process.env.PAGE_ACCESS_TOKEN;
const res = await fetch(url, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
recipient: { id: 'PSID' },
messaging_type: 'RESPONSE',
message: { text: 'Thanks, your order ships today.' },
}),
});
const data = await res.json(); // { recipient_id, message_id }
# pip install requests
import requests
resp = requests.post(
"https://graph.facebook.com/v27.0/PAGE_ID/messages",
params={"access_token": "PAGE_ACCESS_TOKEN"},
json={
"recipient": {"id": "PSID"},
"messaging_type": "RESPONSE",
"message": {"text": "Thanks, your order ships today."},
},
)
print(resp.json()) # {"recipient_id": "...", "message_id": "..."}
<?php
$url = 'https://graph.facebook.com/v27.0/PAGE_ID/messages?access_token=PAGE_ACCESS_TOKEN';
$payload = [
'recipient' => ['id' => 'PSID'],
'messaging_type' => 'RESPONSE',
'message' => ['text' => 'Thanks, your order ships today.'],
];
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
]);
$sent = json_decode(curl_exec($ch), true); // recipient_id, message_id
curl_close($ch);
İlk dört sekme, bağlı bir hesap için Unipile'ı çağırır; aynı istek LinkedIn, WhatsApp, Instagram ve Telegram için de çalışır. Meta sekmeleri, bir Page access token ve kişinin PSID'siyle (PSID nasıl alınır) kendi Sayfanız için Meta'nın Send API'sini çağırır. Referanslar: Unipile Facebook, Send messages ve Meta Send a Message (v27.0, 17 Kasım 2026'da doğrulandı).
Henüz bir sohbet yoksa, kişinin ID'sini users_ids içinde ve metninizi text içinde göndererek POST /v2/{account_id}/chats/send çağrısını yapın. Meta'nın Send API'si bunu yapamaz.
https://api.unipile.comSDK: startChat (Node.js), start_chat (Python)
200 OK
Yanıt, yeni chat_id'yi ve message_id'yi döndürür.
Facebook hesabın bu kişiye mesaj göndermesine izin vermezse istek provider/access_restricted ile başarısız olur.
Bir Sayfa konuşma başlatamaz (501 api/not_implemented) ve kendi mesajlarını silemez.
Kullanıcının yönettiği bir Sayfa aynı account_id üzerinden yanıt verir: gelen kutularını listeleyin, Sayfa gelen kutusunu açın, ardından bir Sayfa sohbet ID'siyle gönderin. Sayfaların ve token'larının Meta tarafında nasıl çalıştığını Facebook Page API rehberimizde anlatıyoruz.
{chat_id}PAGE_<page_id>_<thread_key>Genel sohbet listesi yalnızca kişisel sohbetleri döndürür. PAGE_ öneki, Unipile'ın Sayfa olarak hareket etmesini sağlar. Ayrıntılar Facebook Pages dokümantasyonunda.
Aynı gönderim endpoint'ine bir attachments dizisi ekleyin. Büyük dosyalar için multipart kullanın.
Büyük dosya: multipart/form-data
200 OK
Şifreli sohbetler. Uçtan uca şifrelenmiş kişisel sohbetlerde her dosya ayrı bir mesaj olarak gönderilir.
Meta karşılığı. Send API, bir type ve bir url içeren bir attachment nesnesi alır; gönderim başına en fazla 30 görsel.
Bir 200, mesajın teslim edildiği değil Facebook'un mesajı kabul ettiği anlamına gelir. Teslimat, yanıtları da getiren message.new webhook olayıyla doğrulanır.
Gönderilen ve alınan mesajlar için tetiklenir; is_sender alanına bakın.
Sayfa olaylarını, API'dekinden farklı olabilen chat_id değerlerinin PAGE_<page_id>_ önekine göre yönlendirin. Kurulum Configure a webhook sayfasında.
Meta tarafında, Send API üzerine kurulu bir Sayfa botunun kendi Messenger webhook'una ihtiyacı vardır. Yanıt vermeden önce PSID'yi okuduğunuz yer de burasıdır.
Kaynak: Meta'nın Messenger webhook'ları. Son doğrulama: 17 Kasım 2026.
Gönderim hatalarının çoğu bir kuraldan kaynaklanır: yeniden denemek yine başarısız olur. pages_messaging izni olmayan bir token tüm Send API çağrılarını engeller.
| Hata | Anlamı | Çözüm |
|---|---|---|
| Meta 100 | Geçersiz parametre veya 27 Nisan 2026'da kaldırılan bir etiket | PSID'yi kontrol edin, etiketi kaldırın |
| Meta 10 / 2018278 | İzin verilen pencerenin dışında gönderilen mesaj | Yeni bir mesaj bekleyin veya bir HUMAN_AGENT yanıtı gönderin |
| Meta 200 / 2018028 | Uygulamanın yöneticisi, geliştiricisi veya test kullanıcısı olmayan kişilere mesaj gönderilemiyor: pages_messaging henüz onaylanmadı | App Review'u tamamlayın, bu arada uygulama rolleriyle test edin |
| Meta 551 | Bu kişi şu anda sizden mesaj almıyor | Yeniden denemeyin |
| Meta 613 | Rate limit aşıldı | Daha seyrek gönderin |
Unipile provider/access_restricted | Facebook bu alıcıyı hesap için reddediyor | Yeniden denemeyin |
Unipile 403 api/insufficient_permissions | Sayfa hesapta etkinleştirilmemiş | Yeniden bağlanırken etkinleştirin |
Unipile 501 api/not_implemented | Bir Sayfa sohbet başlattı veya mesaj sildi | Mevcut bir sohbette yanıt verin |
HUMAN_AGENT yanıtı gönderinpages_messaging henüz onaylanmadıKaynaklar: Meta'nın Messenger hata kodları ve Unipile'ın hata yanıtları. Son doğrulama: 17 Kasım 2026.
Her kullanıcı kendi hesabından gönderir
Unipile bağımsız bir şirkettir; resmi bir Meta uygulaması veya Meta Partner değildir. Meta'nın koşullarına bağlı kalan, kimliği doğrulanmış kullanıcılar adına hareket eder. Müşteri desteği, CRM ve doğrudan konuşmalar için kullanın.
İlk mesajınızı gönderin
Meta'nın Send API'si kendi Sayfanızdaki bir bot için uygundur. Kullanıcılarınızın kendi hesaplarından Facebook Messenger API ile mesaj gönderme akışı için hesaplarını Unipile üzerinden bağlayın.
Her kullanıcı kendi hesabını bağlar, profil depolama yok. Unipile bir Meta İş Ortağı değildir. Digital Markets Act yaklaşımımız
Tüm Facebook API endpoint'leri tek bir yerde
Mesajlar bunun yalnızca bir parçası. Gönderilerden ve yorumlardan profillere ve webhook'lara kadar Unipile ile kullanılabilen tüm Facebook endpoint'lerine göz atın veya eksiksiz Facebook API rehberimizi okuyun.
API ile Messenger mesajı gönderme hakkında hızlı yanıtlar.
Hayır. Send API yalnızca Sayfanıza mesaj yazmış kişilere, mesajlaşma penceresi içinde ulaşır ve bir Sayfa asla ilk mesajı yazmaz. Yeni bir konuşma, bağlı bir kişisel hesaptan başlamalıdır; örneğin Unipile'ın POST /v2/{account_id}/chats/send çağrısıyla.
Meta, Send API için resmi bir Python SDK'sı listelemiyor: yukarıdaki Meta Python sekmesinde olduğu gibi requests ile /{PAGE-ID}/messages adresine POST gönderin. Unipile, unipile olarak içe aktarılan, get_chats_list ve send_message içeren bir Python SDK'sı sunar.
cURL veya Guzzle ile bir HTTP POST gönderin: bir Page access token ile Graph API'deki /{PAGE-ID}/messages adresine (Meta PHP sekmesi) ya da X-API-KEY anahtarınızla Unipile'daki /v2/{account_id}/chats/{chat_id}/messages/send adresine (PHP sekmesi).
@unipile/sdk paketini kurun ve yukarıdaki Node.js sekmesinde olduğu gibi account_id, chat_id ve text ile sendMessage çağrısını yapın. Meta'nın Send API'si için, Meta Node.js sekmesinde olduğu gibi fetch ile /{PAGE-ID}/messages adresine POST gönderin.
Send API'de: kapanmış bir pencere (10 hatası, 2018278 alt kodu), 27 Nisan 2026'da kaldırılan bir etiket (100 hatası), pages_messaging izni onaylanmamış bir token (200 hatası, 2018028 alt kodu) veya mesajlarınızı engelleyen bir kişi (551 hatası). Unipile'da: Facebook alıcıyı reddettiğinde provider/access_restricted ya da konuşma başlatmaya çalışan bir Sayfa.
Meta platformundaki bir Sayfa botu için endpoint'iniz GET doğrulamasını hub.challenge döndürerek yanıtlar, X-Hub-Signature-256 imzasını App Secret'ınızla kontrol eder ve messages alanına abone olur; her olaydaki sender.id, yanıt verdiğiniz PSID'dir. Unipile ile tek bir URL kaydedersiniz ve tüm bağlı hesaplar için message.new olaylarını alırsınız.
Hayır. Unipile bağımsız bir şirkettir: Meta Partner değildir ve Meta tarafından desteklenmez, sponsorluğu yapılmaz veya onaylanmaz. Bu sayfadaki Meta sekmeleri Meta'nın herkese açık Send API'sini çağırır; diğer sekmeler Unipile API'sini çağırır. Facebook ve Messenger, Meta Platforms, Inc.'in ticari markalarıdır.
Hayır. Meta uygulaması, Page token ve App Review yalnızca Send API yoluna aittir. Unipile ile kullanıcılarınız kendi Facebook hesaplarını veya yönettikleri Sayfaları hosted authentication üzerinden bağlar ve siz bir account_id ile API anahtarınızı kullanarak gönderirsiniz.
Unipile, Digital Markets Act'in ruhuna uygun olarak tasarlanmıştır: her kullanıcı kendi hesabını bağlar ve mesajlar, Unipile kullanıcı profillerini saklamadan, onlar adına kendi konuşmalarında gönderilir. Ayrıntılar Digital Markets Act sayfamızda.
Evet. Her bağlı hesap Meta'nın Hizmet Koşullarına bağlı kalır. Mesajları destek yanıtları, CRM takipleri ve kişilerin beklediği konuşmalar gibi meşru ihtiyaçlar için gönderin; toplu istenmeyen mesajlar ve spam hesabın kısıtlanmasına yol açabilir.
Hâlâ sorularınız mı var? Ekibimiz yardıma hazır.
Bir uzmanla görüşün