> For the complete documentation index, see [llms.txt](https://docs.3dolphins.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.3dolphins.ai/5.3.0-id/bot-settings-1/dialog-flows/create-new-dialog/defined-entity-bot-response/whatsapp-flows/data-exchange.md).

# Data Exchange

**Data exchange** berfungsi untuk melakukan pertukaran data antara sistem Anda dengan Meta dalam alur WhatsApp flow.

Untuk membuat data exchange, Anda dapat menuju ke menu **Bot Settings** dan klik menu **Dialog Flows**. Anda dapat membuat Intention & Entity seperti pada halaman sebelumnya. Kemudian, pada tahap **Prompt Respon** Anda dapat memilih **'Whatsapp Flows'** dan mengisi form Attach Whatsapp Flows seperti gambar berikut.&#x20;

{% hint style="info" %}
Field **Flow Action** perlu diisi dengan data\_exchange.
{% endhint %}

<figure><img src="https://3286717921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlqWTLEMUin8jixjPTHF7%2Fuploads%2F7pYohzII0YmEz4yk45Jd%2Fwhatsapp%20flow%20add%20dialog%20censored.png?alt=media&amp;token=de80ccf7-8fe4-47ce-ae1d-7e608663e796" alt=""><figcaption><p>Attach Whatsapp Flows</p></figcaption></figure>

**Komponent Explanation:**

<table><thead><tr><th width="278.83331298828125">Komponen</th><th>Deskripsi</th></tr></thead><tbody><tr><td>Title</td><td>Judul utama yang muncul pada pesan WhatsApp saat flow dikirim ke pelanggan.</td></tr><tr><td>Body</td><td>Isi utama pesan yang menjelaskan tujuan flow dan memberikan arahan kepada pelanggan.</td></tr><tr><td>Flows ID</td><td>ID yang berasal dari <strong>Meta Business Suite</strong> dan digunakan untuk menghubungkan flow WhatsApp yang sudah dibuat sebelumnya.</td></tr><tr><td>Flows CTA</td><td>Merupakan teks yang akan ditampilkan pada tombol form ke pelanggan.</td></tr><tr><td>Flows Action</td><td><p>Field untuk mendefinisikan tindakan (action) untuk pertukaran data yang akan dikirimkan ke Meta.<br><br><strong>Note :</strong></p><ul><li><strong>data_exchange</strong> = Data dari flows yang akan dikirimkan ke meta untuk setiap step form yang dituju. </li><li><strong>navigate</strong> = tidak melakukan pertukaran data dikarenakan halaman sudah ditentukan dari awal, sebagaimana yang didefinisikan pada flow screen ID. </li></ul></td></tr><tr><td>Flows Screen ID </td><td>ID screen untuk mengarahkan pelanggan langsung ke step flows setelah mengklik tombol CTA.<br><br><strong>Note :</strong> <br>Wajib diisi <strong>jika</strong> menggunakan <strong>navigate</strong> di dalam Flows Action.</td></tr><tr><td>Fallback Message</td><td>Merupakan pesan yang akan dikirim ke pelanggan jika WhatsApp Flows tidak bisa dijalankan.</td></tr></tbody></table>

Pada process flow, Anda diharapkan menambahkan node MVEL bernama handler yang berfungsi untuk menerima permintaan data dari WhatsApp ketika user mengklik flow seperti gambar berikut.

<figure><img src="https://3286717921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlqWTLEMUin8jixjPTHF7%2Fuploads%2FqRwjhrLZDL1ebj5ioYSC%2Fwhatsapp%20flow%20handler%20censored.png?alt=media&amp;token=cb1ac926-70c9-4254-929b-7154fb8691a1" alt=""><figcaption><p>Handler Process Flow</p></figcaption></figure>

Diperlukan juga penambahan **flowData** untuk setiap data yang diminta oleh **Meta**. FlowData ini berisi informasi yang dikirim dari flow, meliputi halaman terakhir yang diakses, halaman aktif saat ini, nama flow, ID flow, serta status penyelesaian flow (apakah flow telah selesai atau belum).

<figure><img src="https://3286717921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlqWTLEMUin8jixjPTHF7%2Fuploads%2F5a40wgrzPWyNu72vFcrd%2Fwhastapp%20flow%20censored.jpg?alt=media&amp;token=f1ce754e-9e3a-49dd-93db-1a9609ed1598" alt=""><figcaption><p>flowData</p></figcaption></figure>

Pada setiap node akhir yang akan dikirimkan ke whatsapp, **wajib** memuat script berikut :&#x20;

{% code overflow="wrap" %}

```javascript
//Membuat dataObject yang di perlukan
JSONObject flowData = new JSONObject();
flowData.put("last_page", "4");
flowData.put("current_page", "1");
flowData.put("flow_id", "xxxxxxxxx");
flowData.put("flow_name", "Example flow name");
flowData.put("completed", "false");

// Mengubah dataObject ke string dan menambahkan escape karakter 4 kali
String flowDataString = flowData.toString().replace("\"", "\\\\\"");

// Menyusun finalData dengan escape karakter
String finalData = "{" +
    "\\\\\"flow_data\\\\\":" + flowDataString + "," +
    "\\\\\"version\\\\\":\\\\\"" + v + "\\\\\"," +
    "\\\\\"screen\\\\\":\\\\\"" + sc + "\\\\\"," +
    "\\\\\"data\\\\\":" + dataString +
    "}";
```

{% endcode %}

Tahap terakhir adalah pengaturan **Endpoint** pada WhatsApp flow bisnis agar dapat melakukan penukaran data dengan flow.&#x20;

{% hint style="info" %}
**Endpoint** terdiri dari **{EndPointChannel}/{ChannelId}/flow/{urlWebhook}.**&#x20;
{% endhint %}

<figure><img src="https://3286717921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlqWTLEMUin8jixjPTHF7%2Fuploads%2F5pZ3QNjFi6zAbEnsJdqm%2Fimage.png?alt=media&amp;token=af3f7431-b790-4d8b-8c6e-0ce066ca1c93" alt=""><figcaption><p>Configuration of Endpoints in Business WhatsApp Flow</p></figcaption></figure>

Pengisian Endpoint pada process flow dapat Anda lihat seperti gambar berikut.

<figure><img src="https://3286717921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlqWTLEMUin8jixjPTHF7%2Fuploads%2FibqDml7hraV9iDTrOgVd%2FScreenshot_19-1-2026_141416_venom.3dolphins.ai.jpeg?alt=media&amp;token=1cd59734-18d0-4f91-8ec7-8a8a9131adc1" alt=""><figcaption><p>Endpoint</p></figcaption></figure>
