Integrasi GoHighLevel (GHL)
Sudah menggunakan GoHighLevel (GHL) untuk mengelola bisnis Anda? Integrasi ini memungkinkan Anda menambahkan pesan berbasis AI dari Your AI Connector di atas pengaturan GHL Anda yang sudah ada. Pesan yang masuk ke GHL diteruskan ke Your AI Connector untuk penanganan berbasis AI, dan balasan dari Your AI Connector dikirim kembali melalui GHL ke pelanggan di saluran aslinya.
Menggunakan CRM yang berbeda? Tidak perlu layar khusus untuk bekerja dengan Your AI Connector: lihat Menghubungkan Alat yang Tidak Kami Cantumkan untuk fungsi kustom, API, dan webhook.
Ini berarti Anda tetap dapat menggunakan GHL sebagai pusat utama Anda sambil membiarkan AI menangani percakapan yang digerakkan oleh AI.
Catatan: Ini adalah integrasi yang lebih teknis yang melibatkan pengaturan alur kerja otomatis dan menghubungkan sistem menggunakan webhook (pemberitahuan otomatis antar aplikasi) dan panggilan API. Jika Anda kurang nyaman dengan hal ini, Anda mungkin ingin memberikan halaman ini kepada pengembang atau anggota tim yang paham teknologi.
Prasyarat
- Akun Your AI Connector aktif dengan kunci API Anda (ditemukan di Pengaturan → Integrasi → Kunci API). Kunci API adalah kode unik yang memungkinkan GHL berkomunikasi secara aman dengan akun Anda.
- Akun GoHighLevel dengan izin untuk membuat alur kerja (workflow) dan mengelola webhook (pemberitahuan otomatis antar sistem).
Cara Kerjanya
| Arah | Apa yang Terjadi |
|---|---|
| GHL ke Your AI Connector | Pelanggan mengirim pesan kepada Anda melalui SMS, email, Messenger, Instagram, atau obrolan langsung di GHL. Alur kerja secara otomatis meneruskan pesan tersebut ke Your AI Connector. Your AI Connector memprosesnya (respons AI, penandaan, dll.). |
| Your AI Connector ke GHL | Saat Your AI Connector mengirim balasan (secara manual atau melalui AI), sistem secara otomatis memberi tahu GHL. Alur kerja di GHL menemukan kontak tersebut dan mengirimkan balasan melalui saluran yang benar. |
Alur Kerja 1: GHL ke Your AI Connector
Alur kerja ini meneruskan pesan masuk dari GHL ke Your AI Connector.
Langkah 1: Buat Alur Kerja
- Di GHL, buka Otomatisasi > Alur Kerja.
- Klik Buat Alur Kerja Baru.
- Beri nama yang deskriptif, seperti “Kirim Pesan ke Your AI Connector.”
Langkah 2: Tambahkan Pemicu
Tambahkan pemicu untuk setiap saluran yang ingin Anda teruskan:
- Pelanggan Membalas - SMS
- Pelanggan Membalas - Email
- Pelanggan Membalas - Pesan Facebook
- Pelanggan Membalas - DM Instagram
- Pelanggan Membalas - Obrolan Langsung
Anda dapat menambahkan semuanya atau hanya saluran yang relevan dengan pengaturan Anda.
Langkah 3: Tambahkan Filter Tag (Opsional)
Jika Anda hanya ingin meneruskan pesan dari kontak tertentu:
- Klik Add Filter pada pemicu.
- Atur kondisi ke “Contact has tag.”
- Pilih tag Anda.
- Pilih apakah kontak harus memiliki salah satu atau semua tag yang dipilih.
Langkah 4: Buat Pemisahan Saluran (Channel Split)
Tambahkan tindakan Condition untuk mengarahkan setiap saluran ke webhook-nya masing-masing:
| Cabang | Kondisi |
|---|---|
| Cabang 1 | Sumber pesan sama dengan Email |
| Cabang 2 | Sumber pesan sama dengan SMS |
| Cabang 3 | Sumber pesan sama dengan Messenger |
| Cabang 4 | Sumber pesan sama dengan Instagram |
| Cabang 5 | Sumber pesan sama dengan Live Chat |
Langkah 5: Konfigurasi Webhook
Untuk setiap cabang, tambahkan tindakan Webhook / HTTP Request:
-
Metode:
POST -
URL:
https://api.youraiconnector.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY -
Bidang Data Kustom:
| Bidang | Nilai | Catatan |
|---|---|---|
messageSid |
{{right_now.second}}{{contact.id}} |
Pengidentifikasi pesan unik |
fromId |
{{contact.id}} |
ID kontak GHL |
toId |
{{user.id}} |
ID pengguna GHL Anda |
body |
{{message.body}} |
Isi pesan |
channel |
Lihat tabel di bawah | Harus sesuai dengan cabang |
status |
created |
Selalu atur ke created |
messageType |
text |
Jenis pesan |
Nilai saluran per cabang:
| Cabang | Nilai channel |
|---|---|
email |
|
| SMS | sms |
| Messenger | messenger |
ig |
|
| Live Chat | livechat |
Penting: Pastikan nilai channel sama persis — nilai ini peka terhadap huruf besar-kecil (case-sensitive).
Langkah 6: Aktifkan Masuk Kembali (Re-Entry)
Dalam pengaturan alur kerja, pastikan Allow Re-entry diaktifkan. Tanpa ini, hanya pesan pertama dari setiap kontak yang akan diteruskan.
Alur Kerja 2: Your AI Connector ke GHL
Alur kerja ini menerima balasan dari Your AI Connector dan mengirimkannya ke pelanggan melalui saluran GHL yang benar.
Langkah 1: Buat Webhook Masuk di GHL
- Di GHL, buka Pengaturan > Pengembang / API.
- Klik Buat Webhook Baru (atau “Webhook Masuk”).
- Beri nama “Pesan.”
- Simpan dan salin URL webhook — Anda akan membutuhkannya di langkah berikutnya.
Langkah 2: Konfigurasi Your AI Connector
- Di Your AI Connector, klik Settings di bilah sisi.
- Di bawah Channels, klik Channels.
- Gulir ke kartu Custom channel di bagian paling bawah halaman.
- Tempel URL webhook masuk GHL yang baru saja Anda salin ke Webhook URL (harus berupa alamat HTTPS publik) dan klik Save.
Ini bukan halaman Settings → Integrations → Webhooks. Halaman tersebut ditujukan untuk notifikasi acara dan mengirimkan payload yang berbeda. Relai keluar GHL diatur pada kartu Custom channel di bawah Settings → Channels.
Your AI Connector sekarang akan secara otomatis mengirim pemberitahuan ke GHL setiap kali pesan dikirim ke kontak. Data yang dikirim terlihat seperti ini:
{
"contactId": "NtL97bwnhITrfIq8lWFi",
"messageId": "s28dtg13qNuhXLoKpcLs",
"userId": "wpDZRvaw4Hgh4whUBpwlKPRftOi2",
"body": "Message content here",
"toId": "qtpBsc6fiqkXTnSOeze3",
"channel": "email"
}
Catatan navigasi: Kunci API yang Anda gunakan untuk Alur Kerja 1 dan kartu Custom channel yang Anda gunakan di sini berada di tempat yang berbeda — Settings → Integrations → API Key untuk kunci tersebut, dan kartu Custom channel di bagian bawah Settings → Channels untuk relai ini. Halaman Settings → Integrations → Webhooks yang terpisah ditujukan untuk notifikasi acara dan mengirimkan payload yang berbeda; lihat Webhooks jika itu yang Anda inginkan.
Langkah 3: Buat Alur Kerja Respons
- Di GHL, buka Automation > Workflows.
- Buat alur kerja baru bernama “Send Message to Contact.”
- Atur pemicu ke Inbound Webhook dan pilih webhook yang Anda buat di Langkah 1.
Langkah 4: Tambahkan Tindakan Temukan Kontak
- Tambahkan tindakan Find Contact.
- Atur kolom pencarian ke Contact ID.
- Gunakan nilai:
{{inboundWebhookRequest.toId}}
Langkah 5: Tambahkan Pemeriksaan Tag Opsional
Jika Anda ingin membatasi kontak mana yang menerima pesan dari Your AI Connector:
- Tambahkan tindakan Condition.
- Periksa apakah kontak memiliki tag tertentu.
- Jika tag tidak ada, akhiri alur kerja (tambahkan tindakan “Stop” pada cabang false).
Langkah 6: Tambahkan Pemisahan Saluran
Tambahkan tindakan Kondisi yang merutekan pesan berdasarkan {{inboundWebhookRequest.channel}}:
| Cabang | Kondisi | Tindakan |
|---|---|---|
| Cabang 1 | sama dengan email |
Kirim Email |
| Cabang 2 | sama dengan sms |
Kirim SMS |
| Cabang 3 | sama dengan messenger |
Kirim Pesan Facebook |
| Cabang 4 | sama dengan ig |
Kirim Pesan Instagram |
| Cabang 5 | sama dengan livechat |
Kirim Pesan Obrolan |
Langkah 7: Konfigurasikan Setiap Tindakan Kirim
Di setiap tindakan kirim, atur isi pesan ke:
{{inboundWebhookRequest.body}}
Langkah 8: Aktifkan Masuk Kembali (Re-Entry)
Seperti pada Alur Kerja 1, pastikan Izinkan Masuk Kembali diaktifkan di pengaturan alur kerja.
Menguji Integrasi
Uji GHL ke Your AI Connector (Alur Kerja 1)
- Kirim pesan ke nomor GHL atau saluran terhubung Anda (misalnya, kirim SMS ke diri sendiri).
- Buka Your AI Connector dan pastikan pesan muncul di Obrolan.
- Periksa apakah label saluran sudah benar (SMS, email, dll.).
- Ulangi untuk setiap saluran yang Anda konfigurasi.
Uji Your AI Connector ke GHL (Alur Kerja 2)
- Di Your AI Connector, kirim balasan ke kontak (secara manual atau biarkan AI merespons).
- Buka GHL dan verifikasi bahwa kontak telah menerima pesan tersebut.
- Pastikan pesan dikirim melalui saluran yang benar.
- Periksa apakah konten pesan sudah sesuai.
Pemecahan Masalah
| Masalah | Apa yang Harus Diperiksa |
|---|---|
| Pesan tidak sampai ke Your AI Connector | Pastikan kunci API Anda sudah benar di URL webhook. Periksa apakah pemicu alur kerja berfungsi (log alur kerja GHL). Konfirmasikan bahwa Allow Re-entry diaktifkan. |
| Pesan tidak sampai ke GHL | Pastikan URL webhook masuk GHL telah ditempel dengan benar ke Webhook URL pada kartu Custom channel di bagian bawah Settings → Channels (bukan di halaman Settings → Integrations → Webhooks, yang merupakan fitur berbeda). Periksa apakah webhook masuk GHL aktif. Tinjau log eksekusi alur kerja GHL. |
| Kontak tidak ditemukan di GHL | toId dalam data webhook harus cocok dengan ID kontak GHL yang ada. Pastikan kontak ada di kedua sistem dengan ID yang cocok. |
| Saluran yang salah digunakan untuk balasan | Periksa kembali nilai saluran di cabang kondisi Anda. Nilai tersebut harus sama persis: email, sms, messenger, ig, livechat. |
| Hanya pesan pertama yang diteruskan | Aktifkan Allow Re-entry di kedua pengaturan alur kerja. |
Langkah Selanjutnya
- Webhook — siapkan webhook untuk peristiwa Your AI Connector lainnya.
- Akses API — gunakan API untuk integrasi kustom di luar GHL.
- Saluran Kustom — pelajari lebih lanjut tentang pengiriman pesan saluran kustom.