Build pada Tech Pad API.
Kirim pesan template WhatsApp dari sistem Anda sendiri, terima kejadian pengiriman dengan webhook dan monitor setiap permintaan dalam log.
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.
Buat suatu kunci API
Buka Pengembang tombol API dalam app dan membuat kunci (awalan ttp_live_). Rahasia penuh ditampilkan sekali - segera salin.
Pilih template yang telah disetujui
Area kerja Anda perlu setidaknya satu Templat yang disetujui Meta- (lihat Templat). Templat langsung menyegarkan dari Meta.
Kirim permintaan tes
Gunakan in- app penguji API atau permintaan di bawah ini. Penerima mesti telah dipilih untuk menerima pesan template dari nomor Anda.
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 usedTimticap. - Rahasia penuh hanya ditampilkan sekali pada penciptaan, itu tidak dapat ditemukan nanti. Mengcabut dan menciptakan kembali sebagai gantinya.
- Kirim kunci di
Authorizationtajuk:Authorization: Bearer ttp_live_…
Kirim pesan
Mengirim pesan ke satu penerima yang telah disetujui dari nomor yang tersambung di area kerja Anda.
https://v1.thetechpad.com/functions/v1/api-send
Tajuk: Authorization: Bearer ttp_live_… · Content-Type: application/json
Meminta tubuh
| Ruas | Tipe | Deskripsi |
|---|---|---|
phoneNumberId | string | ID dari nomor WhatsApp yang tersambung di area kerja Anda (Halaman nomor WhatsApp). |
to | string | Nomor telepon Penerima dalam format E.164, misalnya 15551234567. |
template.name | string | Nama dari template yang disetujui Meta- di area kerja Anda, misalnya order_update. |
template.language | string | Kode bahasa plat, misalnya en. |
template.parameters | array < 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'] }
})
});
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
| Peristiwa | Kebakaran ketika |
|---|---|
message.sent | Sebuah pesan diterima dan dikirim oleh platform WhatsApp. |
message.delivered | Pesan itu dikirim ke alat penerima. |
message.read | Penerima membaca pesan. |
message.failed | Pesan gagal (tak terantar, templat ditolak, batas pengirim,...). |
message.received | Pesan 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.
| Rencana | Panggilan API / bulan | Laju pengiriman dasar |
|---|---|---|
| Pemulai Kampanye | — | Sampai 6 pesan / menit |
| Luncurkan | 10,000 | Laju paket |
| Grow | 200,000 | Laju paket |
| Skala | 2,000,000 | Laju 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."
}
| Status | Artinya |
|---|---|
2xx | Permintaan diterima / diproses. |
400 | Permintaan salah bentuk - ruas hilang atau tidak valid. |
401 | Kehilangan atau kunci API yang tak valid. |
403 | Kunci valid tapi tak diijinkan bagi aksi atau area kerja ini. |
404 | Nomor, template, atau sumber daya tidak diketahui. |
429 | Batas rate atau kuota terlampaui - coba setelah backoff. |
5xx | Galat 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.