# Klaviyo Integratie Met de Klaviyo integratie kun je je Botpress chatbot verbinden met Klaviyo, een toonaangevend platform voor klantgegevens en marketingautomatisering. Met deze integratie kan je chatbot leads aanmaken, klantgegevens bijwerken en profielen abonneren op SMS- en E-mailmarketing. ## Beschikbare acties ### Profiel aanmaken Maak een nieuw klantprofiel aan in Klaviyo. Met deze actie kunt u nieuwe contacten toevoegen aan uw Klaviyo database met uitgebreide profielinformatie. **Vereiste velden:** - Ofwel **emailadres** OF **telefoonnummer** (in E.164 formaat zoals +15005550006) **Optionele velden:** - **Voornaam** en **achternaam** - **Organisatie** en **functieomschrijving** - **Locale** (in IETF BCP 47 formaat zoals en-US, fr-FR) - **Locatie** (adresgegevens inclusief adresregels, stad, land, regio, postcode) - **Custom properties** (sleutelwaardeparen voor het opslaan van aanvullende profielgegevens) **Uitvoer:** Retourneert het aangemaakte profiel met zijn unieke Klaviyo ID. ### Profiel bijwerken Update een bestaand klantprofiel in Klaviyo met behulp van de unieke ID van het profiel. Met deze actie kunt u profielinformatie wijzigen na het aanmaken. **Vereiste velden:** - Profiel ID** (de unieke Klaviyo identifier van het bij te werken profiel) **Optionele velden:** - **Emailadres** (werkt het e-mailadres van het profiel bij) - **Telefoonnummer** (in E.164 formaat) - **Voornaam** en **achternaam** - **Organisatie** en **functieomschrijving** - Locatie** (in IETF BCP 47-formaat) - **Locatie** (volledige adresinformatie) - **Aangepaste eigenschappen** (sleutelwaardeparen) **Uitvoer:** Geeft het bijgewerkte profiel met alle huidige informatie. ### Profiel ophalen Haal een specifiek klantprofiel op uit Klaviyo met behulp van zijn unieke ID. Deze actie is handig voor het opzoeken van individuele klantinformatie. **Vereiste velden:** - Profiel ID** (de unieke Klaviyo identifier van het op te halen profiel) **uitvoer:** Retourneert de volledige profielinformatie inclusief ID, e-mail, telefoon, naam en alle andere opgeslagen gegevens. ### Profielen ophalen Zoek en haal meerdere klantprofielen op uit Klaviyo met behulp van filters en sorteeropties. Deze actie is perfect voor het vinden van groepen klanten op basis van specifieke criteria. **Filteropties:** - Filter Veld:** Kies uit `id`, `email`, `phone_number`, `external_id`, `created`, of `updated`. - Filter operator:** Gebruik vergelijkingsoperatoren zoals `gelijk aan`, `bevat`, `groter-dan`, `minder-dan`, `begint-met`, `eindigt-met`. - Filterwaarde:** De waarde waarnaar moet worden gezocht (ondersteunt strings en datums) **Rangschikking en sortering:** - **Paginagrootte:** Aantal terug te geven profielen (1-100, standaard: 20) - **Sorteren:** Sorteren op elk veld met optionele aflopende volgorde (voorvoegsel met `-`) **Gebruiksvoorbeeld:** - Zoek alle profielen die na een bepaalde datum zijn aangemaakt - Zoek naar profielen met e-mailadressen die een domein bevatten - Zoek profielen gesorteerd op aanmaakdatum (nieuwste eerst) **Uitvoer:** Geeft een array van profielen die voldoen aan uw criteria. ### Abonneer profielen Abonneer meerdere klantprofielen op e-mail- en/of SMS-marketinglijsten in Klaviyo. Deze actie verwerkt inschrijvingen asynchroon en kan tot 1.000 profielen tegelijk verwerken. **Vereiste velden:** - **Inschrijvingen op profielen:** Array van profielen met toestemmingsinformatie - Profiel ID** (of e-mail/telefoon voor identificatie) - Toestemming voor e-mail:** Booleaans om toestemming voor e-mailmarketing aan te geven - Toestemming voor SMS:** Booleaans om toestemming voor SMS-marketing aan te geven **Optionele velden:** - Lijst-ID:** Specifieke Klaviyo lijst om geabonneerde profielen aan toe te voegen - Historische import:** Booleaans om historische profielen te importeren **Belangrijke opmerkingen:** - Maximaal 1.000 profielen per aanvraag - Minimaal één profiel is vereist - Toestemmingsvlaggen bepalen op welke marketingkanalen het profiel wordt geabonneerd - De operatie wordt asynchroon verwerkt door Klaviyo **Output:** Geeft als resultaat een booleaanse succeswaarde die aangeeft of de inschrijftaak met succes is ingepland.
