clickSomo
ClickSomota kichay

API

Pakasqa t'inkinna kanman. Chaypas, interfaspaqpas.

Aswan rurasqa ruwaqkuna iskay API-yuq: willakuq, chiqan riqsisqa; huktaq kikin pantallankunap llamk'achiyninpi kaq, chaytaq aswan allin, ichaqa chaytaqa pichqa kuti yaspaqtiykichu. Kaypi hukllam, chaymanta interfasaqa chaypaq mikhuna hinam — chaymi ñukunaman sayachiy, chaymi ama hinaqtataq, mayninpi ruway munasqayki tukuy atikun.

Chay kamachiy imata chiqanpi chinkuchin

Chayqa: pantallaqa API-ta chiqan tukunanta suyasunmana, huk utqay ñit'inallaraq apakuspa. Pantallaqa API churayta atiyniyuqta munaptin, chay p'unchaw API pantallataq, allinchaynintaq API-mi.

Qolqenqa: kimsa ancha sapan mikhunaqa yakukamanpas mana yapachiyta munanchu. MCP serverqa mikhunam. dash-b ñit'inmi mikhunam. Kikin scriptniyki mikhunam. Manataq iskay kaq runalla kanchu huk paqarichisqa ruwaqpaq, imarayku chaypaq ukhupa kaqninna kanchu.

Willasqa, hinaspa sinchiqe chasqasqa

OpenAPIqa /docs nisqapi paqarichikun, hinaspa sapa ñanpiqa proba kan, dokumintapi rikuchisqam. Qillqasqa chaymanta imaqa wañuy killawan qatiqtaq; chayqa mana allin kaptinmi llalliyta chinkuchin.

Yaykuy

Castomo kikillayki, authorization code flow PKCE-wan — dash-b huk qarqaykunahinam kikin. Manaña serverniyuq p'anqaqa chay flow-ta allinmi ruwan; chayqa chay flow paqarichisqanraq. Machina-machina llamk'aypaq: proyecto qatipasqa API yakuchi.

Uyariqapi.clicksomo.com
  • 1Runakuna/v1/contacts · /lists · /segments · /tags · /imports
  • 2Ima kaq/v1/creatives, allinta qhawachiy, ñawpaqta rikhachiy, sapa t'inkinpi t'umpanapaq
  • 3Kikillanmanta ruway/v1/funnels · /funnels/:id/versions · /runs · /simulate
  • 4Mast'ariy/v1/campaigns, runa huñu, Hunt'achiy, p'unchaw churay, kachiy sapa huklliq ruwayllaraq
  • 5Willakuykuna yaykumuq/v1/events — kikin ruwasqayki eventokuna, paqarichiq hinalla
  • 6Chayamuy/sender-identities · /domains · /apps · /webhooks
  • 7 Yupaykuna/v1/reports/*, chaymanta /track/* qatiq karupi

OpenAPI /docs nisqapi/mcp kaqllam ruwana nisqapi

Ruraykamachiymi

Huk castomo llamk'anap hina, kaqlla tupuypi

Chaymi aswan chaniyuq, ima chikayan. Ama hinaqtataq huklayllaraq hunt'asqa kaspa, kay laya allin, llalliy, phichiy imaynataw ruraptintaqa yaqapuni yachanki.

Hukllam pantay qatipaq

Sapa pantay huk rikch'ayniyuqmi, allin codewan, runaman riqch'ariq willakuwan. Mayqin ñanpas kikinpa nanakuyninta kikillanmantachu paqarichin.

Cursor nisqawan p'anqa t'inkichiy

Offsets nisqawan mana. Qhawaspa tikrasqa listuqa mana imatapas chinkachinchu icha kutichinchu, offset paginación nisqaqa ñawpaqta, sapa kuti chayta ruwan.

Idempotencia llamk'ana yachaquna

Sapa tikraqta ñanpi. Mana chayamusqata yasaq maqasqaykita kutichiy, chaywan huk kawsayniyuq, huk kamachiy, huk apaykachay tariy, iskaynintataq mana.

Huk proyectollapaq sayasqa

Huk token huk tenanteda, huk proyectotapas rikuchin. Iskaynin chimpayuq kay database kikinpi kamachisqa, yuyakuspa clausula yapayta mana.

Lluqsiq webhooks

Watasqa, kutichiy tukriywan, huk kutillapas apachikuy — chayrayqu puntallayki idempotente kananpas. Willakuykuna willaykuna llamk'achiq simi k'itillam.

Chinkachiy hinaspa lluqsichiy

Huk contacto API nintakam lluqsichikunman, chinkachikunmanpas, hinaspa chinkachiy tukriy willayniyuq kawsaq llaqta llapan wawqin serviciokunaman chayakun, ayllu ukhu ñanninta.

Interfaz imatapas atiq, huk POST atin.

Willakuykuna sumaq partin

Kay panqapi huknintaq suyayniyuq tuberiyallam. POST /v1/events ñanqa ruwayta tikran imarayku ruwasqa kasqanta.

Ruruchinayki yachan imakunata marketing llamk'ana mana qawasqanta: pipa qallariy tukriyta, pipa masinta qayachasqanta, pipa sayanpi chikasqanta, pipa willankunata domingopita chisi tuta lluqsichisqanta. Chaykunata willakuykunahina qillqay kikin token niykiwan, sapa huknin tikran: huk qallariy, huk kamachi, huk rakiy.

Chaymanta qatiqnin contacto ruwaymanta hamun. Willakuykuna yapasqallam, mana allinchasqachu; llapan ruway chay willayniyuq chawpiman. Willakuyniykipi qallariyta tariq funnel mana huk t'inkiyllachu — message_opened llamk'achiq kikin mecanismollam, huk sutiwan.

Willakuyniyki funnel tukrunapi_event
  • 1Qam apachinkiPOST /v1/events — huk suti, huk contacto, huk payload, huk idempotencia llamk'ana.
  • 2ChayakunContacto willayninman yapasqa. Huknintaq mana yachanpas kashasqanta.
  • 3Huk funnel qallarinIma funnel chay willakuyta qallariy sutiypi chariq, ima contacto chay qallariy kamachiywan yaykunapaq.
  • 4Huk funnelkuna chaymanta rakiykun"Kay willakuy qhipa 14 p'unchawpi tukriyta chuqun" huk sapa segmento kamachiyllam.
  • iChaymanta runakunata tukrinKikin willakuyta sutiyuq meta nodo runa imatapas ruwasqanpi huk secuencia sayachin.

SimiykiToken niyki

Manaraq ruwasqaykipi yachanapaq sayaykuna

ClickSomo kimsa riqsiyta waqaychikun qamanta — huk tenant, huk proyecto, huk usuario, mana riqsisqa id nisqakunahina — huknintaq mana imapas. Mana clave, mana perfil, mana tarjeta, mana factura. Plan sayaykuna yupaykunahina hamun: hayk'a contacto, hayk'a apachiy, hayk'a paqarichiy. Qullqi simi kay sayaypi manam chimpakunchu, mayqin ñanpipas.

Contactoniykiki qamqapam. Qam willay kamachiq; ñuqayku ruwaq. Mana huk ñan kanchu ayllu ukhu huk ruwayniyuq contactoniyki lista ñawirinanpaq, qillqananpaqpas, mana huknin chayta chaskinapaq ñanpas.

Sichus kayta ch'ikichikuni kashanki: kay webpa aswan qatiqninta ñawiriyta manaraq /docs ñawiriy. API ruwasqaykipi chiqan willaynin, kay panqakunapi sapa niy huk ñanman, huk nodo layaman chikachkan. Esquema tikrakuptin, kay panqakunapas tikranku.