---

Webhook គឺជាសារប្រព័ន្ធអូតូដែលត្រូវបានផ្ញើពីកម្មវិធីមួយទៅកម្មវិធីមួយផ្សេងទៀតនៅពេលដែលមានអ្វីកើតឡើង។ ឧទាហរណ៍ នៅពេលដែលកំណត់ត្រាថ្មីត្រូវបានបង្កើតក្នុង Blue, Webhook អាចត្រូវបានកំណត់ឱ្យផ្ញើទិន្នន័យអំពីកំណត់ត្រានោះទៅប្រព័ន្ធផ្សេងទៀត។

Webhooks របស់ Blue ត្រូវបានចាប់ផ្តើមភ្លាមៗ ក្នុងរយៈពេលមីលីវិនាទីបន្ទាប់ពីព្រឹត្តិការណ៍កើតឡើង។ ភាពជាក់ស្តែងនេះធ្វើឱ្យវាអស្ចារ្យសម្រាប់ការបញ្ចូល Blue ជាមួយប្រព័ន្ធអាជីវកម្មផ្សេងទៀត។

Webhooks

• ការសម្របសម្រួលទិន្នន័យពេលវេលាពិតនៅក្នុងប្រព័ន្ធ
• សមត្ថភាពឆ្លើយតប និងអនុវត្តន៍លើព្រឹត្តិការណ៍ Blue
• មិនចាំបាច់ត្រូវធ្វើការត្រួតពិនិត្យជាអចិន្ត្រៃយ៍សម្រាប់ការផ្លាស់ប្តូរ; ផ្ញើភ្លាមៗ
• បង្កើតការបញ្ចូល និងការងារដោយផ្ទាល់

ការគ្រប់គ្រងដែលមិនធ្លាប់មាន

Webhooks របស់ Blue ផ្តល់ឱ្យអ្នកនូវការគ្រប់គ្រងល្អលើ:

• ព្រឹត្តិការណ៍ណាដែលគួរត្រូវបានចាប់ផ្តើម webhook និងពីគម្រោងណា
• ការតម្រង់ដើម្បីកំណត់វិសាលភាពនៃកំណត់ត្រា
• ការបញ្ជាក់ហត្ថលេខាសម្រាប់សុវត្ថិភាពកាន់តែខ្ពស់

ការបង្កើត Webhook

នៅក្នុង Blue, អ្នកគ្រប់គ្រងគម្រោងអាចបង្កើត webhooks នៅក្រោមការកំណត់ផ្ទាល់ខ្លួន។ អ្នកត្រូវកំណត់:

• ឈ្មោះ Webhook
• URL Payload ដើម្បីផ្ញើទិន្នន័យ
• សម្ងាត់ជាជម្រើសសម្រាប់ហត្ថលេខា

Triggers

Webhooks អាចត្រូវបានចាប់ផ្តើមដោយព្រឹត្តិការណ៍ Blue ជាច្រើនប្រភេទ, រួមមាន:

• កំណត់ត្រាបង្កើត/ធ្វើបច្ចុប្បន្នភាព/លុប
• ការអត្ថាធិប្បាយបានបន្ថែម/កែសម្រួល
• អ្នកចាត់ចែងបានផ្លាស់ប្តូរ
• ស្ថានភាពបញ្ជីត្រួតពិនិត្យបានផ្លាស់ប្តូរ
• តម្លៃវាលកំណត់ត្រាផ្ទាល់ខ្លួនបានផ្លាស់ប្តូរ
• និងច្រើនទៀត

Webhook Payload

នៅពេលដែលត្រូវបានចាប់ផ្តើម, Blue ផ្ញើ payload JSON ដែលមានព័ត៌មានលម្អិតទាំងអស់នៃព្រឹត្តិការណ៍ទៅ URL ដែលអ្នកបានកំណត់។

នេះគឺជាឧទាហរណ៍ payload:

{
  "event": "RECORD_CREATED",
  "record": {
    "id": "1234",
    "title": "New record"
    ...
  },
  "company": {
    "id": "5678"  
  },
  "project": {
    "id": "91011"
  },
  "user": {
    "id": "1213" 
  }
}

ហត្ថលេខា

ដើម្បីបញ្ជាក់ថា payloads មកពី Blue ពិតប្រាកដ, អាចត្រូវបានពិនិត្យហត្ថលេខាជាជម្រើស។ ដូចជាការប្រើប្រាស់ OAuth, ហត្ថលេខាត្រូវបានបង្កើតដោយការបញ្ចូលមាតិកា payload ជាមួយសោដែលអ្នកបានជ្រើសរើស។

ការបញ្ជាក់គំរូនៅក្នុង Node.js

const crypto = require('crypto');
const key = 'secret'; 
const body = {...webhookPayload} 
const hash = crypto.createHmac('sha256', key).update(body);
const signature = hash.digest('hex');

ការបញ្ចូលបន្ថែម

ក្រៅពី webhooks ផ្ទាល់ខ្លួន, Blue ក៏ផ្តល់ឱ្យនូវការបញ្ចូលជាមួយឧបករណ៍ដូចជា Zapier និង Pabbly Connect ដើម្បីសម្រួលការតភ្ជាប់ទិន្នន័យ Blue ជាមួយកម្មវិធីពេញនិយមរាប់រយ។

ឧទាហរណ៍ចម្លើយ Webhook

{

  "event": "TODO_CREATED",

  "webhook": {

    "id": "clb4qaopy0000vt24mlp28v03",

    "uid": "edb5b5d51dc9461a952160dbe72153b4",

    "name": "Testing webhook",

    "url": "https://httpdump.app/dumps/7cc66eda-8e83-4039-ba49-4c36db14d508",

    "secret": "",

    "status": "HEALTHY",

    "enabled": true,

    "metadata": {

      "events": [

        "TODO_CREATED",

        "TODO_DELETED",

        "TODO_MOVED",

        "TODO_NAME_CHANGED",

        "TODO_CHECKLIST_CREATED",

        "TODO_CHECKLIST_NAME_CHANGED",

        "TODO_CHECKLIST_DELETED",

        "TODO_CHECKLIST_ITEM_CREATED",

        "TODO_LIST_CREATED",

        "TODO_LIST_DELETED",

        "TODO_LIST_NAME_CHANGED",

        "COMMENT_CREATED",

        "COMMENT_DELETED",

        "COMMENT_UPDATED"

      ],

      "projectIds": [

        "clakt90vu000bvt64hhffqleq",

        "claulnu1y0000vtrcjurjgds4",

        "clb4gay0y000qvtzs8smaays8"

      ]

    },

    "createdById": "claksl2ye0000vtas0h0ln71e",

    "createdAt": "2022-12-01T07:01:25.014Z",

    "updatedAt": "2022-12-01T11:23:00.661Z"

  },

  "currentValue": {

    "id": "clb4zna6x0000vt1swuwso25f",

    "uid": "11021cb836f34732b31e5ebd5dd5eb27",

    "title": "GGGG",

    "html": null,

    "text": null,

    "position": "32767.5",

    "archived": false,

    "done": false,

    "startedAt": null,

    "duedAt": null,

    "timezone": null,

    "createdAt": "2022-12-01T11:23:09.000Z",

    "updatedAt": "2022-12-01T11:23:09.241Z",

    "createdById": "claksl2ye0000vtas0h0ln71e",

    "todoListId": "clakt9v5t000kvt64f563l90l",

    "todoCustomFields": [],

    "todoUsers": [],

    "todoTags": [],

    "todoList": {

      "id": "clakt9v5t000kvt64f563l90l",

      "uid": "df0e931e6e8f4fc2905ece9da167d2d3",

      "createdAt": "2022-11-17T08:29:22.000Z",

      "updatedAt": "2022-11-17T08:29:22.050Z",

      "title": "ETEST",

      "position": 131070,

      "createdById": "claksl2ye0000vtas0h0ln71e",

      "projectId": "clakt90vu000bvt64hhffqleq",

      "project": {

        "id": "clakt90vu000bvt64hhffqleq",

        "uid": "d7db469a8908496f8e5f5e68030fe4c8",

        "slug": "teest",

        "name": "TEEST",

        "description": "",

        "archived": false,

        "createdAt": "2022-11-17T08:28:43.000Z",

        "updatedAt": "2022-11-17T08:28:42.811Z",

        "isTemplate": false,

        "isOfficialTemplate": false,

        "category": "GENERAL",

        "companyId": "clakt8jud0002vt64205yyj10",

        "imageId": null,

        "hideEmailFromRoles": null,

        "company": {

          "id": "clakt8jud0002vt64205yyj10",

          "uid": "400eb3f8238c486caf40957618be9662",

          "slug": "rogue",

          "name": "Rogue",

          "description": null,

          "createdAt": "2022-11-17T08:28:21.000Z",

          "updatedAt": "2022-11-17T08:28:20.726Z",

          "freeTrialExpiredAt": "2022-12-01T08:28:15.000Z",

          "freeTrialStartedAt": "2022-11-17T08:28:15.000Z",

          "subscribedAt": null,

          "imageId": null,

          "subscriptionPlanId": "clakt8jue0003vt64e40q2prj",

          "freeTrialExtendedById": null,

          "freeTrialExtendedAt": null

        }

      }

    }

  }

}