Webhooks

Webhooks нь гадаад сервист workflow-г HTTP request илгээх замаар эхлүүлэх боломжийг олгодог. OpenAgentAGI нь webhook суурилсан хоёр аргыг дэмждэг.

Generic Webhook Trigger

Generic Webhook block нь зөвхөн таны workflow-г эхлүүлэх уян endpoint үүсгэдэг, ямар ч payload-г хүлээж авна:

Ажиллах зарчим

1. Generic Webhook Block нэмэх – Workflow эхлэхэд Generic Webhook block-г canvas-д оруулна
2. Payload тохируулах – Хүлээж авах payload-ийн бүтэц тохируулах (заавал биш)
3. Webhook URL авах – Автомат үүссэн уник endpoint-ийг хуулна
4. Гадаад интеграц – Гадаад сервис POST request-ийг энэ URL руу илгээхээр тохируулна
5. Workflow Execution – Webhook URL-д ирсэн request бүр workflow-г эхлүүлнэ

Онцлогууд

• Уян payload: JSON бүтэц ямар ч байж болно
• Автомат parsing: Webhook мэдээлэл автоматаар parse хийгдэж, дараагийн block-д ашиглагдана
• Authentication: Bearer token эсвэл custom header сонголттой
• Rate Limiting: Давтагдсан хэрэглээнээс хамгаалах хамгаалалт
• Deduplication: Давталт request-оор workflow-г дахин ажиллахгүй

Service Blocks-д Trigger Mode ашиглах

Мөн тодорхой сервис block-ууд (Slack, GitHub гэх мэт) trigger mode-оор ашиглаж, илүү онцгой webhook endpoint үүсгэж болно:

Trigger Mode тохируулах

1. Service Block нэмэх – Сервис block сонгоно (Slack, GitHub, Airtable гэх мэт)
2. Trigger Mode идэвхжүүлэх – Block settings-д "Use as Trigger" toggle хийх
3. Сервис тохируулах – Auth болон event filter-ийг тусгай сервисийн дагуу тохируулна
4. Webhook бүртгэл – Сервис webhook-ийг гадаад платформд автоматаар бүртгэнэ
5. Event-Based Execution – Workflow зөвхөн тухайн сервисээс ирсэн тодорхой event дээр ажиллана

Аль аргийг хэзээ ашиглах вэ

Generic Webhook ашиглах үед:

• Custom аппликейшн эсвэл сервисийг интеграцлах
• Payload бүтэцэд хамгийн их уян хатан байдал хэрэгтэй бол
• Тусгай block байхгүй сервисүүдтэй ажиллах
• Дотоод интеграц бүтээх

Trigger Mode ашиглах үед:

• Дэмжигдсэн сервисүүдтэй ажиллах (Slack, GitHub гэх мэт)
• Сервис тусгай event filter хэрэгтэй
• Webhook-ийг автоматаар бүртгэх
• Тухайн сервисийн бүтэцтэй өгөгдлийг шууд авах

Trigger Mode дэмждэг сервисүүд

• Slack – Мессеж, mentions, reactions
• GitHub – Push, PR, issue event
• Airtable – Record өөрчлөлт
• Telegram – Bot мессеж, commands
• Gmail – Email мэдэгдэл
• WhatsApp – Messaging events
• Jira – Issue update, comments
• Linear – Issue state өөрчлөлт
• Notion – Page update

Аюулгүй байдал ба Шилдэг Туршлага

Authentication Сонголтууд

• Bearer Tokens: Authorization: Bearer <token> header оруулах
• Custom Headers: Custom authentication header тодорхойлох

Payload боловсруулах

• Validation: Malformed data-ыг урьдчилан сэргийлэх
• Size Limits: Payload size limit баталгаажуулах
• Error Handling: Invalid request-д error response тохируулах

Webhook турших

1. Postman эсвэл curl ашиглан endpoint-г турших
2. Workflow execution log-г шалгах
3. Payload бүтэц таны хүлээсэнтэй тохирч байгааг шалгах
4. Authentication болон алдаа нөхцлийг турших

Түгээмэл Ашиглалтууд

Real-time Мэдэгдэл

• Slack мессеж workflow-г автоматаар ажиллуулах
• Чухал event-ийн email мэдэгдэл

CI/CD Интеграц

• GitHub push workflow-ийг эхлүүлэх
• Build статус мэдэгдэл
• Автомат тест pipeline

Өгөгдлийн Синхронизаци

• Airtable өөрчлөлт бусад системд update хийх
• Form submit follow-up action эхлүүлэх
• E-commerce order боловсруулалт

Customer Support

• Support ticket үүсгэх workflow
• Автомат escalation процесс
• Олон сувгийн харилцааг чиглүүлэх