# Emarsys (beta)

{% hint style="warning" %}
A integração com a Emarsys ainda está em beta
{% endhint %}

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.

<figure><img src="/files/1240841151191bccf077d3fc087d65d42b2c2c4a" alt="" width="375"><figcaption><p>Configurar permissões do usuário da API na Emarsys (parte 1)</p></figcaption></figure>

<figure><img src="/files/47c868574887460e8356a0f0141ac0bb5de76ffe" alt="" width="375"><figcaption><p>Configurar permissões do usuário da API na Emarsys (parte 2)</p></figcaption></figure>

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](https://dev.emarsys.com/docs/emarsys-core-api-guides/branches/main/84e0ffaf961f9-overview) 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).

<figure><img src="/files/6cda7984724aea6187e5a9f4fe68d9b26e2be6c8" alt="" width="375"><figcaption><p>Insira Nome de Usuário e Segredo da Emarsys</p></figcaption></figure>

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](https://dev.emarsys.com/docs/core-api-reference/7f3e853b57d26-contact-system-fields) 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.

<figure><img src="/files/279d10019a262b061b4bb950e69d073bff2d373d" alt="" width="375"><figcaption><p>Ação Obter Dados de Contato com Valores de Enumeração</p></figcaption></figure>

**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.

<figure><img src="/files/838289c905a0d2789b938c4e7cbd58087037d765" alt="" width="375"><figcaption><p>Ação Atualizar Dados do Contato</p></figcaption></figure>

**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.

<figure><img src="/files/631d5839930a84a41e9ff2f8f7d05ecaeeb15d4b" alt="" width="375"><figcaption><p>Ação Listar Campos Disponíveis</p></figcaption></figure>

### 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.

<figure><img src="/files/67673f58541c036cd6d2522638092e736a44481e" alt="" width="375"><figcaption><p>Listar opções disponíveis para campos de múltipla escolha</p></figcaption></figure>

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

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

<figure><img src="/files/01e9b979e9eef9fb6b9f72e4265f30dd290d1ae1" alt="" width="375"><figcaption><p>Listar opções disponíveis para campos de escolha única</p></figcaption></figure>

### 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.

<figure><img src="/files/de161148e5d14ae242f6cc3be34f93a521a3f7fd" alt="" width="375"><figcaption><p>Ação Obter Dados de Contato</p></figcaption></figure>

**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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/app-integrations/emarsys.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.