> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/app-integrations/emarsys.md).

# Emarsys (beta)

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

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.

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

<figure><img src="/files/47c868574887460e8356a0f0141ac0bb5de76ffe" alt="" width="375"><figcaption><p>Configurar permissões de usuário de API no 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 do Emarsys](https://dev.emarsys.com/docs/emarsys-core-api-guides/branches/main/84e0ffaf961f9-overview) 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).

<figure><img src="/files/6cda7984724aea6187e5a9f4fe68d9b26e2be6c8" alt="" width="375"><figcaption><p>Insira o Nome de usuário e o Segredo do 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 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](https://dev.emarsys.com/docs/core-api-reference/7f3e853b57d26-contact-system-fields) 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.

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

<figure><img src="/files/838289c905a0d2789b938c4e7cbd58087037d765" alt="" width="375"><figcaption><p>Ação Atualizar dados de 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 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.

<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últiplas)

Retorna as opções disponíveis para campos de múltipla escolha, ajudando você a entender os 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 isso para trazer 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 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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.