Klaviyo

  # Klaviyo Integration Ang Klaviyo integration ay nagpapahintulot sa iyo na ikonekta ang iyong Botpress chatbot kasama si Klaviyo, isang nangungunang data ng customer at platform ng marketing automation. Sa pagsasamang ito, ang iyong chatbot ay maaaring lumikha ng mga lead, mag-update ng impormasyon ng customer, at mag-subscribe ng mga profile sa SMS at Email marketing. ## Magagamit na Mga Aksyon ### Lumikha ng Profile Lumikha ng bagong profile ng customer sa Klaviyo. Binibigyang-daan ka ng pagkilos na ito na magdagdag ng mga bagong contact sa iyong database ng Klaviyo na may komprehensibong impormasyon sa profile. **Mga Kinakailangang Field:** - Alinman sa **email address** O **numero ng telepono** (sa E.164 na format tulad ng +15005550006) **Mga Opsyonal na Field:** - **First name** at **apelyido** - **Organization** and **job title** - **Locale** (sa IETF BFR-fr-fr) ** mga detalye ng address tulad ng en*** linya, lungsod, bansa, rehiyon, ZIP code) - **Mga custom na property** (mga pares ng key-value para sa pag-iimbak ng karagdagang data ng profile) **Output:** Ibinabalik ang ginawang profile kasama ang natatanging Klaviyo ID nito. ### I-update ang Profile I-update ang isang umiiral nang profile ng customer sa Klaviyo gamit ang natatanging ID ng profile. Binibigyang-daan ka ng pagkilos na ito na baguhin ang anumang impormasyon ng profile pagkatapos gawin. **Mga Kinakailangang Field:** - **Profile ID** (ang natatanging Klaviyo identifier ng profile na ia-update) **Mga Opsyonal na Field:** - **Email address** (ini-update ang email ng profile) - **Numero ng telepono** (sa E.164 format) - **First name** and **apelyido** - **Organization** and **job title B** ( - 4 **LocaleF**CP*) (kumpletong impormasyon ng address) - **Mga custom na katangian** (mga pares ng key-value) **Output:** Ibinabalik ang na-update na profile kasama ang lahat ng kasalukuyang impormasyon. ### Kumuha ng Profile Kunin ang isang partikular na profile ng customer mula sa Klaviyo gamit ang natatanging ID nito. Ang pagkilos na ito ay kapaki-pakinabang para sa paghahanap ng indibidwal na impormasyon ng customer. **Mga Kinakailangang Field:** - **Profile ID** (ang natatanging Klaviyo identifier ng profile na kukunin) **Output:** Ibinabalik ang kumpletong impormasyon ng profile kabilang ang ID, email, telepono, pangalan, at lahat ng iba pang nakaimbak na data. ### Kumuha ng Mga Profile Maghanap at kunin ang maramihang mga profile ng customer mula sa Klaviyo gamit ang mga filter at mga pagpipilian sa pag-uuri. Ang pagkilos na ito ay perpekto para sa paghahanap ng mga grupo ng mga customer batay sa mga partikular na pamantayan. **Mga Opsyon sa Filter:** - **Filter Field:** Pumili mula sa `id`, `email`, `phone_number`, `external_id`, `created`, o `updated` - **Filter Operator:** Gumamit ng mga operator ng paghahambing tulad ng `equals`, `contains`, `greater-than`, `less-than`s` na may -,`less-than`s` **Halaga ng Filter:** Ang value na hahanapin (sumusuporta sa mga string at petsa) **Pagination at Pag-uuri:** - **Laki ng Pahina:** Bilang ng mga profile na ibabalik (1-100, default: 20) - **Pagbukud-bukurin:** Pagbukud-bukurin ayon sa anumang field na may opsyonal na pababang pagkakasunud-sunod (prefix na may `-`) **Mga Halimbawang Use Cases:** - Hanapin ang lahat ng profile ng profile na may tukoy na petsa pinagsunod-sunod ayon sa petsa ng paglikha (pinakabago muna) **Output:** Nagbabalik ng hanay ng mga profile na tumutugma sa iyong pamantayan. ### Mag-subscribe Mga Profile Mag-subscribe ng maraming profile ng customer sa email at/o mga listahan ng marketing sa SMS sa Klaviyo. Pinoproseso ng pagkilos na ito ang mga subscription nang asynchronous at kayang humawak ng hanggang 1,000 profile nang sabay-sabay. **Mga Kinakailangang Field:** - **Mga Subscription sa Profile:** Array ng mga profile na may impormasyon ng pahintulot - **Profile ID** (o email/telepono para sa pagkakakilanlan) - **Pahintulot sa Email:** Boolean na nagpapahiwatig ng pahintulot para sa email marketing - **SMS Consent:** Boolean na nagpapahiwatig ng pahintulot para sa SMS marketing **Opsyonal na Mga Field:** - **Listahan ng Klaviyo upang magdagdag ng **Spesipikong Klaviyo na listahan upang magdagdag ng **List ID:** Import na listahan Boolean para mag-import ng mga makasaysayang profile **Mahalagang Paalala:** - Maximum na 1,000 profile sa bawat kahilingan - Hindi bababa sa isang profile ang kailangan - Ang mga flag ng pahintulot ay tumutukoy kung aling mga marketing channel ang profile ay masu-subscribe sa - Ang operasyon ay pinoproseso ng asynchronous ni Klaviyo **Output:** Nagbabalik ng tagumpay na boolean na nagsasaad kung matagumpay na nakaiskedyul ang trabaho sa subscription.