--- title: "Gunakan ThunderPhone dengan Zapier" description: "Hubungkan aplikasi ThunderPhone di Zapier ke organisasi Anda dan buat Zap yang berjalan setiap kali panggilan berakhir." --- [Zapier](https://zapier.com) menghubungkan aplikasi dengan alur kerja otomatis yang disebut Zap. Aplikasi ThunderPhone di Zapier menambahkan: - **Pemicu:** **Panggilan Selesai** dipicu saat panggilan telepon, web, atau uji berakhir. **Panggilan Dinilai** dipicu saat nilai panggilan yang selesai tersedia. - **Tindakan:** **Lakukan Panggilan Keluar**, **Tambahkan Kontak ke Kampanye**, dan **Mulai Kampanye**. - **Pencarian:** **Cari Panggilan** mencari panggilan berdasarkan ID dan mengembalikannya beserta transkrip dan URL rekaman yang ditandatangani jika tersedia. Temukan di [ThunderPhone di Zapier](https://zapier.com/apps/thunderphone/integrations). Untuk ringkasan kedua cara menggunakan Zapier dengan ThunderPhone, lihat [halaman integrasi Zapier](https://thunderphone.com/integrations/zapier). ## Hubungkan organisasi Anda Aplikasi terhubung melalui OAuth. Anda masuk ke ThunderPhone dan menyetujui akses untuk satu organisasi, tanpa menyalin kunci API ke Zapier. Di editor Zap, cari **ThunderPhone** (ditampilkan dengan label Beta) dan pilih pemicu atau tindakan. Saat Zapier meminta akun, hubungkan akun baru. Zapier membuka jendela masuk ThunderPhone. Masuk, periksa izin yang diminta, pilih organisasi, lalu pilih **Setujui**. Aplikasi meminta izin untuk membaca agen dan nomor telepon Anda, membaca dan menulis panggilan serta kampanye, mengelola integrasi seperti endpoint webhook, dan melihat email akun Anda. Zapier memberi nama koneksi berdasarkan organisasi yang Anda setujui, sehingga Anda dapat membedakan koneksi saat Anda menjadi anggota lebih dari satu organisasi. Hubungkan dengan akun yang memiliki peran admin atau pemilik di organisasi tersebut. Mengaktifkan atau menonaktifkan Zap pemicu, serta setiap tindakan, memerlukan peran tersebut. Zap pemicu yang sudah aktif tetap menerima peristiwa panggilan setelah peran berubah atau koneksi dicabut. Nonaktifkan untuk menghentikannya. Cari Panggilan dapat digunakan oleh anggota mana pun. Aplikasi ini tidak memiliki biaya ThunderPhone tersendiri. Panggilan yang dibuat atau dimulainya ditagihkan sesuai tarif ThunderPhone normal Anda, dan Zapier menghitung tugas dalam paket Zapier Anda. ## Buat Zap pertama Zap ini menambahkan baris ke Google Sheet setiap kali panggilan berakhir. Buka agen di builder, klik **Bicara**, lalu akhiri panggilan. Panggilan pengujian builder memicu Panggilan Selesai, sehingga pemicu memiliki panggilan terbaru untuk dimuat. Pilih **ThunderPhone** sebagai aplikasi pemicu, atur peristiwa ke **Panggilan Selesai**, lalu pilih koneksi ThunderPhone Anda. Uji pemicu. Zapier memuat panggilan selesai terbaru Anda sebagai contoh, dengan format yang sama seperti peristiwa langsung. Tambahkan tindakan Google Sheets yang membuat baris spreadsheet. Pilih sheet dengan baris header, lalu petakan setiap kolom ke field dari pemicu (lihat tabel di bawah). Publikasikan dan aktifkan Zap. Mengaktifkannya membuat endpoint webhook di organisasi ThunderPhone Anda bernama **Zapier: Panggilan Selesai**. Menonaktifkan Zap menghapus endpoint tersebut. Lakukan panggilan pengujian builder lagi. Saat panggilan berakhir, Zap berjalan dan sebuah baris muncul. Kolom yang berguna: | Kolom | Field Panggilan Selesai | |---|---| | ID Panggilan | ID Panggilan | | Agen | Nama Agen | | Arah | Arah | | Dari | Nomor Dari | | Ke | Nomor Ke | | Dimulai | Dimulai Pada | | Berakhir | Berakhir Pada | | Durasi (dtk) | Durasi dalam Detik | | Status | Status | | Alasan berakhir | Alasan Berakhir | | Tautan panggilan | Ketik `https://app.thunderphone.com/dashboard/call-history/`, lalu masukkan ID Panggilan | Tautan panggilan membuka panggilan di dasbor ThunderPhone untuk anggota organisasi Anda, beserta transkrip dan rekamannya, sehingga sheet tidak perlu menyimpan keduanya. Peristiwa juga dapat memuat transkrip, sebagai daftar giliran percakapan, dan URL Rekaman, yaitu tautan bertanda tangan yang kedaluwarsa. Tambahkan hanya jika sheet memerlukannya. Transkrip, ringkasan, dan rekaman panggilan dapat berisi informasi pribadi atau kesehatan. Kirimkan hanya ke aplikasi yang diizinkan digunakan oleh organisasi Anda untuk data tersebut, berdasarkan BAA jika melibatkan informasi kesehatan, dan simpan hanya field yang Anda perlukan. Lihat [`telephony.complete` / `web.complete`](/id/webhooks/call-complete) untuk setiap field. Setiap pengiriman ditandatangani. Aplikasi memeriksa HMAC `X-ThunderPhone-Signature` terhadap rahasia endpoint sebelum Zap berjalan dan menghentikan proses untuk pengiriman yang tidak ditandatangani atau tidak valid. Jika Zapier tidak menerima pengiriman, ThunderPhone mencoba ulang hingga 24 jam. Lihat [ringkasan Webhook](/id/webhooks/overview). ## Pemicu, tindakan, dan pencarian **Panggilan Dinilai** memberikan ID Panggilan, ID Agen, Nama Agen, serta penilaian: ID Penilaian, Skor, Hasil Panggilan, Ringkasan, Model Penilai, dan Waktu Penilaian. Mengaktifkan Zap membuat endpoint bernama **Zapier: Panggilan Dinilai**. Panggilan dapat dinilai lebih dari sekali, dan setiap proses penilaian yang selesai memicu pemicu. Lihat [`call.graded`](/id/webhooks/events). **Temukan Panggilan** menerima ID Panggilan, dengan menu dropdown berisi panggilan terbaru. Tindakan ini mengembalikan agen panggilan, arah, nomor, waktu mulai dan selesai, status, alasan berakhir, skor penilaian dan hasil panggilan, transkrip, serta URL rekaman yang ditandatangani jika tersedia. ID Panggilan yang tidak dikenal tidak mengembalikan hasil, bukan error. **Lakukan Panggilan Keluar** menerima: | Bidang | Arti | |---|---| | Agen | Agen yang disimpan. Menu dropdown mencantumkan agen Anda. | | Nomor Tujuan | Tujuan dalam format E.164, seperti `+14155552671`. | | Nomor Asal | Menu dropdown hanya mencantumkan nomor yang diaktifkan untuk panggilan keluar. | | Variabel | Objek JSON opsional berisi nilai untuk placeholder dalam Prompt agen. | | Kunci Idempotensi | ID stabil dari pemicu atau rekaman sumber. Wajib diisi. | Tindakan ini mengembalikan ID Panggilan, Status, dan Pemutaran Ulang Idempoten. **Tambahkan Kontak ke Kampanye** menambahkan kontak ke kampanye draf. Untuk satu kontak, isi **Nomor Telepon** dalam format E.164 dan, secara opsional, **Variabel Kontak**, yaitu objek JSON yang propertinya menjadi variabel kampanye. Untuk batch, isi **JSON Kontak** dengan array hingga 5.000 objek. Setiap objek memerlukan `phone_number`, dan propertinya yang lain menjadi variabel. Langkah ini gagal jika setiap kontak ditolak, dan menetapkan **Keberhasilan Parsial** jika hanya sebagian yang diterima. **Mulai Kampanye** memulai atau melanjutkan kampanye yang memiliki setidaknya satu kontak. Tindakan ini memerlukan **Persetujuan Pembebanan Biaya**. Lihat [Kampanye keluar](/id/guides/outbound-campaigns). ## Sebelum Zap melakukan panggilan Lakukan Panggilan Keluar dan Mulai Kampanye menghubungi nomor telepon nyata dan memulai panggilan berbiaya. - Jika ThunderPhone meminta organisasi Anda untuk mengonfirmasi bahwa panggilan keluarnya mematuhi TCPA dan undang-undang panggilan lainnya, administrator harus mencatatkan konfirmasi tersebut di dashboard sebelum Zap dapat memulai panggilan. - Nomor Asal harus diaktifkan untuk panggilan keluar. Nomor yang Anda bawa dari operator sendiri memenuhi syarat setelah diverifikasi. Nomor yang disediakan ThunderPhone pada awalnya hanya untuk panggilan masuk, dan Anda dapat meminta akses panggilan keluar untuk nomor tersebut di dashboard. Lihat [Dapatkan nomor telepon](/id/guides/get-a-phone-number). - Lakukan Panggilan Keluar memerlukan **Kunci Idempotensi**. Petakan ID stabil dari pemicu atau rekaman sumber, seperti ID peristiwa ThunderPhone atau ID rekaman CRM. Jika Zapier mencoba ulang langkah tersebut, ThunderPhone mengenali kunci itu dan mengembalikan panggilan asli alih-alih melakukan panggilan kedua. Hindari stempel waktu, nilai acak, atau ID Zap saja. - Mulai Kampanye memerlukan **Persetujuan Pembebanan Biaya**, yang mengonfirmasi bahwa Zap dapat memulai panggilan keluar berbiaya pada akun Anda. - Organisasi Anda bertanggung jawab untuk memiliki persetujuan untuk menghubungi setiap nomor dan mematuhi undang-undang panggilan yang berlaku. Lihat [undang-undang panggilan keluar](/id/guides/outbound-calling-laws). Kunci idempotensi bersifat unik di seluruh organisasi Anda dan dapat berisi maksimal 128 karakter. Menggunakan kembali kunci dengan agen, nomor, atau variabel yang berbeda akan gagal karena konflik, jadi jika dua Zap dapat menghubungi terkait rekaman yang sama, berikan setiap Zap prefiks tetapnya sendiri sebelum ID rekaman. [Lakukan panggilan keluar](/id/guides/place-outbound-calls) membahas API di balik tindakan ini. ## Contoh Zap - **Panggilan Selesai ke CRM.** Catat aktivitas untuk setiap panggilan yang selesai beserta status, alasan berakhir, dan transkripnya. - **Panggilan Dinilai untuk tindak lanjut.** Filter berdasarkan hasil atau skor panggilan dan arahkan panggilan ke alur kerja tindak lanjut yang tepat. - **Prospek baru ke kampanye.** Tambahkan prospek ke kampanye draf dengan Tambahkan Kontak ke Kampanye, lalu jalankan Mulai Kampanye setelah seseorang menyetujui daftar tersebut. Transkrip, ringkasan, dan rekaman panggilan dapat berisi informasi pribadi atau kesehatan. Kirimkan hanya ke aplikasi yang diizinkan organisasi Anda gunakan untuk data tersebut, berdasarkan BAA jika melibatkan informasi kesehatan, dan simpan hanya kolom yang Anda perlukan. ## Pemecahan masalah **Sebuah langkah gagal dengan kesalahan otorisasi.** Sambungkan kembali koneksi ThunderPhone di Zapier dan setujui lagi. Koneksi berhenti berfungsi saat orang yang menghubungkannya mencabutnya di ThunderPhone melalui **Organisasi → Kunci → Aplikasi yang diotorisasi**, saat orang tersebut keluar dari organisasi, atau saat koneksi tersebut berjalan 30 hari tanpa pembaruan token yang berhasil. Lihat [Hubungkan dengan OAuth](/id/guides/oauth). **Mengaktifkan atau menonaktifkan Zap gagal, atau sebuah tindakan ditolak.** Orang yang menghubungkan memerlukan peran admin atau pemilik di organisasi. Sambungkan kembali menggunakan akun yang memiliki peran tersebut. Zap pemicu yang sudah aktif tetap menerima peristiwa panggilan setelah peran berubah atau koneksi dicabut. Nonaktifkan untuk menghentikannya. **Anda ingin memutuskan aplikasi.** Nonaktifkan Zap ThunderPhone Anda sebelum mencabut koneksi, karena menonaktifkan Zap menghapus endpoint-nya dan memerlukan koneksi yang berfungsi. Jika Anda mencabutnya terlebih dahulu, hapus endpoint **Zapier: …** yang tersisa dengan `DELETE /v1/developer/webhook-endpoints/{id}` menggunakan kunci API admin. Lihat [Endpoint webhook](/id/webhooks/endpoints). **Zap harus menggunakan organisasi yang berbeda.** Setiap koneksi mencakup satu organisasi. Nonaktifkan Zap terlebih dahulu agar endpoint webhook-nya dihapus dari organisasi saat ini. Kemudian hubungkan akun ThunderPhone baru di Zapier, pilih organisasi lain saat Anda menyetujui, dan pilih koneksi tersebut pada setiap langkah ThunderPhone. Agen, nomor, dan kampanye berbeda antarorganisasi, jadi pilih kembali **Agen**, **Nomor Asal**, dan **Kampanye** pada setiap langkah yang memilikinya. Kemudian aktifkan kembali Zap. **Pemicu berhenti berjalan.** Setiap Zap dengan pemicu ThunderPhone memiliki satu endpoint webhook di organisasi Anda, bernama **Zapier: Panggilan Selesai** atau **Zapier: Panggilan Dinilai**. Endpoint dibuat saat Zap diaktifkan dan dihapus saat Zap dinonaktifkan. Biarkan sebagaimana adanya. Jika endpoint diedit atau dihapus di ThunderPhone, nonaktifkan lalu aktifkan kembali Zap untuk membuat endpoint baru. Dengan kunci API admin, [`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries) menampilkan upaya pengiriman terbaru. Ingin agen menggunakan aksi Zapier selama panggilan, alih-alih setelahnya? Hubungkan endpoint MCP Zapier melalui **Koneksi → MCP**. Lihat [server MCP](/id/guides/mcp-servers). Untuk mengirim peristiwa panggilan yang sama ke server Anda sendiri, lihat [Endpoint webhook](/id/webhooks/endpoints).