Giriş yapınÜcretsiz denemeyi başlatın
Meta Tech Provider

AI ajanları için WhatsApp API: dakikalar içinde resmi erişim, Tech Provider olmadan

Bir AI ajanı, Meta'nın Cloud API'si üzerinden resmi WhatsApp erişimi alır. WhatsApp Business uygulamasında kalan bir numara ise bir Tech Provider veya Solution Partner aracılığıyla bu erişime katılır. İşletme doğrulaması, App Review videoları ve bir Embedded Signup yapısıyla siz de bunlardan biri olabilirsiniz; ya da zaten böyle olan bir sağlayıcı üzerinden bağlanabilirsiniz: numara dakikalar içinde katılır ve ajan MCP araçlarını ya da API kimlik bilgilerini alır.

easyCoexistence, bağımsız bir Meta Tech Provider'dır: bir WhatsApp Business numarasını Coexistence üzerinden dakikalar içinde Cloud API'ye bağlar; böylece ajanınız resmi erişim alırken işletme uygulamasını kullanmaya devam eder.

Tech Provider

Meta, WhatsApp Business uygulamasında kalan bir numarayı kuran herkesten Tech Provider veya Solution Partner statüsü ister.

2 videos

App Review, uygulamanızdan gönderilen bir mesajın ve uygulamanızın bir şablon oluşturmasının birer videosunu ister.

Advanced access

App Review, Tech Provider olmak için ikisi de gerekli olan whatsapp_business_messaging ve whatsapp_business_management izinlerini verir.

October 15, 2026

Meta, Embedded Signup v2 ve v3'ü kullanımdan kaldırdığında entegrasyonlara v4'e geçmelerini söyledi.

20 msg/s

Hem WhatsApp Business uygulamasıyla hem Cloud API'yle kullanılan bir numaranın sabit işlem hızı.

1 hour

Bir platform müşterinin numarasını Partner API üzerinden kurduğunda, barındırılan bağlantı linkinin ne kadar süre geçerli kaldığı.

Bir AI ajanının WhatsApp'ı resmi olarak kullanması için neye ihtiyacı var?

Meta'nın Cloud API'sinden dört şey. Ajanın messages uç noktasını çağırabilmesi için whatsapp_business_messaging izni olan bir numara kimliği (phone_number_id) ve bir erişim token'ı. Meta'nın gelen mesajları ilettiği bir webhook uç noktası; uygulamayla ortak kullanılan bir numarada ise kişinin telefondan yazdığı yanıtlar için smb_message_echoes. Onaylanmış şablonlar, çünkü yazılan bir mesaj yalnızca son 24 saat içinde yazmış kişiye ulaşır. Ve bağlantı koptuğunda bunu öğrenmenin bir yolu; çünkü API tarafı durduğunda telefondaki uygulama çalışmaya devam eder.

İnsanların ilk bulduğu kısayol, bağlı bir cihaz olarak oturum açan WhatsApp Web otomasyonudur. Bu, WhatsApp'ın koşullarını ihlal eder ve üzerinde çalışan ajan ne yaparsa yapsın numarayı yasaklanma riskine sokar.

Tech Provider yolu neleri içerir?

Meta'nın kendi adımları, bu sırayla. Her adım ücretsizdir ve hiçbiri parayla hızlandırılamaz: incelemeler Meta'nın takvimine göre yürür ve Meta bir zaman çizelgesi yayımlamaz. Bu yüzden ilk müşterinin numarası bağlanmadan önce günler değil haftalar planlayın. Bundan sonra arka uç çalışmaya devam etmelidir: her kayıttan sonra token değişimi, bir webhook alıcısı, numara bazlı yönlendirme ve Meta'nın 14 günlük hareketsizlik kuralı gibi bağlantı kopmalarının izlenmesi.

1Business verificationName, address, phone, email and website checked by Meta
2Meta appThe WhatsApp use case and a connected business portfolio
3App ReviewTwo videos, then advanced access to both WhatsApp permissions
4Embedded SignupVersion 4 or later, with WhatsApp Business app onboarding
5Your backendToken exchange, webhooks, routing and monitoring

Daha kısa yol nedir?

Numarayı bu süreci zaten tamamlamış bir sağlayıcı üzerinden bağlayın. easyCoexistence ile işletme Meta'nın Embedded Signup akışını çalıştırır ve WhatsApp Business uygulamasıyla bir kodu tarar; bu yaklaşık iki dakika sürer. Numara, işletmenin kendi Business Portfolio'sunda Cloud API'ye katılır ve uygulama çalışmaya devam eder. Ajan, ardından hangi dili konuşuyorsa ona göre erişim alır: ChatGPT, Claude, Claude Code veya Codex gibi bir asistan için MCP araçları, ya da kendi çalıştırdığınız kod için numaranın kimlik bilgileri ve webhook'ları.

Connect through easyCoexistenceBecome a Tech Provider
Meta app and App ReviewNot needed: the number joins through oursYours to build and pass
Embedded SignupHosted, with the QR scan in the appYou integrate version 4 and host the flow
First number connectedMinutes after signing upAfter verification and review
Webhook trustA secret in your URL, or X-EC-Signature on forwarded messagesYour app secret signs Meta's deliveries
Disconnection alertsEvery number watched 24/7, 14-day rule includedMonitoring you build and run
Who owns the WhatsApp Business AccountThe business, in its own portfolioThe business

Ajan numaranın kimlik bilgilerini nasıl alır?

get_api_credentials aracılığıyla ya da panelde numaranın sayfasından. Araç; Graph API temel URL'sini, WhatsApp Business Account ID'sini, phone_number_id alanını, gönderme uç noktasını ve varsa işletmenin kendi erişim token'ını döndürür; bu token WhatsApp varlıklarıyla sınırlıdır. Bir istemci token'ı verilmediyse token null döner ve panelden numarayı yeniden bağlamanın bir tane vereceği notu eklenir; çalışan bir token ise değiştirilmez. Alınacak bir uygulama gizli anahtarı yoktur, çünkü Meta webhook'ları easyCoexistence'ın asla paylaşılmayan gizli anahtarıyla imzalar. Token mesaj gönderebildiği için araç aktif bir plan gerektirir.

Send a reply with the returned credentials
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511999998888",
    "type": "text",
    "text": { "body": "Your order #1042 is ready for pickup." }
  }'

Gelen mesajlar ajana nasıl ulaşır?

Her numaranın iki modu vardır; set_inbound_mode ile ya da numaranın sayfasından değiştirilir. Sunucunuza doğrudan: set_webhook_destination, Meta'yı doğrudan HTTPS uç noktanıza yönlendirir. Bu uç nokta Meta'nın GET el sıkışmasını yanıtlamalıdır ve easyCoexistence mesajları asla görmez, bu yüzden otomasyonlar kapalıdır. Bu teslimatları Meta bizim gizli anahtarımızla imzaladığı için URL yoluna uzun, rastgele bir gizli değer koyun ve bu değer olmayan istekleri reddedin.

Otomasyonlar açık: Meta easyCoexistence'a teslim eder, otomasyonlar yanıt verebilir ve isteğe bağlı bir Forward URL, Meta'nın orijinal payload'unu "value" altında alır. Bu payload, X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>"> ile imzalanır ve sır yalnızca bir kez gösterilir. Bir otomasyonun "Call my webhook" adımı da mesajı ve sohbetin son 10 mesajını ajanınıza iletir; yanıtınız 20 saniye içinde {"reply": "..."} biçimindeyse yanıtı da gönderir.

Ajanın hangi limitlere uyması gerekir?

Meta'nınkiler; bunlar herhangi bir sağlayıcı üzerinden aynıdır. Bunları önceden bilen bir ajan, hata gibi görünen sorunların çoğundan kaçınır:

  • Ortak kullanılan numaralar için Meta tarafından sabitlenmiş, numara başına saniyede 20 mesaj.
  • Yazılan mesajlar yalnızca müşterinin son mesajından sonraki 24 saat içinde; sonrasında onaylanmış bir şablon.
  • Şablonlar yalnızca API üzerinden gider, çünkü Coexistence numarasındaki uygulama bunları gönderemez.
  • Kişinin uygulamada yazdığı yanıtlar smb_message_echoes olarak gelir; o sohbette ajanı duraklatın, yoksa müşteri iki yanıt alır.
  • Grup sohbetleri API ile senkronize edilmez, bu yüzden ajan bire bir sohbetlerde çalışır.
  • Kişiler ve en fazla 6 aylık bire bir sohbetler yalnızca bağlantıdan sonraki 24 saat içinde doğrudan bir webhook hedefi kaydedilmişse bir kez içe aktarılır; otomasyonları açık olan numara içe aktarmayı almaz.
  • Sesli ve görüntülü aramalar uygulamada çalışmaya devam eder, ancak Cloud API bir Coexistence numarasında aramaları taşımaz, bu yüzden ajan metinle çalışır.

Bir platform kendi müşterilerinin numaralarını bu şekilde bağlayabilir mi?

Evet; kendi Tech Provider statüsü olmadan bir SaaS veya ajansın müşterilerini kurduğu Partner API üzerinden. create_api_key ile anahtar oluşturun (ec_live_ ile başlar ve bir kez gösterilir), sonra arka ucunuzdan POST /api/v1/connect-sessions çağırın ya da asistandan create_connect_link kullanın; bu, 1 saat geçerli barındırılan bir bağlantı linki verir. Müşteri orada Meta'nın açılır penceresini ve QR taramasını çalıştırır ve connection_id ile redirect_url adresinize döner. Ardından GET /api/v1/connections/:id?credentials=1 müşterinin kendi token'ını döndürür; connection.disconnected gibi durum olayları ise X-EC-Signature ile imzalanmış olarak gelir. Her numara, aynı numara başına fiyat bantlarıyla hesabınıza faturalandırılır.

Yaygın hatalar

  • Doğrudan hedefte X-Hub-Signature-256 doğrulaması yapmak. Meta, easyCoexistence'ın asla paylaşılmayan gizli anahtarıyla imzalar; bu yüzden gerçek teslimatlar kontrolden geçemez. URL'deki uzun rastgele bir gizli değere güvenin ya da X-EC-Signature ile yönlendirme kullanın.
  • n8n'in WhatsApp Trigger düğümüyle almak. O, kendi Meta uygulamanızı bekler; bunun yerine URL'sinde gizli değer bulunan genel Webhook düğümünü kullanın.
  • smb_message_echoes'ı yok saymak. Ajan, telefondan zaten yanıt vermiş bir kişinin üzerine yanıt yazar ve müşteri iki yanıt okur.
  • Doğrudan webhook hedefini bağlantıdan günler sonra kaydetmek ya da numarayı otomasyonlarda bırakmak. Meta'nın kişilerin ve en fazla 6 aylık sohbetlerin tek seferlik içe aktarımı, bağlantıdan sonraki 24 saat içinde kaydedilmiş doğrudan bir hedef gerektirir.
Bunu EasyCoexistence'la yapmak

Ajan 30'dan fazla MCP aracıyla ya da her numaranın kimlik bilgileri ve webhook'larıyla çalışır; her numara 7/24 izlenir ve uyarılar gelir. Numara başına aylık US$ 9'dan US$ 0.75'e kadar, numara ekledikçe düşer; ilk 3 gün ücretsiz.

Sık sorulan sorular

Kendi Meta uygulamam gerekir mi?

Hayır. Numara easyCoexistence'ın Meta uygulaması üzerinden kurulur ve işletmenin kendi Business Portfolio'sunda ve WhatsApp Business Account'ında kalır. Kodunuz, get_api_credentials'tan gelen işletmenin kendi token'ıyla gönderir; ileride bir uygulama geliştirmeye karar vermediğiniz sürece sizin bir uygulamanız işin içinde değildir.

Ajan ve ekip numarayı aynı anda kullanabilir mi?

Evet. Meta, Cloud API ile WhatsApp Business uygulaması arasında mesajları aynalar; yani ajanın gönderdiği mesaj telefondaki uygulamanın sohbet akışında görünür ve ekibin uygulamada yazdığı her şey smb_message_echoes olarak sisteminize ulaşır.

Hangi ajan çerçeveleri bununla çalışır?

OAuth ile HTTP üzerinden MCP konuşan her istemci; ChatGPT, Claude, Claude Code, Codex ve Cursor gibi. Ayrıca Meta'nın Graph API'sini çağıran her kod: Node.js, Python, n8n, LangChain, OpenAI Agents SDK veya Vercel AI SDK. Alttaki API Meta'nın kendi API'sidir, bu yüzden ajanın içinde özel bir şey yoktur.

Genel amaçlı bir AI asistanına WhatsApp'ta izin var mı?

Meta'nın Business Solution Terms belgesinin 4.7 maddesi, AI'nın Meta'nın belirlediği üzere birincil işlev olduğu genel amaçlı AI asistanı sağlayıcılarının WhatsApp Business Platform'da bunları sunmasını engeller; kural 15 Ocak 2026'dan beri yürürlüktedir. Kendi müşterileri için destek, satış veya rezervasyon amacıyla AI kullanan bir işletme hedef değildir; AB ve Brezilya düzenleyicileri de rakip asistanlar için kuralın askıya alınmasını veya geri alınmasını Meta'ya emretti.

Okumaya devam edin

Başlamaya hazır mısınız?

WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.

Ücretsiz denemeyi başlatın

Doğrulama tarihi