# Gambaran keseluruhan Integrations

**Integrations** (integrasi) menyambungkan akaun anda dengan alat lain yang anda gunakan. Buka **Settings → Integrations**, pilih perkhidmatan, dan ikut langkah untuk menyambungkannya.

## Tonton tutorial

{% embed url="https://youtu.be/KXNlnAwSEc8" %}

Yang paling kerap anda gunakan:

* **AI Providers** — satu halaman untuk semua kunci AI. Balasan Ejen Flow dijalankan menggunakan **Anthropic (Claude)** atau **DeepSeek** (apabila kedua-duanya disambungkan, DeepSeek digunakan). **OpenAI** menggerakkan AI Knowledge (penjanaan dan carian FAQ), transkripsi nota suara, pemahaman imej, dan terjemahan artikel — ini hanya berjalan pada OpenAI. Lihat [Cara mendapatkan kunci API OpenAI anda](/settings/how-to-get-your-openai-api-key), [Mencipta kunci API Claude](/settings/creating-a-claude-api-key-and-checking-usage-limits) dan [Mencipta kunci API DeepSeek](/settings/creating-a-deepseek-api-key).
* **Google Sheets** — sambungkan akaun Google anda dan butiran pelanggan yang dikumpul oleh ejen AI anda akan masuk terus ke hamparan anda sendiri, sedia untuk pasukan anda. Lihat [Menyambungkan Google Sheets](/settings/connecting-google-sheets).
* **Lark Base** — hantar butiran yang sama ke jadual Lark (Feishu) Base, dengan satu baris yang sentiasa dikemas kini bagi setiap pelanggan. Lihat [Menyambungkan Lark Base](/settings/connecting-lark-base).
* **Slack** — terima perbualan dalam saluran Slack dan balas tanpa perlu keluar daripadanya.
* **Webhooks** — hantar acara perbualan ke sistem anda sendiri secara masa nyata.
* **Dashboard apps** — benamkan alat anda sendiri terus dalam paparan perbualan.
* **Google Translate** dan **Dialogflow** juga tersedia untuk aliran kerja terjemahan dan bot.

Sesetengah ciri, seperti AI Knowledge, memerlukan kunci pembekal yang berkaitan disambungkan terlebih dahulu.

## Webhooks

Webhook menghantar acara daripada akaun anda — perbualan baharu, mesej, perubahan kenalan dan banyak lagi — ke URL anda sendiri, sebaik sahaja ia berlaku.

1. Buka **Settings → Integrations** dan pilih **Webhooks**.
2. Klik **Add new webhook**.
3. Masukkan **Webhook Name** dan **Webhook URL** anda.
4. Di bawah **Events**, tandakan acara yang anda mahu terima.
5. Klik **Create webhook**.

Selepas anda mencipta webhook, **Secret** webhook tersebut dipaparkan supaya sistem anda boleh menyemak bahawa penghantaran benar-benar datang daripada akaun anda. Salin ketika itu — anda juga boleh menemuinya kemudian dalam borang edit webhook.

### Menghantar jawapan Ejen Flow

Tandakan **Flow submission created or updated** untuk menghantar jawapan yang dikumpul oleh Ejen Flow anda ke CRM, hamparan atau mana-mana alat automasi yang menerima webhook.

Bila penghantaran dibuat:

* Apabila jawapan pelanggan dikumpul atau diubah.
* Apabila flow selesai.
* Giliran yang tidak mengumpul apa-apa yang baharu tidak menghantar apa-apa.

Kandungan setiap penghantaran:

* Setiap jawapan yang dikumpul setakat ini, jadi rekod anda kekal terkini sebelum flow tamat.
* Sama ada penyerahan itu sudah selesai atau masih dalam proses.
* Nama, e-mel dan nombor telefon kenalan, nama Ejen Flow, nombor perbualan dan nama peti masuk.

## Tindakan Send Webhook Event

Peraturan automasi juga boleh memanggil webhook. Tindakan **Send Webhook Event** menghantar butiran perbualan ke URL anda setiap kali peraturan berjalan — termasuk ke CRM dan API yang memerlukan token dalam header atau kaedah selain POST.

1. Buka **Settings → Automation**, cipta atau edit peraturan, dan tambah tindakan **Send Webhook Event**.
2. Masukkan URL dan pilih kaedah di sebelahnya: POST, GET, PUT, PATCH atau DELETE.
3. Untuk POST, PUT dan PATCH, anda boleh memasukkan JSON anda sendiri di bawah **Custom payload (optional)** dan menggunakan **Insert variable** untuk menambah butiran perbualan. Biarkan kosong untuk menghantar butiran standard.
4. Di bawah **Custom headers (optional)**, klik **Add header** dan masukkan nama dan nilai header — contohnya `Authorization` dan `Bearer your-token`.
5. Klik **Test send** untuk menyemak bahawa endpoint menerima permintaan tersebut, kemudian simpan peraturan.

Perlu diketahui:

* Sehingga 10 header bagi setiap tindakan. Nama header tidak boleh mengandungi ruang, nilai mesti satu baris, dan **Host**, **Content-Length**, **Transfer-Encoding** serta **Connection** tidak boleh ditetapkan.
* Permintaan GET dan DELETE dihantar tanpa badan (body), jadi letakkan sebarang parameter dalam URL.
* **Test send** menggunakan kaedah dan header yang sama, diisi dengan data daripada salah satu perbualan anda. Anda memerlukan sekurang-kurangnya satu perbualan dalam akaun anda untuk menguji.
* Pilihan yang sama terdapat pada tindakan **Send Webhook Event** dalam **Macros** dan **Inbound Webhooks**, serta pada automasi pelanggaran Reply SLA.

## Perkara yang boleh anda masukkan ke dalam payload

Klik **Insert variable** di atas kotak payload untuk menambah pemegang tempat di kedudukan kursor. Menu itu dikumpulkan mengikut kumpulan, dan anda boleh mencarinya:

* **Contact** — ID, nama, nama pertama dan nama akhir, e-mel, telefon, ID Facebook dan Instagram, nama syarikat, bandar, negara, dan bila kenalan itu mula berbual dengan anda.
* **Inbox** — ID, nama, jenis saluran, dan nombor telefon perniagaan yang menerima perbualan (peti masuk WhatsApp, SMS dan Twilio).
* **Assignment** — nama dan e-mel ejen yang ditugaskan, pasukan, dan Ejen Flow yang mengendalikan perbualan.
* **Conversation** — ID, pautan, status, keutamaan, label (dipisahkan dengan koma), bila ia bermula dan bila kali terakhir aktif, serta ID iklan Meta apabila pelanggan datang daripada iklan atau hantaran Click-to-Message Meta.
* **Chat history (last 10 messages)** — mesej terkini perbualan daripada pelanggan, ejen anda dan bot. Lihat di bawah.
* **Flow answers** — setiap jawapan yang dikumpul oleh Ejen Flow anda, satu pemegang tempat bagi setiap jawapan.
* **Custom attributes** — atribut kenalan dan perbualan anda.

Masa dihantar dalam format ISO 8601 bersama ofset zon waktunya, contohnya `2026-09-29T10:02:00+08:00`.

### Menghantar sejarah perbualan

Terdapat dua cara untuk menghantar 10 mesej terakhir. Kedua-duanya disusun daripada yang paling lama ke yang terbaru, dan tidak termasuk nota peribadi serta baris aktiviti seperti penugasan:

* `{{conversation.chat_history}}` menghantar mesej sebagai senarai. Setiap mesej mempunyai `role` (`customer`, `agent` atau `bot`), `sender`, `content`, `attachments` dan `created_at`. Letakkannya **tanpa** tanda petik, contohnya `"history": {{conversation.chat_history}}`.
* `{{conversation.chat_history_text}}` menghantar mesej yang sama sebagai satu blok teks, satu baris bagi setiap mesej, seperti `[2026-09-29 10:02] Customer (Aisyah): Is the 3-bedroom unit available?`. Letakkannya **di dalam** tanda petik. Ia sesuai untuk medan nota atau keterangan dalam CRM.

Jika anda meletakkan `{{conversation.chat_history}}` di dalam tanda petik, editor akan memaparkan **Chat history is a list: remove its quotes, or use {{conversation.chat_history_text}} for text.** dan **Test send** tidak boleh digunakan sehingga anda membetulkannya.

## Berkaitan

* [Label, atribut dan automasi](/settings/labels-attributes-and-automation)
* [Inbound Webhooks](/settings/inbound-webhooks)
* [Reply SLA](/settings/reply-sla)
* [Menyambungkan Google Sheets](/settings/connecting-google-sheets)
* [Menyambungkan Lark Base](/settings/connecting-lark-base)

---
Source: https://help.mampuai.com/ms/settings/integrations