API do Klaviyo: o que dá para fazer e como usar com agentes de IA
A API do Klaviyo permite gerenciar perfis, listas e segmentos, registrar eventos de comportamento e consultar campanhas, fluxos e métricas. É usada por marcas de e-commerce que fazem e-mail e SMS no Klaviyo. O acesso é por chave privada de API com escopos ou OAuth para apps.
Os grandes recursos da API, em português claro.
Cadastro, atributos personalizados e consentimento de e-mail e SMS.
Inscrição e consulta de públicos.
Registro de ações como produto visto, carrinho e compra.
Criação e consulta de campanhas de e-mail e SMS.
Automações e seus estados.
Resultados agregados por campanha e fluxo.
Produtos usados em recomendações.
Como se acessa a API do Klaviyo.
- Com credencial da sua empresaChave privada de API criada na conta do Klaviyo, com escopos de leitura e escrita por recurso, ou OAuth 2.0 para aplicativos.
- Documentação oficialdevelopers.klaviyo.com
- Respeite o consentimento de e-mail e SMS (LGPD).
- Há limites de requisição por endpoint.
- A API usa revisões datadas; mantenha a revisão configurada atualizada.
- api klaviyo
- klaviyo api key
- klaviyo api eventos
- klaviyo api profiles
- integração api klaviyo
- klaviyo api documentação
O que um agente do iTeam faz com a API do Klaviyo.
Quando o cliente pergunta de um produto no WhatsApp, o agente registra o interesse como evento no Klaviyo para alimentar o fluxo certo.
Quem pede para parar de receber no atendimento tem o consentimento atualizado pelo agente.
Toda semana, o agente compara receita e cliques das campanhas e destaca o que funcionou.
Clientes do segmento de maior valor que reclamam recebem atendimento prioritário do agente.
Da credencial ao agente trabalhando, com aprovação.
Crie a chave privada com escopos
Escolha só os recursos necessários, como perfis e eventos.
Cadastre no cofre do iTeam
A chave fica no cofre; os agentes registram eventos e atualizam perfis, sem disparar campanhas.
Teste com aprovação
Inclusões em listas e qualquer envio passam por aprovação no início.
Dúvidas sobre a API do Klaviyo.
A API do Klaviyo é gratuita?
De forma geral, a API está disponível em todas as contas; o custo do Klaviyo segue o número de perfis e envios.
Preciso programar para usar a API do Klaviyo com o iTeam?
Não necessariamente. O Klaviyo está no catálogo de apps, e o time de implantação configura os fluxos.
Dá para disparar fluxos com eventos próprios?
Sim, eventos enviados pela API podem acionar fluxos configurados no Klaviyo.
Como criar a chave privada de API do Klaviyo com escopos de leitura e escrita?
A chave privada é criada nas configurações da conta do Klaviyo, e cada recurso recebe o escopo de leitura, escrita ou nenhum. Um agente que só analisa campanhas e métricas não precisa de escrita em perfis ou listas. Comece com leitura e libere escrita por recurso, depois de testar.
O que significa a revisão datada na API do Klaviyo?
A API do Klaviyo é versionada por data: cada requisição informa a revisão desejada em um cabeçalho, e o comportamento daquela revisão fica estável. Revisões antigas acabam sendo descontinuadas, então mantenha a configurada atualizada e reserve tempo para testar quando o Klaviyo anunciar mudanças.
Um agente de IA pode registrar eventos de comportamento no Klaviyo?
Pode: a API recebe eventos ligados a um perfil, como pedido atrasado ou visita a uma página de produto. Esses eventos viram gatilhos de fluxos que a equipe de CRM monta no Klaviyo. O agente alimenta o gatilho, mas o fluxo e o texto continuam aprovados por pessoas.
O agente pode enviar campanha de e-mail ou SMS pelo Klaviyo sozinho?
A API alcança campanhas e fluxos, mas um disparo atinge muita gente de uma vez e não tem volta. Por isso o envio exige aprovação: o agente monta o segmento e propõe o texto, e a pessoa responsável confirma. Isso vale mais ainda para SMS, que custa por mensagem.
Como o Klaviyo trata o consentimento de e-mail e SMS no uso por um agente?
O agente deve respeitar o consentimento e o descadastro registrados em cada perfil, incluindo na montagem de segmentos de envio. Mandar mensagem a quem não aceitou fere a LGPD e prejudica a reputação de envio. Peça ao jurídico para validar as regras de contato antes da primeira campanha.
Existe sandbox do Klaviyo para testar eventos e fluxos sem atingir clientes?
Não localizei um sandbox oficial; confira em developers.klaviyo.com. Uma saída prática é montar uma lista de teste com poucos perfis internos e validar ali o evento e o fluxo antes de apontar o agente para a base real de clientes.
O Klaviyo limita as requisições por endpoint?
Sim, os limites variam por endpoint, e a resposta de excesso orienta quando tentar de novo. O agente deve respeitar essa espera e, quando houver operação em lote, usá-la em vez de enviar um perfil por vez. Os valores atuais estão na documentação oficial.
O Klaviyo vale a pena para uma loja pequena que quer usar agente de IA?
Vale se a loja já faz e-mail e SMS no Klaviyo e tem histórico de pedidos para segmentar. O agente ajuda a achar quem comprou há muito tempo e a preparar a recompra. Sem base de contatos consentidos, não há muito o que automatizar.
