Geliştiriciler > Kimlik Bilgileri bölümünde messages:write entegrasyonu için bir token oluşturun. Oluştururken kopyalayın, backend'inizde saklayın ve göndermeden önce kontrol panelinde WhatsApp bağlantısını yapılandırın.
API Geliştiricisi
WhatsApp'ı sistemlerinize ve uygulamalarınıza bağlamak için API.
CRM, ERP, uygulamalar ve dahili sistemleri WPP Marketing REST API ile WhatsApp’a entegre edin. Metin ve medya gönderin, mesajları sorgulayın ve teslimatları webhook'lar aracılığıyla takip edin. Akışlarınızı Official API ile entegre etmek için MCP’yi de kullanın. MCP hakkında bilgi edinin.
Ne zaman kullanılır
Sisteminizin WhatsApp mesajı göndermesi gerektiğinde mesajlaşma API'sini kullanın.
Bir ileti başlatmak için CRM'inizi, bir güncelleme göndermek için ERP'nizi veya bir müşteriyi bilgilendirmek için uygulamanızı kullanın. Ne zaman gönderileceğine dair mantık sisteminizde kalır; API, hesapta yapılandırılmış bağlantı üzerinden gönderimi gerçekleştirir. Hazır ticari otomasyonlar için Events API'yi kullanın.
Metin için POST /send-text veya medya için POST /send-media kullanın. Resmî bağlantıda metin ve görsel yapılandırılmış şablonları kullanır; ses, video ve belgeler için son 24 saat içinde müşteriden alınmış bir mesaj gereklidir.
HTTP 200 kabulü gösterir, teslimatı değil. messages:read ile GET /messages kullanın ve kanal için mevcut durumları kontrol edin.
HTTPS URL'sini kaydedin ve panoda etkinlikleri etkinleştirin. GET /webhooks üzerinde denemeleri sorgulamak için webhooks:read kullanın; bu uç nokta teslimatları listeler, abonelikleri kaydetmez.
Token'den ilk dahil gönderime kadar.
Sunucunuzda SEU_TOKEN yerine kimlik bilgilerini ve numara yerine test için yetkili alıcıyı koyun. Gönderim başına benzersiz bir anahtar kullanın ve aynı isteği tekrarlıyorsanız aynı anahtarı yeniden kullanın.
HTTP durumunu ve yanıt gövdesini kontrol edin. 401 için token ve geçerliliğini gözden geçirin; 403 için kapsamları (scopes) ve hesap koşullarını kontrol edin. 409 için anahtarın başka bir içerikle zaten kullanılıp kullanılmadığını kontrol edin. 429 için yeniden denemeden önce Retry-After’a uyun.
Ardından messages:read ile GET /messages'i kontrol edin veya yapılandırılmış webhook'ları izleyin. Teslimat onayı kanalın yanıtına bağlıdır.
cURLPOST /send-text
curl --request POST 'https://api.wppmarketing.com/send-text' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: pedido-10231-aviso-1' \
--data '{"number":"5511999999999","body":"Olá! Seu pedido foi atualizado."}'Metin, medya, gönderim geçmişi ve izleme.
WhatsApp’ı uygulamanıza entegre etmek için REST uç noktalarını kullanın. WPP Marketing API, hesapta yapılandırılmış bağlantıyı kullanır; Resmi WhatsApp API ile çalışmak için bu bağlantıyı panelde yapılandırın. Her işlemin formatları, kapsamları, sınırları ve yanıtları için OpenAPI’ye bakın.
POST
/send-text
Bir WhatsApp numarasına metin mesajı gönderir.
Texto
POST
/send-media
Görsel, ses, video veya belgeyi kamuya açık HTTPS URL'si ile gönderin; format ve bağlantı koşullarına uygun olarak. Ses için aynı uç nokta kullanılır.
Mídia
GET
/messages
Durum ve sayfalama ile gönderilen mesajların geçmişini kontrol edin.
Histórico
GET
/webhooks
Olay, HTTP sonucu, denemeler ve sayfalama ile webhook teslimatlarını kontrol edin.
Webhooks
DOC
Swagger / OpenAPI
Sözleşmeler, örnekler, zorunlu alanlar ve beklenen yanıtlarla etkileşimli dokümantasyon.
Docs
Teknik ayırma
Entegrasyonun her aşaması için doğru özelliği seçin.
Mesajları Messaging API ile gönderin, Events API ile ticari otomasyonları tetikleyin ve geri bildirimleri webhooks ile alın. Uygulamanız gerekli akışa göre bu özellikleri birleştirebilir.
Resmi bağlantı iletişim kanalıdır; WPP Marketing API, sisteminiz tarafından kullanılan arayüzdür. Gereksinimler için bakınız Resmi WhatsApp API ve birlikte varoluş.
Sisteminiz, metin veya medya mesajları göndermek ve mesaj geçmişlerini ile webhook teslimatlarını sorgulamak için WPP Marketing'i çağırır.
Sisteminiz, sipariş oluşturuldu, ödeme onaylandı, gönderim veya terk edilmiş sepet gibi ticari etkinlikler gönderir.
Kullanılabilir olayları ve otomasyonları anlayınWPP Marketing, sizin sağladığınız bir URL'ye oluşturma, teslim, okuma ve hata ile ilgili standartlaştırılmış olaylar gönderir.
İade olaylarını ve teslimat takibini görüntüleyinÜretime almadan önce payloadları, kimlik doğrulamayı ve yanıtları doğrulamak için etkileşimli dokümantasyonu kullanın.
Jetonlar backend'de kalmalıdır. Kimlik bilgilerini herkese açık sayfalarda, ön uç uygulamalarda veya depolarda açığa çıkarmayın.
/send-text ve /send-media içinde, Idempotency-Key aynı isteği başarılı yanıtla 48 saate kadar tekrarlamanıza olanak tanır. Anahtarı farklı içerikle yeniden kullanmak 409 döndürür. Anahtar olmadan çağrıyı tekrarlamak gönderimin çoğalmasına neden olabilir. RateLimit ve Retry-After başlıklarına uyun; istek limitleri plan kotasından farklıdır.
Gerekli izinlerle her entegrasyon için bir kimlik bilgisi.
Panosunda tokena bir ad verin, kapsamları (scopes) seçin ve isteğe bağlı bir süresi dolma tarihi belirleyin. Tam token oluşturulurken yalnızca bir kez gösterilir. Liste, son kullanımı, süresini ve gerektiğinde erişimi iptal etmeyi kontrol etmenizi sağlar.
Bir kimlik bilgisi değiştirildiğinde, sunucunuzdaki gizli anahtarı güncelleyin ve önceki olanı iptal edin. WhatsApp sağlayıcı tokenını API kimlik bilgisi yerine asla kullanmayın.
Metin ve medya göndermeye izin verir. Yalnızca gönderim başlatması gereken entegrasyonlara verin.
Bunlar sırasıyla mesaj geçmişi ve webhook teslimatlarını görüntülemeyi sağlar. Bir gönderim kimliği bu izinleri otomatik olarak almaz.
Hesapta yapılandırılmış otomasyonlara Events API aracılığıyla müşterileri, sepetleri ve siparişleri bildirmeye olanak tanır.
Tanı için kaydedilmiş ayarları, otomasyonları, sayımları ve son kayıtları inceler. Kişisel veriler ve mesaj içeriği içerebilir: yalnızca yetkili entegrasyonlara ve desteğe verin. Bu sorgu sağlayıcı bağlantısını canlı olarak doğrulamaz.
MCP ve Resmi WhatsApp API'si.
WPP Marketing'in MCP'si ile AI araçlarını WhatsApp operasyonunuza bağlayın. WhatsApp'ı asistanlarınızın ve temsilcilerinizin iş akışlarına entegre edin; mesajlaşma bağlantısı olarak Official API'yi kullanın.
MCP, ajanlarınızın akışlarını entegrasyona bağlar; mesajlaşma API'si gönderimleri gerçekleştirir ve resmi bağlantı WhatsApp kurallarına uyar. Bu, MCP'yi yerel bir chatbot yapmaz ve hesap yapılandırmasının yerine geçmez. Ekip, kullanım durumunuz için entegrasyon eylemlerini ve gereksinimleri yönlendirir.
MCP'yi AI araçları ile WhatsApp arasında entegrasyon yolu olarak kullanın; sistemlerinizin ve ekibinizin akışlarını tamamlar.
Kullandığınız AI aracını ve WhatsApp'a bağlamak istediğiniz eylemleri ekibimizle görüşün. İşleminiz için gereksinimleri ve uygun kapsamı kontrol edin.
MCP entegrasyonundan bahsetSisteminizin WPP Marketing ile entegre olmaya hazır mı?
Messaging API uç noktalarını, payload örneklerini, bearer token kimlik doğrulamasını ve beklenen yanıtları görüntülemek için Swagger’ı açın. Mağaza olayları ve teslimat geri bildirimi için ayrıca bakın Events API ve Webhooks de status.