Integrasi Keluar
Integrasi Keluar:
Whatsapp > CRM dan sistem Anda yang lain
Bagikan artikel ini dengan pengembang Anda atau gunakan Zapier untuk mengintegrasikan sistem Anda dengan Whatsapp
Pengaturan
TimelinesAI memungkinkan untuk memberi tahu sistem eksternal ketika pesan baru diterima atau dikirim di akun whatsapp yang terhubung di ruang kerja. Ini termasuk pesan whatsapp yang dikirim melalui Aplikasi Seluler Whatsapp atau dari dalam Timeline.
Sering kali integrasi semacam itu digunakan melalui beberapa layanan perantara seperti Zapier, di mana setiap aktivasi webhook diperhitungkan dalam penggunaan kuota tugas.
Untuk membuat penggunaan kuota tugas menjadi lebih efisien, TimelinesAI menyediakan kemungkinan untuk menggabungkan beberapa pesan yang dikirim atau diterima dalam obrolan tertentu selama periode waktu yang dipilih. Pesan-pesan tersebut melalui webhook sebagai satu "bundel". Untuk kenyamanan Anda, "bundel" tersebut berisi bidang dengan agregasi pesan yang telah diformat sebelumnya (dan tautan ke titik dalam percakapan di TimelinesAI), tetapi Anda dapat mengimplementasikan pemformatan Anda sendiri menggunakan data yang disediakan dengan webhook.

Untuk menyiapkan integrasi menggunakan Outbound Webhooks:
- Arahkan ke halaman Kait Web di akun TimelinesAI Anda
- Pilih tab Keluar.
Anda akan dihadapkan pada pengaturan berikut ini:
- Perincian Agregasi - pesan akan dikumpulkan dan dikirim menggunakan webhook sesuai dengan pilihan (setiap 1/6/12/24 jam) atau akan dikirim segera setelah muncul di linimasa ("Jangan gabungkan)
- URL Webhook - di sini Anda perlu memasukkan URL aktual yang perlu diberitahukan.
- Webhook diaktifkan - Anda dapat menonaktifkan webhook jika ingin menghentikan integrasi.
Setelah Webhook diaktifkan dan beberapa pesan terkirim, log aktivitas akan ditampilkan (hingga 10 tindakan terbaru).
Catatan: saat ini, hanya pesan teks dan emoji yang didukung. Pesan yang berisi lampiran akan dilewati.
Kesalahan dan pemecahan masalah
Untuk memastikan operasi integrasi yang benar, jika lebih dari 10 kesalahan berturut-turut dari sisi penerima akan ditemukan (kesalahan apa pun, mulai dari URL yang tidak valid hingga kode respons yang bukan 200), sistem akan secara otomatis menonaktifkan integrasi. Dalam hal ini, pemilik ruang kerja akan menerima notifikasi melalui email.
Jika Anda perlu memecahkan masalah kesalahan, Anda dapat mengunduh log terperinci (tautan akan tersedia di bagian bawah halaman), di mana hingga 100 permintaan terbaru akan muncul dengan semua detail data yang dikirim dan respons yang diterima.
Format data
Data akan dikirim ke URL Webhook melalui permintaan HTTP POST, dalam format JSON. Data disediakan dalam 2 format yang berbeda, tergantung pada pengaturan Aggregation Granularity, seperti yang dijelaskan di bawah ini.
Agregat setiap X jam
Pesan akan dikumpulkan menjadi sebuah "bundel". Data berikut akan tersedia:
- "akun whatsapp" - rincian akun whatsapp (dan rekan tim ruang kerja, yang menghubungkan akun tersebut), yang digunakan untuk menerima atau mengirim pesan
- "telepon" - nomor telepon akun WA
- "nama_lengkap" - nama lengkap pemilik akun WA, seperti yang terdaftar di Linimasa
- "email" - email pemilik akun WA, seperti yang terdaftar di Linimasa
- "obrolan" - detail obrolan (obrolan langsung atau grup), tempat pesan dikirim atau diterima
- "nama_lengkap" - nama obrolan (seperti yang muncul di Linimasa)
- "nama_penanggung_jawab" - nama rekan satu tim yang ditugaskan sebagai penanggung jawab untuk obrolan ini
- "responsible_email" - email rekan satu tim yang ditugaskan sebagai penanggung jawab untuk obrolan ini
- "chat_url" - URL tempat obrolan dapat diakses di TimelinesUI
- "chat_id" - ID obrolan di TimelinesUI (dapat digunakan untuk membuat URL obrolan atau dengan inbound webhook)
- "is_new_chat" - benar, jika obrolan ini baru saja dibuat, salah jika tidak
- "is_group" - benar, jika obrolan ini adalah obrolan langsung, sebaliknya salah
- "telepon" - nomor telepon obrolan (kosong untuk obrolan grup)
- "pesan" - daftar pesan, di mana setiap objek pesan berisi bidang-bidang berikut
- "arah" - dapat "diterima" atau "dikirim"
- "timestamp" - cap waktu pesan, dalam zona waktu UTC
- "message_id" - ID unik internal pesan
- "pengirim" - rincian pengirim (peserta obrolan) dari sebuah pesan
- "nama_lengkap" - judul obrolan atau nama rekan tim di Timeline (jika dikirim dari dalam Timeline)
- "telepon" - nomor telepon pengirim (atau kosongkan untuk obrolan grup)
- "penerima" - rincian pengirim (peserta obrolan) dari sebuah pesan
- "nama_lengkap" - judul obrolan atau nama rekan tim di Timeline
- "telepon" - nomor telepon penerima (atau kosongkan untuk obrolan grup)
- "text" - teks pesan (plaintext)
- "first_message_timestamp" - stempel waktu dari pesan paling awal dalam bundel, dalam zona waktu UTC
- "last_message_timestamp" - stempel waktu dari pesan terakhir dalam bundel, dalam zona waktu UTC
- "agregasi" - teks pesan yang dikumpulkan, dalam format HTML, cocok untuk digunakan dengan CRM atau sistem serupa sebagai konten catatan, termasuk tautan langsung ke pesan pertama di Timeline.
Contoh
{ "whatsapp_account" : { "full_name" : "Amnon Haha", "email" : "Amnon@acme.com", "phone" : "+972500000000" }, "chat": { "full_name": "John Doe>", "responsible_name": "Amnon", "responsible_email": "Amnon@acme.com", "chat_url" : "https://app.timelines.ai/chat/10010001/messages/", "chat_id" : "10010001", "is_new_chat" : true, "is_group": false, "phone": "+97254000000" }, "messages" : [ { "direction": "sent", "timestamp": "2021-02-24T16:25:29+0000", "message_id": "ddfskhsd76dsfs6dsd5skjsdhf", "sender": { "full_name": "John Doe", "phone": "+972540000000" }, "recipient": { "full_name": "Jane Smith", "phone": "+972550000000" }, "text": "lorem ipsum" }, { "direction": "received", "timestamp": "2021-02-24T16:30:29+0000", "message_id": "ddfskhsd76dsfs6dsd5skjsdhf", "sender": { "full_name": "John Doe", "phone": "+972540000000" }, "recipient": { "full_name": "Jane Smith", "phone": "+972550000000" }, "text": "lorem ipsum" } ], "first_message_timestamp" : "2021-02-24T16:25:29+0000", "last_message_timestamp" : "2021-02-24T16:30:29+0000", "aggregation": "from John Doe on 2021-02-24 16:25: Hi! How are you?<br/>from Jane Smith on 2021-02-24 16:30: I am fine, how are you?<br/>Click <a href='https://app.timelines.ai/permalink/77a28d55-5345-5435-8c72-3a7bcad8ded9/'>here</h> to open the conversation in TimelinesAI" }
Jangan menggabungkan
Setiap pesan dikirim satu per satu, segera setelah tersedia. Tidak ada "bundling" yang terjadi. Data berikut akan tersedia:
- "akun whatsapp" - rincian akun whatsapp (dan rekan tim ruang kerja, yang menghubungkan akun tersebut), yang digunakan untuk menerima atau mengirim pesan
- "telepon" - nomor telepon akun WA
- "nama_lengkap" - nama lengkap pemilik akun WA, seperti yang terdaftar di Linimasa
- "email" - email pemilik akun WA, seperti yang terdaftar di Linimasa
- "obrolan" - detail obrolan (obrolan langsung atau grup), tempat pesan dikirim atau diterima
- "nama_lengkap" - nama obrolan (seperti yang muncul di Linimasa)
- "nama_penanggung_jawab" - nama rekan satu tim yang ditugaskan sebagai penanggung jawab untuk obrolan ini
- "responsible_email" - email rekan satu tim yang ditugaskan sebagai penanggung jawab untuk obrolan ini
- "chat_url" - URL tempat obrolan dapat diakses di TimelinesUI
- "chat_id" - ID obrolan di TimelinesUI (dapat digunakan untuk membuat URL obrolan atau dengan inbound webhook)
- "is_new_chat" - benar, jika obrolan ini baru saja dibuat, salah jika tidak
- "is_group" - benar, jika obrolan ini adalah obrolan langsung, sebaliknya salah
- "telepon" - nomor telepon obrolan (kosong untuk obrolan grup)
- "pesan" - rincian pesan
- "arah" - dapat "diterima" atau "dikirim"
- "timestamp" - cap waktu pesan, dalam zona waktu UTC
- "message_id" - ID unik internal pesan
- "pengirim" - rincian pengirim (peserta obrolan) dari sebuah pesan
- "nama_lengkap" - judul obrolan atau nama rekan tim di Timeline (jika dikirim dari dalam Timeline)
- "telepon" - nomor telepon pengirim (atau kosongkan untuk obrolan grup)
- "penerima" - rincian pengirim (peserta obrolan) dari sebuah pesan
- "nama_lengkap" - judul obrolan atau nama rekan tim di Timeline
- "telepon" - nomor telepon penerima (atau kosongkan untuk obrolan grup)
- "text" - teks pesan (plaintext)
Contoh
{ "whatsapp_account" : { "full_name" : "Amnon Haha", "email" : "Amnon@acme.com", "phone" : "+972500000000" }, "chat": { "full_name": "John Doe>", "responsible_name": "Amnon", "responsible_email": "Amnon@acme.com", "chat_url" : "https://app.timelines.ai/chat/10010001/messages/", "chat_id" : "10010001", "is_new_chat" : true, "is_group": false, "phone": "+97251111111" }, "message" : { "direction": "sent", "timestamp": "2021-02-24T06:25:29+0000", "message_id": "ddfskhsd76dsfs6dsd5skjsdhf", "sender": { "full_name": "John Doe", "phone": "+972540000000" }, "recipient": { "full_name": "Jane Smith", "phone": "+972550000000" }, "text": "lorem ipsum" } }
- Memaksimalkan Keterlibatan Pelanggan dengan Integrasi WhatsApp dan CRM - 5 Desember 2023
- Menggunakan WhatsApp dalam Pendidikan: Sebuah Tinjauan Menyeluruh - 28 November 2023
- Panduan untuk Merekrut di WhatsApp: Gambaran Umum yang Komprehensif - 27 November 2023