កំណត់ការដឹកជញ្ជូន Outbound Webhook

ការរៀបចំរហ័ស

សណ្ឋាគារភាគច្រើនបញ្ចប់វានៅក្នុង 5 ទៅ 10 នាទី។

មគ្គុទ្ទេសក៍នេះជួយអ្នកផ្ញើ event JSON guest_verified បន្ទាប់ពីការផ្ទៀងផ្ទាត់ភ្ញៀវ និង PMS sync។

ទៅកាន់: Settings → Outbound Webhook

Signature header

រាល់ delivery រួមបញ្ចូល X-Vouch-Signature។ ប្រព័ន្ធទទួលរបស់អ្នកគួរផ្ទៀងផ្ទាត់ header នេះ មុនទុកចិត្តលើ payload។

ឯកសារយោងរហ័ស

ការកំណត់	វាគ្រប់គ្រងអ្វី	អ្វីដែលអ្នកឃើញ
Enabled	បើក ឬបិទការដឹកជញ្ជូន outbound webhook	Toggle នៅតែបើក បន្ទាប់ពី save
Webhook URL	URL ទិសដៅសម្រាប់ delivery	AVA ទទួល URL របស់ receiver
Headers	Static auth headers សម្រាប់ receiver	តម្លៃសម្ងាត់នៅតែត្រូវបាន mask បន្ទាប់ពី save
Payload Fields	វាលភ្ញៀវណាខ្លះត្រូវផ្ញើ	មានតែវាលដែលធីកប៉ុណ្ណោះបង្ហាញក្នុង delivery
Max attempts	ចំនួន retry សម្រាប់ delivery បរាជ័យ	តម្លៃនៅក្នុងចន្លោះ 1 ទៅ 10
HMAC signing secret	ការចុះហត្ថលេខា payload សម្រាប់រាល់ delivery	Save ត្រូវបានបិទ ប្រសិនបើគ្មាន secret ពេលបើក ឬ testing
Send Test	ផ្ញើ delivery សាកល្បងមួយ	ការសាកល្បងចុងក្រោយបង្ហាញក្នុង Delivery Logs
Delivery Logs	ស្ថានភាព delivery ថ្មីៗ និង payloads	អ្នកឃើញ 10 records ក្នុងមួយ page រួមទាំង status, attempts, HTTP status, response body, និង payload details

មុនចាប់ផ្តើម

បញ្ជាក់មូលដ្ឋានទាំងនេះ៖

• អ្នកមានសិទ្ធិ settings:write
• អ្នកដឹង URL របស់ receiver
• អ្នកដឹង static auth headers ដែលត្រូវការ
• អ្នកមាន HMAC signing secret
• អ្នកដឹងថាវាលភ្ញៀវណាខ្លះដែល receiver ត្រូវការ

Secrets ដែលបានរក្សាទុកនៅតែ masked

តម្លៃ header និង signing secret ដែលបានរក្សាទុកនៅតែត្រូវបានលាក់។ ចុច pencil icon ពេលអ្នកចង់ជំនួសវា។

ពេលវាផ្ញើ

AVA ផ្ញើ webhook បន្ទាប់ពី guest verification ជោគជ័យ។ ឈ្មោះ event គឺ guest_verified។ AVA មិនផ្ញើ webhook ទេ បើ PMS sync បរាជ័យ។

សំណើប្រើ JSON POST។ AVA រួមបញ្ចូល static headers របស់អ្នកក្នុង delivery គ្រប់លើក។

កំណត់រចនាសម្ព័ន្ធ Webhook

បើកវា

1. ទៅកាន់ Settings → Outbound Webhook។

2. បើក Enabled។

3. បញ្ចូល Webhook URL។

4. ចុច Save។

   ✓ AVA រក្សាទុក endpoint សម្រាប់ delivery នាពេលក្រោយ។

បន្ថែម Custom Headers

ប្រើ headers ពេល receiver រំពឹង auth ស្ថិតស្ថេរ។ AVA ផ្ញើវាទៅក្នុង JSON POST គ្រប់លើក។ ឧទាហរណ៍ អ្នកអាចផ្ញើ Authorization: token api_key:api_secret។

1. ចុច Add។

2. បញ្ចូលឈ្មោះ header។

3. បញ្ចូលតម្លៃ header។

4. បើក Secret សម្រាប់តម្លៃសម្ងាត់។

5. ចុច Save។

   ✓ Secret headers នៅតែត្រូវបាន mask បន្ទាប់ពី save។

ជ្រើស Payload Fields

ជ្រើសវាលដែល receiver ត្រូវការពីកាត Payload Fields។ ជម្រើសធម្មតារួមមាន confirmation number, dates, guest contact details, nationality, document number, និង marketing consent។

1. ធីកវាលនីមួយៗដែលអ្នកចង់ផ្ញើ។

2. ដកធីកវាលណាដែល receiver មិនត្រូវការ។

3. ចុច Save។

   ✓ មានតែវាលដែលធីកប៉ុណ្ណោះដែលបង្ហាញក្នុង delivery នាពេលក្រោយ។

កំណត់ Retry Attempts និង Signing Secret

ប្រើ retry សម្រាប់ការបរាជ័យ delivery ជាបណ្ដោះអាសន្ន។ កំណត់ signing secret ដើម្បីឲ្យ receiver អាចផ្ទៀងផ្ទាត់ payload នីមួយៗបាន។

1. បញ្ចូលតម្លៃក្នុង Max attempts។

2. ប្រើតម្លៃពី 1 ទៅ 10។

3. បញ្ចូល HMAC signing secret របស់អ្នក។

4. ចុច Save។

   ✓ AVA retry ករណីបរាជ័យ 429, 5xx និង timeout។ ✓ កំហុស validation និង authentication នៅតែស្ថិតក្នុង log ដោយមិន retry។

ជំនួស Secret ដែលបានរក្សាទុក

ប្រើវា នៅពេល header secret ឬ signing secret មានរួចហើយ។ អ្នកមិនអាចបង្ហាញតម្លៃចាស់បានទេ។

1. ចុច pencil icon នៅជាប់ secret ដែលបាន mask។

2. បញ្ចូលតម្លៃថ្មី។

3. ចុច Save។

   ✓ តម្លៃដែលបានរក្សាទុកនៅតែត្រូវបាន mask បន្ទាប់ពី save។

ផ្ញើ Delivery សាកល្បង

ប្រើ delivery សាកល្បង បន្ទាប់ពីអ្នករក្សាទុកការកំណត់។ ការសាកល្បងប្រើ configuration ដែលបានរក្សាទុកចុងក្រោយ។ វាក៏ប្រើ HMAC signing secret ដែលបានរក្សាទុកផងដែរ។

1. ចុច Send Test។

2. រង់ចាំសារជោគជ័យ។

3. បើក Delivery Logs ដើម្បីបញ្ជាក់ថា row ថ្មីបង្ហាញឡើង។

   ✓ Row ថ្មីបំផុតបង្ហាញ test delivery។

Save first

បើអ្នកផ្លាស់ប្តូរអ្វីមួយលើទំព័រ សូម save មុនពេលផ្ញើ test។ AVA បិទប៊ូតុង test រហូតដល់ការផ្លាស់ប្តូរដែលមិនទាន់ save ត្រូវបានដោះស្រាយ។

ពិនិត្យ Delivery Logs

Delivery logs ជួយអ្នកពិនិត្យការព្យាយាមថ្មីៗ។ រាល់ page បង្ហាញ 10 rows។ រាល់ row បង្ហាញ delivery status, timestamp, attempts, HTTP status, និងព័ត៌មានលម្អិត។ អ្នកក៏អាចបើក request payload និង response body បាន។ ប្រើ page controls ដើម្បីផ្លាស់ទីរវាង delivery ចាស់ និងថ្មី។

Status	មានន័យថា
delivered	Receiver បានទទួល delivery
processing	AVA កំពុងដំណើរការ delivery
retrying	AVA នឹងព្យាយាមម្ដងទៀតនៅពេលក្រោយ
pending	AVA បានដាក់ delivery ចូល queue
failed	AVA ឈប់ retry delivery នោះហើយ

1. ចុច Refresh delivery logs ដើម្បីផ្ទុក page បច្ចុប្បន្នឡើងវិញ។

2. ប្រើ First page, Previous, Next, ឬ Last page ពេលមានលទ្ធផលច្រើន។

3. បើក row មួយ ដើម្បីពិនិត្យ response details។

4. ពង្រីក View request payload បើអ្នកត្រូវការមើល JSON ដែលបានផ្ញើ។

   ✓ Page counter បង្ហាញ Page X of Y ពេលមានច្រើន page។ ✓ Controls នៅតែអាចប្រើបាន រហូតដល់អ្នកទៅដល់ first ឬ last page។

Redacted details

តម្លៃសម្ងាត់នៅតែត្រូវបាន redacted ក្នុង log view។ ប្រើ payload details សម្រាប់ troubleshooting ប៉ុណ្ណោះ។

ការដោះស្រាយបញ្ហា

ទំព័រមិនផ្ទុក

អ្វីដែលអ្នកឃើញ: អ្នកឃើញ Unable to load outbound webhook settings។

វិធីដោះស្រាយ៖

1. ចុច Retry។
2. Refresh ទំព័រ។
3. បញ្ជាក់ថាអ្នកនៅក្នុង property ត្រឹមត្រូវ។
4. សាកល្បងម្ដងទៀត បន្ទាប់ពី sign in ម្តងទៀត ប្រសិនបើចាំបាច់។

Save បរាជ័យ ពេលបើក webhook

អ្វីដែលអ្នកឃើញ: Save បរាជ័យ បន្ទាប់ពីបើក Enabled។

វិធីដោះស្រាយ៖

1. បញ្ចូល HMAC signing secret។
2. Save ម្តងទៀត។
3. បើអ្នកមានរួចហើយ សូមជំនួសវា ជំនួសឱ្យការលុបចេញ។

Send Test នៅតែបិទ

អ្វីដែលអ្នកឃើញ: Send Test ត្រូវបានបិទ បន្ទាប់ពីអ្នកកែទំព័រ។

វិធីដោះស្រាយ៖

1. ចុច Save មុន។
2. រង់ចាំសារជោគជ័យ។
3. សាកល្បង Send Test ម្តងទៀត។
4. បញ្ជាក់ថាអ្នកមានសិទ្ធិ settings។

Webhook URL ត្រូវបានបដិសេធ

អ្វីដែលអ្នកឃើញ: Save ឬ test បរាជ័យសម្រាប់ destination URL មួយចំនួន។

វិធីដោះស្រាយ៖

1. ប្រើ public HTTPS URL។
2. លុប private, reserved, loopback, និង site-local addresses ចេញ។
3. សាកល្បងម្តងទៀតជាមួយ public receiver។

Delivery logs នៅទទេ

អ្វីដែលអ្នកឃើញ: Delivery Logs មិនទាន់មាន row។

វិធីដោះស្រាយ៖

1. ចុច Send Test។
2. រង់ចាំ event guest verification។
3. ចុច Refresh delivery logs។
4. ពិនិត្យ page counter និង page controls បើអ្នករំពឹង delivery ចាស់ៗ។
5. ពិនិត្យម្ដងទៀត បន្ទាប់ពី check-in ដែលសមរម្យនៅលើកក្រោយ។
6. ប្រើ Last page បើអ្នកត្រូវការលោតទៅ delivery ចាស់ៗឱ្យលឿន។

នៅតែជាប់?

ទាក់ទង success@vouch-technologies.com ប្រសិនបើ៖

• ❌ ទំព័រនៅតែមិនផ្ទុក បន្ទាប់ពី retry
• ❌ Save បរាជ័យ បន្ទាប់ពីអ្នកបន្ថែម HMAC signing secret
• ❌ Test deliveries មិនបង្ហាញក្នុង logs

បញ្ចូល៖

• រូបថតអេក្រង់នៃកំហុស
• ពេលបញ្ហាចាប់ផ្តើម
• តម្លៃគោលដៅ webhook ដែលអ្នកបានប្រើ