Emarsys (beta)

A Emarsys é uma plataforma abrangente de automação de marketing que permite engajamento personalizado com clientes por meio de e-mail, SMS e outros canais.

A integração com a Emarsys ainda está em beta

Conecte sua conta Emarsys ao Chatlayer para gerenciar dados de contato, acionar campanhas automatizadas e sincronizar informações de clientes entre seus canais de marketing.

Configurando credenciais de API na Emarsys

Você precisa do Proprietário da Conta papel dentro da Emarsys para poder provisionar uma. Você pode encontrá-lo em Gerenciamento -> Configurações de Segurança -> Credenciais de API, crie uma do tipo WSSE.

Permissões da API

Antes de conectar a Emarsys ao Chatlayer, você precisa garantir que suas credenciais de API tenham as permissões apropriadas na Emarsys.

Configurar permissões do usuário da API na Emarsys (parte 1)

Configurar permissões do usuário da API na Emarsys (parte 2)

Certifique-se de que seu usuário de API tenha permissões para acessar contatos, eventos externos e informações de campos. Consulte a documentação da API da Emarsys para informações detalhadas sobre a criação de usuários de API.

Conectando a Emarsys ao Chatlayer

Depois de obter suas credenciais de API (Nome de usuário (ID) e Segredo (Client Secret)) da sua conta Emarsys, você pode conectar ao Chatlayer.

Em um bloco Ação, o aplicativo Emarsys estará disponível no menu de opções de App.

Uma seção de integração de App aparecerá. Você verá quaisquer contas já conectadas ao Chatlayer e um botão para conectar uma nova conta. Se a conta que você precisa já estiver conectada, você pode selecioná-la na lista e pular os passos de conexão.

Clique em "Conectar nova conta" e insira suas credenciais de API da Emarsys (Nome de usuário e Segredo do usuário de API que você criou).

Insira Nome de Usuário e Segredo da Emarsys

Após a autenticação bem-sucedida, sua conta Emarsys aparecerá na lista de contas conectadas.

Ações Disponíveis

A integração Emarsys fornece várias ações para gerenciar contatos e acionar eventos:

A maioria das ações usa IDs de campo. Veja esta referência para campos integrados. Você também pode usar a ação "Listar Campos Disponíveis" para ver todos os campos disponíveis.

Obter Dados de Contato com Valores de Enumeração

Recupera os valores dos campos de um contato especificado e retorna valores legíveis para campos de escolha em vez de códigos numéricos.

Ação Obter Dados de Contato com Valores de Enumeração

Campos obrigatórios:

• ID da Chave: O ID do campo a ser usado como identificador do contato (por exemplo, "3" para e-mail)

• ID do Contato: O valor do identificador (por exemplo, o endereço de e-mail)

• Campos: Lista separada por vírgulas dos IDs de campo a serem recuperados (por exemplo, "1,2,3")

Atualizar Dados do Contato

Atualiza dados de um contato existente ou cria um novo contato se ele não existir.

Ação Atualizar Dados do Contato

Campos obrigatórios:

• ID da Chave: O ID do campo a ser usado como identificador do contato

• ID do Contato: O valor do identificador

• Campos de Dados do Contato: Pares chave-valor de IDs de campo e seus novos valores

Caso de uso de exemplo: Atualizar as preferências de um contato ou status de assinatura com base nas interações com o bot.

Listar Campos Disponíveis

Recupera todos os campos de contato disponíveis na sua conta Emarsys. Útil para descobrir IDs de campo ao configurar outras ações.

Ação Listar Campos Disponíveis

Listar Opções Disponíveis (Múltipla)

Retorna as opções disponíveis para campos de múltipla escolha, ajudando você a entender valores válidos para atualizações.

Listar opções disponíveis para campos de múltipla escolha

Listar Opções Disponíveis (Única)

Retorna as opções disponíveis para campos de escolha única.

Listar opções disponíveis para campos de escolha única

Obter Dados de Contato

Recupera os valores dos campos de um contato especificado. Use isto para puxar informações do cliente para o fluxo do seu bot.

Ação Obter Dados de Contato

Campos obrigatórios:

• ID da Chave: O ID do campo a ser usado como identificador do contato (por exemplo, "3" para e-mail)

• ID do Contato: O valor do identificador (por exemplo, o endereço de e-mail)

• Campos: Lista separada por vírgulas dos IDs de campo a serem recuperados (por exemplo, "1,2,3")

Acionar Evento Externo

Aciona um evento externo na Emarsys para um contato específico, o que pode iniciar campanhas automatizadas.

Campos obrigatórios:

• ID do Contato: O identificador único do contato

• ID do Evento: O ID do evento externo a ser acionado

Caso de uso de exemplo: Acionar uma campanha de e-mail de boas-vindas quando um usuário conclui o onboarding no seu bot.

Notas para Desenvolvedores

Autenticação

A integração Emarsys usa autenticação WSSE (Web Services Security), que gera um token seguro para cada requisição de API baseado em:

• Nome de usuário e Segredo das suas credenciais de API

• Um nonce único (valor aleatório)

• Timestamp atual

• Hash SHA1 para segurança

Isso garante comunicação segura sem expor suas credenciais em texto simples.

IDs de Campo

A Emarsys usa IDs numéricos de campo em vez de nomes de campo. Campos comuns do sistema incluem:

• 1: Primeiro Nome

• 2: Sobrenome

• 3: E-mail

• 31: Telefone

Use a ação "Listar Campos Disponíveis" para descobrir IDs de campo específicos da sua conta, incluindo campos personalizados.

Tratamento de Erros

As respostas da API incluem códigos de status e mensagens de erro. Problemas comuns:

• 400: Formato de requisição inválido ou campos obrigatórios ausentes

• 401: Autenticação falhou - verifique suas credenciais

• 404: Contato ou recurso não encontrado

• 429: Limite de taxa excedido - reduza a frequência de requisições