# Integração do Klaviyo A integração Klaviyo permite-lhe ligar o seu chatbot Botpress à Klaviyo, uma plataforma líder de dados de clientes e de automatização de marketing. Com esta integração, o seu chatbot pode criar leads, atualizar a informação dos clientes e subscrever perfis para marketing por SMS e e-mail. ## Ações disponíveis ### Criar perfil Criar um novo perfil de cliente na Klaviyo. Esta ação permite-lhe adicionar novos contactos à sua base de dados Klaviyo com informações de perfil abrangentes. **Campos necessários:** - Ou **endereço de correio eletrónico** OU **número de telefone** (no formato E.164 como +15005550006) **Campos opcionais:** - **Nome próprio** e **sobrenome** - **Organização** e **título do cargo** - **Locale** (no formato IETF BCP 47 como en-US, fr-FR) - Localização** (detalhes do endereço, incluindo linhas de endereço, cidade, país, região, código postal) - Propriedades personalizadas** (pares chave-valor para armazenar dados de perfil adicionais) **Output:** Devolve o perfil criado com o seu ID Klaviyo único. ### Atualizar perfil Actualiza um perfil de cliente existente no Klaviyo utilizando o ID único do perfil. Esta ação permite-lhe modificar qualquer informação do perfil após a criação. **Campos necessários:** - ID do perfil** (o identificador único do Klaviyo do perfil a atualizar) **Campos opcionais:** - **Endereço de e-mail** (actualiza o e-mail do perfil) - **Número de telefone** (no formato E.164) - **Nome próprio** e **sobrenome** - **Organização** e **título do cargo** - **Localidade** (no formato IETF BCP 47) - **Localização** (informação completa do endereço) - Propriedades personalizadas** (pares chave-valor) **Output:** Devolve o perfil atualizado com todas as informações actuais. ### Obter perfil Recupera um perfil de cliente específico do Klaviyo usando o seu ID único. Esta ação é útil para procurar informações individuais do cliente. **Campos necessários:** - ID do perfil** (o identificador único do Klaviyo do perfil a recuperar) **Output:** Devolve a informação completa do perfil, incluindo ID, e-mail, telefone, nome e todos os outros dados armazenados. ### Obter perfis Pesquise e recupere vários perfis de clientes do Klaviyo usando filtros e opções de classificação. Esta ação é perfeita para encontrar grupos de clientes com base em critérios específicos. **Opções de filtro:** - Campo de filtro:** Escolher entre `id`, `email`, `número_de_telefone`, `id_externo`, `criado` ou `atualizado` - Operador de Filtro:** Use operadores de comparação como `igual`, `contém`, `maior que`, `menor que`, `começa-com`, `fim-com` - **Valor do filtro:** O valor a ser pesquisado (suporta strings e datas) **Paginação & Ordenação:** - **Tamanho da página:** Número de perfis a retornar (1-100, padrão: 20) - Ordenação:** Ordenar por qualquer campo com ordem descendente opcional (prefixo com `-`) **Casos de uso de exemplo:** - Encontrar todos os perfis criados após uma data específica - Procurar perfis com endereços de correio eletrónico que contenham um domínio - Obter perfis ordenados por data de criação (os mais recentes primeiro) **Resultado:** Retorna uma matriz de perfis que correspondem aos seus critérios. ### Subscrever perfis Subscrever vários perfis de clientes para listas de marketing por e-mail e/ou SMS no Klaviyo. Esta ação processa as subscrições de forma assíncrona e pode processar até 1.000 perfis de uma só vez. **Campos necessários:** - Assinaturas de perfis:** Conjunto de perfis com informações de consentimento - ID do perfil** (ou e-mail/telefone para identificação) - Consentimento por correio eletrónico:** Booleano que indica o consentimento para marketing por correio eletrónico - Consentimento por SMS:** Booleano que indica o consentimento para marketing por SMS **Campos opcionais - ID da lista:** Lista específica do Klaviyo à qual adicionar perfis subscritos - **Importação de histórico:** Booleano para importar perfis históricos **Notas importantes:** - Máximo de 1.000 perfis por pedido - É necessário pelo menos um perfil - As bandeiras de consentimento determinam os canais de marketing em que o perfil será subscrito - A operação é processada de forma assíncrona pela Klaviyo **Devolve um booleano de sucesso que indica se a tarefa de subscrição foi agendada com êxito.
