Webãµã€ãããã©ãŒã ãããã¯ãšã³ããããHTTPåŒã³åºã1åã§é¡§å®¢ãç»é²ãããã¹ãŠã®å€æŽãHMAC-SHA256ã§çœ²åãããããã¡ã§èªåã®ãµãŒããŒã«åãåããŸãã
CRMã¯ãããããéããŠå ¥åããå Žæã§ã¯ãªããªããããªãã®ã·ã¹ãã ãåŒã³åºããšã³ããã€ã³ãã«ãªããŸãã
AIsToHire ã®CRMã¢ã㪠AiCrm ã¯ãèªåã®é£çµ¡å ã«å¯Ÿããå ¬éREST APIãæäŸããŸãã`X-Api-Key` ããããŒã«ããŒãæå®ããã°ãWebãµã€ãã®ãã©ãŒã ããã£ããããããZapãPythonã¹ã¯ãªãããèªç€Ÿã®ããã¯ãšã³ããããé£çµ¡å ã®äœæãäžèЧååŸãåç §ãæŽæ°ãåé€ãã§ããã©ã®é£çµ¡å ã«ãã¢ã¯ãã£ããã£ã远å ã§ããŸããã¬ã¹ãã³ã¹ã¯ `{ success, data }` ã®åœ¢åŒã®JSONã§ãäžéã¯ããŒããšã«1åããã100ãªã¯ãšã¹ãã§ãã
APIããã®ç»é²ã¯éè€ããŸãããéä¿¡ããã¡ãŒã«ããã§ã«ããŒã¿ããŒã¹ã«ããå ŽåãAiCrm ã¯ãã§ã«ããã«ãŒããæŽæ°ã(è¶³ããªãé»è©±çªå·ãååãäŒç€Ÿãè£ããã¿ã°ãçµå)ãæ°ããéä¿¡ãã¿ã€ã ã©ã€ã³ã«èšé²ããŠãHTTP 200ãè¿ããŸããæ°èŠã®å Žåã¯äœæããŠ201ãè¿ããŸããAPIã§å ¥ã£ãŠããé£çµ¡å ã«ã¯ãèªåçã« `api-lead` ã®ã¿ã°ãä»ããéä¿¡ããã¿ã°ã¯ãã®ãŸãŸä¿æãããæµå ¥å ã® `subId` ãšãã¢ã¯ã»ã¹å ã®åœãIPããã©ãŠã¶ãä¿åãããŸãã
ååä»ãã®APIããŒã¯ãã¢ããªå éšã®ããŒã«å ããŠãæå€§20åãŸã§äœæã§ããŸãã飿ºããš(Webãµã€ãã5æã®ãã£ã³ããŒã³ã®ãã©ãŒã ãã€ã³ã¿ãŒã³ãååŒå )ã«å¥ã®ããŒãæž¡ãããã®é£æºãçµãã£ãããä»ã«è§Šããã«ãã®ããŒã ããç¡å¹åã§ããŸããããŒã®å®å šãªå€ã¯ãäœææã«äžåºŠã ã衚瀺ããããã®åŸã¯äžèЧã§ãã¹ã¯ãããç¶æ ã§ããèŠãããŸããã
éæ¹åã§ã¯ãWebhookãã·ã¹ãã ã«éç¥ããŸããæå€§10ã®å®å ãèšå®ããããããã賌èªããã€ãã³ã(`customer.created`ã`customer.updated`ã`customer.deleted`ã`activity.created`)ãéžã¶ãšãAiCrm ã `X-AiCrm-Event` ãš `X-AiCrm-Signature: sha256=âŠ` ã®ããããŒãä»ããŠãããªãã®URLã«POSTããŸããåŸè ã¯ããã®Webhookã®ã·ãŒã¯ã¬ããã§èšç®ããæ¬æã®HMAC-SHA256眲åã§ãé ä¿¡ãæ£åœãªãã®ããæ€èšŒã§ããŸããURLã®ä¿åæã«ã¯ãSSRF察çã«ãããlocalhostã127.0.0.0/8ã10.xã192.168.xã172.16-31.xã::1ã0.0.0.0ããã㊠`.local` ãš `.internal` ã®ãã¡ã€ã³ãæåŠãããŸãã
Ventaja 1
1åã®åŒã³åºãã§é£çµ¡å ãç»é²ã§ããŸããã¡ãŒã«ãšå¥œããªã¿ã°ãä»ã㊠`/api/apps/public/crm/customers` ã«POSTãããšããªãŒãã¯ããã«CRMã«åé¡ãããŠå ¥ããŸãã
Ventaja 2
èšèšäžãéè€ããŸãããã¡ãŒã«ããã§ã«ååšããå Žåã¯ã2æç®ã®ã«ãŒããäœã代ããã«ãã«ãŒããæŽæ°ããæ°ããéä¿¡ãã¿ã€ã ã©ã€ã³ã«èšé²ããŸãã
Ventaja 3
ååä»ãã®ããŒãæå€§20åã飿ºããšã«1ã€ã§ãåå¥ã«ç¡å¹åã§ããŸããããŒãæŒããå Žåã¯ããã®ããŒã ããåé€ããã°ãä»ã¯äœãæ¢ãŸããŸããã
Ventaja 4
HMAC-SHA256ã§çœ²åãããWebhookãèªåã®ã·ãŒã¯ã¬ããã§ `X-AiCrm-Signature` ããããŒãæ€èšŒããã°ãéç¥ã第äžè ã§ã¯ãªãèªåã®CRMããæ¥ããšåãããŸãã
Ventaja 5
SSRF察çãæåããå ¥ã£ãŠããŸããã¢ããªã¯ãlocalhostããã©ã€ããŒããããã¯ãŒã¯ã®ç¯å²ãžã®Webhooké ä¿¡ãæåŠããã®ã§ãCRMãå éšãããã¯ãŒã¯ã®æ¢çŽ¢ã«äœ¿ãããããšã¯ãããŸããã
Ventaja 6
ç»é²ã ãã§ãªããCRUDãå®å šã«ãµããŒããããŒãžããŒã·ã§ã³ãšãã£ã«ã¿ãŒ(æ€çŽ¢ãã¹ããŒã¿ã¹ãã¿ã°ãåœ)ã€ãã®äžèЧãã¢ã¯ãã£ããã£ãå«ãé£çµ¡å ã®ååŸãæŽæ°ãåé€ãã¢ã¯ãã£ããã£ã®èšé²ãã§ããŸãã
Ventaja 7
æµå ¥å ãèªåã§è¿œè·¡ããŸããAPIçµç±ã®ç»é²ããšã«ãéä¿¡ãã `subId` ã«å ããŠãåœãIPããã©ãŠã¶ãä¿åããã`api-lead` ã®ã¿ã°ãä»ãã®ã§ãããšã§ã¢ããªå ã§çµã蟌ããŸãã
Ventaja 8
åœãŠæšéãªãã§ãã¹ãã§ããŸããã¢ããªã«ã¯ãã³ããŒã§ãã `curl` ã®äŸã€ãã®ãšã³ããã€ã³ãã®ããã¥ã¡ã³ãããããåWebhookã«ãã¹ãé ä¿¡ãéããã¿ã³ãšãæåŸã®è©Šè¡ã®ã¹ããŒã¿ã¹ãšæå»ã衚瀺ãããŸãã

AiCrm ã¯ãAIsToHire ã®CRMããŒã«ã§ãREST APIçµç±ã§é£çµ¡å ãåãåãã眲åä»ãWebhookã§ã·ã¹ãã ã«éç¥ããŸããã¢ã«ãŠã³ããäœæããããŒãçæããŠãæåã®åŒã³åºããè¡ããŸãããã
AIãäœ¿ãæ©èœã§ã¯ãåçã¯AIãçæãããã®ã§ãããå°éå®¶ã®å©èšã«ä»£ãããã®ã§ã¯ãããŸããã