Emarsys (beta)
Emarsys é uma plataforma completa de automação de marketing que possibilita engajamento personalizado com o cliente por 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.
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).
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.
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.
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.
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 (Única)
Retorna as 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.
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
Atualizado
Isto foi útil?