Penyelenggaraan dan pemulihan panggilan suara Twilio: Penjelasan terperinci mengenai mod mesyuarat dan pemprosesan kaki panggilan bebas

Dalam Pembangunan Aplikasi Suara Twilio, meletakkan panggilan terus dan pemulihan berikutnya adalah keperluan biasa. Walau bagaimanapun, operasi kemas kini langsung pada satu kaki panggilan, seperti mengubahsuai URL TWIMLnya, sering membawa kepada pemotongan panggilan yang tidak dijangka dari pihak lain. Ini kerana apabila arahan TWIML untuk kaki panggilan dilaksanakan atau diarahkan, Twilio akan menganggap bahawa proses semasa untuk kaki itu selesai. Artikel ini akan memperkenalkan dua cara untuk membolehkan pengekalan dan pemulihan panggilan: menggunakan ciri persidangan Twilio (disyorkan) dan mengendalikan kaki panggilan bebas.

Kaedah 1: Gunakan Persidangan Twilio (disyorkan)

Ciri persidangan Twilio adalah cara yang paling mudah dan paling mantap untuk menyimpan panggilan dan pulih. Mesyuarat pada dasarnya adalah bilik maya yang menghubungkan pelbagai peserta bersama -sama. Dalam mod ini, anda boleh mengawal status setiap peserta dalam mesyuarat secara bebas, termasuk meletakkannya dalam keadaan pegangan.

1. Letakkan peserta ditahan

Apabila kaki panggilan menyertai mesyuarat sebagai peserta, anda boleh meletakkannya dengan mengemas kini sumber peserta itu. Ini melibatkan menghantar permintaan kemas kini ke API Twilio, menetapkan harta pegangan peserta kepada Benar, dan menyatakan Holdurl untuk memainkan muzik Hold.

Kod Contoh (PHP):

  Php
// Anggapkan bahawa anda telah memasang Twilio PHP perpustakaan memerlukan_once 'vendor/autoload.php' melalui komposer;

Gunakan Twilio \ Rest \ client;

// Akaun Twilio Sid dan Token Auth
$ sid = "acxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"; // Ganti dengan Sid Akaun anda
$ token = "your_auth_token"; // ganti dengan token auth anda
$ client = klien baru ($ SID, $ token);

// Katakan anda sudah mempunyai sid persidangan dan sid peserta
$ conferencesId = "cfxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
$ PesertaSid = "Caxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Cuba {
    $ peserta = $ pelanggan
        -> Persidangan ($ conferencesId)
        -> Peserta ($ peserta)
        -> Kemas kini ([
            "tahan" => Benar,
            "holdurl" => "http://www.myapp.com/hold_music.mp3" // Pastikan url muzik
        ]);

    Echo "Peserta". $ peserta-> callid. "Berjaya diletakkan di Hold State. \ N";
} menangkap (pengecualian $ e) {
    echo "Kesalahan berlaku semasa meletakkan peserta dalam keadaan pegangan:". $ e-> getMessage (). "\ n";
}
?>

Dalam kod di atas, apabila Hold ditetapkan untuk benar, Twilio akan memainkan audio yang ditentukan oleh HoldUrl kepada peserta, dan peserta mesyuarat lain tidak akan dapat mendengar peserta.

2. meneruskan panggilan

Untuk memulihkan peserta dari Simpan ke mesyuarat, hanya mengemas kini sumber peserta sekali lagi dan menetapkan harta pegangan kepada palsu.

Kod Contoh (PHP):

  Php
// Anggapkan bahawa anda telah memasang Twilio PHP perpustakaan memerlukan_once 'vendor/autoload.php' melalui komposer;

Gunakan Twilio \ Rest \ client;

// Akaun Twilio Sid dan Token Auth
$ sid = "acxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"; // Ganti dengan Sid Akaun anda
$ token = "your_auth_token"; // ganti dengan token auth anda
$ client = klien baru ($ SID, $ token);

// Katakan anda sudah mempunyai sid persidangan dan sid peserta
$ conferencesId = "cfxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
$ PesertaSid = "Caxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Cuba {
    $ peserta = $ pelanggan
        -> Persidangan ($ conferencesId)
        -> Peserta ($ peserta)
        -> Kemas kini ([
            "hold" => palsu
        ]);

    Echo "Peserta". $ peserta-> callid. "Pulih berjaya dari Hold. \ N";
} menangkap (pengecualian $ e) {
    echo "Kesalahan berlaku semasa pulih peserta:". $ e-> getMessage (). "\ n";
}
?>

Nota:

• Gunakan ciri mesyuarat untuk memudahkan pengurusan negeri kerana Twilio mengendalikan logik sambungan di dalam mesyuarat.
• HoldUrl boleh menjadi URL fail audio yang boleh diakses, menyokong format MP3 dan WAV.

Kaedah 2: Mengendalikan kaki panggilan bebas (maju)

Jika anda memilih untuk tidak menggunakan ciri mesyuarat, tetapi secara langsung menguruskan dua kaki panggilan berasingan, ia akan menjadi lebih rumit untuk mencapai penyimpanan panggilan. Ini kerana apabila anda mengemas kini twiml satu kaki panggilan (contohnya, mengalihkannya kepada satu memegang Twiml), arahan Twiml semasa kaki panggilan yang lain terus dilaksanakan dan sekali dilaksanakan, kaki panggilan digantung.

1. Memahami soalan: Mengapa pihak lain pecah?

Senario yang diterangkan dalam soalan asal, iaitu, "Apabila pihak panggilan dikekalkan, pihak panggilan terputus", adalah perwujudan mekanisme ini. Apabila anda mengemas kini panggilan melalui API (contohnya, menunjuk TWIML ke URL yang memainkan dan memegang muzik), aliran TWIML kaki panggilan itu terganggu dan menunjuk ke URL baru. Satu lagi kaki panggilan yang disambungkan kepadanya, arahan twimlnya (biasanya ) akan mengandaikan bahawa sasaran sambungannya telah "selesai", menyebabkan proses TWIML kaki itu terus melaksanakan, dan secara automatik akan digantung jika tidak ada arahan lain pada masa akan datang.

Analisis coretan kod asal:

 // ...
$ rr = array (
  "url" => "http://demo.twilio.com/docs/voice.xml", // url twiml baru
  "Kaedah" => "Pos"
);
$ call = $ client-> call ($ callID)-> update ($ rr); // Kemas kini pemanggil // ...

Kod ini mengemas kini sumber TWIML kaki panggilan yang diwakili oleh $ callid ke http://demo.twilio.com/docs/voice.xml. Jika $ callid adalah pihak panggilan dan ia sebelum ini disambungkan ke pihak panggilan melalui , maka apabila TWIML pihak panggilan dikemas kini, arahan yang dilaksanakan oleh pihak panggilan akan mempertimbangkan sambungannya "selesai", dan TWIML pihak panggilan akan terus dilaksanakan (jika ada yang berikutnya), jika tidak, ia akan hang -hang.

2. Sediakan Twiml Susulan untuk Kaki Tidak Bertahan

Untuk mengelakkan kaki yang tidak memegang sambungan apabila pemanggil diadakan, anda perlu memberikan arahan susulan dalam twimlnya. Sebagai contoh, tambahkan selepas arahan untuk mendapatkan panggilan ke URL lain:

Contoh Twiml:

 <sponsepsi>
  <al> customer_number  
  <sedirect> https://example.com/hold_waiting  
</sedirect></al></sponsepsi>

Dalam contoh ini, apabila operasi selesai (mis., Kerana kaki yang lain diadakan atau diarahkan), panggilan tidak akan digantung, tetapi akan diarahkan ke TWIML yang disediakan oleh https://example.com/hold_waiting. Twiml ini boleh memainkan nada segera untuk memaklumkan pengguna bahawa mereka sedang menunggu.

3. Melaksanakan strategi untuk menjaga dan memulihkan

Untuk mencapai pengekalan dan pemulihan yang lengkap, strategi berikut boleh diterima pakai:

• Simpan dalam tindakan:

  • Kemas kini twiml kaki panggilan (mis., Kaki ejen) yang perlu disimpan melalui API untuk memainkan URL TWIML muzik Keep.
  • Kemas kini twiml kaki panggilan lain (contohnya, kaki klien) melalui API ke URL TWIML yang beratur panggilan (). Dengan cara ini, kaki pelanggan tidak akan digantung, tetapi akan berada dalam barisan menunggu.

  Contoh Twiml untuk Enqueue:

   <sponsepsi>
    <enqueue waiturl="http://www.myapp.com/wait_music.mp3"> mycustomerqueue </enqueue>
  </sponsepsi>

• Operasi Pemulihan:

  • Kemas kini twiml kaki ejen ke URL TWIML yang menghubungkan ke barisan klien melalui arahan .
  • Apabila kaki ejen didail ke dalam barisan, Twilio akan menyambungkan kaki ejen ke kaki klien yang menunggu dalam barisan.

  Contoh Twiml untuk Dail Queue:

   <sponsepsi>
    <silding> <due> mycustomerqueue  
  </due></silding></sponsepsi>

Nota:

• Pendekatan ini memerlukan anda untuk menguruskan keadaan dua kaki panggilan dan aliran Twiml secara manual, dengan peningkatan kerumitan yang ketara.
• Anda perlu memastikan permohonan anda dapat menjejaki status semasa dan panggilan SID yang sepadan setiap kaki panggilan.
• Pengendalian ralat dan kes kelebihan (seperti pelanggan yang tidak menunggu dalam barisan) perlu dipertimbangkan dengan teliti.

Ringkasan dan amalan terbaik

Dari dua kaedah di atas, dapat dilihat bahawa menggunakan fungsi persidangan Twilio adalah cara yang paling disyorkan untuk mengekalkan dan memulihkan panggilan. Ia menyediakan pengurusan negeri terbina dalam dan API yang dipermudahkan yang sangat mengurangkan kerumitan pembangunan.

• Rancangan pilihan: Mesyuarat Twilio. Jika kes penggunaan anda membolehkan mesyuarat, pastikan anda memilih senario ini. Ia menyediakan ciri -ciri yang lebih kuat (seperti pelbagai peserta, bisu, kick out, dll.) Dan menyimpan dan mengembalikan operasi intuitif dan mudah dilaksanakan.
• Penyelesaian Lanjutan: Kaki Panggilan Bebas. Pertimbangkan secara manual menguruskan kaki panggilan bebas hanya jika senario aplikasi anda mempunyai sekatan khas dan tidak boleh menggunakan ciri mesyuarat. Pendekatan ini memerlukan anda mempunyai pemahaman yang mendalam mengenai aliran Twilio dan panggilan API Twilio, dan memerlukan lebih banyak kod untuk mengendalikan status panggilan, menyambung semula logik, dan situasi ralat.

Terlepas dari kaedah yang anda pilih, adalah penting untuk memahami bagaimana Twilio Twiml berfungsi dan bagaimana API mempengaruhi status panggilan. Dengan rasional merancang logik Twiml dan Backend anda, anda boleh membina aplikasi suara Twilio yang mantap dan pengguna.