Antes de incluir ações externas nos seus fluxos de ação, é preciso conectar o criador de ações ao sistema externo.

Qual é o meu plano?
Suite, todas as versões Team, Growth, Professional, Enterprise ou Enterprise Plus
Support Team, Professional ou Enterprise

Resumo: ◀▼

Você pode conectar fluxos de ação ao Klaviyo usando uma chave da API para automatizar o gerenciamento de perfil do cliente, o monitoramento de eventos, as assinaturas em lista e a criação de campanha. Esta integração oferece suporte à criação, atualização e pesquisa de perfis, ao gerenciamento de listas e métricas e ao gerenciamento de campanhas. Use uma conta de serviço dedicada para conexões seguras e revise as permissões com atenção para manter o controle sobre dados e ações realizadas por meio da integração.

Ao conectar o criador de ações a sistemas externos, como o Klaviyo, os administradores podem integrar o Zendesk a sistemas externos em fluxos de trabalho automatizados, melhorando a colaboração e mantendo uma experiência contínua em várias plataformas.
Observação: as etapas associadas aos sistemas externos em fluxos de ação são chamadas coletivamente de ações externas.
Este artigo contém os seguintes tópicos:
  • Conexão do Klaviyo ao criador de ações
  • Uso de ações do Klaviyo em fluxos de ação

Conexão do Klaviyo ao criador de ações

Antes de incluir ações externas nos seus fluxos de ação, é preciso conectar o criador de ações ao sistema externo.

Ao se conectar a sistemas externos para uso em fluxos de ação, as seguintes práticas recomendadas devem ser observadas:
  • Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.
  • Todas as integrações solicitam acesso aos escopos necessários. No entanto, é importante que você avalie e valide os escopos antes de autorizar a conexão com o sistema externo.
  • Ao gerenciar credenciais para ferramentas baseadas em chave de API, como a OpenAI, recomendamos armazenar as chaves em um cofre seguro ou em um gerenciador de credenciais.

Como criar uma chave da API

A conexão do Klaviyo requer uma chave da API para autenticação. Para obter instruções detalhadas, consulte a documentação de credenciais de API do Klaviyo.
Importante: mantenha sua chave da API segura e não a compartilhe. A chave concede acesso à sua conta do Klaviyo e permite que os fluxos de ação executem operações em seu nome.
  1. Faça login em sua conta do Klaviyo.
  2. Vá para Configurações > Chaves da API.
  3. Copie a chave no formato: Klaviyo-API-Key {your_key}
  4. Salve a chave da API ou mantenha a janela aberta para poder copiá-la e colá-la no Zendesk.

    Você precisará dela ao conectar o Klaviyo ao criador de ações.

Como conectar o criador de ações ao Klaviyo
  1. Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione Ações > Fluxos de ação.
  2. Crie ou edite um fluxo de ação.
  3. Abra a barra lateral da etapa.
  4. Em Ações externas, clique em Klaviyo.
  5. Clique em Conectar.
  6. Siga os comandos para inserir a chave da API do Klaviyo e concluir a conexão. Cole a chave completa, incluindo o prefixo.

    Quando você autoriza a conexão, é redirecionado para o Klaviyo para conceder permissões à sua conta do Zendesk.

    A conexão do Klaviyo usa OAuth 2.0 com o tipo de concessão de código de autorização. Revise as permissões com atenção antes de autorizar a conexão. Essas permissões permitem fluxos de ação para criar e modificar páginas, adicionar comentários, gerenciar itens de banco de dados e atualizar conteúdo no espaço de trabalho do Klaviyo em seu nome.

    Observação: Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.

Depois de se conectar ao sistema, você verá um indicador de conexão e detalhes sobre a instância à qual está conectado, bem como as ações disponíveis para o Klaviyo.

Uso de ações do Klaviyo em fluxos de ação

As seguintes ações do Klaviyo estão disponíveis:
  • Criar perfil
  • Atualizar perfil
  • Pesquisar perfil
  • Criar evento
  • Inscrever perfil na lista
  • Remover perfil da lista
  • Pesquisar lista
  • Listar listas
  • Criar lista
  • Pesquisar métrica
  • Listar métricas
  • Criar campanha
  • Pesquisar campanha
  • Listar campanhas

Criação de perfil

Use a ação Criar perfil para criar um novo perfil de cliente no Klaviyo com informações de contato e atributos.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Opcionais: Email, Phone number, First name, Last name, Organization, Title, Image URL, Address line 1, Address line 2, City, Region/State, Country, Zip/Postal code

Números de telefone devem usar o formato E.164 com um sinal +, código do país e número do assinante sem espaços ou caracteres especiais (por exemplo, +15551234567).
Saída Retorna um objeto que contém ID do perfil, e-mail, número de telefone, nome, sobrenome, organização, cargo, imagem, carimbos de data/hora criados e atualizados e objeto de objeto de localização (com endereço 1, endereço 2, cidade, região, país, CEP).

Atualização de perfil

Use a ação Atualizar perfil para atualizar um perfil de cliente existente no Klaviyo com novas informações.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatória: Profile ID

Opcionais: Email, Phone number, First name, Last name, Organization, Title, Image URL, Address line 1, Address line 2, City, Region/State, Country, Zip/Postal code

Números de telefone devem usar o formato E.164 com um sinal +, código do país e número do assinante sem espaços ou caracteres especiais (por exemplo, +15551234567).
Saída Retorna um objeto que contém ID do perfil, e-mail, número de telefone, nome, sobrenome, organização, cargo, imagem, carimbos de data/hora criados e atualizados e objeto de objeto de localização (com endereço 1, endereço 2, cidade, região, país, CEP).

Pesquisa de perfil

Use a ação Pesquisar perfil para recuperar um único perfil de cliente por ID, e-mail ou número de telefone.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Identity profile by, Profile identifier

Você pode identificar perfis por ID, E-mail ou Número de telefone. O campo Identificador do perfil torna-se visível após selecionar o método de identificação.
Saída Retorna um objeto que contém ID do perfil, e-mail, número de telefone, nome, sobrenome, organização, cargo, imagem, carimbos de data/hora criados e atualizados e objeto de objeto de localização (com endereço 1, endereço 2, cidade, região, país, CEP).

Criação de um evento

Use a ação Criar evento no Klaviyo para acionar fluxos e medir a interação.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Metric name, Profile ID

Opcionais: Properties, Timestamp

As propriedades devem ser fornecidas como pares de chave-valor no formato JSON. O carimbo de data/hora deve usar o formato ISO 8601 (por exemplo, 2025-01-15T14:30:00Z) e o horário atual deve ser assumido como padrão, caso não seja fornecido.
Saída Retorna um objeto que contém o nome da métrica, o ID do perfil e o objeto properties.

Inscrição de perfil em uma lista

Use a ação Inscrever perfil na lista para adicionar um perfil a uma lista com configurações adicionais de consentimento por e-mail e SMS.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatória: List

Opcionais: Email, Phone number, Profile ID, Email consent, SMS consent

Números de telefone devem usar o formato E.164. As opções de consentimento por e-mail e por SMS incluem Sim – Realizar assinatura por e-mail/SMS (SUBSCRIBED) ou Não – Não realizar assinatura por e-mail/SMS (NONE).
Saída Retorna um objeto que contém status de sucesso (booliano) e mensagem.

Remoção de perfil de uma lista

Use a ação Remover perfil da lista para remover um perfil de uma lista específica no Klaviyo.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: List, Profile ID
Saída Retorna um objeto que contém status de sucesso (booliano) e mensagem.

Pesquisa de uma lista

Use a ação Pesquisar lista para recuperar detalhes de uma lista específica por ID ou nome.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Identify list by, List identifier

Você pode identificar listas por ID ou Nome. O campo Identificador da lista torna-se visível após selecionar o método de identificação.
Saída Retorna um objeto que contém o ID da lista, o nome, os carimbos de data/hora criados e atualizados e o processo de consentimento.

Lista de listas

Use a ação Listar listas para recuperar todas as listas no Klaviyo com filtragem de nomes e paginação opcionais.

As entradas e saídas dessa ação são:

  Variáveis
Entradas

Opcionais: Name, Page cursor
Saída Retorna um objeto que contém uma matriz de listas (cada uma com ID, nome, carimbos de data/hora criados e atualizados e processo de consentimento) e o cursor de próxima página para paginação.

Criação de listas

Use a ação Criar lista para criar uma nova lista no Klaviyo para organizar perfis.

As entradas e saídas dessa ação são:

  Variáveis
Entradas

Obrigatória: Name
Saída Retorna um objeto que contém o ID da lista, o nome, os carimbos de data/hora criados e atualizados e o processo de consentimento.

Pesquisa de uma métrica

Use a ação Pesquisar métrica para recuperar detalhes de uma métrica específica por ID.

As entradas e saídas dessa ação são:

  Variáveis
Entradas

Obrigatória: Metric ID
Saída Retorna um objeto que contém ID da métrica, nome, carimbos de data/hora criados e atualizados e objeto de integração (com ID, nome e categoria).

Lista de métricas

Use a ação Listar métricas para recuperar todas as métricas no Klaviyo com filtragem e paginação opcionais. Use essa ação para descobrir as métricas de evento disponíveis para gerenciar o comportamento do cliente.

As entradas e saídas dessa ação são:

  Variáveis
Entradas

Opcionais: Integration name, Integration category, Page cursor
Saída Retorna um objeto que contém uma matriz de métricas (cada uma com ID, nome, carimbos de data/hora criados e atualizados e objeto de integração com ID, nome e categoria) e o cursor de próxima página para paginação.

Criação de campanhas

Use a ação Criar campanha para criar uma nova campanha de marketing no Klaviyo com canal de e-mail ou SMS.

As entradas e saídas dessa ação são:

  Variáveis
Entradas

Obrigatórias: Name, List, Channel, Send strategy

Opcionais: Subject, Preview text, From email, From name, Reply-to email

As opções de canal são E-mail ou SMS.

As opções de estratégia de envio incluem Imediato, Programado (estático), Cadenciado ou Tempo de envio inteligente. A linha de assunto é obrigatória para campanhas de e-mail.
Saída Retorna um objeto que contém o ID da campanha, o nome, o status, o canal, os carimbos de data/hora criados e a hora de envio.

Pesquisa de uma campanha

Use a ação Pesquisar campanha para recuperar detalhes de uma campanha específica por ID ou nome.

As entradas e saídas dessa ação são:

  Variáveis
Entradas

Obrigatórias: Identify campaign by, Campaign identifier

Ao pesquisar por Nome (contém), a pesquisa retorna a primeira correspondência.

O campo Identificador da campanha torna-se visível após selecionar o método de identificação.
Saída Retorna um objeto que contém o ID da campanha, o nome, o status, o canal, os carimbos de data/hora criados, a hora de envio e o status arquivado (booliano).

Lista de campanhas

Use a ação Listar campanhas para recuperar todas as campanhas no Klaviyo com filtragem e paginação opcionais.

As entradas e saídas dessa ação são:

  Variáveis
Entradas

Obrigatória: Channel

Opcionais: Name, Status, Archived, Page cursor

As opções de status incluem Rascunho, Programado, Enviado ou Cancelado.

O filtro Arquivado aceita Sim ou Não.
Saída Retorna um objeto que contém uma matriz de campanhas (cada uma com ID, nome, status, canal, carimbos de data/hora criados e atualizados, hora de envio e status arquivado) e o cursor de próxima página para paginação.
Powered by Zendesk