Emarsys (beta)
A Emarsys é uma plataforma abrangente de automação de marketing que permite engajamento personalizado com clientes por e-mail, SMS e outros canais.
A integração com o Emarsys ainda está em beta
Conecte sua conta do Emarsys ao Chatlayer para gerenciar dados de contato, acionar campanhas automatizadas e sincronizar informações de clientes em todos os seus canais de marketing.
Configurando credenciais de API no Emarsys
Você precisa da função de Proprietário da conta no Emarsys para conseguir provisionar uma. Você pode encontrá-la em Gerenciamento -> Configurações de segurança -> Credenciais de API, crie uma do tipo WSSE.
Permissões de API
Antes de conectar o Emarsys ao Chatlayer, você precisa garantir que suas credenciais de API tenham as permissões apropriadas no 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 do Emarsys para obter informações detalhadas sobre a criação de usuários de API.
Conectando o Emarsys ao Chatlayer
Depois de obter suas credenciais de API (Nome de usuário(ID) e Segredo(Segredo do cliente)) da sua conta Emarsys, você pode se conectar ao Chatlayer.
Em um bloco de ação, o aplicativo Emarsys estará disponível no menu de opções de aplicativos.
Uma seção de integração de aplicativo aparecerá. Você verá quaisquer contas já conectadas ao Chatlayer e um botão para conectar uma nova conta. Se a conta de que você precisa já estiver conectada, você pode selecioná-la na lista e pular as etapas de conexão.
Clique em "Conectar nova conta" e insira suas credenciais de API do 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 com o Emarsys oferece várias ações para gerenciar contatos e acionar eventos:
A maioria das ações usa IDs de campo. Consulte esta referência para campos padrão. 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 por humanos 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 de IDs de campo a serem recuperados (por exemplo, "1,2,3")
Atualizar dados de contato
Atualiza os 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 de chave-valor de IDs de campo e seus novos valores
Caso de uso de exemplo: atualizar as preferências ou o status de assinatura de um contato 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últiplas)
Retorna as opções disponíveis para campos de múltipla escolha, ajudando você a entender os 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 isso para trazer 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 de IDs de campo a serem recuperados (por exemplo, "1,2,3")
Disparar evento externo
Dispara um evento externo no Emarsys para um contato específico, o que pode iniciar campanhas automatizadas.
Campos obrigatórios:
ID do contato: O identificador exclusivo do contato
ID do evento: O ID do evento externo a ser disparado
Caso de uso de exemplo: disparar uma campanha de e-mail de boas-vindas quando um usuário concluir o onboarding no seu bot.
Notas do desenvolvedor
Autenticação
A integração com o Emarsys usa autenticação WSSE (Web Services Security), que gera um token seguro para cada solicitação de API com base em:
Nome de usuário e Segredo das suas credenciais de API
Um nonce exclusivo (valor aleatório)
Carimbo de data/hora atual
Hash SHA1 para segurança
Isso garante uma comunicação segura sem expor suas credenciais em texto simples.
IDs de campo
O Emarsys usa IDs numéricos de campo em vez de nomes de campo. Os campos de sistema comuns incluem:
1: Nome
2: Sobrenome
3: E-mail
31: Telefone
Use a ação "Listar campos disponíveis" para descobrir os 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 solicitação inválido ou campos obrigatórios ausentes
401: Falha na autenticação - verifique suas credenciais
404: Contato ou recurso não encontrado
429: Limite de taxa excedido - reduza a frequência das solicitações
Atualizado
Isto foi útil?