Mampu AI Docs/Integrasi/Gambaran keseluruhan Integrations

Gambaran keseluruhan Integrations

Kemas kini terakhir

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

Tonton tutorial

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, Mencipta kunci API Claude dan Mencipta kunci API DeepSeek.
  • 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.
  • 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.
  • 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