Şunun üzerine inşa edin Tech Pad API.

Hızlı başlangıç

Sıfırdan dört adımda teslim edilmiş bir WhatsApp mesajına. Buradaki her şey ayrıca uygulamanın içinde de çalışır Geliştiriciler → Genel Bakış sayfası, ilerlemenizi takip eder.

Kimlik doğrulama

API, bearer token olarak gönderilen her çalışma alanına özel API anahtarları ile doğrulanır. Anahtarlar oluşturulur ve iptal edilir Geliştiriciler → API anahtarları.

• Anahtarlar ile başlar ttp_live_ ve tek bir çalışma alanı ile sınırlıdır.
• Her entegrasyon için ayrı bir anahtar oluşturun — her anahtar kendi last used zaman damgasını takip eder.
• Tam gizli anahtar yalnızca oluşturulurken bir kez gösterilir; daha sonra geri alınamaz. Bunun yerine iptal edip yeniden oluşturun.
• Anahtarı Authorization başlıkta gönderin: Authorization: Bearer ttp_live_…

Mesaj gönder

Bağlı numaranızdan çalışma alanınızdaki bir opt-in alıcıya onaylanmış bir WhatsApp şablon mesajı gönderir.

İstek gövdesi

Örnek istek

curl -X POST 'https://v1.thetechpad.com/functions/v1/api-send' \
  -H 'Authorization: Bearer ttp_live_...' \
  -H 'Content-Type: application/json' \
  -d '{
  "phoneNumberId": "1122334455",
  "to": "15551234567",
  "template": {
    "name": "order_update",
    "language": "en",
    "parameters": ["Ava", "#4031"]
  }
}'

// JavaScript
const response = await fetch('https://v1.thetechpad.com/functions/v1/api-send', {
  method: 'POST',
  headers: { Authorization: 'Bearer ttp_live_...', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    phoneNumberId: '1122334455',
    to: '15551234567',
    template: { name: 'order_update', language: 'en', parameters: ['Ava', '#4031'] }
  })
});

Webhook'lar

Giden web kancaları, mesaj yaşam döngüsü olaylarını HTTPS uç noktanıza neredeyse gerçek zamanlı olarak iletir. Uç noktaları şu adresten yönetin Geliştiriciler → Webhooks — ekleyin, düzenleyin, duraklatın, test edin ve silin.

Olaylar

• Uç noktalar şunlar olmalıdır HTTPS ve internetten erişilebilir.
• Her uç nokta, seçilen bir etkinlik alt kümesine abone olur; her etkinlik, mesaj kimliği ve durumu içeren bir JSON yükü ile tetiklenir.
• Kullanım Test Bir örnek teslimat göndermek ve işleyicinizi doğrulamak için bir uç noktada kullanın.
• Durdurulmuş uç noktalar yapılandırmalarını korur ancak etkinlik almayı durdurur.

Hız sınırları

Mesajlar, planınızdaki paket hızınıza kadar gönderilir. Meta mesajlaşma seviyesi, telefon kalitesi veya hesap düzeyindeki sınırlamaları uyguladığında gerçek verimlilik daha düşük olabilir. Mesajlar kalır güvenli bir şekilde kuyruğa alındı atılmak yerine.

Her istek API çağrı kotanıza sayılır ve durum kodu ile süresiyle birlikte API günlüklerine kaydedilir.

Kayıtlar ve izleme

Geliştiriciler → Günlükler iki görünüm sağlar:

• API günlükleri — her API isteği: yöntem, uç nokta, HTTP durumu, kullanılan şablon ve süre.
• Webhook günlükleri — her webhook gönderim denemesi ve sonucu.

Başarısız gönderimleri hata ayıklamak, webhook gönderimini doğrulamak ve entegrasyonları baştan sona denetlemek için bunları kullanın.

Hatalar

Başarılı istekler bir 2xx durum döner. Başarısızlıklar, sorunu açıklayan bir JSON gövdesi ile birlikte 2xx olmayan bir durum döner:

{
  "error": "Template not approved",
  "hint": "Check the template status in Templates — only APPROVED templates can be sent."
}