REST API ื•-webhooks

REST API ืฆื™ื‘ื•ืจื™ ืขื ื›ืžื” ืžืคืชื—ื•ืช API ื•-webhooks ื—ืชื•ืžื™ื

ื”ื•ืกื™ืคื• ืœืงื•ื—ื•ืช ืžื”ืืชืจ, ืžื”ื˜ื•ืคืก ืื• ืžื”ื‘ืงึพืื ื“ ื‘ืงืจื™ืืช HTTP ืื—ืช, ื•ืงื‘ืœื• ื›ืœ ืฉื™ื ื•ื™ ื‘ืฉืจืช ืฉืœื›ื ื—ืชื•ื ื‘-HMAC-SHA256.

ื”-CRM ืฉืœืš ืžืคืกื™ืง ืœื”ื™ื•ืช ืžืงื•ื ืฉืฆืจื™ืš ืœื”ื™ื›ื ืก ืืœื™ื• ื›ื“ื™ ืœื›ืชื•ื‘: ื”ื•ื ื”ื•ืคืš ืœ-endpoint ืฉื”ืžืขืจื›ื•ืช ืฉืœืš ืงื•ืจืื•ืช ืืœื™ื•.

AiCrm, ืืคืœื™ืงืฆื™ื™ืช ื”-CRM ืฉืœ AIsToHire, ื—ื•ืฉืคืช REST API ืฆื™ื‘ื•ืจื™ ืขืœ ืื ืฉื™ ื”ืงืฉืจ ืฉืœืš ืขืฆืžืš. ืขื ืžืคืชื— ื‘ื›ื•ืชืจืช `X-Api-Key` ืืคืฉืจ ืœื™ืฆื•ืจ, ืœืจืฉื•ื, ืœืฉืœื•ืฃ, ืœืขื“ื›ืŸ ื•ืœืžื—ื•ืง ืื ืฉื™ ืงืฉืจ, ื•ืœื”ื•ืกื™ืฃ ืคืขื™ืœื•ื™ื•ืช ืœื›ืœ ืื—ื“ ืžื”ื, ืžื˜ื•ืคืก ื”ืืชืจ, ืžืฆ'ืื˜ื‘ื•ื˜, ืž-Zap, ืžืกืงืจื™ืคื˜ Python ืื• ืžื”ื‘ืงึพืื ื“ ืฉืœืš. ื”ืชืฉื•ื‘ื•ืช ื”ืŸ JSON ื‘ืฆื•ืจืช `{ success, data }`, ื•ื”ืžื’ื‘ืœื” ื”ื™ื 100 ื‘ืงืฉื•ืช ืœื“ืงื” ืœื›ืœ ืžืคืชื—.

ื”ื”ื•ืกืคื” ื“ืจืš ื”-API ืœื ืžืฉื›ืคืœืช: ืื ื”ืื™ืžื™ื™ืœ ืฉืฉื•ืœื—ื™ื ื›ื‘ืจ ืงื™ื™ื ื‘ืžืกื“ ืฉืœืš, AiCrm ืžืขื“ื›ื ืช ืืช ื”ื›ืจื˜ื™ืก ืฉื›ื‘ืจ ื”ื™ื” ืœืš (ืžืฉืœื™ืžื” ืืช ื”ื˜ืœืคื•ืŸ, ื”ืฉื ืื• ื”ื—ื‘ืจื” ืฉื—ืกืจื•, ืžืื—ื“ืช ืืช ื”ืชื•ื•ื™ื•ืช) ื•ืจื•ืฉืžืช ืฉืœื™ื—ื” ื—ื“ืฉื” ื‘ืฆื™ืจ ื”ื–ืžืŸ ืฉืœื•, ื•ืžื—ื–ื™ืจื” HTTP 200; ืื ื”ื•ื ื—ื“ืฉ, ื”ื™ื ื™ื•ืฆืจืช ืื•ืชื• ื•ืžื—ื–ื™ืจื” 201. ื›ืœ ืื™ืฉ ืงืฉืจ ืฉื ื›ื ืก ื“ืจืš ื”-API ืžืชื•ื™ื’ ืื•ื˜ื•ืžื˜ื™ืช ื›-`api-lead`, ืฉื•ืžืจ ืืช ื”ืชื•ื•ื™ื•ืช ืฉืฉื•ืœื—ื™ื ื•ืฉื•ืžืจ ืืช ื”-`subId` ืฉืœ ื”ืžืงื•ืจ, ื‘ื ื•ืกืฃ ืœืžื“ื™ื ื”, ืœ-IP ื•ืœื“ืคื“ืคืŸ ืฉืžืžื ื• ื”ื’ื™ืข.

ืืคืฉืจ ืœื”ื—ื–ื™ืง ืขื“ 20 ืžืคืชื—ื•ืช API ืขื ืฉื ืžืฉืœื”ื, ื‘ื ื•ืกืฃ ืœืžืคืชื— ื”ืคื ื™ืžื™ ืฉืœ ื”ืืคืœื™ืงืฆื™ื”. ื›ืš ื ื•ืชื ื™ื ืžืคืชื— ืฉื•ื ื” ืœื›ืœ ืื™ื ื˜ื’ืจืฆื™ื” โ€” ื”ืืชืจ, ื˜ื•ืคืก ื”ืงืžืคื™ื™ืŸ ืฉืœ ืžืื™, ื”ืžืชืžื—ื”, ื”ืกืคืง โ€” ื•ืžื‘ื˜ืœื™ื ืื•ืชื• ืœื‘ื“ื• ื›ืฉื”ืื™ื ื˜ื’ืจืฆื™ื” ื”ื–ื• ืžืกืชื™ื™ืžืช, ื‘ืœื™ ืœื’ืขืช ื‘ืฉืืจ. ื”ืขืจืš ื”ืžืœื ืฉืœ ืžืคืชื— ืžื•ืฆื’ ืคืขื ืื—ืช ื‘ืœื‘ื“, ื‘ื™ืฆื™ืจื”; ืื—ืจ ื›ืš ืจื•ืื™ื ืื•ืชื• ืจืง ืžื•ืกืชืจ ื‘ืจืฉื™ืžื”.

ื‘ื›ื™ื•ื•ืŸ ื”ื”ืคื•ืš, ื”-webhooks ืžื•ื“ื™ืขื™ื ืœืžืขืจื›ื•ืช ืฉืœืš. ืžื’ื“ื™ืจื™ื ืขื“ 10 ื™ืขื“ื™ื, ื‘ื•ื—ืจื™ื ืœืื™ืœื• ืื™ืจื•ืขื™ื ื›ืœ ืื—ื“ ื ืจืฉื (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`) ื•-AiCrm ืฉื•ืœื—ืช POST ืœ-URL ืฉืœืš ืขื ื”ื›ื•ืชืจื•ืช `X-AiCrm-Event` ื•-`X-AiCrm-Signature: sha256=โ€ฆ`, ื—ืชื™ืžืช HMAC-SHA256 ืฉืœ ื”ื’ื•ืฃ ืขื ื”ืกื•ื“ ืฉืœ ืื•ืชื• webhook, ื›ื“ื™ ืฉืชื•ื›ืœ ืœื•ื•ื“ื ืฉื”ืžืฉืœื•ื— ืœื’ื™ื˜ื™ืžื™. ื‘ืฉืžื™ืจืช ื”-URL, ื”ื’ื ืช anti-SSRF ื“ื•ื—ื” localhost, 127.0.0.0/8, 10.x, 192,168.x, 172.16-31.x, ::1, 0.0.0.0 ื•ืืช ื”ื“ื•ืžื™ื™ื ื™ื `.local` ื•-`.internal`.

ื”ื™ืชืจื•ื ื•ืช ืฉืœ REST API ื•-webhooks

ื”ื•ืกืคืช ืื ืฉื™ ืงืฉืจ ื‘ืงืจื™ืื” ืื—ืช

POST ืืœ `/api/apps/public/crm/customers` ืขื ื”ืื™ืžื™ื™ืœ ื•ื”ืชื•ื•ื™ื•ืช ืฉืจื•ืฆื™ื, ื•ื”ืœื™ื“ ื›ื‘ืจ ื‘-CRM ืฉืœืš, ืžืกื•ื•ื’.

ื‘ืœื™ ื›ืคื™ืœื•ื™ื•ืช ื‘ืขื™ืฆื•ื‘

ืื ื”ืื™ืžื™ื™ืœ ื›ื‘ืจ ืงื™ื™ื, ื”ื›ืจื˜ื™ืก ืžืชืขื“ื›ืŸ ื•ื”ืฉืœื™ื—ื” ื”ื—ื“ืฉื” ื ืจืฉืžืช ื‘ืฆื™ืจ ื”ื–ืžืŸ ืฉืœื• ื‘ืžืงื•ื ืœื™ืฆื•ืจ ื›ืจื˜ื™ืก ืฉื ื™.

ืขื“ 20 ืžืคืชื—ื•ืช ืขื ืฉื

ืื—ื“ ืœื›ืœ ืื™ื ื˜ื’ืจืฆื™ื”, ื ื™ืชื ื™ื ืœื‘ื™ื˜ื•ืœ ื‘ื ืคืจื“. ืื ืžืคืชื— ื“ื•ืœืฃ, ืžื•ื—ืงื™ื ืื•ืชื• ื•ืฉื•ื ื“ื‘ืจ ืื—ืจ ืœื ืžืคืกื™ืง ืœืขื‘ื•ื“.

Webhooks ื—ืชื•ืžื™ื ื‘-HMAC-SHA256

ืžืืžืชื™ื ืืช ื”ื›ื•ืชืจืช `X-AiCrm-Signature` ืขื ื”ืกื•ื“ ืฉืœืš ื•ื™ื“ื•ืขื™ื ืฉื”ื”ื•ื“ืขื” ืžื’ื™ืขื” ืžื”-CRM ืฉืœืš ื•ืœื ืžืฆื“ ืฉืœื™ืฉื™.

ื”ื’ื ืช anti-SSRF ื›ืœื•ืœื”

ื”ืืคืœื™ืงืฆื™ื” ืžืกืจื‘ืช ืœืฉืœื•ื— webhooks ืืœ localhost ืื• ืืœ ื˜ื•ื•ื—ื™ ืจืฉืช ืคืจื˜ื™ื™ื, ื›ืš ืฉืื™ ืืคืฉืจ ืœื”ืฉืชืžืฉ ื‘-CRM ืฉืœืš ื›ื“ื™ ืœืกืจื•ืง ืจืฉืช ืคื ื™ืžื™ืช.

CRUD ืžืœื, ืœื ืจืง ื”ื•ืกืคื•ืช

ืจืฉื™ืžื” ืขื ืขื™ืžื•ื“ ื•ืžืกื ื ื™ื (ื—ื™ืคื•ืฉ, ืžืฆื‘, ืชื•ื•ื™ื•ืช, ืžื“ื™ื ื”), ืฉืœื™ืคืช ืื™ืฉ ืงืฉืจ ืขื ื”ืคืขื™ืœื•ืช ืฉืœื•, ืขื“ื›ื•ืŸ, ืžื—ื™ืงื” ื•ืจื™ืฉื•ื ืคืขื™ืœื•ื™ื•ืช ืขื‘ื•ืจื•.

ื”ืžืงื•ืจ ื ืจืฉื ืื•ื˜ื•ืžื˜ื™ืช

ื›ืœ ื”ื•ืกืคื” ื“ืจืš ื”-API ืฉื•ืžืจืช ืืช ื”-`subId` ืฉืฉื•ืœื—ื™ื ื‘ืชื•ืกืคืช ื”ืžื“ื™ื ื”, ื”-IP ื•ื”ื“ืคื“ืคืŸ, ื•ืžืชื•ื™ื’ืช ื›-`api-lead` ื›ื“ื™ ืœืกื ืŸ ืื•ืชื” ืื—ืจ ื›ืš ื‘ืืคืœื™ืงืฆื™ื”.

ื‘ื“ื™ืงื•ืช ื‘ืœื™ ื ื™ื—ื•ืฉื™ื

ื”ืืคืœื™ืงืฆื™ื” ืžื’ื™ืขื” ืขื ืชื™ืขื•ื“ ืฉืœ ื”-endpoints ืขื ื“ื•ื’ืžืช `curl` ืฉืืคืฉืจ ืœื”ืขืชื™ืง ื•ื›ืคืชื•ืจ ืœืฉืœื™ื—ืช ืžืฉืœื•ื— ื ื™ืกื™ื•ืŸ ืœื›ืœ webhook, ืขื ื”ืžืฆื‘ ื•ื”ืฉืขื” ืฉืœ ื”ื ื™ืกื™ื•ืŸ ื”ืื—ืจื•ืŸ.

Claire Donovan โ€” ื“ืžื•ืช AI, ืœื ืื“ื ืืžื™ืชื™.

ื—ื‘ืจื• ืืช ื”ืืชืจ ืฉืœื›ื ืœ-CRM ื›ื‘ืจ ื”ืขืจื‘

AiCrm ื”ื™ื ื›ืœื™ ื”-CRM ืฉืœ AIsToHire ืฉืžืงื‘ืœ ืืช ืื ืฉื™ ื”ืงืฉืจ ืฉืœื›ื ื“ืจืš REST API ื•ืžื•ื“ื™ืข ืœืžืขืจื›ื•ืช ืฉืœื›ื ืขื webhooks ื—ืชื•ืžื™ื. ืคืชื—ื• ื—ืฉื‘ื•ืŸ, ืฆืจื• ืžืคืชื— ื•ื‘ืฆืขื• ืืช ื”ืงืจื™ืื” ื”ืจืืฉื•ื ื”.

ื‘ืชื›ื•ื ื•ืช ืฉืžืฉืชืžืฉื•ืช ื‘ื‘ื™ื ื” ืžืœืื›ื•ืชื™ืช, ื”ืชืฉื•ื‘ื•ืช ื ื•ืฆืจื•ืช ืขืœ ื™ื“ื™ ื‘ื™ื ื” ืžืœืื›ื•ืชื™ืช ื•ืื™ื ืŸ ืชื—ืœื™ืฃ ืœื™ื™ืขื•ืฅ ืžืงืฆื•ืขื™.

REST API ืœ-CRM ืขื webhooks ื—ืชื•ืžื™ื | AiCrm