Twilio ialah pembekal telekomunikasi antarabangsa. Ia membolehkan bot menghubungi pelanggan dan menyambungkan mereka dengan pekerja anda di mana-mana daripada 100+ negara yang menawarkan nombor telefon Twilio, termasuk Mexico, Brazil, Turki, Sepanyol, Jerman, Perancis, UAE, Thailand, Malaysia, dan banyak lagi.

Apa yang anda dapat selepas menyambungkan Twilio:

  • menghubungi pelanggan dengan satu klik terus dari kad perbualan;
  • panggilan automatik berasaskan skenario — bot menghubungi pelanggan dan membaca mesej teks dengan kuat;
  • panggilan kumpulan — bot menghubungi pelanggan dan menyambungkan mereka dengan pekerja pertama yang tersedia;
  • rakaman semua panggilan, dengan pautan rakaman disimpan dalam pemboleh ubah pesanan;
  • peristiwa panggilan (berdering, dijawab, selesai) terus dalam perbualan — anda boleh menggunakannya untuk membina skenario.

Langkah 1. Buat Akaun dan Beli Nombor

  1. Daftar di twilio.com dan lengkapkan proses pengesahan.
  2. Dalam Konsol Twilio, buka Phone Numbers → Buy a number dan pilih nombor di negara yang anda perlukan. Pastikan Voice diaktifkan — sesetengah nombor hanya menyokong SMS dan tidak boleh digunakan untuk panggilan.

Langkah 2. Salin Kredensial Akses Anda

Pada halaman utama Konsol Twilio, di bawah Account Info, anda akan menemui dua nilai:

Item Rupa bentuknya
Account SID ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Auth Token tersembunyi; klik Show untuk mendedahkannya

⚠️ Salin Auth Token tepat seperti yang dipaparkan, tanpa sebarang ruang tambahan sebelum atau selepasnya. Kami menggunakannya untuk mengesahkan keaslian setiap permintaan daripada Twilio. Satu aksara tambahan yang tidak kelihatan boleh menyebabkan panggilan berfungsi tetapi peristiwa panggilan tidak muncul dalam perbualan.

Auth Token memberikan akses penuh kepada akaun Twilio anda dan dana di dalamnya. Jangan hantarnya melalui aplikasi mesej atau terbitkannya di mana-mana.

Langkah 3. Sambungkan Twilio dalam Akaun Anda

Buka Project → Integrations → Telephony → Twilio dan isi tiga medan:

Medan Apa yang perlu dimasukkan
Account SID daripada Langkah 2
Auth Token daripada Langkah 2
Twilio Number nombor yang anda beli, dalam format antarabangsa: +14155550100

Nombor mesti dimasukkan dalam format E.164: +, kod negara, dan nombor telefon, tanpa ruang, kurungan, atau tanda sempang.

Selepas menyimpan, URL panggil balik akan muncul pada halaman. Salinnya. Kemudian buka tetapan untuk nombor yang anda beli dalam Konsol Twilio dan, di bawah Voice & Fax, konfigurasikan:

  • A call comes in → Webhook → tampal URL yang disalin dan pilih HTTP POST.

Tanpa konfigurasi ini, panggilan keluar akan berfungsi, tetapi panggilan masuk dan peristiwa panggilan dalam perbualan tidak akan.

Untuk memutuskan integrasi, kosongkan medan Account SID dan simpan tetapan.

Langkah 4. Tambah Nombor Telefon Pekerja

Twilio menghubungi pekerja melalui nombor telefon biasa — tiada sambungan dalaman di sini.

Buka tab Team, pilih pekerja, dan isi medan Twilio Phone Number dengan nombor telefon penuh mereka dalam format yang sama:

+905551112233

Tanpa nombor ini, butang panggilan dalam kad pelanggan tidak akan berfungsi untuk pekerja tersebut.

Memanggil dari Kad Pelanggan

Butang panggilan akan muncul di sebelah nombor telefon pelanggan dalam kad perbualan. Mengkliknya memulakan urutan berikut:

  1. Twilio menghubungi pekerja — pekerja melihat nombor Twilio anda sebagai ID pemanggil.
  2. Pekerja menjawab panggilan.
  3. Hanya selepas itu Twilio menghubungi pelanggan dan menyambungkan kedua-dua pihak.

Urutan ini disengajakan: pelanggan tidak perlu mendengar deringan semasa pekerja mencapai telefon mereka. Jika pekerja tidak menjawab, pelanggan tidak akan dipanggil sama sekali.

Panggilan daripada Skenario Bot

Empat kaedah tersedia dalam kalkulator.

twilio_employee_call(client_phone, employee_phone, caller_id)

Menyambungkan pekerja dengan pelanggan. Ia berfungsi sama seperti butang panggilan dalam kad pelanggan: pertama pekerja dipanggil, kemudian pelanggan.

twilio_employee_call(client_phone, "+905551112233")

Argumen ketiga adalah pilihan. Ia menentukan nombor telefon yang akan dilihat oleh pelanggan sebagai ID pemanggil. Secara lalai, nombor Twilio anda digunakan.

twilio_group_call(client_phone, employee_phones, caller_id)

Menghubungi pelanggan dan, sebaik sahaja pelanggan menjawab, secara serentak menghubungi semua pekerja dalam senarai yang ditentukan. Panggilan disambungkan kepada pekerja pertama yang menjawab.

twilio_group_call(client.phone, "+905551112233,+905554445566,+905557778899")

⚠️ Urutan diterbalikkan di sini. Tidak seperti kaedah sebelumnya, pelanggan menjawab dahulu dan mungkin mendengar beberapa saat kesunyian semasa Twilio menghubungi pekerja. Ini adalah had Twilio: memanggil kumpulan secara serentak dan menyambungkan orang pertama yang menjawab hanya berfungsi dengan cara ini. Jika penting bahawa pelanggan tidak perlu menunggu, gunakan twilio_employee_call.

twilio_play_message(client_phone, text, voice, language)

Menghubungi pelanggan dan membaca teks yang ditentukan menggunakan ucapan sintesis. Ini berguna untuk peringatan janji temu, pengesahan pesanan, dan pemberitahuan penghantaran.

twilio_play_message(client.phone, "Hello! This is a reminder about your appointment tomorrow at 3:00 PM.", "alice", "en-EN")

Suara alice adalah universal dan menyokong bahasa utama, termasuk tr-TR, es-ES, es-MX, pt-BR, de-DE, fr-FR, en-US, ru-RU, dan ar-XA.

Sentiasa nyatakan bahasa secara eksplisit — jika tidak, Twilio mungkin membaca teks menggunakan sebutan Inggeris.

Jangan sertakan kata laluan, kod pengesahan, atau maklumat sensitif lain dalam mesej: panggilan mungkin dijawab oleh mel suara.

Mengembalikan pautan ke rakaman panggilan. Ini jarang diperlukan kerana pautan biasanya muncul secara automatik (lihat bahagian seterusnya). Ia boleh berguna jika pautan rakaman tidak diterima dan perlu diminta semula.

twilio_get_record_link()

Jika tiada argumen diberikan, panggilan terbaru pelanggan digunakan.

Pemboleh Ubah dan Peristiwa

Selepas setiap panggilan, bot menyimpan pemboleh ubah berikut dalam pesanan pelanggan:

Pemboleh Ubah Apa yang mengandungi
twilio_call_id pengecam panggilan Twilio
twilio_call_disposition hasil panggilan: completed, busy, no-answer, failed, canceled
twilio_call_duration tempoh panggilan dalam saat
twilio_record_link pautan ke rakaman
twilio_record_id pengecam rakaman Twilio

Peristiwa dalam format twilio_call_event <status> dihantar ke perbualan. Anda boleh menggunakannya sebagai syarat dalam skenario anda:

Peristiwa Bila ia dihantar
twilio_call_event initiated panggilan telah dicipta
twilio_call_event ringing telefon sedang berdering
twilio_call_event answered panggilan telah dijawab
twilio_call_event completed panggilan telah tamat
twilio_call_event busy / no-answer / failed / canceled panggilan tidak dapat diselesaikan
twilio_call_event recording rakaman panggilan sedia

⚠️ Tunggu peristiwa recording sebelum menggunakan pautan rakaman, bukan peristiwa completed. Twilio memproses fail rakaman selepas panggilan telah tamat. Pada masa peristiwa completed diterima, pemboleh ubah twilio_record_link masih kosong. Skenario yang menghantar rakaman kepada pengurus atau CRM mesti dicetuskan oleh peristiwa recording.

Skenario biasa "tidak dapat menghubungi pelanggan — hantar mesej kepada mereka" berfungsi seperti ini: syarat untuk twilio_call_event no-answer atau busy → hantar mesej kepada pelanggan.

Rakaman Panggilan

Rakaman diaktifkan secara lalai untuk semua panggilan yang melibatkan pekerja. Kedua-dua pihak perbualan dirakam bermula dari saat panggilan dijawab. Fail disimpan dalam akaun Twilio anda dan dicaj oleh Twilio.

⚠️ URL twilio_record_link menunjuk terus ke Twilio dan dilindungi oleh kredensial akaun anda. Anda tidak boleh membukanya dalam pelayar atau menghantarnya kepada pelanggan — ralat akses akan dipaparkan. Untuk memuat turun rakaman, buka Konsol Twilio dan pergi ke Monitor → Logs → Calls, kemudian cari panggilan menggunakan twilio_call_id.

⚖️ Rakaman panggilan dikawal oleh undang-undang. Di banyak negara — termasuk Jerman, Perancis, Sepanyol, dan di banyak negeri AS — persetujuan daripada kedua-dua pihak mungkin diperlukan, dan dalam sesetengah kes, notis lisan mesti dimainkan pada permulaan panggilan. Sebagai pemilik akaun Twilio, anda bertanggungjawab untuk mematuhi keperluan yang berkenaan. Jika peraturan ini terpakai kepada anda, mulakan panggilan dengan notis rakaman atau lumpuhkan rakaman dalam tetapan nombor Twilio anda.

Penyelesaian Masalah

Panggilan Tidak Dicipta dan Ralat Pengesahan Dikembalikan

Account SID atau Auth Token tidak betul. Salin semula daripada Konsol Twilio. Punca paling biasa ialah ruang tambahan atau secara tidak sengaja menyalin Test Token dan bukan Auth Token utama.

Panggilan Berfungsi, tetapi Tiada Peristiwa atau Rakaman dalam Perbualan

URL panggil balik belum dikonfigurasikan dalam tetapan nombor Twilio (lihat Langkah 3), atau ia dikonfigurasikan dengan kaedah HTTP yang salah. Kaedah mesti HTTP POST.

Punca biasa lain ialah Auth Token telah ditukar dalam Twilio tetapi token lama masih dikonfigurasikan dalam akaun anda. Dalam kes ini, tandatangan permintaan tidak lagi sepadan, jadi semua panggil balik ditolak.

Ralat 21606 atau "From number not valid"

Nombor yang dimasukkan dalam medan Twilio Number sama ada tidak dibeli di bawah akaun Twilio anda atau tidak menyokong panggilan suara.

Buka Phone Numbers → Manage → Active numbers dan pastikan nombor itu disenaraikan dan mempunyai keupayaan Voice.

Ralat 21215 — Geo Permissions

Secara lalai, Twilio menyekat panggilan ke banyak negara sebagai langkah pencegahan penipuan.

Buka Voice → Settings → Geo Permissions dan dayakan destinasi yang anda perlukan.

Pelanggan Memanggil, tetapi Kad Perbualan Dicipta untuk Nombor Pekerja

Panggil balik dikonfigurasikan dengan URL yang salah. Salin URL panggil balik dari halaman integrasi sekali lagi, pastikan menyalin keseluruhan URL, termasuk semua yang selepas tanda soal.

Akaun Percubaan: Twilio Memainkan Mesej Suara Sebelum Panggilan

Ini adalah tingkah laku standard untuk akaun percubaan Twilio. Akaun percubaan juga hanya boleh menghubungi nombor telefon yang disahkan.

Tambah dana ke akaun anda dan naik taraf ke akaun Twilio penuh.