די API
עס זײַנען נישט דאַ פּריוואַטע ענדפּוינטן. אפֿילו נישט פֿאַר דעם צוביק.
מערסטע פּראָדוקטן האָבן צוויי APIs: דאָקומענטירטער, וואָס מען באָט זיך אײַך, און דער אינטערעסאַנטער, וואָס זייערע אייגענע עקראַנען ניצן. דער צווייטער איז שטענדיק בעסער, און מען לאָזט אײַך קיינמאָל נישט צו אים. דאָ איז דאַ נאָר איינער, און דער צוביק איז אַ קליענט פֿון אים ווי אַלץ אַנדערש — וואָס איז אַ שראַנק אויף אונדז, און דער סיבה וואָרום אַלץ וואָס איר ווילט בויען איז מעגלעך.
וואָס די כלל פֿאַקטיש קאָסט
עס מיינט אַז אַ עקראַן מוז זיך מאַל מאַל אויסהאַלטן ביז די API איז ריכטיק, אַנשטאָט זיך אַרומצודרייען פֿאַר איין באַקוועמער פֿעלד. דער טאָג ווען אַ עקראַן דאַרף עפּעס וואָס די עפֿנטלעכע API קען נישט געבן איז דער טאָג ווען די API איז פֿאַלש, און דער פֿיקס איז די API.
דער פֿאַרדינסט איז אַז דרײַ זייער פֿאַרשידענע קליענטן קאָסטן כּמעט גאָרנישט צוזאַץ. דער MCP סערווער איז אַ קליענט. אַ dash-b קעכל איז אַ קליענט. אײַער אייגענער סקריפּט איז אַ קליענט. קיינער פֿון זיי איז נישט אַ צווייטקלאַסיקער בירגער וואָס זיך אַרומדרייט אַרום אַ ייבערפֿלאַך געמאַכט פֿאַר אַנדערשטע, ווײַל עס איז נישט דאַ קיין אַנדערער ייבערפֿלאַך.
דאָקומענטירט, און דורכגעפֿירט
OpenAPI ווערט גענערירט בײַ /docs, און יעדער רוט האָט אַ טעסט וואָס איז דער ביישפּיל אין דער דאָקומענטאַציע. דאָקומענטאַציע וואָס מען שרײַבט באַזונדער פֿון דעם קאָד גייט אָפּ אין אַ מאָנאַט; דאָקומענטאַציע וואָס פֿיילט דעם בילד ווען זי איז פֿאַלש — נישט.
אַרײַנלאָגין
אײַער castomo חשבון, איבער דעם authorization code flow מיט PKCE — דער זעלביקער חשבון וואָס איר ניצט פֿאַר dash-b און די איבעריקע פֿון דער משפּחה. אַ זײַט אָן אַ סערווער פֿון איר אייגענער פֿירט דעם פֿלוס פּושקעס אויס; דאָס איז פּוק וואָס דער פֿלוס איז געמאַכט געוואָרן פֿאַר. פֿאַר מאַשין-צו-מאַשין אַרבעט, אַ project-scoped API שליסל.
- 1מענטשן
/v1/contacts·/lists·/segments·/tags·/imports - 2אינהאַלט
/v1/creatives, מיט וואַלידאַציע, פּרעוויו און רענדער לויט ציל - 3אויטאָמאַטיזאַציע
/v1/funnels·/funnels/:id/versions·/runs·/simulate - 4בראָדקאַסט
/v1/campaigns, מיט אַודיענץ, מאַטעריאַליזירן, פּלאַנירן און שיקן ווי באַזונדערע שריט - 5געשעענישן אַרײַן
/v1/events— אײַער אייגענער אַפּליקאַציעס געשעענישן, ווי טריגערס - 6צושטעלונג
/sender-identities·/domains·/apps·/webhooks - 7נומערן
/v1/reports/*, און/track/*אויף דעם tracking האָסט
OpenAPI בײַ /docs/mcp אויף דעם זעלביקן פּראָצעס
קאָנווענציעס
דער זעלביקער פֿאָרעם ווי יעדער אַנדערער castomo דינסט
וואָס מיינט מער ווי עס קלינגט. אויב איר רופֿט שוין איינעם פֿון די, וויסט איר שוין ווי דער ענטפֿערט, פֿיילט און פּאַגינירט.
איין פֿעלער־קאַנווערט
יעדער פֿעלער האָט די זעלבע פֿאָרעם, אַ סטאַבילן קאָד און אַ מעלדונג פֿאַר אַ מענטש. קיין רוט ערפֿינדט נישט איר אייגענעם אופֿן צו זײַן אומצופֿרידן.
קורסאָר־פּאַגינאַציע
נישט אָפֿסעץ. אַ ליסטע וואָס ענדערט זיך בשעת מען גייט איבער איר שפּרינגט נישט שטילערהײַט שורות אָדער ווידערהאָלט זיי, וואָס אָפֿסעט־פּאַגינאַציע טוט שטיל און שטענדיק.
אידעמפּאָטענץ־שליסלען
אויף יעדער מוטירנדיקער רוט. פּרובירט נאָך אַ בקשה וואָס איר זענט נישט זיכער אַז זי איז אָנגעקומען און באַקומט די זעלבע ענטפֿער אַנשטאָט אַ צווייטן קאָנטאַקט, אַ צווייטע קאַמפּיין אָדער אַ צווייטן שיק.
אײַנגעשרענקט צו אַ פּראָיעקט
אַ טאָקן אַדרעסירט איין טענאַנט און איין פּראָיעקט, ביידע. Row-level security ווערט דורכגעפֿירט אין דער דאַטאַבאַז איר אַליין, נישט דורך דערמאָנען צו צולייגן אַ טייל.
וועבהוקן אַרויס
אונטערגעשריבן, פּרובירט נאָך מיט backoff, און צוגעשטעלט לפֿחות איין מאָל — אַזוי אײַער ענדפּוינט זאָל אויך זײַן אידעמפּאָטענט. די געשעענישן זענען דער זעלביקער וואָקאַבולאַר וואָס די דערגייונגען ניצן.
אויסמעקן און עקספּאָרטירן
אַ קאָנטאַקט מען קען עקספּאָרטירן אָדער אויסמעקן דורך דער API, און אַן אויסמעקונג דערגרייכט יעדן שוועסטער-סערוויס וואָס האָט געהאַלטן אַ קאָפּיע דורך דער משפּחה׳ס אייגענער אינערלעכער ליין.
אַלץ וואָס דער אינטערפֿייס קען טון, קען אַ POST טון.
איבערונגען זענען דער אינטערעסאַנטער טייל
אַלץ אַנדערש אויף דעם בלאַט איז אינסטאַלאַציע וואָס מען דערוואַרט. POST /v1/events איז דער וועג וואָס ענדערט וואָס דער פּראָדוקט איז פֿאַר.
דיין אַפּליקאַציע ווייסט שוין זאַכן וואָס קיין מאַרקעטינג-געצייג קען נישט באַמערקן: ווער האָט געענדיקט אָנבאָרדינג, ווער האָט איינגעלאַדן אַ חבר, ווער האָט דערגרייכט אַ גרענעץ, ווער האָט עקספּאָרטירן זיין דאַטן אין אַ זונטיק נאָכמיטאָג. שיק דאָס אַלץ ווי איבערונגען מיט דיין אייגן טאָקען, און יעדע ווערט אַ טריגער, אַ תנאי און אַ סעגמענט.
דער רעשט פֿאָלגט פֿון דעם קאָנטאַקט-מאָדעל. איבערונגען ווערן צוגעלייגט, קיינמאָל נישט פֿאַרבעסערט; זיי זענען דער לאָג וואָס דער גאַנצער פּראָדוקט האָנגט זיך אויף. אַ טראָכט וואָס ציט זיך אויף אַן איבערונג וואָס דו האָסט דעפֿינירט איז נישט קיין אינטעגראַציע — עס איז דער זעלביקער מעכאַניזם וואָס message_opened ניצט, מיט אַן אַנדערן נאָמען דערין.
- 1דו פּאָסט עס
POST /v1/events— אַ נאָמען, אַ קאָנטאַקט, אַ פּיילאָוד, אַן אידעמפּאָטענץ-שליסל. - 2עס קומט אָןצוגעלייגט צום קאָנטאַקטס לאָג. נישט אַנדערש דאַרף וויסן אַז עס עקזיסטירט.
- 3אַ טראָכט הייבט זיך אָןיעדער טראָכט וואָס זיין אַריינגאַנג דערמאָנט יענע איבערונג, פֿאַר יעדן קאָנטאַקט וואָס איז באַרעכטיקט לויט זיין אַריינגאַנג-שפּעציפֿיקאַציע.
- 4אַנדערע טראָכטן צווייגן זיך אויף אים"האָט זיך די איבערונג פּאַסירט אין די לעצטע 14 טעג" איז אַ געוויינלעכער סעגמענט-פּרעדיקאַט.
- iאון ער ענדיגט לויפןאַ ציל-קנודל וואָס דערמאָנט די זעלביקער איבערונג שטעלט אַן ענדע צו אַ סיקווענץ אין דעם מאָמענט ווען דער מענטש טוט די זאַך.
דיין וואָקאַבולאַרדיין טאָקען
גרענעצן וואָס עס לוינט זיך צו וויסן בעפֿאָר דו בויעסט
ClickSomo האַלט דריי אידענטיפֿיקאַטאָרן וועגן דיר — אַ טענאַנט, אַ פּראָיעקט און אַ באַניצער, ווי אָפּאַקע אידן — און גאָרנישט נאָך. קיין פּאַסוואָרט, קיין פּראָפֿיל, קיין קאַרטל, קיין אינווייס. פּלאַן-גרענעצן קומען אָן ווי צאָלן: וויפֿיל קאָנטאַקטן, וויפֿיל שיקונגען, וויפֿיל גענעראַציעס. צאָלונג-וואָקאַבולאַר איבערשטייגט נישט יענע גרענעץ אין קיין שום ריכטונג.
דיין קאָנטאַקטן זענען דיינע. דו ביסט דער דאַטן-קאָנטראָלירער; מיר זענען דער פּראָצעסאָר. עס גיט נישט קיין וועג וואָס אַן אַנדער פּראָדוקט אין דער משפּחה קען ליינען אָדער שרייבן דיין קאָנטאַקט-ליסטע, און קיין אַרייננעמע-ליין פֿאַר איינעם צו ניצן.
אויב דו עוואַלואירסט דאָס ערנסט: ליין /docs בעפֿאָר דו ליינסט נאָך עפּעס פֿון דעם וועבזייטל. די API איז די אמתע באַשרייַבונג פֿון וואָס דער פּראָדוקט טוט, און יעדער טענה אויף די בלעטער מאַפּט זיך צו אַ רוט אָדער אַ קנודל-סאָרט וואָס דו קענסט געפֿינען דאָרט. ווען די סכעמע ענדערט זיך, ענדערן זיך די בלעטער.