Dokumentasi pengembang

Build pada Tech Pad API.

Kirim pesan template WhatsApp dari sistem Anda sendiri, terima kejadian pengiriman dengan webhook dan monitor setiap permintaan dalam log.

Plugin WordPress bebas

Lewati kode - instal plugin konektor.

Apapun yang dilakukan Bisnis API, yang dibungkus dengan plugin konektor bebas untuk alat-alat yang telah Anda pakai - setiap bentuk, pemesanan, acara dan platform toko mengirim langsung ke WhatsApp Anda. Pasang, hubungkan dengan email Anda, selesai.

Cepat mulai

Dari nol ke disampaikan pesan WhatsApp dalam empat langkah. Semuanya di sini juga bekerja di dalam aplikasi Pengembang Tampilan DalfName halaman, yang melacak kemajuan Anda.

1

Buat suatu kunci API

Buka Pengembang tombol API dalam app dan membuat kunci (awalan ttp_live_). Rahasia penuh ditampilkan sekali - segera salin.

2

Pilih template yang telah disetujui

Area kerja Anda perlu setidaknya satu Templat yang disetujui Meta- (lihat Templat). Templat langsung menyegarkan dari Meta.

3

Kirim permintaan tes

Gunakan in- app penguji API atau permintaan di bawah ini. Penerima mesti telah dipilih untuk menerima pesan template dari nomor Anda.

4

Tambah sebuah webhook pengiriman

Arahkan sebuah webhook di titik akhir HTTPS Anda, pilih kejadian yang Anda pedulikan, dan lihat Log Webhook konfirmasi pengiriman.

Otentikasi

API terotentikasi dengan kunci API per area kerja yang dikirim sebagai token pembawa. Kunci dibuat dan dicabut dari Pengembang tombol API.

  • Tombol dimulai dengan ttp_live_ dan diskop ke satu area kerja.
  • Buat kunci terpisah per integrasi - masing-masing kunci trek sendiri last used Timticap.
  • Rahasia penuh hanya ditampilkan sekali pada penciptaan, itu tidak dapat ditemukan nanti. Mengcabut dan menciptakan kembali sebagai gantinya.
  • Kirim kunci di Authorization tajuk: Authorization: Bearer ttp_live_…
Jangan pernah mengekspos kunci API Anda dalam kode sisi-klien, aplikasi mobile atau repositori publik. Kunci ditujukan untuk server kalian sendiri dan hanya untuk keamanan.

Kirim pesan

Mengirim pesan ke satu penerima yang telah disetujui dari nomor yang tersambung di area kerja Anda.

POST https://v1.thetechpad.com/functions/v1/api-send

Tajuk: Authorization: Bearer ttp_live_… · Content-Type: application/json

Meminta tubuh

RuasTipeDeskripsi
phoneNumberIdstringID dari nomor WhatsApp yang tersambung di area kerja Anda (Halaman nomor WhatsApp).
tostringNomor telepon Penerima dalam format E.164, misalnya 15551234567.
template.namestringNama dari template yang disetujui Meta- di area kerja Anda, misalnya order_update.
template.languagestringKode bahasa plat, misalnya en.
template.parametersarray < string >Nilai posisi untuk variabel template, dalam urutan.

Permintaan contoh

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'] }
  })
});
Peraturan plat berlaku. Pesan harus memakai template yang telah disetujui dan penerima harus dipilih (yang dipilih). Meta validasi dan biaya untuk setiap pesan template disampaikan - mereka biaya ditagih secara terpisah oleh Meta, di luar rencana Tech Pad Anda.

Pengait Web

Outbound webhook push message lifecycle events to your HTTPS endpoint in nearly real time. Kelola titik akhir dari Pengembang Pengait Web - tambahkan, edit, jeda, tes dan hapus.

Kejadian

PeristiwaKebakaran ketika
message.sentSebuah pesan diterima dan dikirim oleh platform WhatsApp.
message.deliveredPesan itu dikirim ke alat penerima.
message.readPenerima membaca pesan.
message.failedPesan gagal (tak terantar, templat ditolak, batas pengirim,...).
message.receivedPesan inbound tiba dari pelanggan.
  • Endpoints harus HTTPS dan bisa dihubungi dari internet.
  • Setiap titik akhir subsatoring ke bagian yang dipilih dari peristiwa; setiap peristiwa kebakaran dengan muatan JSON berisi id dan status pesan.
  • Gunakan Uji di titik akhir untuk mengirim sample pengiriman dan memverifikasi handler Anda.
  • Titik akhir yang diistirahatkan menjaga konfigurasi mereka tapi berhenti menerima kejadian.

Batas rate

Pesan dikirim sesuai dengan tingkat paket rencana Anda. Secara aktual melalui dapat lebih rendah ketika Meta berlaku messaging-tier, kualitas telepon atau akunta- batas tingkat. Pesan tetap antrian aman daripada dibuang.

RencanaPanggilan API / bulanLaju pengiriman dasar
Pemulai Kampanye—Sampai 6 pesan / menit
Luncurkan10,000Laju paket
Grow200,000Laju paket
Skala2,000,000Laju paket

Setiap permintaan dihitung terhadap kuota API-call anda dan direkam dalam log API dengan kode status dan durasi.

Log & pemantauan

Pengembang GNU Log terus dua tampilan:

  • Log API - setiap permintaan API: metode, titik akhir, status HTTP, template yang digunakan dan durasi.
  • Log Webhook - setiap usaha pengiriman webhook dan hasilnya.

Gunakan mereka untuk debug gagal mengirim, konfirmasi pengiriman webhook dan audit integrations berakhir.

Galat

Permintaan sukses mengembalikan 2xx status. Iklan mengembalikan status non2xx dengan tubuh JSON menjelaskan masalah:

{
  "error": "Template not approved",
  "hint": "Check the template status in Templates — only APPROVED templates can be sent."
}
StatusArtinya
2xxPermintaan diterima / diproses.
400Permintaan salah bentuk - ruas hilang atau tidak valid.
401Kehilangan atau kunci API yang tak valid.
403Kunci valid tapi tak diijinkan bagi aksi atau area kerja ini.
404Nomor, template, atau sumber daya tidak diketahui.
429Batas rate atau kuota terlampaui - coba setelah backoff.
5xxGalat platform - coba lagi; periksa log API dan halaman status.

Coba API dari konsol.

Penguji API in- app menghasilkan curl, JavaScript dan PHP untuk setiap permintaan.

Obrolan dengan kami