Twilio

Entitas, operasi, dan tindakan

Semua Konektor Integrasi menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ini ditampilkan kepada Anda sebagai entitas, operasi, dan tindakan.

• Entitas: Entitas dapat dianggap sebagai objek, atau kumpulan properti, dalam aplikasi atau layanan yang terhubung. Definisi entitas berbeda dari konektor ke konektor. Misalnya, di konektor database, tabel adalah entitas, di konektor server file, folder adalah entitas, dan di konektor sistem pesan, antrean adalah entitas.

  Namun, ada kemungkinan konektor tidak mendukung atau tidak memiliki entity apa pun, sehingga daftar Entities akan kosong.

• Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entity. Anda dapat melakukan salah satu operasi berikut pada entitas:
  • Daftar
  • Dapatkan
  • Buat
  • Update
  • Hapus

  Memilih entitas dari daftar yang tersedia akan menghasilkan daftar operasi yang tersedia untuk entitas tersebut. Untuk deskripsi mendetail tentang operasi, lihat operasi entitas tugas Konektor. Namun, jika konektor tidak mendukung operasi entitas apa pun, operasi yang tidak didukung tersebut tidak tercantum dalam daftar Operations.

• Tindakan: Tindakan adalah fungsi kelas pertama yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada satu atau beberapa entitas, dan berbeda-beda dari konektor ke konektor. Biasanya, tindakan akan memiliki beberapa parameter input, dan parameter output. Namun, ada kemungkinan konektor tidak mendukung tindakan apa pun, sehingga daftar Actions akan kosong.

Batasan sistem

Konektor Twilio dapat memproses 25 transaksi per detik, per node, dan membatasi transaksi apa pun yang melebihi batas ini. Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk koneksi.

Untuk mengetahui informasi tentang batas yang berlaku untuk Integration Connectors, lihat Batas.

Contoh

Bagian ini menjelaskan cara melakukan beberapa operasi entitas di konektor ini.

Contoh - Mencantumkan semua rekaman

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Rekaman dari daftar Entity.
3. Pilih operasi List, lalu klik Selesai.

Contoh - Mendapatkan rekaman tunggal

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Rekaman dari daftar Entity.
3. Pilih operasi Get, lalu klik Selesai.
4. Tetapkan ID entitas ke Get single Recording. Untuk menyetel ID entitas, di bagian Task Input pada tugas Connectors, klik entityId, lalu masukkan RE2e915e78549694bd0a0742d2d39454e5 di kolom Default Value.

Contoh - Menghapus panggilan

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Panggilan dari daftar Entity.
3. Pilih operasi Delete, lalu klik Selesai.
4. Setel ID entitas ke Hapus Panggilan. Untuk menyetel ID entitas, di bagian Task Input pada tugas Connectors, klik entityId, lalu masukkan CAaa4a99c300bd9d1bcc0d1ae9dcd248c6 di kolom Default Value.

Contoh - Membuat masukan panggilan

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Masukan dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
                       "Sid": "CAdefbf2b4caa7df11dc48106385e32345",
                       "QualityScore": 5
                     }

   Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

   {
                       "Sid": "CAdefbf2b4caa7df11dc48106385e32345"
                     }

Contoh - Membuat ringkasan masukan panggilan

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih FeedbackSummary dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
                       "StartDate": "2014-06-01",
                       "EndDate": "2014-06-04"
                     }

   Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

   {
                       "Sid": "FS11f26a89d7260fb8cef070b768fcf5d1"
                     }

Contoh - Membuat Pesan

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Pesan dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
                       "To": "whatsapp:+9178923*****",
                       "Sender": "whatsapp:+14155238886",
                       "Body": "Message is sent from Google Cloud"
                     }

   Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

   {
                       "Sid": "SMdfde81ab903c0a9e67f932f9bef91090"
                     }

Contoh - Memperbarui Pesan

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Pesan dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Setel ID entitas ke Perbarui Pesan. Untuk menyetel ID entitas, di bagian Task Input pada tugas Connectors, klik entityId, lalu masukkan SM3ad97d41e786c02bca47c8ce1745053b di kolom Default Value.
5. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
                       "Body": ""
                     }

Atau, alih-alih menentukan entityId, Anda juga dapat menyetel filterClause ke SM3ad97d41e786c02bca47c8ce1745053b.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

{}

Contoh - Memperbarui IncomingPhoneNumbers

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih IncomingPhoneNumbers dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Setel ID entity ke Update a IncomingPhoneNumbers. Untuk menyetel ID entitas, di bagian Task Input pada tugas Connectors, klik entityId, lalu masukkan PN4047ac009a15885690a50a1d388b8411 di kolom Default Value.
5. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
                       "Name": "name of IncomingPhoneNumber is getting updated"
                     }

Atau, alih-alih menentukan entityId, Anda juga dapat menyetel filterClause ke PN4047ac009a15885690a50a1d388b8411.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

{
                    "Sid": "PN4047ac009a15885690a50a1d388b8411"
                  }

Contoh - Memperbarui OutgoingCallerIds

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih OutgoingCallerIds dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Setel ID entitas ke Update OutgoingCallerIds. Untuk menyetel ID entitas, di bagian Task Input pada tugas Connectors, klik entityId, lalu masukkan PN6f5f9bf39cb1801a6e21a5a80d274bdd di kolom Default Value.
5. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
                       "Name": "Name Updated for 99025*****"
                     }

Atau, alih-alih menentukan entityId, Anda juga dapat menyetel filterClause ke PN6f5f9bf39cb1801a6e21a5a80d274bdd.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

{
                    "Sid": "PN6f5f9bf39cb1801a6e21a5a80d274bdd"
                  }