Migrasi webhook Dify ke Google Sheets: pindahkan aliran kerja ke AI Flowi Workflow
Migrasi webhook Dify ke Google Sheets menggunakan reka bentuk Verification Router yang telah diuji dalam persekitaran produksi untuk mengesahkan medan masuk sebelum menambah baris Google Sheets. Bahagian AI Flowi diuji dalam persekitaran produksi pada 8 Oktober 2026: input yang diterima memulangkan 200, penolakan pengesahan memulangkan 422 dengan sebab, dan kunci yang tiada atau tidak sah memulangkan 403. Penolakan tidak menulis sebarang baris. JSON aliran kerja yang telah dibersihkan daripada maklumat sensitif diimport ke aliran baharu dan diuji semula. Bahagian Dify didokumenkan, bukan diuji oleh Ai Flowi.
Langkah pembinaan lengkap: tutorial webhook ke Google Sheets. Muat turun ZIP JSON aliran kerja yang telah dibersihkan daripada maklumat sensitif dan disahkan.
Dify DSL bukan format import untuk AI Flowi. Dify mengeksport DSL YAML miliknya sendiri; AI Flowi mengimport JSON aliran kerja miliknya sendiri. Gunakan eksport Dify sebagai rujukan untuk membina semula tingkah laku. Menamakan semula fail atau menukar sintaksnya tidak menjadikan komponen atau bukti kelayakan serasi.
Berkaitan: Migrasi webhook n8n ke Google Sheets: pindahkan aliran kerja ke AI Flowi Workflow.
Sebelum bermula
- Rekodkan medan input Dify sedia ada, transformasi, urutan lajur, destinasi, pengesahan, respons pemanggil dan dasar penghantaran pendua anda.
Pemetaan Dify ke AI Flowi dan catatan platform
Dify mendokumenkan Webhook Trigger dan nod HTTP Request. Plugin Google Sheets oleh omluc di pasarannya, v0.0.2, ialah plugin pihak ketiga yang menyenaraikan Batch Get dan Batch Update dengan pengesahan JSON akaun perkhidmatan. Tiada alat Google Sheets rasmi ditemui dalam dokumentasi rasmi Dify semasa semakan pada 8 Oktober 2026. Untuk menambah baris, laluan yang disimpulkan ialah Batch Update dengan julat yang dipilih atau HTTP Request ke operasi values:append Sheets API. Kemas kini julat tidak semestinya menambah baris: rekodkan cara aliran semasa anda memilih destinasinya.
Webhook Trigger Dify mendokumenkan status lalai 200 dan julat status tersuai 200–399. Rekodkan respons yang kini diharapkan oleh penghantar anda. Butiran Dify ini didokumenkan, bukan diuji oleh Ai Flowi; tutorial ini tidak mendakwa bahawa laluan Dify yang disimpulkan itu telah dijalankan.
| Laluan Dify | Destinasi AI Flowi | Catatan pembinaan semula secara manual |
|---|---|---|
| Webhook Trigger | Universal Webhook | Rekodkan medan masuk, pengesahan dan respons pemanggil; gantikan laluan penghantar selepas ujian. |
| HTTP Request ke Sheets API values:append, atau Batch Update plugin pihak ketiga dengan julat yang dipilih | Append Rows | Bina semula pemetaan lajur name/email/request. Kemas kini julat tidak semestinya menambah baris; rekodkan cara laluan sedia ada memilih destinasinya. |
| JSON akaun perkhidmatan yang digunakan oleh plugin Google Sheets | Google Connection | Berikan semula kebenaran kepada akaun destinasi; bukti kelayakan plugin tidak dipindahkan. |
Perkara yang perlu dibina semula secara manual
Eksport DSL Dify tidak menyertakan kunci API alat pihak ketiga dan kandungan sebenar pangkalan pengetahuan. Bukti kelayakan plugin akaun perkhidmatannya bukan Google Connection AI Flowi: berikan semula kebenaran kepada akaun destinasi. Periksa eksport untuk mengesan maklumat rahsia sebelum berkongsi. JSON awam yang dibekalkan telah dibersihkan daripada maklumat sensitif; eksport pukal biasa boleh mengekalkan label akaun, pengecam sambungan, ID hamparan dan URL titik akhir.
Perkara yang tidak dipindahkan
- Tiada import terbina dalam: Dify DSL YAML tidak boleh diimport ke AI Flowi. Bina semula tingkah laku secara manual; JSON AI Flowi yang dibekalkan ialah resipi permulaan, bukan aliran kerja Dify yang telah ditukar format.
- Ciri tanpa padanan yang telah diuji dalam resipi ini: laluan Batch Get / Batch Update plugin Sheets pihak ketiga dan julat status webhook tersuai Dify 200–399 tidak membuktikan tingkah laku penambahan baris atau respons pemanggil yang setara dalam AI Flowi. Butiran platform sumber ini didokumenkan (sumber rasmi, disemak 8 Oktober 2026), bukan diuji oleh Ai Flowi: penyenaraian plugin di pasaran Dify dan Dify Webhook Trigger. Bina semula dan uji sebarang tingkah laku yang diperlukan secara berasingan.
- Bukti kelayakan dan kandungan pengetahuan: cipta semula sambungan Google dan pengesahan webhook dalam AI Flowi. Dify DSL tidak menyertakan kunci API alat pihak ketiga dan kandungan sebenar pangkalan pengetahuan (didokumenkan (sumber rasmi, disemak 8 Oktober 2026), bukan diuji oleh Ai Flowi); simpan dokumen pengetahuan yang diperlukan secara berasingan.
- URL webhook: penghantar mesti menggunakan AI Flowi Production Endpoint baharu selepas semakan penerimaan. Simpan URL Dify lama dan log sejarah yang diperlukan untuk pemulihan ke sistem asal.
Keputusan AI Flowi yang telah diuji (8 Oktober 2026)
Reka bentuk yang dibekalkan lulus ujian persekitaran produksi dan import ke aliran baharu pada 8 Oktober 2026. Keputusan ini meliputi resipi AI Flowi, bukan aliran kerja Dify anda yang dimigrasikan. Bina semula pemetaan medan, bukti kelayakan dan destinasi anda sendiri, kemudian sahkan respons pemanggil serta helaian yang ditulis sebelum menukar penghantar.
| Kes | Keputusan HTTP yang direkodkan | Keputusan destinasi yang direkodkan |
|---|---|---|
| Badan permintaan dan kunci platform yang sah | 200, dengan hasil penambahan baris | Satu baris ditambah mengikut urutan name/email/request |
| Medan tiada, jenis salah atau e-mel tidak sah | 422, dengan sebab bagi setiap medan | Tiada baris ditambah |
| JSON dengan format yang salah | 422, dengan ralat badan permintaan berbentuk objek | Tiada baris ditambah |
| Kunci platform tiada atau tidak sah | 403, sebelum aliran dijalankan | Tiada baris ditambah |
| ID hamparan salah, aliran asal sahaja | 404, ralat mentah komponen Google | Helaian ujian tidak berubah |
| Peristiwa sah yang sama dihantar dua kali | 200 bagi setiap penghantaran | Dua baris ditambah; tiada penyahduplikasian |
Salinan yang diimport ke aliran baharu menghasilkan semula kejayaan, penolakan pengesahan, penolakan kunci dan tingkah laku pendua. Ujian ID salah hanya dilakukan pada reka bentuk asal. Bandingkan badan respons dan baca semula helaian sebenar selepas setiap kes; kanvas atau import yang berjaya sahaja tidak membuktikan bahawa data telah ditulis.
Had yang diketahui: versi penambahan baris yang lebih ringkas pada 8 Oktober menambah satu baris bagi setiap penghantaran pendua. Bagi penghantar yang mencuba semula, gunakan dan uji versi perlindungan pendua, yang diuji dalam persekitaran produksi pada 9 Oktober 2026 dan menggunakan event_id serta Upsert Row untuk penghantaran berturutan; penghantaran serentak masih boleh menyebabkan kedua-duanya memasukkan baris. Kegagalan Sheets mendedahkan butiran ralat mentah Google, termasuk ID hamparan dalam URL API; resipi ini tiada mekanisme yang disokong untuk menangkap ralat tersebut dalam aliran. Percubaan semula/pemulihan automatik, tamat masa dengan hasil yang tidak pasti, kadar pemprosesan, kebolehpercayaan umum, helaian yang dicipta secara luaran dan pengesahan External Provider masih belum disahkan. Mencuba semula badan permintaan yang tidak sah tanpa perubahan tidak akan membetulkannya.
Simpan bukti kelayakan, dokumen pengetahuan dan log sejarah yang diperlukan secara berasingan: DSL Dify tidak memindahkannya melalui import JSON AI Flowi. Respons pemanggil, dasar percubaan semula dan peraturan akses memerlukan semakan tingkah laku walaupun nama nod kelihatan serupa.
Senarai semak peralihan
Gunakan langkah ini untuk aliran kerja Dify yang anda bina semula. Ini ialah senarai semak operasi, bukan bukti bahawa peralihan antara platform ini telah diuji.
- Bina dan konfigurasikan: ikut persediaan tutorial asas, atau persediaan perlindungan pendua bagi penghantar yang mencuba semula. Cipta semula sambungan Google; semak Spreadsheet ID, tab, urutan lajur, pemetaan medan, kaedah POST, pengesahan Platform API Key dan mod respons From Flow. Pastikan medan JQ kelihatan.
- Jalankan ujian penerimaan pada AI Flowi: input sah yang telah disahkan mesti memulangkan 200 dan menulis satu baris; medan tiada, jenis salah, e-mel tidak sah dan JSON dengan format yang salah mesti memulangkan 422 tanpa menambah baris; kunci tiada dan tidak sah mesti memulangkan 403 tanpa menambah baris. Baca semula helaian selepas setiap kes.
- Uji penghantaran pendua: versi penambahan baris menulis dua baris bagi dua penghantaran sah yang sama. Dengan versi perlindungan pendua, hantar
event_idyang sama secara berturutan: jangkakan 200 dengan{"status":"inserted"}, kemudian 200 dengan{"status":"duplicate"}tanpa baris tambahan. Penghantaran serentak masih boleh menyebabkan kedua-duanya memasukkan baris. - Jalankan kedua-dua sistem secara selari pada helaian ujian: hantar input sintetik yang sama kepada Dify dan AI Flowi, menggunakan tab berasingan dalam hamparan ujian supaya hasil penulisan dapat dibandingkan. Bandingkan nilai yang dipetakan, urutan lajur, respons HTTP dan tingkah laku pendua dengan kontrak pemanggil yang anda rekodkan. Selesaikan perbezaan sebelum menukar penghantar produksi.
- Tukar URL penghantar: rekodkan URL lama dan masa peralihan, kemudian gantikan URL webhook Dify dengan AI Flowi Production Endpoint dan konfigurasikan pengesahan AI Flowi bagi penghantar.
- Pantau permintaan pertama: semak status/badan respons pemanggil dan baris sebenar di destinasi untuk mengesan penulisan yang hilang atau berulang. Kegagalan Sheets boleh memulangkan ralat mentah platform; resipi yang diuji tiada mekanisme menangkap ralat dalam aliran. Gunakan pelan pemulihan ke sistem asal jika tingkah laku yang dibina semula gagal dalam semakan anda.
- Kekalkan tempoh pemulihan ke sistem asal: nyahaktifkan aliran kerja Dify lama selepas pertukaran. Biarkannya dinyahaktifkan, bukan dipadamkan, dengan URL dan konfigurasi tersedia sehingga tempoh pemulihan yang anda pilih berakhir.
Pelan pemulihan ke sistem asal
- Pulihkan penghantaran: halakan penghantar semula ke URL webhook Dify yang direkodkan, pulihkan pengesahan asalnya dan aktifkan semula aliran kerja lama. Sahkan satu permintaan dan baris di destinasi, kemudian nyahaktifkan pengganti AI Flowi.
- Selaraskan rekod sepanjang tempoh peralihan: apabila versi perlindungan pendua digunakan, bandingkan baris yang ditulis sepanjang tempoh tersebut dengan rekod penghantar mengikut
event_idsebelum menghantar semula peristiwa yang hilang. Kekalkan pengecam yang sama untuk percubaan semula. Upsert Row mengemas kini baris sepadan yang sedia ada; ia tidak menggabungkan baris pendua sedia ada, dan skop kuncinya ialah satu lembaran kerja. Jika aliran kerja lama tidak menyimpanevent_id, simpan pengecam itu dalam rekod penghantar untuk penyelarasan manual. Versi penambahan baris tiada perlindungan pendua event_id, jadi semak baris dalam tempoh tersebut secara manual sebelum menghantar semula.
Beralih semula tidak membatalkan penulisan pada helaian. Ini ialah pemulihan operasi secara manual ke sistem asal; had perlindungan pendua yang diuji masih terpakai, termasuk kemungkinan baris dimasukkan serentak.
Sumber dan skop bukti
- Tutorial webhook ke Google Sheets yang dikemas kini dan ZIP JSON aliran kerja yang telah dibersihkan daripada maklumat sensitif. Resipi, JQ yang tepat, respons dan had diambil daripada laporan ujian persekitaran produksi dan import ke aliran baharu bertarikh 8 Oktober 2026; port sepadan dengan fail import yang telah dibersihkan daripada maklumat sensitif.
- Google Connection, import/eksport aliran kerja AI Flowi dan harga AI Flowi.
- Eksport Dify DSL, Webhook Trigger, HTTP Request, plugin Google Sheets omluc dan katalog alat rasmi. Sumber rasmi disemak pada 8 Oktober 2026; didokumenkan, bukan diuji oleh Ai Flowi.