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

Claude Code veya Codex ile uygulamada tuttuğunuz numarada bir WhatsApp botu geliştirin

Claude Code veya Codex'e bir WhatsApp MCP sunucusu ekleyin ve kurulumu kodlama agent'ına bırakın: agent numaranın Cloud API kimlik bilgilerini okur, bir webhook alıcısı iskeleti oluşturur, gelen mesajları ona yönlendirir ve son 24 saat içinde yazan birine test yanıtı gönderir. Ortaya çıkan şey, sunucunuzda kendi kodunuz olarak çalışan kendi agent'ınızdır.

easyCoexistence, uygulamada tuttuğunuz WhatsApp Business numarasını Coexistence üzerinden Meta'nın Cloud API'sine bağlar ve Claude Code ile Codex'e kimlik bilgileri, yönlendirme, şablonlar, test gönderimleri ve otomasyonlar için 30'dan fazla MCP aracı sunar.

--scope user

Tüm projelerinizde bir sunucuyu yükleyen Claude Code bayrağı; varsayılan yerel kapsam ise onu yalnızca eklendiği yerde yükler.

codex mcp login

Bir sunucunun OAuth oturumunu saklayan Codex komutu; kimlik bilgisi yoksa Codex kimlik doğrulaması olmadan bağlanabilir.

HTTPS

Doğrudan bir webhook hedefinin kullanması gerekenler; Meta'nın GET el sıkışmasında hub.challenge değerini geri döndürmelidir.

20 seconds

Bir Call my webhook adımının uç noktanızdan {"reply"} yanıtını beklediği süre; bu süre dolarsa adım başarısız olur.

24 hours

Kullanıcının son mesajından sonraki müşteri hizmetleri penceresi; bu pencerenin dışında Meta yalnızca şablon mesajlarını kabul eder.

20 msg/s

WhatsApp Business uygulamasıyla ve Cloud API ile birlikte kullanılan bir numaranın sabit işlem hacmi.

Bir WhatsApp agent'ı kurmak için kodlama agent'ının neye ihtiyacı var?

Dört şey. Coexistence üzerinden Meta'nın Cloud API'sine bağlı bir WhatsApp Business numarası; böylece kod mesaj gönderip alabilir, uygulama ise telefonda kalır. Claude Code veya Codex'ten bu numaraya bir MCP bağlantısı; bu sayede kodlama agent'ı panel açmadan kimlik bilgilerini okuyabilir, yönlendirmeyi değiştirebilir ve test mesajları gönderebilir. Alıcı için herkese açık bir HTTPS adresi; bu, dağıtım yaptığınız bir barındırma hizmetinden ya da geliştirme sırasında kullandığınız bir tünelden gelir. Ve oluşturduğunuz agent için bir model anahtarı.

İki agent'ı zihninizde ayırın. Claude Code veya Codex inşa edendir: yalnızca siz terminalde onunla çalışırken etkindir. Onun yazdığı program müşterilere yanıt veren programdır ve oturumu kapattıktan sonra da çalışmaya devam eder.

WhatsApp araçlarını Claude Code ve Codex'e nasıl eklersiniz?

Her ikisi de terminalden tek bir URL alır ve OAuth ile oturum açar; dosyaya hiçbir anahtar yazılmaz. Claude Code'da sunucuyu --scope user ile ekleyin ki her projede yüklensin, ardından claude'u başlatın, /mcp komutunu çalıştırın, easycoexistence'ı seçin ve tarayıcıda oturum açın. Codex'te sunucuyu ekleyin ve oturumu saklayan codex mcp login komutunu çalıştırın; codex mcp list neyin yapılandırıldığını gösterir. Codex girişi ~/.codex/config.toml dosyasında tutulur; ChatGPT masaüstü uygulaması ve Codex IDE eklentisi de bu dosyayı okur.

Çalıştığını, yalnızca araçların yanıtlayabileceği bir şeyi sorarak kontrol edin, örneğin "WhatsApp numaralarımı listele". Agent list_numbers çağırır ve her numaranın connection_id değerini alır; diğer tüm araçlar bu değeri kullanır.

Add the server, then sign in
# Claude Code: then start claude and run /mcp to sign in
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp

# Codex: add, store the OAuth sign-in, check
codex mcp add easycoexistence --url https://easycoexistence.com/api/mcp
codex mcp login easycoexistence
codex mcp list

Agent hangi rotayı kurmalı?

Müşterinin mesajını kodunuza taşıyan üç rota var ve kodun ne kadar iş yapması gerektiği bakımından birbirlerinden farklılar. İlk sürüm için Call my webhook adımı en kısa yoldur: easyCoexistence yinelenen mesajları atlar, siz telefondan yanıt verdiğinizde geri çekilir ve uç noktanız çağrılmadan önce 24 saatlik pencereyi kontrol eder; böylece kodunuz yalnızca yanıtı yazar. Agent yalnızca bir otomasyonun seçtiği mesajları değil her olayı istediğinde Forward URL'ye ya da doğrudan hedefe geçin.

Call my webhook stepAn automation POSTs the message and the chat's last 10 messages, signed; return {"reply": "..."} within 20 seconds
Forward URL (Automations on)A signed copy of each Meta event goes to your code; automations keep running; you send through the Graph API
Direct destinationMeta posts straight to your endpoint; easyCoexistence never sees the messages; automations stop for that number

Kodlama agent'ından ne yapması istenmeli?

Ona rotayı, dili ve kuralları baştan verin ve kod yazmadan önce bir plan isteyin. Hangi araç çağrılarını kendi başına yapabileceğini söyleyin: kimlik bilgilerini ve belgeleri okumak zararsızdır, ama mesajların nereye gideceğini değiştirmek canlı numarayı etkiler. get_docs, easyCoexistence'ın belgelerini döndürür; bu belgeler bir alıcının gönderimleri nasıl doğruladığını da içerir, böylece agent kuralları tahmin etmek yerine okuyabilir. Böyle bir istek, tek oturumda gözden geçirebileceğiniz bir alıcı üretir:

A request for Claude Code or Codex
Build a WhatsApp agent in Node.js for my number +55 11 4000 1234.
1. Call list_numbers, then get_api_credentials for that number.
   Put send_endpoint and access_token in .env, never in code.
2. Scaffold an HTTPS server with POST /wa/<long random path>.
   Verify X-EC-Signature (HMAC-SHA256 of "<t>.<raw body>").
   Skip message ids already handled.
   On smb_message_echoes, stay quiet on that chat for 4 hours.
3. Reply with my model only within 24 hours of the
   customer's last message.
4. Write tests for the signature check and the 24-hour rule.
Do not call set_inbound_mode or set_webhook_destination
until I say so.

Alıcıyı nasıl bağlar ve test edersiniz?

Sunucuyu Meta ve easyCoexistence'ın HTTPS üzerinden ulaşabileceği bir yerde başlatın, ardından yönlendirmeyi agent'a yaptırın. Forward URL rotası için, Automations on mode'daki bir numarada agent URL'nizle set_inbound_mode çağırır; forward secret bir kez döner ve agent onu .env dosyanıza yazar. Doğrudan rota için uç nokta önce Meta'nın GET el sıkışmasına yanıt vermelidir; ardından agent, URL'nizle, yolunda uzun ve rastgele bir secret taşıyan adresle ve verify token'ınızla set_webhook_destination çağırır.

Test etmek için işletme numarasına kendi telefonunuzdan mesaj yazın ve kayıtları izleyin: alıcı olayı görmeli, model yanıt vermeli ve yanıt sohbette görünmelidir. Az önce yazdığınız için 24 saatlik pencere açıktır, bu yüzden kodlama agent'ı kendi numaranıza send_message'ı da deneyebilir.

Hazır agent hâlâ MCP sunucusuna ihtiyaç duyar mı?

Hayır. MCP sunucusu, sizin adınıza oturum açmış olan inşa edici aracıdır. Dağıttığınız agent, get_api_credentials'ın döndürdüğü send_endpoint ve access_token ile Meta'nın Graph API'si üzerinden gönderir; access_token, işletmenin kendi WhatsApp varlıklarıyla sınırlı, işletmeye ait bir token'dır ve alımı sizin seçtiğiniz rota üzerinden yapılır. access_token null döndüyse, zaten çalışan bir token'ı değiştirmeden paneldeki numarayı yeniden bağlamak yeni bir tane üretir.

MCP bağlantısını agent'ın çevresindeki işler için tutun: create_template ile şablon oluşturmak, bir şey yanlış göründüğünde get_number_health ile kontrol etmek ve mesajları kodunuza devreden herhangi bir otomasyonun çalışma kaydını okumak.

Nasıl kurulur

  1. Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
  2. Add the server to your coding agentRun the claude mcp add or codex mcp add command, then sign in with /mcp in Claude Code or codex mcp login in Codex.
  3. Ask for credentials and a planHave the agent call list_numbers and get_api_credentials, store the values in .env and propose the receiver before writing it.
  4. Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
  5. Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
  6. Test from your phoneSend the business number a message and check that your agent's reply arrives in the same chat.

Yaygın hatalar

  • İlk 24 saat içinde geçici bir tünelin doğrudan hedef olarak kaydedilmesi. Meta'nın kişilerin ve 6 aya kadar olan sohbetlerin tek seferlik aktarımı bu URL'ye gider ve tünel kapandığında kaybolur.
  • Otomasyon çalıştıran bir numaraya doğrudan hedef ayarlamak. Numara doğrudan moda geçer ve otomasyonları durur; ikisini birlikte tutmak için Automations on mode'da bir Forward URL kullanın.
  • Agent'ın yazdığı .env dosyasını commit etmek. Önce .gitignore'a ekleyin, çünkü erişim token'ını tutan herkes işletme adına müşterilere mesaj gönderebilir.
  • 24 saattir yazmamış bir kişide send_message'ı test etmek. Meta pencerenin dışında serbest metni reddeder, bu yüzden önce numaraya kendi telefonunuzdan mesaj yazın.
Bunu EasyCoexistence'la yapmak

Agent'ınız sonra kendi sunucunuzda çalışır; her numara 24/7 izlenir ve uyarı gönderilir. Bağlı numara başına aylık US$ 9'dan başlayıp numara ekledikçe US$ 0.75'e kadar düşer; ilk 3 gün ücretsizdir.

Sık sorulan sorular

Bu, Cursor veya başka kodlama araçlarında çalışır mı?

Evet. Streamable HTTP üzerinden OAuth ile uzak sunuculara bağlanan her MCP istemcisi aynı URL'yi kullanabilir; buna Cursor, VS Code, Gemini CLI ve Antigravity da dahildir. Değişen yalnızca istemciden istemciye yapılandırma biçimidir.

Agent hangi dilde yazılmalı?

HTTPS sunabilen ve HMAC-SHA256 hesaplayabilen her dil. Node.js ve Python yaygın tercihlerdir; ikisi için de imza kontrolleri, yinelenen mesaj yönetimi ve telefon duraklatmasını içeren test edilmiş örnekler Node.js ve Python agent sayfasındadır.

Kendi Meta uygulamama ya da App Review'a ihtiyacım var mı?

Hayır. Numara easyCoexistence'ın Meta uygulamasıyla Cloud API'ye katılır ve işletmenin kendi portföyünde kalır. Kodunuzun gönderdiği token işletmenin kendi token'ıdır, bu yüzden sizin hiçbir Meta uygulamanız işin içinde değildir.

Kodlama agent'ı, agent'ın ihtiyaç duyduğu şablonları oluşturabilir mi?

Evet, create_template ile; ardından Meta yanıt verene kadar get_template_status çağrılır. Bu genellikle dakikalar içinde, en fazla yaklaşık 24 saat sürer. Agent'ınızın bir konuşma başlatmak ya da 24 saatlik pencere kapandıktan sonra yazmak için onaylı bir şablona ihtiyacı vardır.

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