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

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 Iterable usando uma chave da API do lado do servidor para automatizar o gerenciamento de perfis de usuários, o monitoramento de eventos, comentários e campanhas por e-mail. As ações incluem a criação, atualização e pesquisa de usuários, o envio de e-mails iniciados por gatilho e o gerenciamento de campanhas. Use uma conta de serviço dedicada para a integração e especifique o data center correto para garantir a autenticação adequada e uma automação tranquila do fluxo de trabalho em todas as plataformas.

Ao conectar o criador de ações a sistemas externos, como o Iterable, 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 Iterable ao criador de ações
• Uso de ações do Iterable em fluxos de ação

Conexão do Iterable 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 com o Iterable requer uma chave da API do lado do servidor do seu projeto do Iterable. Chaves da API somente leitura não funcionam. Crie uma chave da API do lado do servidor com as permissões de gravação apropriadas.

1. Entre em sua conta do Iterable.
2. Navegue até Integrations > API Keys.
3. Crie uma nova chave da API do lado do servidor.
4. Salve a chave ou mantenha a janela aberta para poder copiá-la e colá-la no Zendesk.

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

Como conectar o criador de ações ao Iterable

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 Iterable.
5. Clique em Conectar.
6. Siga os comandos do Iterable para se autenticar e concluir a conexão:
   • Insira sua chave da API do lado do servidor do Iterable.
   • Especifique a região do data center (EUA ou UE). Se sua conta do Iterable estiver hospedada no data center da União Europeia, você deve especificar "EU" como o data center. Se deixar vazio, a conexão será padronizada para o data center dos EUA (api.iterable.com). Usar o data center errado causará falhas na autenticação.
   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 Iterable.

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

As seguintes ações do Iterable estão disponíveis:

• Criar usuário
• Atualizar usuário
• Pesquisar usuário
• Criar evento
• Adicionar comentário
• Enviar e-mail para usuário
• Pesquisa campanha
• Listar campanhas

Criação de um usuário

Use a ação Criar usuário para criar um novo perfil de usuário no Iterable. Se o usuário já existir, o perfil dele será atualizado com as informações fornecidas (comportamento de upsert).

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

	Variáveis
Entradas	Obrigatória: Email Opcionais: User ID, Data fields, Prefer user ID, Create new fields, Merge nested objects
Saída	Status de êxito, mensagem, e-mail e ID do usuário.

Atualização de um usuário

Use a ação Atualizar usuário para atualizar um perfil de usuário existente no Iterable. Se o usuário não existir, um novo perfil será criado com as informações fornecidas (comportamento de upsert).

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

	Variáveis
Entradas	Obrigatória: Email Opcionais: User ID, Data fields, Prefer user ID, Create new fields, Merge nested objects
Saída	Status de êxito, mensagem, e-mail e ID do usuário.

Pesquisa de usuário

Use a ação Pesquisar usuário para recuperar um perfil de usuário por endereço de e-mail ou ID do usuário.

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

	Variáveis
Entradas	Obrigatórias: Identifier type, Identifier value
Saída	Detalhes do perfil do usuário, incluindo e-mail, ID do usuário, data de cadastro, data de atualização do perfil e campos de dados personalizados.

Criação de um evento

Use a ação Criar evento para monitorar um evento personalizado para um usuário no Iterable. Os eventos podem ser usados para segmentação, gatilhos de campanha e análise.

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

	Variáveis
Entradas	Obrigatórias: Email, Event name Opcionais: User ID, Data fields, Event ID, Campaign, Template, Create new fields
Saída	Status de êxito, mensagem, nome do evento, e-mail, ID do usuário e ID do evento.

Adição de comentários

Use a ação Adicionar comentário para adicionar um comentário ou uma observação a um perfil de usuário. O comentário é armazenado como um campo personalizado nos campos de dados do usuário.

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

	Variáveis
Entradas	Obrigatórias: Email, Comment Opcionais: User ID, Field name
Saída	Status de êxito, mensagem, e-mail, ID do usuário e nome do campo em que o comentário foi armazenado.

Envio de um e-mail para um usuário

Use a ação Enviar e-mail para usuário para enviar um e-mail iniciado por gatilho para um usuário usando uma campanha do Iterable. A campanha deve estar em um estado acionável.

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

	Variáveis
Entradas	Obrigatórias: Campaign, Recipient email Opcionais: Data fields, Send at
Saída	Status de êxito, mensagem, ID da campanha, e-mail do destinatário e horário de envio programado.

Pesquisa de uma campanha

Use a ação Pesquisar campanha para recuperar detalhes da campanha, incluindo nome, status, tipo e informações do modelo.

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

	Variáveis
Entradas	Obrigatória: Campaign
Saída	Detalhes da campanha, incluindo ID, nome, estado, tipo, ID do modelo, IDs de lista, hora de envio, data de criação e data de atualização.

Lista de campanhas

Use a ação Listar campanhas para recuperar todas as campanhas em seu projeto do Iterable.

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

	Variáveis
Entradas	Nenhuma
Saída	Matriz de objetos de campanha contendo ID, nome, status e tipo, além da contagem total.